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
feat(editor): the Frame Debugger panel ships with the editor
esengine917e94332481
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex c6f796267..cba482b8c 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -16,7 +16,7 @@ published separately; it ships inside the editor.### Added-- **A frame can be captured draw call by draw call, and replayed up to any one of them.** `capture_frame` (MCP and the built-in agent) takes the next whole frame of the viewport or the running game — every camera's pass and the screen overlay — and names, for each draw, why it could not join the one before it (material, shader, a different mesh, the instancing cap, …), what it drew and the entities it was made from. `frame_draws` pages a large frame; `replay_draw` shows the pass as it stood after that draw, and refuses when the scene has changed since the capture rather than showing a later frame under the capture's numbering. The SDK's `captureFrame` / `replayDraw` are the same capture. The engine's capture used to keep no entities, report every material as none, see only the first camera, and could be taken by an asset preview instead of the frame.+- **A frame can be captured draw call by draw call, and replayed up to any one of them.** The Frame Debugger panel (Window menu, or from the Profiler) captures the viewport or the running game and lists every draw by pass, with a chip per reason that filters to it; a scrubber steps through the draws, and the selected one shows its batch cause in words, what it drew, the entities it was made from — click one to select it — and the pass as it stood after it. `capture_frame` (MCP and the built-in agent) takes the next whole frame of the viewport or the running game — every camera's pass and the screen overlay — and names, for each draw, why it could not join the one before it (material, shader, a different mesh, the instancing cap, …), what it drew and the entities it was made from. `frame_draws` pages a large frame; `replay_draw` shows the pass as it stood after that draw, and refuses when the scene has changed since the capture rather than showing a later frame under the capture's numbering. The SDK's `captureFrame` / `replayDraw` are the same capture. The engine's capture used to keep no entities, report every material as none, see only the first camera, and could be taken by an asset preview instead of the frame.- **A project can be packaged as a Huawei quick game (华为快游戏).** The same signed `.rpk` as the quick-game alliance — Huawei's signtool writes the same block, and ours matches it byte for byte — with Huawei's manifest (`appType: "fastgame"`, orientation under `display`) and its own package name, version code and release key in Project Settings. It packages the engine build without SIMD and is judged against 4 MB and the 20 MB AppGallery Connect takes. Subpackages are refused rather than packaged wrongly (Huawei packs each as its own `.rpk`); sign-in, purchase and share go through HMS Core with shapes of their own and are not offered. Huawei's loader asks Huawei's servers about a package before it runs one, so nothing has run without an app registered in AppGallery Connect.- **A project can be packaged for Alipay (支付宝小游戏).** `game.json` turns on iOS high-performance mode — the only iOS mode with `MYWebAssembly`, which the runtime instantiates through with an absolute package path — and `project.config.json` turns off the review build's own transpile and minify, since the bundle is already down-levelled; the appid is passed to Alipay's tool (`minidev -a`), not packaged. The profile hands the family `my` in WeChat's words — a rewarded unit through `my.createRewardedAd`, sign-in through `my.getAuthCode`, share through the card `my.showSharePanel` reads off `my.onShareAppMessage`. It packages the engine build without SIMD, judged against 4 MB and 20 MB. Nothing has run on a device; purchase is not offered (Android and Harmony only, keyed by a `customId`), and Taobao — which only supports Cocos and Laya — is not a target.- **A project can be packaged as a quick game — one signed `.rpk` for vivo, OPPO, Xiaomi and Honor (快游戏联盟).** Set the package name (it must end in `.minigame`) in Project Settings → Packaging → Quick game, and the export writes `manifest.json` (allianceVersion 1300), the project's icon (or Estella's mark), and `<package>.rpk` signed with your release key — or with Estella's public debug key, which a device debugger installs and a store refuses. It needs no vendor tool: the signing block is written here and matches the vendor CLI's byte for byte. The package runs on its own engine build (`build -t quickgame`) without wasm SIMD and BigInt i64, which the hosts' V8 8.3 refuses, and the runtime reads the hosts' window in physical pixels and turns WebAssembly on first. Verified end to end on vivo's engine in an Android emulator; OPPO grants WebGL2 only to a game that applied for it, and no device has run it yet.diff --git a/desktop b/desktopindex a09af4767..d4fee2eac 160000--- a/desktop+++ b/desktop@@ -1 +1 @@-Subproject commit a09af47670d85f342c977f37f2ecc90819c9e117+Subproject commit d4fee2eac9947a83ba63f77592c6b281e11913e1diff --git a/tools/releaseNotes.mjs b/tools/releaseNotes.mjsindex 32c8e8237..76986caa5 100644--- a/tools/releaseNotes.mjs+++ b/tools/releaseNotes.mjs@@ -982,6 +982,10 @@ export const NOTED = {{ note: 'A frame can be captured draw call by draw call, and replayed up to any one of them.' },'feat(editor): capture a frame draw by draw and replay it, in the viewport and the running game':{ note: 'A frame can be captured draw call by draw call, and replayed up to any one of them.' },+ 'feat(editor): the Frame Debugger panel lists a frame\'s draws, why each started, and replays up to one':+ { note: 'A frame can be captured draw call by draw call, and replayed up to any one of them.' },+ 'feat(editor): the Frame Debugger panel ships with the editor':+ { note: 'A frame can be captured draw call by draw call, and replayed up to any one of them.' },'fix(viewport): a paused game is not covered or dimmed; the ring says paused':{ note: 'A paused game is no longer covered or dimmed.' },'feat(project): opening a project gives its tsconfig the official-packages mapping':