root@questkeeper:~$

> QUEST_KEEPER_AI

[ AI_DUNGEON_MASTER + VISUAL_GAME_ENGINE ]

A desktop RPG companion combining an AI Dungeon Master with 3D battlemap visualization, procedural world generation, and complete game state management. Where every action has mechanical weight, every quest tracks progress, and your world persists across sessions.

135+
MCP Tools
3D
Battlemap
ALPHA
Playable Now

🖥️ Desktop App: Full Tauri application with React frontend & Three.js 3D rendering

🎮 MCP Backend: Compatible with Claude Desktop, KiloCode, and RooCode

> GET_STARTED > VIEW_BACKEND
// LATEST_CASE_STUDY

THE GHOST IN THE MACHINE

See what happens when an AI Game Master runs a full D&D session with zero hallucination. Witness the system fix its own code mid-session, bankrupt a player with real dice rolls, and kill a major NPC without mercy.

> READ_THE_LOGS
COMBAT_LOG_EXTRACT
> ROLL: NATURAL 20 (CRITICAL)
> DAMAGE: 17 POINTS
> STATUS: CASSIA_NEREIA [DEAD]
> SYSTEM: STATE_PERSISTED_TO_DB

// ABOUT_THE_PLATFORM

Quest Keeper AI bridges the gap between pure narrative AI tools (like AI Dungeon) and pure mechanical trackers (like D&D Beyond). It combines rich AI-powered storytelling with persistent, trackable game state—where the AI describes the world, but the engine defines it.

🚀 The Problem We Solve

AI tools: Great storytelling, zero mechanical tracking. "You have a sword" but no stats, no inventory, no progression.

Mechanical tools: Excellent character sheets, but no AI. Manual everything.

Quest Keeper AI: The first system where LLMs never lie about state. All game data comes from verified database, not hallucination.

[ CORE_FEATURES ]

🎲

D&D 5e Mechanics

Full implementation of ability scores, skills, combat mechanics, and character advancement with dice rolling

🗺️

3D Battlemap

React Three Fiber visualization with tactical grid, terrain features, and creature tokens with size categories

🌍

Procedural Worlds

Perlin noise terrain generation with biomes, regions, structures, and points of interest

📜

Quest System

Multi-objective quests with progress tracking, prerequisites, rewards, and OSRS-style quest chains

🤖

AI Dungeon Master

Multi-LLM support (Claude, GPT, Gemini, OpenRouter) with tool calling for mechanical accuracy

💾

Persistent World

SQLite database with WAL mode storing characters, inventory, world state, quests, and relationships

🔮

DM Secrets

Hidden information system with reveal conditions, leak detection, and spoiler formatting for dramatic reveals

🏰

Grand Strategy

Nation management, diplomacy, fog of war, turn-based resolution for domain-level play

✨

True Freedom

Native support for "Rule of Cool", improvisation, theft mechanics, and corpse harvesting via specialized MCP tools

🔥

Full Spellcasting

15+ SRD spells, concentration tracking, slot progression, and Warlock pact magic validation

💰

Living Economy

Theft heat system, fence networks, loot tables, and currency conversion mechanics

// SYSTEM_ARCHITECTURE

🖥️ Quest Keeper AI Frontend

Tauri desktop application with dual-pane interface

  • React 19 + TypeScript frontend
  • Three.js / React Three Fiber 3D battlemap
  • Zustand state management
  • Multi-LLM orchestration
  • Markdown chat with tool inspection
  • Character sheets, inventory, world state views
  • Real-time combat visualization
  • Cross-platform (Windows, macOS, Linux)
Tauri 2.x React Three.js Zustand

⚙️ rpg-mcp Backend

Unified MCP server with 135+ tools

  • Character & NPC management with D&D stats
  • Full Spellcasting (Slots, Concentration, SRD)
  • Combat encounters with initiative & actions
  • Complex Economy (Theft, Heat, Fences)
  • World generation with Perlin noise
  • Corpse Decay & Loot Tables
  • Grand strategy & nation management
  • DM secrets with reveal conditions
TypeScript SQLite MCP SDK Zod

The frontend spawns rpg-mcp as a sidecar process, communicating via JSON-RPC over stdio using the Model Context Protocol. The backend can also run standalone with Claude Desktop, RooCode, or any MCP-compatible client.

[ COMPETITIVE_LANDSCAPE ]

How Quest Keeper AI compares to existing platforms—honestly.

🎯 The Mechanical Trust Problem

The fundamental issue with AI game masters: "The High Paladin sends you to recover the Crown of Might. After 27 sessions, you still haven't found it. The AI DM admits there is no Crown of Might. You wasted 27 sessions."

Quest Keeper's Solution: LLM describes, engine validates. All game state comes from SQLite, not hallucination. The AI can narrate finding a sword, but the sword must exist in the database first.

// TECHNICAL_COMPARISON

Capability AI Dungeon Roll20 Foundry VTT D&D Beyond Quest Keeper
AI Integration Core (15+ models) None Community modules None Core (multi-LLM)
Mechanical Validation ❌ None Manual only Module-dependent Character creation ✅ Engine-validated
State Persistence Cloud only Cloud only LevelDB (local) Cloud only SQLite (local)
API Access ❌ None Pro tier only Full JavaScript API ❌ None (7yr wait) 135+ MCP tools
Self-Hosted ❌ ❌ ✅ ❌ ✅
Open Source ❌ ❌ ❌ ❌ ✅ MIT
3D Battlemap ❌ ❌ Via modules ❌ (Sigil cancelled) ✅ Three.js
Pricing Free–$50/mo Free–$11/mo $50 one-time Free–$6/mo + books Free forever

vs. AI Dungeon

