A 3D above-ground goblin colony survival builder with siege-defense combat and light RTS controls — grow a filthy camp into a dangerous monster warren. Built primarily by AI agents (Cursor) inside the chat window, with 3D models sourced from Meshy AI and polished in Blender, AccuRIG/Mixamo, and Cascadeur.
- Engine: Godot 4.7.stable. See
docs/technical-reference.md. - Language: GDScript (primary).
- Pathfinding: Built-in
AStarGrid2Dover a logical grid; agents render on a 3D plane under an RTS camera (not navmesh freeform 3D). - 3D art: Meshy → Blender → GLB (static) / FBX (animated) → Godot.
- Agent control plane: Aesthetic Engine GRB over MCP. See
docs/mcp-setup.md.
This repo is co-authored by humans and AI agents. The rules in AGENTS.md are
binding for both. Game design direction lives in the master design doc below.
| Topic | File |
|---|---|
| Master design (read first for features) | docs/goblin-warrens-design.md |
| Resuming this project | HANDOFF.md |
| AI onboarding summary | docs/chatgpt-master-context.md |
| How agents must behave in this repo | AGENTS.md |
| Why we picked Godot over Unity / Bevy | docs/decisions/0001-engine-selection.md |
| Report vs repo architecture | docs/architecture-reconciliation.md |
| Art pipeline (Meshy, Blender, rigging) | docs/asset-pipeline.md |
| Pinned versions and tool paths | docs/technical-reference.md |
| Installing & wiring the MCP bridge | docs/mcp-setup.md |
Playable rough 7-day prototype in scenes/colony.tscn: worker loop, RTS
selection/commands, building placement, food/population, foblins, day arc,
threats/combat, shrine rituals, burial/revival, win/loss, and basic save/load.
Art is placeholder/kitbash quality. Design milestones 1–10 (§37) are playable;
polish and post-MVP economy (Warren upgrades, unit training, gold spend, Shaman,
champions) are next. See docs/chatgpt-master-context.md and
docs/goblin-warrens-design.md §37.
Clone this repo, open the folder in Godot 4.7, and run scenes/colony.tscn.
| Need | Where |
|---|---|
| What art to build | docs/asset-list.md |
| Style + specs | docs/goblin-warrens-design.md §3.2, docs/asset-pipeline.md |
| Terrain textures | docs/terrain-texture-brief.md |
| Drop finished assets | game/art/**/goblin_warrens/ |
| Runtime art index | scripts/art/visual_catalog.gd |
| Optional raw kit packs | Not in git — see docs/itch-io-acquisition.md / docs/quaternius-acquisition.md |
Copy .cursor/mcp.json.example → .cursor/mcp.json and edit paths if using Cursor + GRB (docs/mcp-setup.md).