Skip to content

Repository files navigation

Aether Engine

Custom AI-native game engine: data-defined worlds and mechanics, live canonical patches, and an AI content plane.

Status

Phase 1–2 complete — package runtime, content plane, Studio, live SSE patches.
Phase 3 in progress — simulated AI; real LLM + spatial/art next.

Planning: Near term (actionable) · Grand design (vision) · Agent guide

Quick start

Requires Rust on your PATH. Run from the repo root.

Daily dev (plane + player in one step)

cargo run -p aether_cli -- dev

On Windows, if the content plane is not running, dev opens a new terminal with aether_plane, waits for it, seeds minimal_explorer if needed, then starts the game with --plane.

# Optional wrapper
.\scripts\dev.ps1
.\scripts\dev.ps1 -Watch
Flag Meaning
--watch Hot-reload package.json while playing
--no-spawn-plane Error if plane is down (don't open a new window)
--plane URL Default http://127.0.0.1:8787
--skip-seed Skip seed step
--no-open-studio Don't launch the browser

Opens Studio in your default browser automatically (http://127.0.0.1:8787/studio/) once the plane is ready.

Player only (no content plane)

cargo run -p aether_player

Controls: WASD / arrows. Collect the golden shard. P = local patch file demo.

Manual setup (three terminals)

If you prefer separate terminals:

cargo run -p aether_plane
cargo run -p aether_plane -- seed minimal_explorer examples/minimal_explorer/package.json
cargo run -p aether_player -- --plane http://127.0.0.1:8787 examples/minimal_explorer/package.json

Browser — Aether Studio

Submit a patch candidate → Publish → the running game updates live.

Or via CLI:

cargo run -p aether_cli -- plane submit minimal_explorer examples/minimal_explorer/patches/add_second_shard.json
cargo run -p aether_cli -- plane publish minimal_explorer add_second_shard

Repository layout

  • crates/ — engine runtime + aether_plane service
  • studio/ — Aether Studio static UI
  • tools/ — CLI
  • docs/ — specs and guides
  • examples/ — sample packages and patches

Docs

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages