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.64.0

esengineff778c9f3124
diff --git a/CHANGELOG.md b/CHANGELOG.md
index f1500a072..fb81dec8b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -14,6 +14,8 @@ published separately; it ships inside the editor.
## [Unreleased]
+## [0.64.0] - 2026-09-12
+
### Added
- **A 2D light can take the shape of a texture.** Every light was a circle or a cone,
@@ -11739,7 +11741,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.63.0...HEAD
+[Unreleased]: https://github.com/esengine/estella/compare/v0.64.0...HEAD
+[0.64.0]: https://github.com/esengine/estella/compare/v0.63.0...v0.64.0
[0.63.0]: https://github.com/esengine/estella/compare/v0.62.0...v0.63.0
[0.62.0]: https://github.com/esengine/estella/compare/v0.61.0...v0.62.0
[0.61.0]: https://github.com/esengine/estella/compare/v0.60.0...v0.61.0
diff --git a/SECURITY.md b/SECURITY.md
index 2480ba491..a29324582 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.63.x | Yes |
-| < 0.63 | No |
+| 0.64.x | Yes |
+| < 0.64 | 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 ebf6dfaf1..a6231aba5 160000
--- a/desktop
+++ b/desktop
@@ -1 +1 @@
-Subproject commit ebf6dfaf156704557e31f7b24e9cd79e871b8f01
+Subproject commit a6231aba5855c1a9489a2b5d1a0909b0d4228694
diff --git a/package.json b/package.json
index 877c977db..1e22e39fd 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
{
"name": "estella",
- "version": "0.63.0",
+ "version": "0.64.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 7d15f137f..80b931f83 100644
--- a/tools/goldenProjects.mjs
+++ b/tools/goldenProjects.mjs
@@ -89,6 +89,27 @@ 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.64.0 —
+ 'A 2D light can take the shape of a texture': { certifies: 'lighting-2d' },
+ 'A 2D light can be shaped, and its shadows can be less than total': { certifies: 'lighting-2d' },
+ 'A sprite states where it sits inside its sorting layer': { certifies: 'sprite-sorting' },
+ 'A subtree can sort as one unit': { certifies: 'sprite-sorting' },
+ 'A sprite can be cut by another sprite\'s shape': { certifies: 'sprite-mask' },
+ 'A polygon collider takes any ring, concave and unbounded': { certifies: 'physics' },
+ 'An `.aseprite` file imports':
+ { notCertifiable: 'an import act: a package holds the sheet and the clips it produced and'
+ + ' never the .aseprite, so what a game can show is animation — the format itself is held'
+ + ' by pipeline/tests/aseprite-import.test.ts and the editor\'s aseprite-import check' },
+ 'A `.psd` file imports':
+ { notCertifiable: 'the same shape: a package holds the PNGs and the prefab the import wrote,'
+ + ' never the .psd; the layer stack is held by the pipeline tests and the editor check' },
+ 'A polygon collider can take the sprite\'s own silhouette':
+ { notCertifiable: 'an EDITOR act — the ring it writes is an ordinary collider, certified as'
+ + ' physics; the trace itself is held by alpha-outline.test.ts and the collider-trace check' },
+ 'A texture\'s geometry is one picture':
+ { notCertifiable: 'an Inspector surface over metadata a package already carries; what it'
+ + ' authors (9-slice borders, sheet cells) is drawn by the sprite capabilities above' },
+
// — 0.63.0 —
'One number turns the sky, the irradiance and the reflection': { certifies: 'environment' },
'A second UV set survives the import boundary':
@@ -241,6 +262,7 @@ export const CAPABILITIES = [
'model-import', 'model-animation', 'model-skinning',
'physics-3d', 'mesh-shadow', 'environment', 'level-of-detail', 'world-streaming',
'lighting-2d',
+ 'sprite-sorting', 'sprite-mask',
'ssao', 'navigation-3d', 'root-motion', 'animation-events', 'shader-readiness',
'tilemap', 'tile-collision',
'touch', 'safe-area', 'pause-resume',
@@ -270,6 +292,10 @@ export const EVIDENCE = {
'third-person': /\b(ThirdPersonController|ThirdPersonCamera)\b/,
particles: /\bParticleEmitter\b/,
'lighting-2d': /\b(Light2D|ShadowCaster2D)\b/,
+ // A scene that STATES its draw order, rather than leaving it to where things
+ // stand: the field, or the group that takes a subtree's place in the order.
+ 'sprite-sorting': /\border:\s*\d|\bSortingGroup\b/,
+ 'sprite-mask': /\bSpriteMask\b/,
// Components OR the resource: audio-demo takes Res(Audio) and never inserts a
// component, and a pattern that only knew the components read it as unused.
audio: /\b(AudioSource|AudioListener|AudioAPI|audioPlugin)\b|Res\(Audio\)/,
@@ -373,7 +399,10 @@ export const GOLDEN = [
},
{
id: 'space-shooter',
- certifies: ['ecs', 'texture-atlas'],
+ // Its hull bar is a sprite cut by another sprite, drawn at an order it states
+ // rather than at the one its position would give it — so the draw order and the
+ // mask are both something a packaged game here actually does.
+ certifies: ['ecs', 'texture-atlas', 'sprite-sorting', 'sprite-mask'],
targets: ['web', 'desktop', 'android'],
tier: 'pr',
interact: { keys: ['ArrowLeft'], frames: 40 },