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.

fix(editor): the 3D starter ships the module its manifest resolves to

yhh93723bfa34f4
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 37f5aff2d..1fed27202 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -270,6 +270,14 @@ published separately; it ships inside the editor.
### Fixed
+- **The 3D starter is a complete project again.** A manifest that names no `scripts`
+ entry gets the defaults, and one of those is `src/components.ts` — the module the
+ editor imports on its own to read a project's component schemas. The 3D starter shipped
+ without it, because its systems declare no components and its `main.ts` says so. The
+ file has to be there whether or not it declares anything: the editor opens what the
+ manifest resolves to. `templates.test.ts` has been red on it since it shipped, which is
+ what says how a bundled template is meant to be checked.
+
- **Waiting for a frame the GPU has not finished is bounded by the device, not by a
poll count.** The readback poll gave up after 240 turns of the event loop — about a
second — and reported the readback as FAILED. That is the right answer for a device
diff --git a/desktop/templates/3d-starter/src/components.ts b/desktop/templates/3d-starter/src/components.ts
new file mode 100644
index 000000000..aff25479f
--- /dev/null
+++ b/desktop/templates/3d-starter/src/components.ts
@@ -0,0 +1,4 @@
+// Declare your components here with defineComponent / defineTag. The editor
+// imports only this module to read component schemas — keep startup code out.
+// A 3D scene's own components come with the engine; this is for yours.
+export {};