What it is
ForgeAX Engine 是 AI 原生的 TypeScript 游戏引擎,README 把 AI agent 列为主要用户。它提供基于 WebGPU 的渲染、ECS World、Rapier 2D/3D 物理、动画、输入、音频和网络同步,并通过 `forgeax` CLI 创建、运行、检查和打包游戏。[1, 2]
What it can do in game development
- 在 WebGPU 上配置材质、灯光、阴影、后处理、GPU 粒子、trail 和 beam。[1, 2]
- 用 ECS World、Rapier 2D/3D 物理、动画、输入、音频和网络同步搭建玩法。[1, 2]
- 导入 glTF、FBX 和图像,或用 TypeScript 生成带参数化变体的资产。[1, 2]
- 用 `forgeax` CLI 检查工程、截取画面、运行测试并打包为 web-zip。[1, 2]
How to install and run (as the README describes)
- 把引擎和 AI 工具链安装到编辑器。
[1, 2]npx -y @forgeax/game install - 或者用引擎直接新建 `game-3d` 工程。
[1, 2]pnpm dlx @forgeax/engine project new my-game --template game-3d - 进入新建的 `my-game` 目录。
[1, 2]cd my-game - 启动新建工程。
[1, 2]pnpm exec forgeax dev start --headless false
What you need
- Node.js 版本要求为 22.13.0 或更高,`.nvmrc` 锁定 22.22.3。[1, 2]
- pnpm 版本要求为 12.10.1,README 要求通过 Corepack 启用。[1, 2]
- Bun 版本要求为 1.2.0 或更高。[1, 2]
- 浏览器需要支持 WebGPU,README 列出最新版 Chrome 和 Edge。[1, 2]
Limits to know
- `shared` 执行层级需要跨源隔离、SharedArrayBuffer 和相关能力,只有符合条件的数值任务会并行运行。[1, 2]
- 多个 Worker 保持一个逻辑 World,结构变更串行处理,不传递活对象,也不拆分 RenderGraph,共享写入部分失败时需要重建 World。[1, 2]
- CPU capture 不能替代 GPU 性能测量,截图、结构检查和真实 GPU 执行回答的问题不同。[1, 2]
Licence
Apache-2.0。 Read the licence file for what it allows.
Sources
- ForgeAX/forgeax-engine/README.en.mdindexed 2026-11-14
- ForgeAX/forgeax-engine/README.mdindexed 2026-11-14
