LLMRPG - Python Modules for LLM VTT environment

LLMRPG Framework

A modular, AI-driven tabletop role-playing engine built entirely in Python.

LLMRPG is a fully offline framework that turns a large language model (LLM) into a self-contained Game Master. It combines classic RPG simulation rules with modern procedural generation to create open-ended campaigns, worlds, and encounters — all controllable directly from chat.

Core Features

🧠 AI-Integrated Rule Engine: Supports both AD&D 2E and D&D 5E combat, initiative, and encounter logic.

🎲 Modular Dice & Combat System: True dice-based rolls with configurable modifiers and variant house rules.

🌍 Procedural World Generator: Builds overland and dungeon maps from node-based coordinate graphs with Gygaxian stocking tables.

🕰️ Dynamic World Simulation: Tracks time, weather, travel, encounters, and morale.

🧾 Character & Party Tracker: Stores PC sheets, inventory, spell points, buffs, and conditions — importable from JSON, TXT, or DOCX.

🧩 Campaign-Agnostic Design: Works with any setting or rule adaptation; swap in your own modules or data tables.

⚙️ Extensible Python Modules: Everything runs through a clean modular architecture (llmrpg_*), easy to extend or replace.

💾 Persistent State: Saves the world map, party, and tracker state between sessions.

Included Launchers

llmrpg_start_5e.py — quick-start for D&D 5E rules.

llmrpg_start_2e.py — quick-start for AD&D 2E rules.

llmrpg_guide_start.py — tutorial / lazy-init version for sandbox play.

Use Cases

Solo or cooperative tabletop sessions.

Text-based campaigns directly in chat or terminal.

A foundation for AI-augmented VTTs and procedural storytelling systems.