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): notes for the shader, preview and bundle fixes

yhh3e35941ae078
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 88bd32192..df8b2c99d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -87,6 +87,9 @@ published separately; it ships inside the editor.
### Fixed
+- **Lit materials draw on WebGPU again.** A lit material on the engine's own vertex stage, and a 2D lit shader, built a WebGPU program with a preprocessor line left in it, so the material drew nothing (and a desktop build of a 3D scene came up black). `#if` and `#elif` conditions with `defined`, `!`, `&&`, `||` and parentheses now resolve in a WGSL twin as they do in GLSL.
+- **A scanned preview reaches the game's own server.** The page a phone opens from the preview QR code allowed connections only to itself, so a game that logged in to a server on the LAN worked in Play and in a single-file build but not on the phone. The preview now connects as Play does; a shipping web export still connects only to the servers listed in Project Settings → Allowed server origins.
+- **A subpath of an official package resolves.** Importing `estella-plugin-…/something` from a project script no longer hangs the script build.
- **Background shader compilation, the warm-up and on-demand drawing reach a build whose quality level is Off.** A build dropped the whole `quality` block when the level was Off, though these three choices hold whatever the level: a project that switched `asyncShaderCompile`, `prewarmShaders` or `renderOnDemand` on read them in the editor and shipped a game that ignored them. The block now ships when any of them is on.
- **A terrain and a streamed world run on the Android and iOS templates.** The terrain's layer textures were refused on a device (it has no wasm heap to copy them through), and a chunked world's maker threw on every tick because QuickJS has no `AbortController`. The layers now go over as bytes, as every other texture does, and the world uses a handle of its own where the host has none.
- **A pointer lands on what is drawn on top.** Where two pressable things overlap at the same depth and layer, the press went to the one created last; a node taken from a pool and added under a panel is created last and drawn first, so it took presses meant for what covered it. It now goes to the one drawn later by its place in the hierarchy. In the Cocos layer, a Toggle belongs to the container its parent holds, and assigning `isChecked` switches the others of its group off.
diff --git a/tools/releaseNotes.mjs b/tools/releaseNotes.mjs
index 20bd96681..ef4fb23a4 100644
--- a/tools/releaseNotes.mjs
+++ b/tools/releaseNotes.mjs
@@ -3412,4 +3412,14 @@ export const NOTED = {
{"note":"Rain for a 2D scene."},
"feat(editor): make a prefab instance virtual from the inspector or the outliner":
{"note":"Virtual prefab instances."},
+ "fix(shaders): an #if or #elif condition resolves in WGSL assembly and in the twin generator, so a lit material's WebGPU program no longer carries a directive into the source":
+ {"note":"Lit materials draw on WebGPU again."},
+ "fix(preview): a LAN preview may connect to any server, as Play may":
+ {"note":"A scanned preview reaches the game's own server."},
+ "fix(bundle): the official-package and Cocos resolvers step aside for one shared marker, so a subpath of an official package no longer resolves forever":
+ {"note":"A subpath of an official package resolves."},
+ "refactor(ui): the anchoring arithmetic is a module of its own, so the Cocos importer uses it without compiling the engine into the pipeline's typecheck":
+ {"internal":"a module split; the arithmetic and the component behave as before"},
+ "fix(cocos): a launched scene has its scripts loaded and enabled before its callback, and the scene before it goes; an instance's mounted components land on the prefab it names; Node.forward/up/right/worldMatrix and the rest of Vec2/Vec3/Quat/Color/Vec4/Mat4 a game calls":
+ {"note":"Cocos scripts drive scenes as the game does."},
};