🚀 Cozy Parrot Runbook
Idiot-proof local run + playtest. Always cd games/cozy-parrot first.
See also: Index · Architecture · Opcodes
✅ Prerequisites
- Docker installed and running
- pnpm ≥ 9 (Node ≥ 20)
- Free ports 17350 (API), 17351 (console), 18080 (Cockroach UI)
Nakama default
7350often collides withkubectl— this stack uses 17350.
🛠️ Run steps
- Install →
pnpm install - nakama:build →
pnpm nakama:build - Copy
build/index.js→nakama/data/modules/build
mkdir -p nakama/data/modules/build && cp nakama/runtime/build/index.js nakama/data/modules/build/index.js - Docker →
docker compose -f nakama/docker-compose.yml up -d - Frontend
.env→PUBLIC_NAKAMA_PORT=17350(from.env.exampleif needed) - Dev →
pnpm --filter frontend dev→ open the printed URL
🎮 Playtest checklist
- Two tabs: Host Match (A) → paste Match ID → Join (B)
- WASD moves both parrots
- Space grabs the token for the correct blank in the prompt
- Throw into the golden hopper (Context Window)
- HUD: prompt blanks, timer, live scores
- result phase shows ranking after play (~60s)
🔬 Verify commands
| Check | Command / expectation |
|---|---|
| Frontend check | pnpm --filter frontend check → clean |
| nakama:build | pnpm nakama:build → nakama/runtime/build/index.js |
| docker ps healthy | docker compose -f nakama/docker-compose.yml ps / docker ps → nakama + cockroachdb healthy |
| E2E_OK | Headless two-player host/join/grab/throw vs API :17350 prints E2E_OK |
🩹 Troubleshooting
| Symptom | Fix |
|---|---|
Port conflict with kubectl / 7350 | Use 17350; set PUBLIC_NAKAMA_PORT=17350 |
Goja __assign / object spread | Remove spreads in runtime JS; rebuild + copy module |
| Inline RPC fail | Use a named function, then register that name |
| Module not loading / stale logic | Rebuild + cp into nakama/data/modules/build + restart Nakama |