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.
TypeScript 2d-game-engine3d3d-game-engineandroidcppecsgame-editorgame-enginegamedeviostypescriptwebassemblywebglwebgpuwechat-minigame
docs(changelog): note the terrain budget, modeling UV and worldgen grounding changes
yhh336aac952caf
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 22bf6a309..d5004bc3c 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -16,10 +16,14 @@ published separately; it ships inside the editor.### Added+- **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+- **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.- **An iOS game opens on iOS 27.** Built with Xcode 27, every game closed 0.3 s after launch on an iOS 27 device: the host opened its window the way UIKit no longer allows, without a window scene. The host now adopts the scene lifecycle (one window scene; the game pauses and resumes with it). Its log also reaches the device console as text, where it read `<private>`. The simulator in CI runs an older iOS and could not see it; it was found on an iPhone.- **A Spine atlas of any size loads.** The atlas text went to the Spine module through its 64 KB stack, so an atlas past about 60 KB wrote over the module's memory: a crash or a corrupted skeleton, whatever the skeleton's format. Its length was also counted in UTF-16 units rather than bytes, so an atlas with non-ASCII page or region names was cut short. The atlas now goes through the heap as UTF-8 with its byte length, as the skeleton data and DragonBones' atlas already did; a 150 KB atlas named in Chinese loads on Spine 3.8 and 4.2.- **A material parameter named like an engine uniform is refused on every platform.** A `#pragma param u_ambient` in a `Lit` shader compiled on WebGPU and failed only on WebGL, a WeChat mini-game among them, with `redefinition of an interface block member name`. The names a parameter may not take are no longer a hand-kept list of three: they are read from what the engine actually declares for the shader's domain, so every member of the light block is refused at load, a name only the light block uses stays free in an `Unlit` shader, and the error says which block owns it.diff --git a/tools/releaseNotes.mjs b/tools/releaseNotes.mjsindex a928045bd..4245bbdca 100644--- a/tools/releaseNotes.mjs+++ b/tools/releaseNotes.mjs@@ -4130,4 +4130,14 @@ export const NOTED = {{"note": "A Spine atlas of any size loads."},"fix(ios): the host adopts the scene lifecycle, so a game built with Xcode 27 opens on iOS 27":{"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."},+ "fix: budget terrain page sampling and painting across frames":+ {"note": "Building terrain no longer stalls a frame."},+ "fix: preserve authored UVs through model transforms and scattering":+ {"note": "A moved or scattered model part keeps its texture mapping."},+ "feat: fit procedural buildings and reserve roads from foliage":+ {"note": "A generated building stands on its ground, and generated roads keep foliage off them."},+ "feat: expose ground fitting and vegetation budgets to editor agents":+ {"note": "A generated building stands on its ground, and generated roads keep foliage off them."},};