https://github.com/aura-industry/auramaxx
Open-source game engine for vibe code. Play games from your terminal!
https://github.com/aura-industry/auramaxx
3d ai game-development game-engine gamedev godot pixel three-js
Last synced: 3 months ago
JSON representation
Open-source game engine for vibe code. Play games from your terminal!
- Host: GitHub
- URL: https://github.com/aura-industry/auramaxx
- Owner: Aura-Industry
- Created: 2026-02-12T17:31:56.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-03-09T17:55:16.000Z (4 months ago)
- Last Synced: 2026-03-09T19:00:53.848Z (4 months ago)
- Topics: 3d, ai, game-development, game-engine, gamedev, godot, pixel, three-js
- Language: Rust
- Homepage: https://www.aurajs.gg/
- Size: 89.2 MB
- Stars: 67
- Watchers: 1
- Forks: 8
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# AuraJS
[](https://opensource.org/licenses/MIT)
Write JavaScript 2D and 3D games, compile to native.
Create, play, and publish from your terminal.
> Alpha status: AuraJS is still in alpha and not ready for production use.
Website: [aurajs.gg](https://aurajs.gg)
## Quickstart
```bash
npm install -g auramaxx
auramaxx create my-game
cd my-game
npm run dev
```
One-off bootstrap without a global install:
```bash
npx auramaxx
```
Inside a scaffolded game, use the shorter `auramaxx` alias or the generated
`npm run ...` scripts for local engine commands.
## Play an Example
```bash
npm install -g auramaxx
auramaxx play auracraft
# or run a published game wrapper directly
npx auracraft play
```
## Fork a Game
```bash
npm install -g auramaxx
auramaxx fork auramon
```
## Working With AI Agent
Inside your codebase:
```bash
cd
npx -y skills add Aura-Industry/auramaxx
```
Then use for engine docs and API references.
## Multiplayer TL;DR
```bash
auramaxx create my-room-game --template multiplayer
cd my-room-game
npm run dev
# second terminal
npm run join -- AURA2P
```
Keep that same flow and add internet-backed rooms with either:
- `aura.config.json -> multiplayer.relay = "relay.aurajs.gg"`
- or `AURA_MULTIPLAYER_RELAY_HOST=relay.aurajs.gg`
Use [Multiplayer Quickstart](https://www.aurajs.gg/docs/multiplayer-quickstart) for the short multiplayer doc, or [Multiplayer Party Example](./packages/aurascript/examples/multiplayer-party/README.md) for the same-project example with diagnostics and room chat.
## Feature Set
| Metric | AuraJS | Unity | C / C++ | Electron |
|---|---|---|---|---|
| Engine fees | **free** | paid tiers | none | free |
| Hot reload | **<1s** | 5-30s | recompile | <1s |
| Min binary size | **~2 MB** | ~80 MB | ~1 MB | ~150 MB |
| GPU access | **native** | native | native | WebGL |
| Developer pool | **20M+** | 5M | 3M | 20M+ |
| AI code gen quality | **excellent** | decent | poor | decent |
| Multiplayer | **sync JSON** | Netcode | custom | sync JSON |
| Modding | **native** | framework | Lua/etc | native |
| Patch size | **KBs** | MBs-GBs | full binary | KBs |
| Platform APIs | **built in** | - | - | - |
| Vendor lock-in | **none** | heavy | none | Chromium |
| Build config | **zero** | editor | cmake | webpack |
- JavaScript-first authoring with a native Rust host underneath it
- Terminal-first create, dev, play, inspect, and publish flow through `auramaxx`
- Native host binaries for macOS, Linux, and Windows
- Room-code multiplayer with local-first join, internet promotion, and relay fallback
- Public docs, handbook pages, and exact contract references on `aurajs.gg/docs`
- Publishable npm game wrappers that can be played from the terminal
## Docs
- [AuraJS README](https://www.aurajs.gg/docs) - AuraJS overview and public docs entrypoint
- [Game Developer Handbook](https://www.aurajs.gg/docs/handbook) - game developer handbook
- [Multiplayer Quickstart](https://www.aurajs.gg/docs/multiplayer-quickstart) - shortest multiplayer setup path
- [Core API Contract](https://www.aurajs.gg/docs/api-contract) - frozen core API contract
- [3D API Contract](https://www.aurajs.gg/docs/api-contract-3d) - frozen 3D API contract
- [Exact Reference Index](https://www.aurajs.gg/docs/reference) - exact reference index
- [Combined Public Reference](https://www.aurajs.gg/docs/reference) - combined public reference
Live docs:
-
-
-
## Native Host Binary Packages
| Platform | Package |
|----------|---------|
| macOS ARM | [`@aurajs/darwin-arm64`](https://github.com/Aura-Industry/aurajs-darwin-arm64) |
| macOS x64 | [`@aurajs/darwin-x64`](https://github.com/Aura-Industry/aurajs-darwin-x64) |
| Linux x64 | [`@aurajs/linux-x64`](https://github.com/Aura-Industry/aurajs-linux-x64) |
| Windows x64 | [`@aurajs/win32-x64`](https://github.com/Aura-Industry/aurajs-win32-x64) |