An AI GM that respects the rules
Narration and structured state are handled separately. The model tells the story; the engine makes HP, items, currency, and checks count.
OPEN-SOURCE · SELF-HOSTED · AI TRPG
Gather your party.Set the scene.Let the story unfold.
DiceFrame is an open-source, self-hosted AI TRPG platform for DND, COC, and custom rules. It brings an AI GM, multiplayer WebUI, character sheets, lorebooks, dice, state tracking, and group chat into one persistent online campaign.
AGPL-3.0 open source
DiceFrame · Adventure tableONLINE
CHECKD20Roll added to the action
MEMORYThe world keeps growingLorebook · Summary · Semantic recall
SELF-HOSTEDDND · COC · CUSTOM RULESBOT
BUILT FOR THE WHOLE TABLE
One AI TRPG engine for the entire table.
DiceFrame is more than a chat box that continues a story. It puts the AI GM, every player, every character sheet, and every state change into the same trackable TRPG world.
One live multiplayer table
Invites, character claims, action queues, pauses, and GM turns all live in one WebUI and stay synchronized in real time.
A world that remembers
Lorebooks inject relevant context, long campaigns condense their history, and embeddings can bring back semantically related memories.
Rules that are not hard-coded
Start with DND 5e, COC, or freeform templates, then edit the rules, character templates, and world setting to build your own table.
From the web into group chat
Connect a web session to group chat through QQ and NapCat so players can act, check status, review the story, and roll dice.
Deployment stays in your hands
Run the Windows portable build, Docker, NAS, or source version. Saves, settings, and API keys remain in your environment.
The wind beyond the door carries the scent of wet iron. When Eliza raises her lantern, the runes do not reflect the light—they are slowly breathing.
SceneSunken GalleryState changeDiscovered · Ancient runes
STORY, WITH CONSEQUENCES
Let the story roam.
Keep the state reliable.
DiceFrame separates the model's narrative from internal state instructions. Players get clean prose while damage, items, payments, experience, and scene changes are validated before reaching the save.
- The roll happens before its result is narrated
- Payments require confirmation and balance validation
- The WebUI and bots share the same game state
FROM ZERO TO SESSION ONE
Four steps to your first AI-powered session.
Whether you play DND, COC, or a custom TRPG system, deploy DiceFrame on your own machine, connect a model API, and invite your friends to the table.
Deploy
Download the Windows portable build or start DiceFrame with Docker on your own device.
Set the table
Choose rules and a world template, or let AI draft an editable starting point.
Invite players
Create characters and share an invite link so web and chat players join the same session.
Start playing
Describe actions, resolve checks, and move the story forward while every change is written back to game state.
DOCKER · START WITH ONE COMMAND
docker run -d -p 9876:9876 -v ./data:/app/data ghcr.io/diceframe/diceframe:latestGUIDES & DOCUMENTATION
Need help? Start here.
From your first DiceFrame deployment to updates and plugin development, the documentation covers each part of the journey and evolves with the project.
github.comdiceframe / diceframe
main
- docs / USER_GUIDE_EN.md
- docs / DOCKER_DEPLOY_EN.md
- docs / PLUGIN_DEVELOPMENT_EN.md
- docs / UPDATER_EN.md
CONTINUOUSLY UPDATEDUp to date
YOUR WORLD. YOUR RULES. YOUR TABLE.
Your next TRPG adventure starts on your own server.
Open-source, self-hosted, and extensible. Download DiceFrame and bring your friends along.