Important
📦 This repository is archived.
StoryMC has been superseded by story-forged, a NeoForge mod that replaces this Paper plugin as the Minecraft frontend of the Story platform. Development moved there because the platform outgrew what a server-side plugin can do: story-forged ships both a server mod and a client mod, giving us custom entities and renderers, client-side HUDs (health, needs, skill checks), camera control for cinematics, and a first-class inventory/item pipeline.
This repo remains available read-only as a reference for the original monolith design. No further releases, fixes, or support.
A Kotlin-based Paper plugin that transformed Minecraft into a living, narrative-driven world through AI-integrated NPCs and voice synthesis.
Fully stable as a Human-in-the-loop (HITL) orchestration tool. It provides a robust narration engine and NPC framework managed by a human Game Master.
StoryMC started as a standalone monolith: one Paper plugin doing dialogue, memory, voice, scheduling, and world logic. That architecture served its purpose and is preserved here, but the platform has since been decomposed into dedicated services, with Minecraft demoted to just one possible frontend:
┌───────────────────────┐ ┌───────────────────────┐
│ story-forged │ │ Other frontends │
│ (NeoForge mod, │ │ (web viewer, ...) │
│ client + server) │ │ │
└──────────┬────────────┘ └──────────┬────────────┘
│ gRPC / protobuf │
▼ ▼
┌─────────────────────────────────────────────────────┐
│ story-go — orchestrator & director │
│ (intents, events, LLM brains, narrative direction) │
└──────────────────────────┬──────────────────────────┘
│ NATS
▼
┌─────────────────────────────────────────────────────┐
│ story-sim — autonomous simulation engine (Rust) │
│ (HTN planning, needs, behaviors, Lua authoring) │
└─────────────────────────────────────────────────────┘
What this plugin did on its own is now split across that stack, and the roadmap items listed below (external simulation, autonomous agents, semantic memory) became the successor's foundation rather than experiments.
Everything below is the original README, kept for historical reference.
Story is a production-ready Minecraft plugin that enables Dungeon Masters to create immersive narrative experiences with AI-powered NPCs. It allows facilitating D&D-style campaigns with persistent character memory, dynamic dialogue generation, and realistic voice synthesis.
- LLM-Powered Dialogues. NPCs generate contextually-aware responses using language models
- Voice Synthesis. Character-specific voices via ElevenLabs integration
- Persistent Memory. NPCs remember conversations, relationships, and story events
- Rich Character System. Complex personalities, backstories, relationships, and lore
- Location Awareness. NPCs understand their environment and react accordingly
- Multi-Player Support. Handle concurrent conversations across multiple players
- Character Schedules. NPCs follow daily routines and autonomous behaviors
- Plugin Ecosystem. Integrates with Citizens, MythicMobs, and other popular plugins
Warning
Provided as-is for historical reference. No support is offered for new installations — the actively developed successor is story-forged.
- Minecraft 1.21.1
- Paper 1.21.1
- Java 21
- OpenRouter API key (for LLM integration)
- ElevenLabs API key (for voice synthesis) (optional)
- Citizens - NPC management
- MythicMobs (optional) - Advanced mob behaviors
- PlaceholderAPI (optional)
- DecentHolograms (optional)
- ItemsAdder (optional)
- RealisticSeasons (optional)
- ReviveMe (optional)
- TheNewEconomy (optional)
- SuperVanish (optional)
- BetterHealthBar (optional)
Click here to get started.
┌─────────────────────────────────────┐
│ Minecraft Server (Paper) │
│ ┌───────────────────────────────┐ │
│ │ Story Plugin (Kotlin) │ │
│ │ ┌─────────────────────────┐ │ │
│ │ │ Character System │ │ │
│ │ │ - Personalities │ │ │
│ │ │ - Relationships │ │ │
│ │ │ - Memories │ │ │
│ │ └─────────────────────────┘ │ │
│ │ ┌─────────────────────────┐ │ │
│ │ │ Lores & Locations │ │ │
│ │ │ - Keywords & Context │ │ │
│ │ └─────────────────────────┘ │ │
│ │ ┌─────────────────────────┐ │ │
│ │ │ LLM Integration │ │ │
│ │ │ (OpenRouter API) │ │ │
│ │ └─────────────────────────┘ │ │
│ │ ┌─────────────────────────┐ │ │
│ │ │ Voice Synthesis │ │ │
│ │ │ (ElevenLabs) │ │ │
│ │ └─────────────────────────┘ │ │
│ └───────────────────────────────┘ │
└─────────────────────────────────────┘
- Player Interaction: Player speaks in proximity to an NPC
- Context Building: System gathers character personality, recent memories, location data
- LLM Generation: OpenRouter API generates contextually-appropriate response
- Voice Synthesis: ElevenLabs converts text to character-specific voice
- Response Delivery: Audio and text delivered to players
- Memory Update: Conversation stored for future context
Run D&D-style adventures with persistent NPC characters who remember player actions and develop relationships over time.
Create settlements with NPCs that have daily schedules, relationships, and goals - making the world feel alive even when not directly interacting.
Let NPCs drive emergent narratives based on player choices and actions, rather than following predetermined scripts.
Facilitate creative roleplay with AI-powered characters that stay in character and respond contextually.
This repository is archived and unsupported. For the actively developed successor:
- Discord: Discord Server
This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0) License.