# ForgeaX

> ForgeaX is an AI-native personal game development studio. Describe the game you want — by chat, in a visual editor, and (soon) with images or video — and AI writes the ECS engine code, hot-reloading live in your browser. Both the engine and the development loop are designed so that AI is the first user. Open source under Apache License 2.0.

Key facts:
- Positioning: an AI-native personal game studio (not chat-only; editor and future image/video inputs too).
- Stack: a self-built ECS game engine (dual RHI: WebGPU + a wasm backend) plus an AI development loop.
- Status: "turn ideas into playable games with AI" — playable FPS, ARPG, survival and shooter demos exist; engine covers PBR rendering, physics and skeletal animation. Open source and available now (latest stable: v0.2.0) at https://github.com/ForgeaX-Games.
- License: Apache License 2.0.
- GitHub: https://github.com/ForgeaX-Games

## Changelog
- [Changelog](https://forgeax.github.io/changelog/): day-by-day log of features and implementation shipped each day.

## Docs
- [Documentation outline](https://forgeax.github.io/docs/): user-facing Studio guide (concepts, chat-driven building, scenes/editor, assets, run & preview, publish, advanced).
- [ForgeaX CLI docs](https://forgeax.github.io/docs/cli/): terminal-native single-agent runtime (`@forgeax/cli` / `forgeax`) — overview, install, workflows, MCP, permissions, CLI reference. Languages: [中文](https://forgeax.github.io/docs/cli/) · [English](https://forgeax.github.io/docs/cli/en/).

## Tutorials
- [Have your AI CLI clone & launch it](https://forgeax.github.io/tutorials/cli-setup.html): hand the repo to a coding CLI (Claude Code / Codex / Cursor / forgeax) and let it clone, install and start ForgeaX.
- [Quick start: your first game](https://forgeax.github.io/tutorials/getting-started.html): the describe → generate → play → describe loop.
- [Generate art with the workbenches](https://forgeax.github.io/tutorials/workbenches.html): the creation workbenches — characters, animation, 3D, VFX, scenes, UI, music, narrative, balance.
- [Make an interactive film-game](https://forgeax.github.io/tutorials/interactive-film-game.html): spark or script → anchors → storyboards → video → play-test, packaged into a webpage anyone can play.

## Blog
- [Why build an AI-native engine](https://forgeax.github.io/blog/why-ai-native-engine.html): single source of truth, recoverable error codes, frame capture instead of "look at the screen", and dual-backend cross-checking.
- [How AI gets a feature right](https://forgeax.github.io/blog/how-the-loop-works.html): the seven-step development loop, orchestrator + sub-agents, AI review + sandbox, and the feedback flywheel.

## Showcase
- [Game demos](https://forgeax.github.io/showcase/): Sector Strike (FPS), Hellforge (ARPG, skeletal animation), Cow Survivor (survival, multi-level), Shoot Opt (shooter, performance stress test).

## About
- [About / vision](https://forgeax.github.io/about.html): let smaller teams make bigger games.
- [License (Apache 2.0)](https://forgeax.github.io/license.html): rights granted and obligations.

## Optional
- [llms-full.txt](https://forgeax.github.io/llms-full.txt): the entire site content as a single Markdown document.