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): note point shadow allocation, runtime entity asset release and script minification

yhh3f09422a0a88
diff --git a/CHANGELOG.md b/CHANGELOG.md
index cfbb778b4..c11bfeaa8 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -39,6 +39,8 @@ published separately; it ships inside the editor.
- **World text under a perspective camera no longer eats the memory.** A `Text` left on `renderMode: Auto` in world space, seen through a perspective camera, was rasterized as if the camera were orthographic: a 32 px label asked for glyphs tens of thousands of pixels high. On a phone the native heap swung between 2.4 and 4.2 GB and the game drew about one frame in two seconds. Auto now draws world text under a perspective camera as SDF, since no single bitmap size lands 1:1 at every depth; the same eight floating labels hold the heap at about 45 MB and 60 fps. A bitmap glyph is also never rasterized larger than half an atlas page (512 px), which also covers an orthographic camera zoomed far in and a forced `Bitmap`; past that it is drawn from 512 px and the log says so once.
- **Sound comes back when a device's audio dies on its own.** On the Android and iOS hosts, a game whose audio device did not start again on returning from the background, or whose output stream was dropped while it was away, stayed silent until it was restarted. The host now checks every frame that the device is still taking sound while the game wants it; after half a second of nothing it restarts the device, and from the third try rebuilds it, retrying at growing intervals of up to 5 seconds. Sounds that were playing carry on where they were, and the log says each time it acts.
- **A render target works on a native device.** On the Android and iOS hosts `RenderTexture.create` handed back 0 for its handle and its texture, so a camera's `renderTarget` and anything painted into a texture drew nothing, and nothing was logged. The SDK asked only the web's engine module for a target; it now asks whichever engine core is running, and a device names the target's texture for a `Sprite` as the web does. A target that cannot be made is now reported once in the log.
+- **A point light's shadow is whole or absent.** When the shadow atlas could not fit all six cube faces of a point light, it was given the faces that fit and drew light through the rest; it now gets all six or none, and the editor's Light Status says why. A new denial is also logged once as a warning.
+- **An asset swapped onto a runtime entity is released when the entity goes.** A texture or material that a hot update put on an entity spawned at runtime, outside any scene, stayed loaded until the app shut down; it now ends with the entity's despawn.
- **A `#pragma lighting direct` surface takes a sun's shadow.** Under a directional light with a size (any `sourceAngle` above 0, the default 0.53 included) such a shader drew no shadow at all; it now draws the hard shadow the directive promises.
## [0.99.1] - 2026-11-07
diff --git a/tools/releaseNotes.mjs b/tools/releaseNotes.mjs
index 2068b9755..15f88b610 100644
--- a/tools/releaseNotes.mjs
+++ b/tools/releaseNotes.mjs
@@ -28,6 +28,14 @@ export const NOTES_FLOOR = 'v0.65.0';
* the reader recognises anyway.
*/
export const NOTED = {
+ 'fix(cyber-rooftop): restore wetness masks and fit fixture shadows':
+ {"internal":"the cyber-rooftop example's own scene and texture settings; the engine and editor are unchanged"},
+ 'fix(render): allocate complete point shadows and report new denials':
+ {"note":"A point light's shadow is whole or absent."},
+ 'fix(assets): release runtime entity replacements on despawn':
+ {"note":"An asset swapped onto a runtime entity is released when the entity goes."},
+ 'feat(settings): Packaging has a Minify scripts row':
+ {"note":"An exported game's scripts are minified"},
'feat(export): scripts are minified on export unless the project turns it off':
{"note":"An exported game's scripts are minified"},
'feat(cocos): a document the creator edited moves from the layer Cocos.Widget to the engine RectAnchors on re-import':