Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

chore: release v0.76.0

esengine028264c416a2
diff --git a/CHANGELOG.md b/CHANGELOG.md
index d0e8eb1f7..63fc48ded 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -14,16 +14,19 @@ published separately; it ships inside the editor.
## [Unreleased]
+## [0.76.0] - 2026-10-01
+
### Changed
- **A texture's Compression is Auto, GPU compressed or Original image, and a build does what it says.** A build used to encode every texture with Compress on and then ship whichever file was smaller, overruling the row: ORCA Bistro's export shipped 321 of its textures as PNGs, 4.7 GiB decoded on a player's GPU. Every engine we looked at (Godot, Unity, Unreal, Cocos Creator) keeps the author's per-texture choice, and Godot's defaults are what Auto follows: a texture a mesh draws — directly, or through its material — is GPU compressed, where video memory is the cost; a sprite or UI image ships as its file, where a flat PNG is often a tenth of the KTX2. An explicit choice is kept whatever draws the texture. A `.meta` written before this keeps its meaning: its `true` was the default every fresh file got, so it reads as Auto, and `false` as Original image. Across the examples, the 2D ones ship the same bytes (tilemap-demo 6 KB more); a 3D one with a 1024 texture on a mesh ships it as a 1.3 MB KTX2 where the PNG was 14 KB. The Inspector says why a texture ships raw, and an export names the Original-image textures a mesh draws and what they cost decoded — a lightmap, kept exact by its bake, left out.
+- **A bake uses every core, in C++.** The ray casting runs in a compiled kernel (`build-tools/lightmap`, built from `tools/lightmap-wasm`) on every core, with a tree built for tracing rather than for building quickly. Its rules are the TypeScript solve's, rounding included, and a gate holds the two to the same atlas bytes; any thread count writes the same bytes. ORCA Bistro — 1.2 million lumels, 2.8 million triangles — bakes in 44 s on a 20-thread machine, where a pool of worker threads took 312 s and one thread twenty-five to fifty-five minutes; the solve itself is 36 s of that. The kernel also decodes the textures a surface's colour is averaged from, side by side: Bistro's 132 took 2 s instead of 20. The editor and `bake-scene` both use it. Two triangles a ray meets at the same distance now go to the lower-numbered one, so the answer no longer depends on how a tree is built; physics-3d's committed bake moved by one step in two texels.
+
### Added
- **A directional light can be the environment's sun.** An HDRI with a sun in it lit a scene twice when the scene also had a sun — once in the environment's diffuse light, spread across the whole sky and into every shadow, and once from the light — and the two pointed wherever each was set. Importing a `.hdr` now finds its sun: the compact region around its brightest texel, when it carries a real share of the light. The `.esenv` keeps the full irradiance and adds the sun's direction, its strength and the sky's irradiance without it. A Directional light with **Follow Environment Sun** takes its direction and strength from that sun, turned with the environment and scaled by the ambient light as the panorama is; its own colour and intensity scale it on top. The environment then lights with the sky alone. The editor draws the light along the sun, and a light following an environment with no sun is left out of the frame with the reason in the Inspector. Bakes resolve it the same way. Under ORCA Bistro's HDRI the sunlit street's colour now matches the reference render, and its shadows are blue sky rather than warm sun. Reimport a `.hdr` to add its sun.
- **Baked light is a lit surface's indirect light.** A lit renderer — every imported model's is — reads its patch of the atlas in place of the environment's diffuse light and a probe volume's, and keeps its lamps, shadows and reflections live. The bake holds the sky as it reaches each point past whatever stands in the way, plus what the surfaces around give off, over as many bounces as asked: under ORCA Bistro's awnings and in its side streets the sky is now mostly hidden, where before every point got all of it. Before, a model's material never read the atlas at all, and a mesh drawn without one added it on top of the sky and the lamps and was lit twice. The sky a bake gathers is the environment's own irradiance, turned and tinted as the frame reads it, so an open floor bakes to exactly what the frame would light it with. An atlas holds light up to eight times a flat ambient of one, where eight plain bits stopped at one. A cutout lets the share of rays that meets its holes through, both faces of a two-sided surface give off light, and a layer lying closer above a surface than half a lumel — a decal, a wet sheen — no longer walls it off from the sky. A scene baked before reads as stale: its atlas is in the old encoding and must be baked again.
-- **A bake uses every core, in C++.** The ray casting runs in a compiled kernel (`build-tools/lightmap`, built from `tools/lightmap-wasm`) on every core, with a tree built for tracing rather than for building quickly. Its rules are the TypeScript solve's, rounding included, and a gate holds the two to the same atlas bytes; any thread count writes the same bytes. ORCA Bistro — 1.2 million lumels, 2.8 million triangles — bakes in 44 s on a 20-thread machine, where a pool of worker threads took 312 s and one thread twenty-five to fifty-five minutes; the solve itself is 36 s of that. The kernel also decodes the textures a surface's colour is averaged from, side by side: Bistro's 132 took 2 s instead of 20. The editor and `bake-scene` both use it. Two triangles a ray meets at the same distance now go to the lower-numbered one, so the answer no longer depends on how a tree is built; physics-3d's committed bake moved by one step in two texels.
- **A model whose second UV set cannot be baked into gets a lightmap UV in its place.** One that covers under 5% of its square pays for the empty rest — ORCA Bistro's road, 3533 m² in 0.5% of it, asked for more atlas than the rest of the town together — and one that lies on itself gives every copy the same texel's light: Bistro's curbs share one strip eighty layers deep, and a building's facades a hundred. Import unwraps either instead and says why; `import-model --lightmap-uv` turns generation on from the command line. A bake names a surface whose UVs overlap, and one that does not fit names the three surfaces taking the most room and how much of their square their UVs cover.
### Fixed
@@ -13806,7 +13809,8 @@ not kept before this file was introduced — see the Git history at
`github.com/esengine/estella` for the full commit-level record since the first
commit on 2026-01-25.
-[Unreleased]: https://github.com/esengine/estella/compare/v0.75.0...HEAD
+[Unreleased]: https://github.com/esengine/estella/compare/v0.76.0...HEAD
+[0.76.0]: https://github.com/esengine/estella/compare/v0.75.0...v0.76.0
[0.75.0]: https://github.com/esengine/estella/compare/v0.74.0...v0.75.0
[0.74.0]: https://github.com/esengine/estella/compare/v0.73.0...v0.74.0
[0.73.0]: https://github.com/esengine/estella/compare/v0.72.0...v0.73.0
diff --git a/SECURITY.md b/SECURITY.md
index 8c402f2fc..57a902313 100644
--- a/SECURITY.md
+++ b/SECURITY.md
@@ -7,8 +7,8 @@ upgrading to the latest release is the supported path to a fix.
| Version | Supported |
|---------|-----------|
-| 0.75.x | Yes |
-| < 0.75 | No |
+| 0.76.x | Yes |
+| < 0.76 | No |
`tools/check-release-metadata.mjs` fails the build if this table stops matching
the version being shipped, so it cannot quietly fall behind again.
diff --git a/desktop b/desktop
index f750973a8..33e902b36 160000
--- a/desktop
+++ b/desktop
@@ -1 +1 @@
-Subproject commit f750973a84317c57627a7c5b851b496239b3d9b9
+Subproject commit 33e902b361d7556fd787bf9a2f80dedce5f6f27e
diff --git a/package.json b/package.json
index 4d9185ad8..e5c8d8ce6 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
{
"name": "estella",
- "version": "0.75.0",
+ "version": "0.76.0",
"private": true,
"type": "module",
"description": "Estella - A fast 2D/3D game engine powered by WebAssembly and ECS",
diff --git a/tools/goldenProjects.mjs b/tools/goldenProjects.mjs
index 05bf28504..5af3a24ca 100644
--- a/tools/goldenProjects.mjs
+++ b/tools/goldenProjects.mjs
@@ -90,6 +90,13 @@ export const CENSUS_FLOOR = '0.60.0';
* that does not exist, and release notes are a different act. Theirs is ungated.
*/
export const SHIPPED = {
+ // — 0.76.0 —
+ "A directional light can be the environment's sun":
+ { notCertifiable: 'no golden project lights from an HDRI with a sun in it; pipeline/tests/environment-import.test.ts holds the sun found on import and the environment-sun editor check the light that follows it' },
+ "Baked light is a lit surface's indirect light":
+ { certifies: 'lightmap' },
+ 'A model whose second UV set cannot be baked into gets a lightmap UV in its place':
+ { notCertifiable: 'an import, which no golden project re-runs; pipeline/tests/lightmap-uv.test.ts holds the unwrap and when it is chosen' },
// — 0.75.0 —
"A cutout's edge is antialiased":
{ notCertifiable: 'no golden project draws an alpha-cutout material; the corpus-cutout-edge and corpus-cutout-edge-gamma render gates hold it on both backends, on Khronos\'s AlphaBlendModeTest' },