What it is
GameMaster is a Discord bot that runs live tabletop RPG sessions as a virtual GM. It uses Retrieval Augmented Generation (RAG) to understand the Cypher System rules from uploaded rulebooks, maintains campaign state in SurrealDB, and generates narrative content through the MiniMax LLM — all in real time through Discord.
The target system is Monte Cook’s The Strange, with the Cypher System mechanics underneath. Players roll d20 + modifiers against difficulty, the GM applies intrusion and handles the fiction. The bot handles the mechanical overhead so the GM can focus on the story.
How it works
Training: Upload rulebook PDFs and other source material. The system extracts text, chunks it, and stores embeddings in Chroma. When a game session runs, relevant rules are retrieved and fed into the LLM prompt so it applies the right mechanics.
Sessions: The Discord bot manages the game flow — player rolls, GM intrusions, character state. The web UI handles campaign management, training, and testing. Sessions run through WebSocket streaming so narrative content appears in Discord as it’s generated.
Campaign structure: Hooks → Threads → Adventures, with a hierarchical narrative model that lets you prep a setting and have the AI fill in the connective tissue.
Architecture
- Discord bot: discord.js, handles commands and chat
- Fastify backend: REST API + WebSocket for streaming responses
- React frontend: Campaign management, training UI, testing interface
- Chroma: Vector store for RAG document retrieval
- SurrealDB: Campaign data, character state, session history
- MiniMax: LLM for narrative generation and rule application
Status
Active development. Core session loop works end-to-end. The main open work is completing the Discord slash command implementation, persisting guild configuration to SurrealDB, and finishing the training hub UI. See the project for the full roadmap.
No public release yet.