An RPG under your roleplay. Deterministic turn-based combat, words that move the dice, fusable classes, and generated art that moves. A Lumiverse extension.
You roleplay in Lumiverse the way you always do; underneath sits a real game. Gambit plays the card you have selected: its characters are the people you bargain with, fight and travel beside, its lorebooks are the map, and your persona is your character sheet.
- Models judge, code decides. Models design skills, read your arguments and draw the world. Every number comes from seeded dice and formulas in code, so nothing a model says can save you from a bad roll or cheat you out of a good one.
- Your words are a stat. In a Parley (a talk, a haggle, a bluff) what you actually type is scored into a bounded dice modifier, and you see the roll.
- Real fights. A turn-based timeline engine with focus, class resources, statuses, signature skills and full-screen cut-ins.
- Classes from the card. Each fighter's kit is read from the card, with a base class behind it; signature skills get their own illustrated cut-ins.
- Art that moves. Portraits, figures, places and moments are generated per card and animated as puppets on the stage. The game never waits for art.
- Four interfaces. Each scene theme is its own game interface, down to how a fight and a talk look.
Every theme carries its look through the scene, the battle and the Parley.
Screenshots use the preview's code-drawn stand-in art; in play, the art comes from your card.
- In Lumiverse, open the drawer → Extensions → Add Extension.
- Paste
https://github.com/japolino/gambitinto Install from Source and click Install. - Review the requested permissions and turn the extension on. It needs Lumiverse 1.2.4 or later.
- Open a chat and choose Play with Gambit in the Gambit drawer.
Gambit uses your Lumiverse connections for text and images.
Requires Bun 1.4.
bun install
bun run verify # tests, typecheck and build
bun run preview # standalone preview at http://localhost:4174 (no Lumiverse needed)| Command | What it does |
|---|---|
bun test |
Engine, art pipeline and UI logic tests |
bun run typecheck |
tsc --noEmit |
bun run build |
Bundles dist/backend.js and dist/frontend.js |
bun run preview |
Scene, battle (/), Parley (/parley) and cut-in (/cutin) harnesses, rebuilt on every request |
bun run play |
Plays a battle in the terminal with no models and no art |
bun run balance |
Runs every encounter hundreds of times and reports the balance |
bun run fx:import |
Indexes the effect sheets and sounds in assets/ (see assets/README.md) |
bun scripts/deploy-local.ts <lumiverse dir> |
Copies a build into a local Lumiverse install |
src/
engine/ rules: combat, Parley, dice, classes (pure, seeded, tested)
backend/ the Spindle side: card reading, model calls, art queue, storage
frontend/
stage/ Pixi battle stage, cut-ins, effects, per-theme battle screens (stage/themes)
parley/ the Parley view and per-theme Parley screens (parley/themes)
scene/ the scene screen and its four themes
shared/ protocol and types shared by both sides
assets/ effect sheets and sounds, played by slot
looks/ art-direction presets
docs/DESIGN.md the full design document
The design, the rules and the roadmap are in docs/DESIGN.md.
- Effect animations by ぴぽや (Pipoya) and sound effects by 効果音ラボ (Sound Effect Lab), used under their terms; see assets/CREDITS.md.
- Music by Kevin MacLeod (incompetech.com), licensed under Creative Commons: By Attribution 4.0. Tracks aren't in this repo: when a player turns music on, a model picks them from the published catalogue and they stream from that site. The Gambit drawer lists the full credit for each track played.
- Fonts: Cinzel, Cormorant Garamond, IM Fell English, Press Start 2P and VT323, under the SIL Open Font License (licenses/).
- Built on PixiJS and three.js.




