gameu-ludo

Classic Ludo with four colors for the gameu lobby host.

• 2–4 players, turn-based.
• DOM renderer (no canvas / WebGL).
• Phone controller uses the host's built-in color_picker (during color choice) + action_picker (during play) templates — no custom controller bundle.

This game lives outside the gameu host repo as part of the gameu-games decoupling — each game ships in its own repo, npm-package-shaped, and reaches the host via POST /api/install (catalog tier) or via --external-game-dir (local dev).

Dev loop

Today, run from a gameu source clone:

cargo xtask run-game --game-dir /path/to/gameu-ludo

Once @jamunlabs/gameu-cli ships to npm:

npm i -g @jamunlabs/gameu-cli
cd gameu-ludo
gameu dev

Build

npm install
npm run build
gameu build

Layout

| File | Purpose | |---|---| | manifest.json | Bundle manifest (id, runtime, player counts, sdk_version). | | index.html | TV-side game iframe entry point. | | game.js | Boots the GameRunner with LudoReducer + LudoRenderer. | | reducer.js | Pure synchronous reducer; per-color token paths + capture rules + home-stretch logic. | | renderer.js | DOM renderer; build-once cross-shaped board + mutate per-token positions. | | dev_mode.js | Auto-drive resolvers gated on ?dev=1. | | *.ts | TypeScript source. |

Runtime contract

Same as the other gameu games — loads /lib/* from the host, imports from @jamunlabs/gameu-sdk via the host importmap, sandboxed iframe.