A living Pathfinder / D&D 3.5 text world—and the engineering ecosystem behind it.
Enter a persistent realm. Explore its lore. Help build what comes next.
LuminariMUD is a persistent, text-based multiplayer RPG built on the tbaMUD/CircleMUD tradition and powered by a modern GNU C23 server. Its deep rules engine brings Pathfinder and D&D 3.5 mechanics into a shared world of exploration, combat, storytelling, crafting, building, and community.
But the game server is only the heart of the story.
The LumiVerse is a connected, multi-product software ecosystem: native and browser clients, real-time protocols, cross-world and Discord gateways, spatial world-building tools, graph-powered lore intelligence, and a full community website and wiki—all maintained by a very small volunteer team.
Small team. Vast undertaking. The LumiVerse resembles a substantial mid-sized product ecosystem, unquestionably serious engineering and operations all open-source / community-driven.
| System | Role in the LumiVerse |
|---|---|
🏰 Luminari-Source   |
The realm itself. A roughly 446,000-line C/header game server with more than 16,000 commits, Pathfinder and D&D 3.5 systems, persistent world data, builders' tools, MariaDB-backed services, and decades of history. |
🧭 LuminariGUI   |
The adventurer's cockpit. A rich Mudlet interface with live MSDP vitals, interactive mapping, tabbed chat, spell and affect tracking, group status, sound alerts, and a customizable layout. |
🌐 luminariweb   |
The browser gateway. A first-party React client with an MSDP-driven HUD, accessible terminal experience, PWA capabilities, and a secure WebSocket-to-Telnet proxy. Launch it → |
🔮 Intermud3   |
The road between worlds. An independent Python I3 gateway with MudMode/LPC framing, router state, network services, observability, and JSON-RPC APIs integrated directly with the C server. |
💬 discord-mud-chat   |
The community bridge. Bidirectional MUD ↔ Discord chat with channel mapping, reconnects, rate limiting, mention safety, logging, health checks, and container-ready operations. |
🗺️ wildeditor   |
The cartographer's workshop. A full-stack wilderness editor for drawing regions and paths against the game's spatial database, with strict shared types, validation, authentication boundaries, REST APIs, MCP tools, and an optional AI assistant. |
📚 Sage   |
The living library. A production-oriented GraphRAG lore platform combining PostgreSQL/pgvector, Neo4j, knowledge graphs, validation workflows, APIs, agents, and MCP to make the world's canon discoverable. |
✨ Website & community tooling (private)  |
The front door. The full Astro-powered LuminariMUD.com experience, wiki, project presentation, and community-facing services. |
flowchart TB
Players((Players & Builders))
Website[Website + Wiki]
GUI[LuminariGUI]
Web[luminariweb]
Core[Luminari-Source<br/>C23 Game Server]
Discord[Discord Bridge]
I3[Intermud3 Gateway]
Editor[Wildeditor]
World[(Spatial World DB)]
Sage[Sage GraphRAG]
Players --> Website
Players --> GUI
Players --> Web
GUI -->|Telnet + MSDP| Core
Web -->|WebSocket → Telnet| Core
Discord <-->|Bidirectional chat| Core
I3 <-->|JSON-RPC integration| Core
Editor <-->|World authoring| World
World <--> Core
Sage <-->|Lore, APIs + MCP| Website
Sage -->|World knowledge| Players
| ⚔️ Play | 🧭 Adventure with Mudlet | 🛠️ Build |
|---|---|---|
| Jump straight into the browser client, or begin at LuminariMUD.com. | Install LuminariGUI for mapping, live gauges, chat tabs, spell tracking, and more. | Start with the server's onboarding checklist, then choose the layer that calls to you. |
The LumiVerse has room for C hackers, world builders, frontend engineers, Python developers, lorekeepers, testers, technical writers, artists, operators, and curious players.
- 🗡️ Find your quest: browse the open issues across the organization.
- 📜 Read the map: every public project keeps its own setup, architecture, testing, and contribution guidance close to the code.
- 🏗️ Build the world: begin with Luminari-Source, Wildeditor, or the builder quickstart.
- 🔭 Explore the whole ecosystem: visit the LuminariMUD repositories.
One persistent world · Eight connected systems · Countless stories still unwritten
