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.

docs(changelog): cut the notes for 0.67.0

esengined0a41f0178d2
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 99ca44376..37c7d369b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -14,6 +14,8 @@ published separately; it ships inside the editor.
## [Unreleased]
+## [0.67.0] - 2026-09-15
+
### Added
- **A scene says how it is lit, and whether its light still describes it.** The
@@ -79,55 +81,6 @@ published separately; it ships inside the editor.
by hand can falsify it, where a solver built first would have nothing to say
whether it solved the right thing. Baking one is the next step.
-### Fixed
-
-- **The command line bakes the meshes a scene actually names.** An asset ref is
- PROJECT-relative, and `bake-scene` resolved it against the scene's own folder —
- so every object drawing a real `.esmesh` fell out of the bake with "draws no
- mesh asset", and only scenes built from stock geometry came out lit. It now
- resolves against the project root and reads `@uuid:` refs out of the `.meta`
- index, which is what the editor's own collector does.
-
-- **Both bake doors read a light the same way.** A spot's inner angle defaults to
- 30 degrees, and the command line filled an unstated one in with 45. One reading
- now serves both — the document's values over the component's own defaults —
- along with one transform compose and one `.esprobes` writer. Three places where
- the editor and CI could quietly disagree about the same scene.
-
-- **A scene's ambient light reaches its bake.** `LightType.Ambient` is the third
- value of the enum and `Spot` the fourth, and both bake collectors read the third
- as a spot lamp — so the sky lit nothing it was not standing next to. An ambient
- light occupies no slot and aims nowhere; it is now the bake's ambient term, the
- way the renderer already folds it into its own. Outdoors this is most of the
- indirect light there is: `physics-3d`'s probes go from black to carrying its
- sky's blue.
-
-- **A bake's products can be carried by a package.** `bake-scene` wrote the atlas
- and nothing else — no `.meta`, so the cook had no identity to carry it by, and
- the export said so in a warning nobody reads. The scene named an atlas the
- package did not hold, and the room shipped unlit. The check now fails on a
- product with no `.meta` and says which command mints one; the editor's own bake
- already minted them.
-
-- **A gather reads the lit side of a surface.** Light bounced off the BACK of a
- wall as readily as off its front, because an atlas is per triangle and has no
- side. A ray arriving at a face from behind now finds it unlit, which is what
- keeps a probe standing behind a wall from being lit by what the wall hides.
-
-- **A per-draw block reaches the draw that wrote it.** The pose of a skinned
- draw, the shapes of a morphed one and (now) the indirect light of a probe-lit
- one shared one buffer each, rewritten immediately before the draw that reads
- it. That is correct where an upload takes effect at the call, and wrong on a
- backend that QUEUES them: on WebGPU the writes land together when the pass is
- submitted, so every draw in that pass read whatever the LAST of them wrote —
- one pose on every character in the room, one set of shapes on every face.
-
- Every skin and morph gate in the suite drew a single object, so none of them
- could see it. Each draw now takes a buffer of its own from a frame-scoped pool,
- and a draw with nothing to say binds a zeroed block that is never written —
- "none" as an object rather than an erasure someone has to remember to perform.
- Two morphed draws in one frame, blended different amounts, is now a gate.
-
- **A room in the corpus is actually lit.** `physics-3d` — twenty-two boxes and
two lamps — now ships with its lighting baked: an atlas beside the scene, and a
`MeshLightmap` on every object saying where in it to read. It is the first
@@ -287,6 +240,53 @@ published separately; it ships inside the editor.
### Fixed
+- **The command line bakes the meshes a scene actually names.** An asset ref is
+ PROJECT-relative, and `bake-scene` resolved it against the scene's own folder —
+ so every object drawing a real `.esmesh` fell out of the bake with "draws no
+ mesh asset", and only scenes built from stock geometry came out lit. It now
+ resolves against the project root and reads `@uuid:` refs out of the `.meta`
+ index, which is what the editor's own collector does.
+
+- **Both bake doors read a light the same way.** A spot's inner angle defaults to
+ 30 degrees, and the command line filled an unstated one in with 45. One reading
+ now serves both — the document's values over the component's own defaults —
+ along with one transform compose and one `.esprobes` writer. Three places where
+ the editor and CI could quietly disagree about the same scene.
+
+- **A scene's ambient light reaches its bake.** `LightType.Ambient` is the third
+ value of the enum and `Spot` the fourth, and both bake collectors read the third
+ as a spot lamp — so the sky lit nothing it was not standing next to. An ambient
+ light occupies no slot and aims nowhere; it is now the bake's ambient term, the
+ way the renderer already folds it into its own. Outdoors this is most of the
+ indirect light there is: `physics-3d`'s probes go from black to carrying its
+ sky's blue.
+
+- **A bake's products can be carried by a package.** `bake-scene` wrote the atlas
+ and nothing else — no `.meta`, so the cook had no identity to carry it by, and
+ the export said so in a warning nobody reads. The scene named an atlas the
+ package did not hold, and the room shipped unlit. The check now fails on a
+ product with no `.meta` and says which command mints one; the editor's own bake
+ already minted them.
+
+- **A gather reads the lit side of a surface.** Light bounced off the BACK of a
+ wall as readily as off its front, because an atlas is per triangle and has no
+ side. A ray arriving at a face from behind now finds it unlit, which is what
+ keeps a probe standing behind a wall from being lit by what the wall hides.
+
+- **A per-draw block reaches the draw that wrote it.** The pose of a skinned
+ draw, the shapes of a morphed one and (now) the indirect light of a probe-lit
+ one shared one buffer each, rewritten immediately before the draw that reads
+ it. That is correct where an upload takes effect at the call, and wrong on a
+ backend that QUEUES them: on WebGPU the writes land together when the pass is
+ submitted, so every draw in that pass read whatever the LAST of them wrote —
+ one pose on every character in the room, one set of shapes on every face.
+
+ Every skin and morph gate in the suite drew a single object, so none of them
+ could see it. Each draw now takes a buffer of its own from a frame-scoped pool,
+ and a draw with nothing to say binds a zeroed block that is never written —
+ "none" as an object rather than an erasure someone has to remember to perform.
+ Two morphed draws in one frame, blended different amounts, is now a gate.
+
- **A hot reload no longer empties the running game of every resource**
([#60](https://github.com/esengine/estella/issues/60)). Edit a script while the
game is playing and the editor re-imports the bundle and swaps the system
@@ -12568,7 +12568,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.66.0...HEAD
+[Unreleased]: https://github.com/esengine/estella/compare/v0.67.0...HEAD
+[0.67.0]: https://github.com/esengine/estella/compare/v0.66.0...v0.67.0
[0.66.0]: https://github.com/esengine/estella/compare/v0.65.0...v0.66.0
[0.65.0]: https://github.com/esengine/estella/compare/v0.64.0...v0.65.0
[0.64.0]: https://github.com/esengine/estella/compare/v0.63.0...v0.64.0
diff --git a/SECURITY.md b/SECURITY.md
index 7bb73308c..c0ab24728 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.66.x | Yes |
-| < 0.66 | No |
+| 0.67.x | Yes |
+| < 0.67 | 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 89b74039d..f8269406a 160000
--- a/desktop
+++ b/desktop
@@ -1 +1 @@
-Subproject commit 89b74039d21c455ea3e60dd1b4983380a1d6085e
+Subproject commit f8269406a89222269b28193dbc6bc248bfb1da21
diff --git a/package.json b/package.json
index 6b6efaf42..502dabe0b 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
{
"name": "estella",
- "version": "0.66.0",
+ "version": "0.67.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 98ed5c52d..08813d069 100644
--- a/tools/goldenProjects.mjs
+++ b/tools/goldenProjects.mjs
@@ -90,6 +90,31 @@ 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.67.0 —
+ 'A mesh can be read through the light that was baked into it.': { certifies: 'lightmap' },
+ 'The bake itself: lights become an atlas.': { certifies: 'lightmap' },
+ 'A bounce carries the colour of what it came off.': { certifies: 'lightmap' },
+ 'Stock geometry takes a bake, and the density suits this engine\'s units.':
+ { certifies: 'lightmap' },
+ 'A room in the corpus is actually lit.': { certifies: 'lightmap' },
+ 'Light probes: what lights a thing a bake cannot hold still.': { certifies: 'light-probe' },
+ 'A bake now solves the probes too, and refuses to light what moves.':
+ { certifies: 'light-probe' },
+ 'A model can be given somewhere to receive baked light.':
+ { notCertifiable: 'the import setting that writes a second UV set into an .esmesh; the one'
+ + ' scene that ships baked is built from stock geometry, whose UVs a bake derives per run,'
+ + ' so no package carries an IMPORTED unwrap. unwrap.test.ts holds the layout, and'
+ + ' check-import-settings holds that the setting has a reader' },
+ 'Bake Lighting.':
+ { notCertifiable: 'the editor command that triggers a bake — a package carries the atlas,'
+ + ' never the menu item that wrote it, and that atlas is certified as lightmap. The'
+ + ' end-to-end editor check bakes a real scene and reads the saved document back' },
+ 'A scene says how it is lit, and whether its light still describes it.':
+ { notCertifiable: 'a bake\'s INPUTS and whether they still match: the knobs change nothing a'
+ + ' package draws, and staleness is a question only the editor asks. What ships is the'
+ + ' light itself, certified as lightmap and light-probe, and the corpus-bake gate holds'
+ + ' the committed atlas against a fresh bake so a stale one cannot pass as correct' },
+
// — 0.66.0 —
'A model brings the shapes it can be blended towards.': { certifies: 'morph-target' },
'A controller is a stack of machines, not one.': { certifies: 'animation-layers' },
@@ -169,9 +194,10 @@ export const SHIPPED = {
// — 0.63.0 —
'One number turns the sky, the irradiance and the reflection': { certifies: 'environment' },
'A second UV set survives the import boundary':
- { notCertifiable: 'a channel carried and deliberately unread — no lightmapper, no graph node,'
- + ' no material change — so no game act can observe it; check-mesh-vocabulary holds the two'
- + ' halves of the format and the .esmesh decode fixtures hold the bytes' },
+ { notCertifiable: 'the channel a lightmap is read through. It has a reader now — the bake —'
+ + ' but the one scene that ships baked is built from stock geometry, whose UVs a bake'
+ + ' derives per run, so no package carries an IMPORTED unwrap; check-mesh-vocabulary holds'
+ + ' the two halves of the format and the .esmesh decode fixtures hold the bytes' },
'The camera a frame was drawn with is a value anyone can hold':
{ notCertifiable: 'a publication the renderer makes for overlay authors; a game draws from the'
+ ' resolve directly and never asks which camera a past frame used' },
@@ -317,6 +343,7 @@ export const CAPABILITIES = [
'spine', 'material', 'asset-lifecycle',
'model-import', 'model-animation', 'model-skinning',
'physics-3d', 'mesh-shadow', 'environment', 'level-of-detail', 'world-streaming',
+ 'lightmap', 'light-probe',
'lighting-2d',
'sprite-sorting', 'sprite-mask', 'ui-widgets', 'velocity-motion',
'ssao', 'navigation-3d', 'root-motion', 'animation-events', 'shader-readiness',
@@ -395,6 +422,13 @@ export const EVIDENCE = {
// its world is cut and by carrying something that asks for places.
'world-streaming': /\b(StreamedWorld|WorldStreamingSource)\b/,
environment: /\.esenv\b/,
+ // The component that names a patch, not the atlas file beside the scene: a
+ // scene carrying one draws light a bake wrote, so a bake that stops writing
+ // changes the picture the suite compares.
+ lightmap: /\bMeshLightmap\b/,
+ // The volume, which is where a MOVING thing takes its indirect light from —
+ // the half of a bake no atlas can hold.
+ 'light-probe': /\bLightProbeVolume\b/,
// The post effect a scene turns on, not the pass that implements it.
ssao: /"type":\s*"ssao"/,
'navigation-3d': /\b(NavVolume|NavLink|NavAgent3D)\b/,
@@ -554,7 +588,10 @@ export const GOLDEN = [
},
{
id: 'physics-3d',
- certifies: ['physics-3d'],
+ // Also the only scene that ships its lighting baked: an atlas its surfaces
+ // read and a volume its thirteen moving bodies take their indirect light
+ // from. Both halves of a bake are in the picture the suite compares.
+ certifies: ['physics-3d', 'lightmap', 'light-probe'],
targets: ['web', 'desktop'],
tier: 'nightly',
// The character walks on the key it declares, and the debug overlay it draws