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(publishing): the side-module table lists 3D physics (Jolt)

yhh0f98eeaeadda
diff --git a/docs/astro/src/content/docs/publishing/overview.mdx b/docs/astro/src/content/docs/publishing/overview.mdx
index 5e56677ea..115a05a23 100644
--- a/docs/astro/src/content/docs/publishing/overview.mdx
+++ b/docs/astro/src/content/docs/publishing/overview.mdx
@@ -253,7 +253,8 @@ the base engine stays small:
| Module | Artifacts | Loaded when |
|---|---|---|
-| Physics (Box2D) | `physics.js` / `physics.wasm` | The project declares physics or a scene uses physics components. |
+| Physics (Box2D) | `physics.js` / `physics.wasm` | The project declares physics or a scene uses 2D physics components. |
+| 3D physics (Jolt) | `physics3d.js` / `physics3d.wasm` | A scene uses 3D rigid bodies (`RigidBody3D`). Loaded only then, and alongside the 2D module, not in place of it. |
| Spine | `spine21` / `spine38` / `spine41` / `spine42` / `spine43` `.js`/`.wasm` | A scene uses a Spine skeleton of that format version. |
| DragonBones | `dragonbones.js` / `dragonbones.wasm` | A scene uses a DragonBones armature. One module reads every version. |
| Basis transcoder | `basis.js` / `basis.wasm` | The build shipped KTX2-compressed textures. |
@@ -309,7 +310,7 @@ What it costs, measured on `hello-world` in headless Chromium:
What it does not have:
- **WebGPU.** The JavaScript engine always renders through WebGL2.
-- **Side modules** (physics, Spine, DragonBones, Basis, video). These are
+- **Side modules** (2D and 3D physics, Spine, DragonBones, Basis, video). These are
WebAssembly binaries. On a host without WebAssembly each one logs a single
error naming the module and stays absent, and the features it provides do not run.
- **Compiled (`@compiled`) systems.** These are wasm modules too. They stay
diff --git a/docs/astro/src/content/docs/zh-cn/publishing/overview.mdx b/docs/astro/src/content/docs/zh-cn/publishing/overview.mdx
index 99aeb7e1e..8ea962fb1 100644
--- a/docs/astro/src/content/docs/zh-cn/publishing/overview.mdx
+++ b/docs/astro/src/content/docs/zh-cn/publishing/overview.mdx
@@ -216,7 +216,8 @@ node build-tools/cli.js build -t wechat
| 模块 | 产物 | 何时加载 |
|---|---|---|
-| 物理(Box2D) | `physics.js` / `physics.wasm` | 项目声明了物理,或场景使用了物理组件。 |
+| 物理(Box2D) | `physics.js` / `physics.wasm` | 项目声明了物理,或场景使用了 2D 物理组件。 |
+| 3D 物理(Jolt) | `physics3d.js` / `physics3d.wasm` | 场景使用了 3D 刚体(`RigidBody3D`)。只在这时加载,与 2D 模块并存,不取代它。 |
| Spine | `spine21` / `spine38` / `spine41` / `spine42` / `spine43` 的 `.js`/`.wasm` | 场景使用了对应格式版本的 Spine 骨骼。 |
| DragonBones | `dragonbones.js` / `dragonbones.wasm` | 场景使用了 DragonBones 骨架。一个模块读所有版本。 |
| Basis 转码器 | `basis.js` / `basis.wasm` | 构建里发布了 KTX2 压缩纹理。 |
@@ -261,7 +262,7 @@ node build-tools/cli.js build -t wechat
它没有的:
- **WebGPU**:JavaScript 引擎始终走 WebGL2。
-- **侧模块**(物理、Spine、DragonBones、Basis、视频):它们是 WebAssembly 二进制。
+- **侧模块**(2D 与 3D 物理、Spine、DragonBones、Basis、视频):它们是 WebAssembly 二进制。
在没有 WebAssembly 的环境里,每个侧模块只报一条写明模块名的错误,然后保持缺席,
它提供的功能不会运行。
- **编译(`@compiled`)系统**:它们也是 wasm 模块,这里保持解释执行,