A 3D space shooter built with Bevy. Build modular ships, fly them with real thrusters, and fight through asteroid fields and gravity wells.
Project and gameplay documentation lives on the published site:
The flake packages the game, so playing it needs no checkout and no toolchain:
nix run github:alexjercan/nova-protocolnix profile install github:alexjercan/nova-protocol keeps it, and adds a
desktop entry with an icon to the application menu.
The Nix development shell provides the pinned Rust toolchain, Bevy system dependencies, Node.js, and Trunk.
git clone https://github.com/alexjercan/nova-protocol.git
cd nova-protocolWithout Nix, install the toolchain from rust-toolchain.toml, the required
Bevy system dependencies, and Trunk.
nix develop --command cargo run
nix develop --command cargo run --features dev # debug toolsRun the complete local site, including the WASM game and mod portal:
nix develop --command scripts/serve-web.shThe script prints the local URL and watches all three parts. To run only the
WASM game, use nix develop --command trunk serve and open
http://localhost:8080/.
See the developer book for builds, tests, tools, examples, and platform setup.
| Path | Purpose |
|---|---|
AGENTS.md |
Repository workflow, architecture, conventions, and required checks. |
RELEASE.md |
Short checklist for versioning, changelog updates, tagging, and publishing. |
CHANGELOG.md |
Unreleased and shipped user-visible changes. |
Cargo.toml |
Workspace members, examples, features, and the shared package version. |
crates/ |
Game and tooling crates. nova_core::AppBuilder is the main assembly point. |
src/ |
Thin root executable and library entry points. |
assets/ |
Shipped game content and assets. |
examples/ |
Runnable player paths, system scenarios, UI flows, and probes. |
web/ |
Landing site, News, tutorial, and wiki sources. |
scripts/ |
Local web, content, screenshot, and packaging helpers. |
See LICENSE.