Welcome to the moonBASIC documentation. Start here whether you browse on GitHub or offline in the repo.
| I want to… | Read |
|---|---|
| Start from zero (install + why each command) | BEGIN_HERE.md |
| Deep guides (all 40 systems + net) | systems/GUIDES.md — 24 topic guides |
| Install and run a game | GETTING_STARTED.md |
| List every beginner-system command | systems/COMMAND_REGISTRY.md |
| Learn the language | LANGUAGE.md · FIRST_HOUR.md |
| Build a game loop | PROGRAMMING.md |
| Browse commands by system (APP, ENTITY, …) | systems/README.md |
| Look up a namespace (deep reference) | COMMANDS.md → reference/ |
| See every registered command | API_CONSISTENCY.md |
The systems guide documents the 40 systems from the moonBASIC foundation checklist: APP, RENDER, ENTITY, physics, audio, saves, tooling, and more. Each page follows DOCUMENTATION_STYLE_GUIDE.md.
| Part | File | Systems covered |
|---|---|---|
| 1 | systems/01-CORE.md | APP, RENDER, SCENE, ENTITY |
| 2 | systems/02-CAMERA-LIGHT.md | CAMERA, LIGHT |
| 3 | systems/03-ASSETS.md | MESH, MODEL, MATERIAL, TEXTURE, ASSET |
| 4 | systems/04-INPUT.md | INPUT, ACTION |
| 5 | systems/05-PHYSICS.md | PHYSICS, BODY, COLLISION, PICK |
| 6 | systems/06-AUDIO.md | AUDIO, AUDIO3D |
| 7 | systems/07-2D-WORLD.md | SPRITE, TILEMAP, TERRAIN, PARTICLE, ANIMATION |
| 8 | systems/08-UI-TEXT.md | UI, FONT, TEXT |
| 9 | systems/09-DATA.md | SAVE, FILE, JSON, MATH, VEC3 |
| 10 | systems/10-DEBUG-TIMER.md | DEBUG, ERROR, TIMER |
| 11 | systems/11-TOOLING.md | PROJECT, PACKAGE, MODULE, HELP, TEST, TEMPLATE |
All eleven parts follow DOCUMENTATION_STYLE_GUIDE.md.
Foundation example: ../examples/foundation/main.mb
- LANGUAGE.md — syntax, types, case insensitivity
- PROGRAMMING.md — game loop, 2D/3D
- MEMORY.md — handles,
FREE,ERASE ALL - ROADMAP.md — shipped vs planned
- COMMANDS.md — topic index
- reference/ — per-namespace pages (
RENDER.md,ENTITY.md, …) - COMMAND_AUDIT.md — namespace → doc file map
- DEVELOPER.md · BUILDING.md · CONTRIBUTING.md
- DOCUMENTATION_STYLE_GUIDE.md — how to write docs
- API_CONSISTENCY.md — every registered command (manifest listing)
- Commands are case-insensitive:
app.open,APP.OPEN, andApp.Openare the same. - Canonical registry names use
NAMESPACE.COMMAND(uppercase). - Checklist names like
APP.*are aliases documented in systems pages; internals may useWINDOW.*,TIME.*, etc.
- Repository README
- Examples
- FINAL_POLISH_SYSTEMS.md — checklist status summary