User Guide

Welcome to the NPC AI Platform! This guide will help you get started with the core features of the application and master the art of creating living, breathing characters.

Table of Contents

• 1. Managing Campaigns
• 2. Creating & Managing NPCs
• 3. Interacting with Your NPCs
• 4. Advanced Lore & Memory
• 5. The Community Hub
• 6. Pro Tips & Best Practices

1. Managing Campaigns

Campaigns are the containers for your worlds. Every NPC you create must belong to a campaign. This is the first step in building your story.

Creating a Campaign

On your main dashboard, you'll find the "Create a New Campaign" form. Simply provide a name and an optional description for your world. You can also upload a custom cover image to give your campaign a unique visual identity.

2. Creating & Managing NPCs

Once you select a campaign, you will be taken to its NPC Library. This is where all the characters for that specific world live.

The NPC Creator

Clicking "Create New NPC" opens the creator form, where you define the soul of your character.

Core Identity & Personality

Define the basics like Name, Race, Appearance, and Voice. More importantly, define their Goals, Secrets, and Personality Archetypes (Essence vs. Facade). These are not just flavor text—they are the core instructions the AI will use to guide the NPC's behavior and dialogue.

Managing Inventory

The "Personal Inventory" section is where you equip your NPC. This is a crucial part of their identity and memory.

• To Add an Item: Type the item's name into the input field (e.g., "Rusty Key" or "Health Potion") and click the "Add" button.
• To Remove an Item: A list of current items will be displayed. Simply click the "Remove" button next to any item to delete it from their inventory.
• In-Chat Changes: Be aware that the AI can also add or remove items from its own inventory during a conversation based on your interactions!

3. Interacting with Your NPCs

The chat interface is where your creations come to life. You can speak to your NPCs using either voice or text.

The DM's Insight Engine

This is one of the most powerful tools at your disposal. Every time an NPC speaks, an eye icon (👁️) will appear next to their dialogue. Clicking this icon reveals the NPC's true thoughts, feelings, or hidden motivations behind what they just said. Use this to guide your roleplaying and stay one step ahead of your players.

Voice Integration

Toggle the microphone icon to enable voice chat with your NPCs. Speak naturally and the AI will respond in character. You can also enable voice output to hear your NPCs speak using ElevenLabs AI voices that match their personality.

Exporting Conversations

Use the export button in any chat session to download a complete PDF record of your conversation, including hidden DM insights and inventory changes. Perfect for session notes and campaign records.

4. Advanced Lore & Memory

Give your NPCs a deep connection to your world with advanced knowledge management tools, accessible from the NPC Library.

• Lore Locks: These are unbreakable, campaign-wide truths. Facts entered here (e.g., "The King is secretly a dragon") MUST be followed by every NPC in the campaign, ensuring consistency.
• Lore Documents: Upload a text or PDF file containing specific knowledge for a single NPC. This is perfect for giving a historian deep knowledge of ancient ruins or a guard captain detailed information about a recent crime.
• Memory Ledger: This is the NPC's personal diary. At the end of a chat session, the AI can generate a summary of what it learned, or you can add manual entries. These memories directly influence future conversations.
• Session Summaries: Generate comprehensive session summaries that compile all memories and key interactions with an NPC. Click "Generate Summary" on any NPC card to create a downloadable PDF report perfect for campaign records.

Exporting & Documentation

Keep detailed records of your campaigns with our built-in export features.

• Conversation Export: In any chat session, use the export button to download the full conversation as a PDF, including NPC thoughts and inventory changes.
• Session Summary Export: Generate and download comprehensive session summaries from the NPC Library that include character details, recent memories, and interaction history.

6. Pro Tips & Best Practices

• Start with Goals & Secrets: The most memorable NPCs have clear motivations and hidden depths. Define what they want and what they're hiding.
• Use Lore Locks Sparingly: Only lock in the most important world rules. Too many locks can make NPCs feel rigid.
• Regular Memory Updates: After important sessions, add key memories to your NPCs' ledgers to ensure they remember crucial events.
• Export for Records: Use session summaries and conversation exports to keep detailed campaign records. Great for tracking plot threads.
• Voice for Immersion: Enable voice output during important dramatic moments to enhance the emotional impact of key scenes.

7. The Community Hub

The Community Hub is where you can share your creations and discover NPCs made by other users.

• Share to Hub: In your NPC Library, click the "Share to Hub" button on any NPC card to make it public for others to see and use.
• Clone to My Library: On the Templates page, you can browse public NPCs. Clicking "Clone to My Library" will create a private copy of that NPC in one of your own campaigns, which you can then modify and use freely.