# 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](/story/basics/interactive-blocks.md)

***

*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="/files/NXdXOKbcARtnzdp1wq3f">/files/NXdXOKbcARtnzdp1wq3f</a></td><td></td><td><a href="/pages/7aUFmnCMx9m4smGncsXL">/pages/7aUFmnCMx9m4smGncsXL</a></td></tr><tr><td><strong>Systems</strong></td><td>The systems that make up <strong>Story</strong>.</td><td><a href="/files/r5hxBu9SBUhBTLbdGfSg">/files/r5hxBu9SBUhBTLbdGfSg</a></td><td></td><td><a href="/pages/Xk5S0HSZKnMdouFOHq68">/pages/Xk5S0HSZKnMdouFOHq68</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="/files/S5qtbUC6tiNyPSGRhVRa">/files/S5qtbUC6tiNyPSGRhVRa</a></td><td></td><td><a href="/pages/FOYfxAbq7m5sxrPzywIh">/pages/FOYfxAbq7m5sxrPzywIh</a></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://story-2.gitbook.io/story/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.