The pioneer of AI interactive fiction with 15+ model options from 12B to 671B parameters.

Quest Keeper Advantages

  • Mechanical honesty: Game state is database-validated, not AI-hallucinated
  • Real dice rolls: Actual probability with all D&D notation (advantage, exploding, drop lowest)
  • Visual feedback: 3D battlemap, character sheets, inventory UI
  • Self-hosted: Your data stays on your machine
  • Free & open source: No $50/month Mythic tier needed

AI Dungeon Advantages

  • Model variety: 15+ AI models including GPT-4 Turbo with 128K context
  • Established library: Thousands of community scenarios
  • Zero setup: Browser-based, works immediately
  • Unlimited free tier: Play forever with smaller models
  • Custom fine-tunes: Story-optimized models like Harbinger-24B

vs. Roll20

Market leader with 15+ million users and browser-based convenience.

Quest Keeper Advantages

  • AI Dungeon Master: Roll20 has explicitly banned AI content
  • Full API access: 135+ tools vs Roll20's Pro-tier-only API with no HTTP requests
  • Data ownership: SQLite on your machine vs cloud-only storage
  • World generation: Procedural terrain, not just map uploads
  • No subscription: Free forever vs $11/month for advanced features

Roll20 Advantages

  • Player network: Built-in LFG with millions of active users
  • Official content: Licensed D&D, Pathfinder, Call of Cthulhu modules
  • Zero install: Browser-based, no desktop app needed
  • 800+ character sheets: Community-built for virtually every system
  • Production stability: 12+ years of battle-tested infrastructure

vs. Foundry VTT

The technical gold standard for self-hosted VTTs with 2,700+ community modules.

Quest Keeper Advantages

  • Native AI integration: Foundry's founder explicitly refuses AI features
  • Simpler persistence: Human-readable SQLite vs binary LevelDB
  • Open source: MIT licensed vs proprietary
  • Built-in 3D: Three.js included vs module-dependent
  • Free: No $50 license required

Foundry Advantages

  • Mature ecosystem: 2,700+ modules, 350+ game systems
  • Superior lighting: PixiJS WebGL with colored dynamic lighting
  • Full JavaScript API: Build complete game systems and modules
  • Active community: Years of accumulated knowledge and support
  • Production polish: 5+ years of development and refinement

vs. D&D Beyond

The official D&D platform with the best character builder and immediate access to new content.

Quest Keeper Advantages

  • AI Dungeon Master: WotC policy prohibits AI in D&D products
  • Data ownership: You own your data vs "you don't own your books"
  • 3D battlemap: D&D Beyond cancelled their 3D Sigil VTT
  • API access: 135+ MCP tools vs API promised for 7+ years, never delivered
  • No repurchasing: Works with any content you already own

D&D Beyond Advantages

  • Official content: New books available 1-2 weeks early
  • Character builder UX: The most polished D&D character creation experience
  • Automatic errata: Rules updates applied instantly
  • Content sharing: 12 players across 5 campaigns on one Master sub
  • 2024 rules toggle: Support for both 2014 and 2024 D&D versions

⚠️ Honest Limitations

Quest Keeper AI is in alpha. Here's what we don't have yet:

  • No content library: We rely on SRD and user-created content. No official licensed modules.
  • No player network: No built-in LFG. You bring your own players or play solo.
  • Solo developer: Competitors have teams and years of development. We're just getting started.
  • Unproven at scale: Our SQLite approach hasn't been stress-tested with massive campaigns.
  • Learning curve unknown: 135+ MCP tools may overwhelm users seeking simplicity.

[ DEVELOPMENT_ROADMAP ]

From core foundation to comprehensive RPG platform

Phase 1: Core Foundation

✅ Complete

Unified backend, working integration

  • ✅ Unified rpg-mcp server (135+ tools)
  • ✅ Tauri frontend with React + Three.js
  • ✅ Character, inventory, combat systems
  • ✅ Quest system with objectives
  • ✅ World generation with regions
  • ✅ Multi-LLM support
  • ✅ SQLite persistence with WAL mode

Phase 2: Advanced Systems

🔄 In Progress

Current development focus

  • ✅ DM Secrets system with reveal conditions
  • ✅ Grand strategy & nation management
  • ✅ Turn-based resolution system
  • ✅ Full Spellcasting Engine
  • ✅ Theft & Fence Economy
  • ✅ Corpse Decay & Harvesting
  • ✅ NPC Memory & Relationships
  • 🔄 Spatial combat with grid positions

Phase 3: Progression Systems

Upcoming

OSRS-style depth

  • Skill system with XP curves
  • Quest chains with prerequisites
  • Achievement tracking
  • Faction reputation system
  • Discovery mechanics

Phase 4: Session Management

Upcoming

Play forever

  • Session save/load
  • Context condensing for LLM limits
  • Adventure log export
  • Campaign templates (LOTR, etc.)
  • Generative world building workflows

Phase 5: Platform Features

Future

Community & content

  • Universal RPG system support
  • Content sharing marketplace
  • Mobile companion apps
  • Multiplayer foundation
  • Visual generation integration

// DOCUMENTATION

📖 System Analysis

Comprehensive review of the backend and frontend architecture, capabilities, and integration

Read Analysis →

🗺️ Development Roadmap

Detailed development plan from core systems through platform features

View Roadmap →

🔧 API Reference

Complete documentation for all 135+ MCP tools across CRUD, combat, quests, and more

View API Docs →

🚀 Quick Start Guide

Get started with Quest Keeper AI—both the desktop app and standalone MCP backend

Get Started →

🎨 Design System

Retro-futuristic design language with colors, typography, and UI components

View Style Guide →

[ JOIN THE QUEST ]

Sign up to get notified about releases, updates, and community events