# Introduction

{% hint style="warning" %}
This website is work in progress and does not show all the features of Story.
{% endhint %}

## **Story Plugin - AI-Powered Co-DM Assistant**

Transform your Minecraft server into a living, breathing world with AI assistance for dynamic conversations, intelligent NPC responses, and immersive world-building. Story acts as your co-DM, handling the narrative heavy lifting while you focus on the bigger picture.

### **What Story Does**

**🎭 Intelligent NPCs**

* Characters with unique personalities and memories
* Context-aware conversations that reference your world's lore
* NPCs remember players and build relationships over time
* Dynamic responses based on current events and player actions

**🗺️ Living World**

* Create rich locations with detailed history and current events
* AI generates context based on your world's existing lore
* Locations connect to NPCs, factions, and ongoing storylines
* Easy in-game location creation with `/story location create`

**📜 Narrative Assistance**

* AI-generated NPC responses and dialogue
* Context-aware conversations that reference your world's lore
* Co-DM support for dynamic storytelling and quest management
* Seamless integration with your existing world and storylines

**🎤 Voice Integration**

* Realistic voice generation for NPCs using ElevenLabs
* Character-specific voices and emotional tones
* Configurable voice settings and audio controls

### **Quick Start for Server Admins**

1. **Install the plugin** in your PaperMC server
2. **Configure API keys** in `config.yml` (OpenRouter + ElevenLabs)
3. **Create your first location**: `/story location create Lannisport "A bustling trade city"`
4. **Watch NPCs come alive:** `/locinitnpcs "Lannisport" "Generate 5 Lannisport commonfolk NPCs. Game of Thrones. House Lannister. Westerosi people." 5` 

### **Key Features**

* **Co-DM Assistant** - AI handles NPC dialogue and conversation flow
* **Seamless Integration** - Works with Citizens, MythicMobs, and other plugins
* **Persistent World** - NPCs and locations remember everything
* **Web Interface** - Manage your world through the Streamlit dashboard
* **Narrative Support** - Helps with worldbuilding and story consistency

### **Perfect For**

* **Dungeon Masters** - Get AI assistance with NPC dialogue and world consistency
* **Roleplay Servers** - Create immersive, living worlds with narrative support
* **World Builders** - Rich location creation and lore management tools

***

**Ready to get AI assistance for your Minecraft world?** [View on GitHub](https://github.com/canefe/Story) | [Get Started with Locations](https://story-2.gitbook.io/story/basics/interactive-blocks)

***

*Story acts as your co-DM, handling NPC dialogue and narrative consistency so you can focus on creating amazing experiences for your players.*

### Jump right in

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Basics</strong></td><td>Learn the basics of Story</td><td><a href="https://2083711255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6MdJHrhbqkYDSC1bN0fX%2Fuploads%2FEx0LYmvMah0jn6NTWGeP%2FUntitledvideo-MadewithClipchamp11-ezgif.com-optimize.gif?alt=media&#x26;token=1783dcbb-aa02-4fba-b327-f32b6bbba385">Untitledvideo-MadewithClipchamp11-ezgif.com-optimize.gif</a></td><td></td><td><a href="basics">basics</a></td></tr><tr><td><strong>Systems</strong></td><td>The systems that make up <strong>Story</strong>.</td><td><a href="https://2083711255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6MdJHrhbqkYDSC1bN0fX%2Fuploads%2F1cpeE1uxmRBNxQ03t70G%2FScreenshot%202025-05-02%20162228.png?alt=media&#x26;token=2ac85d44-4989-4057-b230-82b9bcbcc807">Screenshot 2025-05-02 162228.png</a></td><td></td><td><a href="systems">systems</a></td></tr><tr><td><strong>Showcase</strong></td><td>Check out images and gifs showing the previous and current state of <strong>Story</strong>!</td><td><a href="https://2083711255-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6MdJHrhbqkYDSC1bN0fX%2Fuploads%2FJS66SlpiY3WJwl9VUGVv%2FScreenshot%202025-05-23%20144914.png?alt=media&#x26;token=aa2af7f7-516c-4878-adab-4927b8835cfe">Screenshot 2025-05-23 144914.png</a></td><td></td><td><a href="showcase">showcase</a></td></tr></tbody></table>