diceframe
A self-hostable AI tabletop RPG platform with multiple rule systems (COC/DND/free tavern etc.), supporting WebUI, multiplayer, lorebook, dice checks, state trac
What is diceframe?
A self-hostable AI tabletop RPG platform with multiple rule systems (COC/DND/free tavern etc.), supporting WebUI, multiplayer, lorebook, dice checks, state tracking, and chat bot. |一个可自部署的 AI跑团引擎(TRPG),多种游戏规则 COC/DND/自由酒馆等,支持 WebUI、多人游戏、世界书、骰子检定、状态追踪和群聊 Bot。
Overview of diceframe
What it is
DiceFrame is a self-hostable AI tabletop RPG engine supporting D&D / CoC / custom rules with a multiplayer Web UI. It is designed for solo or group play with automatic dice checks, character state tracking, and AI-assisted worldbuilding.
Key features
- Play solo or with friends in a browser, with invitations and shared game state.
- Describe actions naturally; rules handle automatic dice checks and character state.
- Build worlds, lorebooks and adventures, or import scripts, PDFs and supported modules.
- Reuse character cards and create worlds, rules and characters with AI assistance.
- Keep long campaigns with summaries, optional memory recall and text-to-speech.
- Add plugins and chat bots; use the owner-only DF Agent for reviewed operations.
Use cases
- Solo tabletop RPG sessions with AI-driven narration and rule enforcement.
- Multiplayer campaigns where players share a persistent game world.
- Custom rule systems beyond D&D and CoC, using the free tavern mode.
- Long-running campaigns with memory and summary features.
- Integration with chat platforms via bot bridge for group play.
Getting started
cp .env.example .env
docker compose pull
docker compose up -d
Or from source:
git clone https://github.com/diceframe/diceframe.git
cd diceframe/frontend-v2
npm ci && npm run build
cd ..
pip install -r requirements.txt
python web_server.py
License and pricing
Licensed under AGPL-3.0. Open source.
Based on the project's public README and repository metadata.