Skip to content

MultihogAurelius/SillyTavern-MultihogDnDFramework

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,213 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Multihog D&D Framework

A D&D-based RPG platform/simulation engine for SillyTavern.

This framework essentially turns SillyTavern into something like AI Dungeon, but with actual mechanics/consequences! This is a mechanical-integrity-first philosophy where your choices matter. I wasn't satisfied with any of the commercial offerings available (AI Realm, AI Dungeon, Friends & Fables, etc.), so I made my own D&D platform inside SillyTavern.

In addition to fantasy, the system works just as well for casual "slice of life" scenarios or modern settings, so you're by no means limited to wizards and goblins. Everything is FULLY customizable and homebrew-friendly.

Crucially, the system is input-output, not just some glorified stats collector. Everything in the State Tracker is fed back to the AI. What you see is what the AI also sees.


A basic character sheet
A basic character sheet


The Core Components:

  1. 🖥️ RPG State Tracker - Extracts and maintains HP, inventory, party, buffs, XP, spells, and more via a dedicated second-pass model. Injects a rolling State Memo back into each prompt to keep the AI (and you) on track.
  2. 🎲 Hybrid RNG System - A dual-engine approach to tabletop physics.
    • RNG Queue: Pre-seeded deterministic dice injected into every turn. Cheaper than using tool calls and very smooth when a lot of rolls are used in sequence such as in combat.
    • Tool Call RNG: Enables a commitment logic where the AI must declare a DC before seeing the result, completely preventing sycophancy.
  3. 🤖 Lorebook Agent - Automatically creates, activates/deactivates, updates, consolidates, etc, lorebook entries, ensuring long-term memory despite summarization.
  4. 🌍 World Progression - A system that creates daily (or more frequent) reports about NPC/world affairs using existing lore entries as well as an optional world "skeleton" created beforehand. The world moves regardless of you.

Together they solve the four core problems of LLM tabletop RP: the AI forgetting your inventory/spells, the AI forgetting long-term context, you always winning (aka. plot armor), and the world being static outside of the immediate player's bubble. I have high confidence in the system's reliability—you can just play and not worry about tinkering with much of anything.


Highlights

  • 20+ Rendering Tags with universal inline support and live preview library.
  • AI-Powered Configuration — generate custom fields and sysprompt sections from plain language descriptions.
  • Dual-Engine Physics: Deterministic queue for instant combat, and interactive tool calls for narrative skill checks.
  • Draggable HUD with HP bars, spell pips, colored status pills, alert badges, and economy coins.
  • Automatic spell slot tracking via 🔵 pips in the UI; never worry about remembering how many you have left.
  • Buff/debuff temporal decay via [TIME] delta tracking; statuses expire automatically over time based on time elapsed.
  • Dynamic enemy scaling — enemies adapt to quest difficulty and player level contextually.
  • Snapshot history + delta log - easy rollback, and see at a glance what was changed in the state.
  • Auto model-switching so that you can use a different model for tracking the state.
  • Full-context audit mode with automatic chunking for massive chat histories.
  • Custom fields, themes, reorderable sections; track whatever you want beyond the stock fields and customize the visuals to your liking.
  • Automatic D&D wikidot spell links - look up spells by clicking on them without awkward googling.
  • Mobile support (open from the wand menu).
  • Talk to the tracker model directly via (💬), making editing or adding things easy.
  • Onboarding system - roll up a random character or describe one to the model.
  • Profile saving - switch between multiple campaigns without losing your state.
  • Homebrew-friendly and flexible in general, relying on AI to do a lot of the lifting.
  • Automatic Long-Context Tracking via the Lorebook Agent with World Engine simulation.
  • AI Portrait Generation via Pollinations.ai — free, non-profit image generation with full lorebook agent context awareness for accurate character portraits.
  • Inventory Currency Auto-Rendering — items with a worth value automatically display a styled coin badge (gold, silver, bronze, or dollar) based on the currency type.
  • Character card importing — import any existing character into the story as an NPC; AI will automatically adapt it to the story, regardless of setting/theme.
  • AI-powered Game Systems Wizard — Simply describe any mechanic to the wizard in natural language (e.g. "reputation system), and the AI will build the system for you according to the structure of the extension (sysprompt + module.) Iterate, regenerate, or manually edit any block directly within the forge before saving.
  • Life/dating sim-style friendship/affection component.

Screenshot 2026-06-18 195917

Installation

The packaged releases will likely not be up to date. I recommend cloning the repo or taking the steps below.

  1. Go to the SillyTavern extension menu.
  2. Click on "Install extension" at the top.
  3. Enter this repo's URL.

Usage Guide

  1. Initial Setup: Use the archetype buttons on the empty tracker to roll a new character, or paste an existing sheet into the "Raw View" (if your sheet doesn't align with what the UI expects, ask the model via 💬 to fix the formatting). Create a character card for your "narrator," such as Simulation Engine that I use. You can also name it something like Game Master.
  2. Auto-Tracking: As you roleplay, the extension intelligently parses assistant responses. It detects losses of HP, new loot, or combat triggers, stitching together multi-part tool-call responses and running background passes to update the state.
  3. Prompt Injection & Execution: The State Memo and RNG Queue are injected seamlessly into your outgoing prompt to act as the "source of truth." For narrative actions, the framework dynamically catches and resolves the AI's RollTheDice tool calls.
  4. World Progression Skeleton & Settings: Optionally, create a "world skeleton" for the World Progression component to inject broader macroscopic content into the context/world in the world reports. Optionally set up the randomizers from the WP settings to determine how much skeleton and organic (Lorebook Agent) content is used in world updates.

Suggested Companions

  • 🧠 Summaryception: A brilliant summarizer/context compression extension. Also handy for crunching all the combat mechanics of the context into summarized history.

Don't Care About D&D?

You can scrap the entire system prompt and all the default fields and track your own things completely. The D&D setup is just a plug & play system that works by default.

What Model to Use?

Your primary narrator model must support Tool Calling for the Hybrid RNG system to work properly, though this is only relevant if you're using tool calls. The extension also works without them (selectable in the settings.)

image

For the State Tracker and Lorebook Agent, use Gemini 3.1 Flash. It's good enough and costs peanuts. For the GM/Narrator, MiMo 2.5 Pro in my opinion has the best quality-price ratio. Experiment.


Combat in progress
Some combat in progress


Lorebook Agent
Lorebook Agent


Got a Question or Ideas?

You can find me in the SillyTavern Discord extensions forum: https://discord.com/channels/1100685673633153084/1494170113279131678.

Tips

Everything is of course provided for free (and I also encourage people to fork and do whatever they want with the code), but if you want to give me a tip, you can: https://buymeacoffee.com/multihog


About

Started off as a humble "RPG State Tracker" but has since expanded into a more ambitious "game engine." The aim is to really build a D&D game framework inside SillyTavern with mechanical integrity. This isn't a narrative-first philosophy; it's game/mechanics first. Narrative emerges out of the mechanics working properly.

Resources

License

Stars

30 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors