SillyTavern-MultihogDnDFramework

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

SillyTavern-MultihogDnDFramework

★ 66 Open GitHub ↗

Started off as a humble "RPG State Tracker" but has since expanded into a more ambitious game engine, simulation system, and modular RPG platform where you can even make your own RPGs with their own systems and game logic. By default, ships with a "hardcore" setup that can best be described as simulation autism. Actions have consequences.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Multihog D&D Framework

*A highly customizable and modular RPG platform/simulation engine for SillyTavern.*

Started off as a humble "RPG State Tracker" but has since expanded into a more ambitious game engine, simulation system, and modular RPG platform where you can even make your own RPGs with their own systems and game logic — and all of this can be done through AI prompting via numerous integrated AI wizards/tools.

By default, ships with a plug-and-play "hardcore" setup that can best be described as simulation autism. Actions have consequences, and there is no scaling. The dragon will kick you to the curb even if you're level 2. The core aim and philosophy is to deliver an immersive experience through robust simulation logic, using realistic time passage as the backbone that ties into numerous other systems, and this aforementioned "player-agnosticism/neutrality." Fundamentally it acts as a cohesive RPG framework as well as an anti-sycophancy system.

I know it says "D&D Framework," but in addition to fantasy, the system works just as well for casual "slice of life" scenarios, modern settings, or anything else imaginable, so you're by no means limited to wizards and goblins. Everything is FULLY customizable and homebrew-friendly, complete with AI wizards, so next to no technical knowledge is required.

---

<img src="https://github.com/user-attachments/assets/878e437c-e7b4-4140-94b9-f9a14aab1002" width="60%" alt="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

- **Full Mobile support**: Continue on your phone where you left off on desktop.
- **AI-powered effortless creation**: generate entire game systems effortlessly from plain language prompts. AI handles it all.
- **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.
- **CYOA Mode**: Offers you clickable choices for frictionless gameplay. Completely optional, of course.
- **Auto model-switching**: The best models for the task.
- **Party-benching system**: Send your squad on quests; they will automatically eventually return, and their success/failure depends on their aptitude and RNG.
- **Custom fields, AI theme wizard, reorderable sections**; track whatever you want beyond the stock fields and customize the visuals to your liking.
- **Robust character creation options**: Specify detailed character information, a simple description, or just roll a completely random character.
- **Save your RPGs as Game Cartridges**: A complete snapshot of your RPG configuration. Importing and exporting is supported for easy backups or even sharing.
- **Homebrew-friendliness** and flexibility in general, supporting any genre.
- **Autonomous Lorebook Agent** handles your lorebooks completely hands-free, with no configuration necessary.
- **Talk to the models directly via (💬)**, making editing or adding things easy.
- **AI Portrait Generation and Real-Time Visualization Mode**: Portraits for everything, and a visualizer viewport.
- **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.
- **Life/dating sim-style friendship/affection component**: Build friendships and romance.
- **d100 support** for percentage-based systems/calculations.
- **Adventure Companion**: Learn the framework with an optional Tutorial Mode, discuss your adventure, update campaign state or lore, and even ask it to take your next turn.
- **Efficient Dual-Engine RNG**: Deterministic queue for instant combat; tool calls for narrative skill checks.

---

<img src="https://github.com/user-attachments/assets/8e615285-1eed-4312-98c6-6cb47febaed5" width="100%" alt="Combat in progress" />
 
 Some combat in progress

---

## 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.

### Initial Setup Video Guide

https://youtu.be/dKKFQqrH7qQ

---

## Suggested Companions

- 🧠 **[Summaryception](https://github.com/Lodactio/Extension-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.)

For the narrator, I'd recommend trying at least the following:

- MiMo 2.5 Pro
- Deepseek V4 Pro and latest Flash
- GPT-5.6 Luna, for its great cost-efficiency. Seems to be a decent model overall.

*For the State Tracker and Lorebook Agent, I've been recommending the Gemini Flash-Lite and Flash models. However, now I'm not sure at all anymore. Deepseek V4 Flash 0731 recently came out and is very promising, and the same goes for GPT-5.6 Luna. These are seriously inexpensive models and seem to be heavy-hitters in terms of performance.*

*If your model thinks too long in combat, enable* ***Combat API Override*** *in State Tracker settings — it auto-switches when the* *[COMBAT]* *tag is active in the tracker and switches back when combat ends.* ***This way you can have a faster model, so combat is faster.***

These are recommendations, not rules — experiment. Different models shine for different styles of play.

---

<table border="0">
 <tr>
 <td align="center" valign="bottom">
 <img src="https://github.com/user-attachments/assets/829b233c-19f0-407b-99a8-f58e80573a0a" width="100%" alt="Lorebook Agent" />
 
 Lorebook Agent
 </td>
 <td align="center" valign="bottom">
 <img src="https://github.com/user-attachments/assets/de2f7522-e3ff-4153-8a3f-d38ca49ceca7" width="100%" alt="Lorebook Agent" />
 
 Relationship system within Lorebook Agent
 </td>
 </tr>
</table>

---

---

 <img src="https://github.com/user-attachments/assets/a2c8a500-dbdf-4949-b2ee-bad025fd44e5" width="60%" alt="Combat in progress" />
 
 Visualization Mode

---

## Got a Question or Ideas?
You can find me in the SillyTavern Discord extensions forum. Join the Discord and then head to the sub-forum there: https://discord.gg/sillytavern

SillyTavern-MultihogDnDFramework

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README