{"id":51744590,"url":"https://github.com/developerz-ai/nexus-engine","last_synced_at":"2026-07-18T17:35:17.569Z","repository":{"id":358495936,"uuid":"1241528546","full_name":"developerz-ai/nexus-engine","owner":"developerz-ai","description":"Open source, AI-first, cross-platform game engine. Built BY AI, maintained BY AI, FOR AI agents + humans. MIT forever. Spec-driven.","archived":false,"fork":false,"pushed_at":"2026-05-17T19:01:16.000Z","size":1698,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-18T17:35:15.417Z","etag":null,"topics":["ai-agents","ai-first","claude-code","cross-platform","deterministic","ecs","game-engine","gamedev","headless","mcp","mit-license","open-source","rust","spec-driven","wgpu"],"latest_commit_sha":null,"homepage":"https://github.com/developerz-ai/nexus-engine","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/developerz-ai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":"audit.toml","citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-17T14:00:13.000Z","updated_at":"2026-05-17T19:01:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/developerz-ai/nexus-engine","commit_stats":null,"previous_names":["developerz-ai/nexus-engine"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/developerz-ai/nexus-engine","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developerz-ai%2Fnexus-engine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developerz-ai%2Fnexus-engine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developerz-ai%2Fnexus-engine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developerz-ai%2Fnexus-engine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/developerz-ai","download_url":"https://codeload.github.com/developerz-ai/nexus-engine/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/developerz-ai%2Fnexus-engine/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35626138,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-18T02:00:07.223Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","ai-first","claude-code","cross-platform","deterministic","ecs","game-engine","gamedev","headless","mcp","mit-license","open-source","rust","spec-driven","wgpu"],"created_at":"2026-07-18T17:35:16.043Z","updated_at":"2026-07-18T17:35:17.565Z","avatar_url":"https://github.com/developerz-ai.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- SPDX-License-Identifier: MIT --\u003e\n\u003c!-- Copyright (c) 2026 Nexus Engine contributors --\u003e\n\n# 🌌 Nexus Engine\n\n\u003e **The Linux of game engines.** Open source. AI-first. Cross-platform. Built by AI, maintained by AI, for AI agents and human developers — together.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![Built with AI](https://img.shields.io/badge/built%20by-AI-blueviolet)](docs/initial/vision.md)\n[![Spec-driven](https://img.shields.io/badge/spec--driven-yes-brightgreen)](docs/guides/spec-format.md)\n[![Status](https://img.shields.io/badge/status-pre--alpha%20·%20docs--first-orange)](docs/initial/vision.md)\n\n---\n\n## ⚡ The Pitch\n\nEvery game engine ever built assumed a human developer sat at a keyboard. **Nexus is the first one that doesn't.**\n\nA solo developer with AI should ship a AAA game in a weekend. A small team should ship a Dota-complexity game in months. Fans should extend the best games of all time within days of release. The barrier between *idea* and *shipped multiplayer game* should be measured in token budget, not man-years.\n\nThat is the design target. Every line of every spec is judged against it.\n\n---\n\n## 🧱 The Ecosystem\n\n| Layer | What it is |\n|---|---|\n| 🎮 **nexus-engine** | The core. ECS · renderer · physics · audio · networking · scripting · assets · editor. 100M LOC at maturity. |\n| 🛠 **nexus-cli** | `nexus new mygame` — Rails-style scaffolding. Convention over configuration, ejectable. |\n| 🤖 **nexus-coder** | In-house AI coding agent. Vercel AI SDK + OpenRouter. Massively parallel. Model-swappable mid-project. |\n| 🧪 **nexus-agent-sdk** | The headless API every AI dev tool executes against. Telemetry · scenarios · snapshots · replay. |\n| 🔌 **nexus-mcp-server** | Model Context Protocol server wrapping the agent RPC. One server, every MCP host (Claude Desktop · Claude Code · Cursor · Zed · ChatGPT Desktop · browser). |\n| 🎨 **nexus-assets** | One command finds, generates, validates, imports. Meshy · Scenario · FLUX local · Kenney · Poly Haven. |\n| 🔀 **nexus-merge** | AI maintainer. Reviews every PR. No politics. No burnout. No bus factor. |\n| 📦 **nexus-game-template** | The monorepo every game starts from. Game · server · web · mobile · DLC · mods · ai-agents. |\n| 🦀 **nexus-crates ecosystem** | The Rust-native compile-time extension layer (genres, styles, physics, netcode, telemetry sinks, asset sources, …). → [`docs/specs/crates/overview.md`](docs/specs/crates/overview.md) |\n| 🛰 **nexus-hub** | Federated **index + curation + verification** layer over crates.io / mod marketplaces / asset libraries. JSON-first. Self-hostable. → [`docs/specs/hub/overview.md`](docs/specs/hub/overview.md) |\n\n**Editor scope.** The native editor is narrow on purpose: asset/level quick-load, place/transform, scene tree + inspector, replay scrubber, telemetry overlays. Not a code editor. Every editor button = one agent RPC. The editor is a fast human cursor over the AI's keyboard.\n\n---\n\n## 🚀 Quick Start *(target — pre-alpha)*\n\n```bash\n# install\ncurl -fsSL https://nexus-engine.dev/install.sh | bash\n\n# scaffold a new game\nnexus new mygame --genre fps --style npr\ncd mygame\n\n# run with hot reload\nnexus dev\n\n# let an AI subagent build a feature for you\nnexus coder implement docs/specs/genres/fps.md#weapon-system\n\n# ship it\nnexus release --to steam,itch,web\n```\n\n---\n\n## 🧠 AI-First, Not AI-Bolted-On\n\nEvery system in Nexus satisfies the **AI-First Mandate**:\n\n| ✓ | Capability |\n|---|---|\n| ✅ | Machine-readable errors — every error is structured JSON with `code`, `location`, `suggested_fix` |\n| ✅ | Telemetry by default — every system streams structured events per frame |\n| ✅ | Headless operation — every system runs without a display, deterministic replay |\n| ✅ | Serializable state — full game state captureable and patchable at any frame |\n| ✅ | Semantic APIs — `engine.spawn(\"dragon near castle\")` is a valid call |\n| ✅ | Documented contracts — every public API has a machine-readable shape |\n\n---\n\n## 🧩 Modding — 100% Power, Out of the Box\n\nEvery Nexus game is **moddable to total-conversion depth** by default. Cosmetic mods are zero-friction. Gameplay mods get capability prompts. Total conversions are first-class. The engine takes **zero cut** of any creator economy. Skyrim · DotA · GMod · Factorio · Minecraft modpacks — all of it, supported.\n\n→ [`docs/specs/mods/overview.md`](docs/specs/mods/overview.md)\n\n---\n\n## 🖥 Platform Targets\n\n| Platform | Status |\n|---|---|\n| 🐧 Linux | v1.0 — primary dev platform |\n| 🪟 Windows | v1.0 |\n| 🍎 macOS | v1.0 |\n| 🤖 Android | v1.0 |\n| 📱 iOS | v1.0 |\n| 🌐 Web (WASM + WebGPU) | v1.0 |\n| 🎮 Switch / PS5 / Xbox | v1.1 (best-effort, NDA-gated) |\n| 🥽 VR (OpenXR) | v1.1 |\n\n---\n\n## 📚 Documentation\n\nNexus is **spec-driven** — no code is written until its spec exists. The complete spec tree lives in [`docs/`](docs/).\n\n- 📜 [**Vision**](docs/initial/vision.md) — the constitution\n- 🧭 [**docs/README.md**](docs/README.md) — entrypoint by role (new contributor · AI dev · game dev · modder · maintainer)\n- 🗂 [**docs/INDEX.md**](docs/INDEX.md) — flat index of every doc\n- 🧷 [**docs/INTEGRATION-REPORT.md**](docs/INTEGRATION-REPORT.md) — post-32-agent integration state (conflicts resolved, decisions open, what's safe to start on)\n- 🧪 **Solved-problems catalog** (voxel · falling-sand · 2.5D · massive RTS · seamless world · destruction · weather · procgen · sim · rhythm · text-heavy · 4X · heavy particles) → [`docs/architecture/08-compose-dont-build.md`](docs/architecture/08-compose-dont-build.md)\n- 🏛 [**Architecture**](docs/architecture/) — system map · principles · tech stack · ADRs\n- 🔧 [**Specs**](docs/specs/) — every subsystem, AI dev teams execute against these\n- 🤝 [**Contracts**](docs/contracts/) — exact boundaries between systems\n- 🎯 [**Genre modules**](docs/specs/genres/) — fps · rpg · rts · moba · platformer · racing · ...\n- 🛠 [**Guides**](docs/guides/) — coding style · testing · deploy · release · liveops · modding · PR workflow\n\n---\n\n## 🤖 For AI Agents Working in This Repo\n\nThe repo ships a complete `.claude/` orchestration layer.\n\n| Path | Purpose |\n|---|---|\n| 🧠 [`CLAUDE.md`](CLAUDE.md) | Mastermind orchestrator — read first |\n| 🎭 `.claude/agents/` | 118 specialist subagents (architect · network-engineer · rollback-specialist · crash-triager · mcp-server-engineer · ide-extension-engineer · editor-rpc-parity-auditor · mod-author · mod-curator · nexus-hub-operator · ...) |\n| ⚡ `.claude/commands/` | Project slash commands (`/spec /contract /impl /scenario /bench /triage /review /parallel`) |\n| 🔧 `.claude/skills/` | PR-workflow skills (`open-pr / wait-for-ci / babysit-pr / coderabbit-triage / coderabbit-resolve`) |\n| 🐰 [`.coderabbit.yaml`](.coderabbit.yaml) | CodeRabbit config tuned for Nexus principles |\n| 📜 `scripts/` | Tested, parameterized CLIs designed for agents to read · execute · trust |\n\nThe default expectation: dozens of subagents in flight, in parallel, all the time. The dev orchestrates; the agents work; the reviewers gate.\n\n---\n\n## 🤝 Contributing\n\nHumans and AI agents follow the **same process**. Read [`docs/guides/contribution.md`](docs/guides/contribution.md) and [`docs/guides/ai-dev-onboarding.md`](docs/guides/ai-dev-onboarding.md).\n\nThe TL;DR:\n1. Read [`docs/initial/vision.md`](docs/initial/vision.md) (the constitution).\n2. Read [`docs/architecture/01-principles.md`](docs/architecture/01-principles.md) (the 15 binding laws).\n3. Find or write the spec for what you're changing.\n4. Write tests first.\n5. Implement.\n6. Open PR — the [merge-bot](docs/guides/merge-system.md) reviews on technical merit alone.\n\n---\n\n## 📜 License\n\n**MIT. Forever.** No dual licensing. No open core. No \"community edition\" with a paid pro tier. The entire engine, every module, every tool — MIT. [Why](docs/architecture/05-adr/0004-mit-license.md).\n\n---\n\n## ⭐ The Commitment\n\nNexus will never:\n- ❌ Charge royalties\n- ❌ Introduce a paid tier\n- ❌ Change the license\n- ❌ Be acquired and closed\n- ❌ Have a single human maintainer as a point of failure\n\nNexus will always:\n- ✅ Be MIT\n- ✅ Be fully open source\n- ✅ Run on every major platform\n- ✅ Treat AI agents as first-class users\n- ✅ Accept contributions on technical merit alone\n- ✅ Ship working software over perfect architecture\n\n---\n\n*Built by AI. Maintained by AI. For everyone who ever wanted to ship a game.* 🚀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeveloperz-ai%2Fnexus-engine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeveloperz-ai%2Fnexus-engine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeveloperz-ai%2Fnexus-engine/lists"}