Amoris is a 3D game engine with a Rust host, TypeScript gameplay, and desktop and web editors. The editor, CLI, and agents share one command API. A wgpu renderer runs natively on Metal and Vulkan, and in the browser on WebGPU.
Showcase · Editor guide · Script API · CLI and MCP · Measurements
Bistro exterior, captured with multi-bounce Metal path tracing: 512 spp and a 12-bounce limit.
Amazon Lumberyard / ORCA, CC BY 4.0. Asset credits.
- Build games with typed components and stateless TypeScript systems.
- Inspect and edit a scene through the desktop or web editor, CLI, HTTP, or MCP.
- Run Play in a fork, pause or step the simulation, and return to the edit world.
- Debug TypeScript with breakpoints, locals, watches, and source-level stepping.
- Record snapshots, replay inputs, and check deterministic runs.
The editor combines a WebGPU viewport with a Hierarchy, Inspector, asset browser, Monaco script editor, debugger, History, Timeline, and Profiler. Its edits and agent commands enter the same undoable history.
The desktop app opens projects in its own window, with a native folder picker, recent projects, and application menus. It starts and stops the Rust host for you. The app includes the engine, WebGPU viewport, and TypeScript checker.
Install Rust, Bun, and Node.js, then build from the repository:
cd sdk && bun install --frozen-lockfile
cd ../editor && bun install --frozen-lockfile && bun run build
cd ..
cargo build --release -p pocket-app
cd desktop && npm ci
npm start -- ../samples/sailingTo create a local macOS application bundle, run npm run package in desktop/.
Open Amoris.app from out/desktop/; choose a folder containing project.toml.
Cmd/Ctrl+O switches projects. The app asks before discarding unsaved edits.
See the desktop build guide for packaging options.
Install Rust and Bun. The repository pins its Rust toolchain in rust-toolchain.toml.
git clone https://github.com/qiulinfan/amoris.git
cd amoris
cd sdk
bun install --frozen-lockfile
cd ../editor
bun install --frozen-lockfile
bun run build
cd ..
cargo build --release -p pocket-app
./target/release/pocket serve samples/sailing --editor editor/distOpen http://127.0.0.1:7878/ and press Play. The executable is currently named
pocket. The browser viewport requires WebGPU.
Select Sloop in the Hierarchy to edit its components. Open scripts/rules.ts to
change its gameplay; Cmd/Ctrl+S applies the script. Set a breakpoint in the gutter,
then use F5, F10, and F11 to continue, step over, and step into. Stop
returns to the original edit world. See the editor guide.
For a native game window:
./target/release/pocket play samples/sailing
./target/release/pocket play samples/anim| Responsibility | Technology |
|---|---|
| Host and entities | Rust · Bevy ECS |
| Gameplay | TypeScript 7 · oxc · QuickJS-ng |
| Physics | Rapier 3D with enhanced determinism |
| Rendering | wgpu · WGSL · Metal / Vulkan / WebGPU |
| Editor | React · dockview · Monaco · Electron (desktop) |
| Automation | CLI · HTTP / WebSocket · MCP |
Game state lives in components. Scripts run as stateless systems, and the renderer reads the simulation's output. Snapshots, replay, and explicit forks operate on the same self-contained world.
Discover commands and inspect a running game:
./target/release/pocket help
./target/release/pocket catalog --host http://127.0.0.1:7878 --json
./target/release/pocket world get Sloop Boat Tally --host http://127.0.0.1:7878 --jsonUse ./target/release/pocket mcp samples/sailing as a stdio MCP server, or connect to
the running host at http://127.0.0.1:7878/mcp. These tools expose the developer
command surface. Player-specific observe / act MCP tools are still pending.
- Script API: components, queries, systems, events, and types.
- CLI and MCP: discovery, world edits, time, capture, and debugging.
- Host protocol: HTTP calls, WebSocket feeds, and schemas.
| Project | Demonstrates |
|---|---|
| Sailing | Wind, buoyancy, boat controls, and cargo collection |
| Animation | Animation, particles, and in-game UI |
Rendering measurements report their scene, hardware, resolution, and timing method. Recorded demonstration videos use fixed simulation steps; playback frame rate is separate from the engine's measured performance. See the showcase data, web rendering study, and physics study.
The site includes native Bistro and Flight Helmet videos, a CC0 Dutch ship controlled through MCP, and a recording of the real WebGPU editor. Fetch the pinned CC0 models locally to open the detailed sailing sample:
python3 tools/showcase_assets.py --projects
./target/release/pocket serve site/demos/harbor --editor editor/distAt 1920 × 1080 on Apple M5 / Metal, 1,024 complete Flight Helmets contribute 96,995,330 scene triangles before culling. The static render-and-wait workload took 82.43 ms mean and 83.66 ms p95 over 300 completed frames. This excludes game simulation and window presentation. Method and raw data.
Large third-party models stay outside Git; the website serves compact videos and posters. Source authors and licenses are preserved in the credits.
DeepSeek Flash plays the detailed sailing course through a project-level player gateway. Its native replay matches every recorded action and final world hash. The selected clip collects 4/4 cargo; all trials and limitations are retained in the agent report.
A frozen six-task development benchmark uses native MCP tools, fresh candidate projects and external grading. All 18/18 patches passed behavior, regression, types and native integrity checks; 15/18 agent sessions ended cleanly, with three provider disconnects after valid patches. Each golden control exercises 63 actual component/event assertions.
Amoris is released under the MIT License. Third-party dependencies and showcase assets retain their own licenses and attribution.