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 the import, compound collider, foliage, worldgen and profiler changes

yhh133cd83f2ce0
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0dfe53d8e..e81a66124 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -16,12 +16,17 @@ published separately; it ships inside the editor.
### Added
+- **An imported scene keeps its materials, animation, particles and colliders.** A glTF scene brings the materials, animation, particle emitters and physics shapes it describes rather than geometry alone, and a Godot project can export a scene in that form with the bridge script in `pipeline/bridges/godot`.
+- **A 3D body can be several shapes, and a scaled model collides at its scale.** `CompoundCollider3D` makes one body out of child shapes, on Jolt and PhysX alike, and a mesh collider follows its model's scale.
+
- **A generated building stands on its ground, and generated roads keep foliage off them.** World generation fits an upright building's base to a grid of ground samples over its whole rotated footprint, and refuses a site that is water, too steep, or rises and falls more than a given relief, reporting how deep the foundation has to reach. Foliage takes the zones a WorldGen world reserves for roads and buildings (and any extra tags) as places it does not grow, with an optional clearance. The world rules editor and the editor's agents can set both.
- **On a phone, a lit 3D scene costs about half as much.** The quality level gains `lighting`. At `low` and `medium`, which a phone takes when the project names no level, every lit mesh and material is compiled as `#pragma lighting direct` asks: the same lighting model with the sixteen lights of the light block and hard shadows, without the lights past them, soft shadows or hair shadows. On a Snapdragon 8 Elite a full-screen lit floor drawn fifteen times over went from 57 to 24 ms a frame under the default soft-shadowed sun, and from 33 to 25 ms under a hard-shadowed one. `high`, and a project with quality off, keep everything. **Project Settings → Rendering → Quality → 3D lighting** changes it per level. Sprites keep their 2D lighting at every level.
### Fixed
+- **Generated plants and placements let go of what they held.** A foliage cell's meshes and materials are released once the last cell using them retires, and world generation releases a scene's zones when the scene goes and keeps an authored placement the same object across regenerations, with shared 2D placements no longer losing each other's change subscriptions.
+- **The profiler's frame time is the frame's own.** Work counters and manually stepped frames are kept out of frame timing, and Play's frame rate leaves out windows that were stepped or reset.
- **A render target reads the right way up on WebGPU, Android and iOS.** A camera drawing into a `RenderTexture`, or anything painted into one, came out upside down wherever the engine draws with WebGPU (the web on WebGPU, Android, iOS): such a device keeps a target's rows top first, where a texture expects them bottom first, and nothing put them back. A target now hands out a copy with its rows in the order every backend samples, made at the end of each frame drawn into it. The 2D fog of war and the 2D rain's shelter, which had turned their masks back by hand in their WebGPU shaders, read them as they are. Pixel checks on both backends now hold the orientation of a target and of the fog.
- **Building terrain no longer stalls a frame.** A page of ground made from the built-in noise was sampled and painted whole in the frame that asked for it; it is now made a slice at a time within the frame's budget, and starts over when the ground or its paint changes meanwhile.
- **A moved or scattered model part keeps its texture mapping.** An explicit UV mapping on a face is now resolved before the face's vertices move, so transforming or scattering a modeled part no longer slides its texture across it.
diff --git a/tools/releaseNotes.mjs b/tools/releaseNotes.mjs
index 979dbc9b2..cfc5f38cf 100644
--- a/tools/releaseNotes.mjs
+++ b/tools/releaseNotes.mjs
@@ -4132,6 +4132,22 @@ export const NOTED = {
{"note": "An iOS game opens on iOS 27."},
"fix(native): the audio watchdog compiles under the min macro windows.h defines":
{"internal": "The watchdog had not reached a release; the Windows host failed to build on master only."},
+ "feat(import): restore scene materials, animation and native effects":
+ {"note": "An imported scene keeps its materials, animation, particles and colliders."},
+ "feat(physics): support compound colliders and scaled model geometry":
+ {"note": "A 3D body can be several shapes, and a scaled model collides at its scale."},
+ "fix(foliage): release retired generation assets after the last chunk":
+ {"note": "Generated plants and placements let go of what they held."},
+ "fix(worldgen): release scene zones and stabilize authored placements":
+ {"note": "Generated plants and placements let go of what they held."},
+ "fix(worldgen): preserve shared 2D placement change subscriptions":
+ {"note": "Generated plants and placements let go of what they held."},
+ "fix(profiler): separate work counters and manual steps from frame timing":
+ {"note": "The profiler's frame time is the frame's own."},
+ "fix(profiler): reject stepped and reset play FPS windows":
+ {"note": "The profiler's frame time is the frame's own."},
+ "perf(transform): reuse authored matrix decomposition across frames":
+ {"internal": "A cached decomposition of an authored matrix; every transform resolves to what it did, only the work per frame is less."},
"fix(render): a render target hands out its picture the right way up on a device that stores rows top first":
{"note": "A render target reads the right way up on WebGPU, Android and iOS."},
"fix: budget terrain page sampling and painting across frames":