Drop any book into it. Play inside the story.
Got a favourite fantasy novel? A Star Trek fanfic? A weird detective novel from the 70s? Drop the PDF in — the system extracts every character, location, item, and plot thread, then drops you into that world as whoever you want to be.
D&D 5e rules give the story stakes and consequences. You don't need to know D&D. Just say what you want to do.
Prerequisites: Claude Code or Codex with repository skill support.
git clone https://github.com/Sstobo/Claude-Code-Game-Master.git
cd Claude-Code-Game-Master
./install.shOnce installed:
1: Optional: drop a PDF or text file into source-material/
2. Launch Claude Code or Codex in the repository.
3. Ask for /new-game. In Codex, slash commands are intent aliases handled by
codex-skills/dm/; they do not need native command registration.
Or launch the browser UI:
./webui.shOpen http://127.0.0.1:18083/, choose a campaign, and select any available
Claude or Codex model from the runtime menu. Campaign creation and gameplay use
the same provider-neutral event contract; changing the model reconnects the UI
without changing the canonical campaign state.
When you run /new-game, the first choice you make is the mode for that campaign. It's set once and lives with the campaign forever.
The original experience. Zero setup beyond naming your campaign.
- Standard D&D 5e mechanics
- Full world generation, NPCs, locations, plot hooks, consequences
- Source material import (RAG-powered — play inside any book)
- Save/restore, session history, character sheets
- Works immediately out of the box
Everything in Classic, plus a suite of optional modules you toggle like game mods. Designed for campaigns that need mechanics beyond standard D&D.
At campaign creation you get a module selection menu, narrator style picker, and campaign rules template selector. All of it lives in .claude/additional/ and never touches the vanilla core.
| Module | What it does | Good for |
|---|---|---|
| 🧭 world-travel | Coordinate navigation, route finding, travel time, random encounters, hierarchical interiors, vehicles, and a Cytoscape web map. | Open worlds, wilderness travel, ships, and settlements |
| ⚔️ firearms-combat | Automated combat resolver. RPM → shots per round, fire modes (single/burst/full_auto), PEN vs PROT damage scaling, subclass bonuses. | Modern or military campaigns |
| 🛡️ mass-combat | Individual unit tracking, group attacks, AOE damage, cover, and battle XP for large encounters. | Squad and army-scale battles |
Each module is self-contained: its own tools/, lib/, rules.md, and module.json. Drop a folder into .claude/additional/modules/ to install community modules.
The system is universal — not just fantasy.
| Campaign | You play as... |
|---|---|
| S.T.A.L.K.E.R. | A stalker in the Chernobyl Zone. Radiation, anomalies, mutants, rival factions. Hunger and thirst tick in real time. |
| Fallout | A vault dweller emerging into a post-nuclear wasteland. SPECIAL stats, bottlecaps, power armor. |
| Metro 2033 | A survivor in Moscow's metro tunnels. Factions at war, mutants on the surface, bullets as currency. |
| Civilization | An immortal ruler guiding a civilization from stone age to space age. Strategic decisions across millennia. |
| SCP: Infinite IKEA | Trapped inside SCP-3008 — an infinite IKEA. Friendly by day, predatory staff by night. No exit. |
| Star Wars: Clone Wars | A clone trooper squad leader or Jedi on tactical missions during the Clone Wars. |
| Warhammer 40K | An Imperial Guard soldier in the grim far future. Everything wants to kill you. Everything will. |
| Pirates of the Caribbean | A pirate captain in the 1700s. Treasure, naval battles, supernatural curses. |
| Medieval Child | An orphaned child in war-torn medieval Europe. No combat stats — just stealth, cunning, and cold. |
| Barotrauma | A submarine crew on an alien ocean moon. Pressure, monsters, and things going very wrong with the hull. |
A campaign imported from Dungeon Crawler Carl. Tandy the sasquatch rips the skin off a Terror Clown, forces Carl to wear it as a disguise, then performs a sasquatch mating dance to distract Grimaldi while Donut frees the dragon.
When you import a document, the system vectorizes it with ChromaDB and spawns extraction agents that pull the book apart into structured data. During gameplay, every scene gets grounded in real passages from your source material.
Everything persists. NPCs remember what you said last session. Consequences fire days later in-game time. Locations change as events unfold. Save and restore at any point.
Specialist playbooks load on demand for monster stats, spell mechanics, loot tables, and equipment. They can be delegated to subagents for independent work, but normal gameplay does not require a permanent worker process. The player sees only the story. The system uses the D&D 5e API for official rules, spellbooks, monsters, and equipment.
| Command | What it does |
|---|---|
/dm |
Start or continue your story |
/dm save |
Save your progress |
/dm character |
View your character sheet |
/dm overview |
See the world state |
/new-game |
Create a world from scratch (choose Classic or Advanced) |
/create-character |
Build your character |
/import |
Import a PDF/document as a campaign |
/enhance |
Enrich entities with source material |
/help |
Full command reference |
| Tool | Purpose |
|---|---|
dm-campaign.sh |
Create, list, switch campaigns |
dm-session.sh |
Session lifecycle, movement, save/restore |
dm-scene.sh |
Apply a complete movement/time/quest/consequence scene transition |
dm-world.sh |
Unified low-level WorldGraph CLI |
dm-player.sh |
HP, XP, gold, inventory, conditions |
dm-npc.sh |
NPC creation, updates, party management |
dm-location.sh |
Locations and connections |
dm-time.sh |
Update in-game time |
dm-consequence.sh |
Schedule and resolve consequences |
dm-plot.sh |
Quest and storyline tracking |
dm-search.sh |
Search world state and source material |
dm-enhance.sh |
RAG-powered entity enrichment |
dm-extract.sh |
Document import pipeline |
dm-note.sh |
Record world facts |
dm-overview.sh |
World state summary |
Advanced module tools (dm-combat.sh, dm-mass-combat.sh) are available when the relevant module is enabled for a campaign.
| Agent | Triggered by |
|---|---|
monster-manual |
Combat encounters |
spell-caster |
Casting spells |
rules-master |
Mechanical edge cases |
gear-master |
Shopping, identifying gear |
loot-dropper |
Victory, treasure discovery |
npc-builder |
Meeting new NPCs |
world-builder |
Exploring new areas |
dungeon-architect |
Entering dungeons |
create-character |
New characters |
CORE (vanilla) ADVANCED (opt-in, per campaign)
────────────── ───────────────────────────────
lib/ .claude/additional/
tools/ ├── modules/ ← gameplay modules
.claude/commands/ │ ├── firearms-combat/
│ ├── mass-combat/
│ └── world-travel/
├── infrastructure/ ← dispatch, narrator, rules
├── dm-slots/ ← vanilla DM rules
└── narrator-styles/ ← narrator presets
The vanilla core (lib/, tools/) is never modified by modules. Advanced features are enabled through the campaign's modules list in campaign-overview.json; middleware is optional and declared by each module.
Claude command files and the Codex DM skill are thin client adapters. Both use
the same tools, compiled rules, modules, and campaign data under
.claude/additional/.
The web backend is FastAPI with asyncio WebSockets. One GameSession owns the
mutation lock and active AI runtime for each campaign. Claude runs through a
persistent Claude Agent SDK client; Codex runs through a persistent
codex app-server JSON-RPC process with resumable threads and native
interrupts. The frontend is dependency-light HTML, CSS, and JavaScript, with
Cytoscape used for the campaign map. Browser dashboards receive projected
player-safe views rather than raw world.json.
See docs/architecture.ru.md for the current business logic, storage boundaries, migration model, and guidance on where changes belong.
This work is licensed under CC BY-NC-SA 4.0 — free to share and adapt for non-commercial use. See LICENSE for details.
Original project by Sean Stobo. Advanced modules contributed by Maxim Astrakhantsev.
Your story awaits. Run /new-game to begin.