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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/diceframediceframe.svg)](https://yunodb.com/tools/diceframediceframe?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/diceframediceframe?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/diceframediceframe.svg" alt="Featured on YunoDB" height="20"></a>