Ruins of Atlantis

An MMORPG built from scratch in Rust

• Game Design Document

Play The Alpha / Build From Source (Public Game Repo)

The weekly alpha builds are playable on the web, and you can also build the game from source locally if your machine supports WebGPU.

• Play in your browser (recommended): https://ruinsofatlantis.com/play
• Build from source (developers/power users): follow the steps below

Prerequisites

• Rust toolchain via rustup (stable). If needed: curl https://sh.rustup.rs -sSf | sh
• Git LFS for large binary assets: git lfs install
• A WebGPU‑capable GPU + up‑to‑date browser (Chrome works well on macOS today)

Clone with assets

git clone https://github.com/OpenAgentsInc/ruinsofatlantis
cd ruinsofatlantis
git lfs pull

Native (desktop) build

# optional: run formatting, lint, shader checks, and tests
cargo xtask ci

# run the app
cargo run

# with logs
RUST_LOG=info cargo run

Web/WASM (local dev)

rustup target add wasm32-unknown-unknown
cargo install trunk

# serve the WASM build locally (http://127.0.0.1:8080)
trunk serve --release

# tip: to skip the Zone Picker, append a zone param
# example: http://127.0.0.1:8080/?zone=cc_demo

Notes

• If a GLTF model uses Draco compression, decompress it once before runtime:
  • cargo run -p gltf-decompress -- assets/models/ruins.gltf assets/models/ruins.decompressed.gltf
• A simple standalone viewer exists:
  • cargo run -p model-viewer -- assets/models/wizard.gltf
• Current keybinds: P (perf), O (orbit), H (HUD), Space/[/] and -/= control time‑of‑day.

Versioned WASM Releases

• We publish immutable, versioned WASM bundles as GitHub Release assets. See docs: docs/ops/wasm-deployment.md:14.
• Run a release bundle locally (unzip first, then serve over HTTP):
  • Python: python3 -m http.server 8080 --directory /path/to/unzipped
  • Node: npx --yes serve -p 8080 /path/to/unzipped
  • Rust: miniserve /path/to/unzipped -p 8080 (install with cargo install miniserve)

Voxel Destructibility Demo

You can preview the destructible voxel path with a built‑in demo grid and perf overlay.

Example:

cargo run -p ruinsofatlantis -- \
  --voxel-demo \
  --voxel-size 0.05 \
  --chunk-size 32 32 32 \
  --mat stone \
  --max-debris 1500 \
  --max-chunk-remesh 3 \
  --seed 123

Overlay line shows:

vox: queue=<pending chunks>  chunks=<processed this frame>  debris=<spawned last>  remesh=<ms>  colliders=<ms>

Notes:

• --debris-vs-world enables coarse per‑chunk colliders so debris can bounce against dirty chunks.
• Use --help-vox to print available destructible flags.
• The demo grid seeds the queue on creation so geometry renders immediately; no carve required.