# Gameable Engine

> Gameable Engine (`aos-gameable-engine`) is a browser game engine: gaussian-splat worlds rendered by three.js on WebGPU, with all game logic compiled to a WebAssembly component.

Status: M0-M3 shipped. Building a game? Read one task bundle below, copy a template, edit src/game.ts, run `npm run dev`, follow one recipe. Never read the whole repository; never edit packages/*.

## Bundles

- [llms-fps.txt](/llms-fps.txt): first-person shooter.
- [llms-third-person.txt](/llms-third-person.txt): third-person adventure.
- [llms-three-character.txt](/llms-three-character.txt): a character in a three.js app.
- [llms-visit.txt](/llms-visit.txt): a character page.
- [llms-multiplayer.txt](/llms-multiplayer.txt): rooms.
- [llms-character.txt](/llms-character.txt): splat characters.
- [llms-mystery.txt](/llms-mystery.txt): the mystery kit (templates/mystery).
- [llms-survive.txt](/llms-survive.txt): the survive kit.
- [llms-hangout.txt](/llms-hangout.txt): the hangout kit.
- [llms-brawl.txt](/llms-brawl.txt): the brawl kit.
- [llms-steal.txt](/llms-steal.txt): the steal kit.
- [llms-collect.txt](/llms-collect.txt): the collect kit.
- [llms-full.txt](/llms-full.txt): the core corpus, without the topics above.

## Templates

- [templates/brawl](/llms/templates/brawl/src/game.ts.txt)
- [templates/collect](/llms/templates/collect/src/game.ts.txt)
- [templates/fps](/llms/templates/fps/src/game.ts.txt)
- [templates/hangout](/llms/templates/hangout/src/game.ts.txt)
- [templates/mystery](/llms/templates/mystery/src/game.ts.txt)
- [templates/steal](/llms/templates/steal/src/game.ts.txt)
- [templates/survive](/llms/templates/survive/src/game.ts.txt)
- [templates/third-person](/llms/templates/third-person/src/game.ts.txt)
- [templates/visit](/llms/templates/visit/src/game.ts.txt)

## Start here

- [AGENTS.md](/llms/AGENTS.md.txt): hard rules, commands, repository map.
- [Overview](/): what the engine is; the 60-second quickstart.
- [Hello world with your Gameable character](/start/01-hello-world)
- [Install](/start/01-install)
- [Build your first FPS](/start/02-first-fps)
- [Build your first adventure](/start/03-first-adventure)
- [Ship it](/start/04-deploy)
- [Make a multiplayer game](/start/05-make-a-multiplayer-game)

## Concepts

- [Concepts](/concepts/): Gameable Engine splits a game in two…
- [The engine loop](/concepts/engine-loop): The host runs a single…
- [Engine modules](/concepts/modules): Every host subsystem is an EngineModule:
- [Assets and the manifest](/concepts/assets): All content is declared in an…
- [The wasm game-logic boundary](/concepts/wasm-boundary): All game logic is TypeScript compiled to…
- [ECS and game code](/concepts/ecs): bitecs 0.4 is the ECS and it lives…
- [Gaussian splats](/concepts/splats): Worlds are gaussian splats rendered by…
- [Animation](/concepts/animation): A character is animated by one object.…
- [Physics](/concepts/physics): Physics is Jolt (jolt-physics 1.1, wasm)…

## Packages

- [@gameable/animation](/api/@gameable.animation)
- [@gameable/assets](/api/@gameable.assets)
- [@gameable/assets-aam](/api/@gameable.assets-aam)
- [@gameable/assets-aosrig](/api/@gameable.assets-aosrig)
- [@gameable/assets-placeholder](/api/@gameable.assets-placeholder)
- [@gameable/audio](/api/@gameable.audio)
- [@gameable/cli](/api/@gameable.cli)
- [@gameable/conversation](/api/@gameable.conversation)
- [@gameable/core](/api/@gameable.core)
- [@gameable/create-gameable](/api/@gameable.create-gameable)
- [@gameable/gameable](/api/@gameable.gameable)
- [@gameable/input](/api/@gameable.input)
- [@gameable/physics-jolt](/api/@gameable.physics-jolt)
- [@gameable/sdk](/api/@gameable.sdk)
- [@gameable/splat](/api/@gameable.splat)
- [@gameable/test-harness](/api/@gameable.test-harness)
- [@gameable/vite-plugin-gameable](/api/@gameable.vite-plugin-gameable)
- [@gameable/voice](/api/@gameable.voice)
- [@gameable/wasm-host](/api/@gameable.wasm-host)

## Schemas

- [Gameable Engine asset manifest](/llms/docs/schemas/assets.schema.json.txt): JSON Schema, draft 2020-12.
- [Gameable Engine prefab](/llms/docs/schemas/prefab.schema.json.txt): JSON Schema, draft 2020-12.

## Reference

- [Recipes](/recipes/): every recipe, by genre.
- [Troubleshooting](/troubleshooting): symptom-first fixes.
- [Glossary](/glossary): project-specific terms.
- [API reference](/api/): TypeDoc markdown; run `npm run docs:api`.