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)

  1. 把引擎和 AI 工具链安装到编辑器。
    npx -y @forgeax/game install
    [1, 2]
  2. 或者用引擎直接新建 `game-3d` 工程。
    pnpm dlx @forgeax/engine project new my-game --template game-3d
    [1, 2]
  3. 进入新建的 `my-game` 目录。
    cd my-game
    [1, 2]
  4. 启动新建工程。
    pnpm exec forgeax dev start --headless false
    [1, 2]

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

  1. ForgeAX/forgeax-engine/README.en.mdindexed 2026-11-14
  2. ForgeAX/forgeax-engine/README.mdindexed 2026-11-14