A first-person post-apocalyptic RPG built entirely in Three.js with procedural assets — no external model or texture files.
- Node.js 18+
- npm
npm install
npm run devThen open the URL Vite prints (usually http://localhost:5173).
| Command | What it does |
|---|---|
npm run dev |
Start the Vite dev server |
npm run build |
Production build into dist/ |
npm run preview |
Serve the production build locally |
npm run shots |
Capture screenshots via Playwright (tools/capture.mjs) |
npm run check |
Run the automated scene checks (tools/check.mjs) |
src/
art/ procedural geometry + material generation
audio/ sound synthesis and mixing
core/ engine loop, state, utilities
data/ game data tables (items, quests, dialogue)
minigames/ self-contained minigame modules
npc/ NPC behaviour and AI
player/ player controller and stats
systems/ gameplay systems (combat, inventory, survival)
ui/ HUD, menus, overlays
world/ terrain, level generation, streaming
tools/ Playwright capture and check scripts
docs/ design canon and art review notes
CONTRACTS.md module interface contracts
Screenshot output (shots/), build output (dist/, dist-check/) and node_modules/ are excluded from version control.
ISC
