Documentation
User Guide/Plugin System

Plugin System

Enhance your AI character conversations with powerful plugins that add new capabilities and interactive features

Plugin System

The Plugin System transforms how you interact with AI characters by adding specialized capabilities and interactive features to your conversations. Plugins enhance character responses and create immersive experiences that go far beyond basic chat.

What Are Plugins?

Plugins are extensions that modify and enhance your conversations with AI characters. They work behind the scenes to:

  • Shape Character Behavior - Guide how characters respond and interact
  • Add Interactive Elements - Display dynamic content, status panels, and visual feedback
  • Create Specialized Experiences - Enable roleplay scenarios, mood tracking, and themed interactions
  • Enhance Immersion - Add context-aware features that make conversations feel more alive

How Plugins Work

Accessing Plugins

  1. Open any character conversation
  2. Look for the Plugins tab in the chat interface
  3. Browse available plugins and their descriptions
  4. Install and configure plugins to suit your preferences

Plugin Types

The system supports two main types of plugins:

Prompt Enhancement Plugins

These plugins work by influencing how characters think and respond:

  • Add custom instructions to character behavior
  • Guide conversation topics and themes
  • Control response depth and detail level
  • Shape personality expression

Interactive Tool Plugins

These plugins create visual, interactive elements in your conversations:

  • Display character status and mood panels
  • Show inventory systems for roleplay
  • Generate dynamic content like live chat reactions
  • Create themed visual experiences

Custom Prompt Injector

Purpose: Add your own custom instructions to guide character behavior

How it works: You provide specific instructions that get woven into the character's responses naturally. For example, you might instruct a character to "always respond with enthusiasm and ask follow-up questions."

Best for: Tailoring character personality, adding specific behavioral traits

Conversation Guide

Purpose: Help characters actively guide conversations and suggest interesting topics

Configuration Options:

  • Guidance Level: Choose how actively the character leads conversations (Passive, Moderate, Active)
  • Topic Focus: Select preferred conversation themes (Open-ended, Hobbies & Interests, Daily Life, Deep Thoughts)

Best for: Overcoming conversation lulls, exploring new topics

Response Depth Controller

Purpose: Control how detailed and deep character responses should be

Configuration Options:

  • Response Depth: Set detail level (Brief, Standard, Detailed, Thorough)
  • Include Thoughts: Toggle whether characters share internal thoughts and feelings

Best for: Matching conversation style to your preferences

Live Chat Reactions

Purpose: Add livestream-style viewer reactions to dramatic or emotional conversation moments

How it works: During intense or entertaining conversation moments, this plugin generates spontaneous viewer comments that appear as a live chat overlay, creating a sense of audience engagement.

Best for: Adding excitement to roleplay scenarios, creating social atmosphere

Using Plugins Effectively

Getting Started

  1. Start Simple - Begin with one plugin to understand how they work
  2. Read Descriptions - Each plugin explains its purpose and effects
  3. Configure Thoughtfully - Adjust settings to match your conversation style
  4. Experiment - Try different combinations to discover what works best

Plugin Management

  • Enable/Disable: Toggle plugins on or off as needed for different conversations
  • Configure Settings: Customize plugin behavior through their configuration options
  • Mix and Match: Use multiple plugins together for layered experiences

Best Practices

For Casual Conversations

  • Use Custom Prompt Injector to add personality quirks
  • Try Conversation Guide on passive mode to keep chats flowing
  • Set Response Depth Controller to "Standard" for balanced responses

For Roleplay Scenarios

  • Combine Custom Prompt Injector with scene-setting instructions
  • Use Live Chat Reactions for dramatic moments
  • Set Response Depth Controller to "Detailed" with thoughts enabled

For Deep Conversations

  • Configure Conversation Guide to focus on "Deep Thoughts"
  • Use Response Depth Controller on "Thorough" mode
  • Add custom prompts that encourage philosophical discussion

Plugin Configuration Tips

Writing Effective Custom Prompts

  • Be specific about desired behaviors
  • Use examples to illustrate what you want
  • Consider the character's existing personality
  • Keep instructions clear and actionable

Choosing the Right Settings

  • Match Your Mood: Adjust plugins based on what kind of conversation you want
  • Consider Context: Different settings work better for different scenarios
  • Start Conservative: Begin with moderate settings and adjust as needed

Managing Multiple Plugins

  • Avoid Conflicts: Make sure plugin instructions don't contradict each other
  • Layer Gradually: Add plugins one at a time to understand their individual effects
  • Save Configurations: Remember settings that work well for future use

Advanced Usage

Creating Themed Experiences

Combine plugins to create specific conversation atmospheres:

Cozy Chat Setup:

  • Custom Prompt: "Respond in a warm, comforting manner"
  • Conversation Guide: Passive mode, Daily Life focus
  • Response Depth: Standard with thoughts enabled

Adventure Roleplay Setup:

  • Custom Prompt: "You're on an epic quest together"
  • Live Chat Reactions: Enabled for dramatic moments
  • Response Depth: Detailed for immersive descriptions

Deep Discussion Setup:

  • Conversation Guide: Active mode, Deep Thoughts focus
  • Response Depth: Thorough with thoughts enabled
  • Custom Prompt: "Engage with philosophical questions thoughtfully"

Troubleshooting Common Issues

Plugin Not Working As Expected:

  • Check if plugin is enabled
  • Review configuration settings
  • Try disabling other plugins to isolate effects

Conflicting Plugin Effects:

  • Disable plugins one by one to identify conflicts
  • Adjust settings to make plugins work together
  • Use fewer plugins if effects seem muddled

Character Behavior Changed Too Much:

  • Reduce response depth settings
  • Use more conservative custom prompts
  • Switch conversation guide to passive mode

Creating Your Own Plugins

Beyond using existing plugins, you can now create your own custom plugins to bring unique ideas to life. The plugin creation system lets you build personalized enhancements that match your exact needs.

Getting Started with Plugin Creation

  1. Navigate to the Plugins tab in any character conversation
  2. Click the Create Plugin button
  3. Choose your plugin type and follow the guided creation process
  4. Test your plugin with the built-in preview system
  5. Save and start using your custom creation immediately

Plugin Creation Types

Custom Prompt Plugins

Create plugins that inject specific instructions into character responses:

What you can build:

  • Character personality modifiers
  • Roleplay scenario setters
  • Conversation style guides
  • Theme or mood controllers

Example Ideas:

  • A "Detective Mode" plugin that makes characters respond like they're solving mysteries
  • A "Storyteller" plugin that encourages characters to weave narratives into responses
  • A "Therapist Assistant" plugin for supportive, reflective conversations

Interactive Tool Plugins

Build visual, interactive elements that appear in conversations:

What you can build:

  • Status displays and dashboards
  • Interactive character sheets
  • Visual feedback systems
  • Dynamic content generators

Example Ideas:

  • A mood tracker that shows character emotional state
  • An RPG-style character stats display
  • A relationship progress tracker
  • A visual story timeline

Plugin Creation Process

Step 1: Basic Information

  • Plugin Name: Choose a descriptive name for your creation
  • Description: Explain what your plugin does (optional but recommended)
  • Plugin Type: Select between Prompt Injection or Interactive Tool

Step 2: Configuration

For Prompt Plugins:

  1. Write Your Template: Create the prompt text using variables like {{char}} for character name, {{user}} for your name
  2. Add Variables: Define custom settings users can configure (text inputs, dropdowns, checkboxes)
  3. Set Defaults: Provide sensible default values for all variables

For Tool Plugins:

  1. Define Parameters: Specify what information the AI should provide to your tool
  2. Create HTML Template: Design how the information should be displayed using {{parameterName}} syntax
  3. Add CSS Styling: Customize the visual appearance (optional)

Step 3: Testing and Preview

  • Use the Preview button to test your plugin with sample data
  • Adjust character and user names to see how variables work
  • Modify templates and settings until you're satisfied with the results

Template System Guide

Using Variables in Prompts

As {{char}}, you should {{behaviorStyle}} and always {{responsePattern}}.
When {{user}} asks about {{topicType}}, respond with {{detailLevel}} information.

HTML Templates for Tools

<div class="character-mood">
  <h3>{{char}}'s Current Mood</h3>
  <div class="mood-indicator">{{moodLevel}}</div>
  <p>{{moodDescription}}</p>
</div>

Adding Interactive Elements

  • Use {{parameterName}} to display AI-provided data
  • Structure content with HTML for better organization
  • Apply CSS classes for consistent styling

Advanced Plugin Features

Variable Types

  • Text Input: For short, single-line values
  • Multi-line Text: For longer descriptions or prompts
  • Dropdown Select: For predefined choice options
  • Checkbox: For yes/no or enable/disable settings

Parameter Configuration

  • String Parameters: For text-based AI responses
  • Number Parameters: For numeric values or ratings
  • Boolean Parameters: For true/false conditions

Best Practices for Plugin Creation

  1. Start Simple: Begin with basic functionality before adding complexity
  2. Test Thoroughly: Use the preview system to verify your plugin works as expected
  3. Write Clear Descriptions: Help other users understand what your plugin does
  4. Use Meaningful Variable Names: Make templates easy to understand and modify
  5. Provide Good Defaults: Choose sensible default values that work out of the box

Sharing and Managing Your Plugins

Personal Plugin Library

  • All your created plugins appear in your personal plugin collection
  • Edit existing plugins to refine functionality
  • Delete plugins you no longer need
  • Each plugin can be used across all your conversations

Plugin Management

  • Edit: Modify existing plugins to improve or change functionality
  • Preview: Test changes before saving
  • Delete: Remove plugins you no longer want
  • Enable/Disable: Control which plugins are active in each conversation

Creative Plugin Ideas to Inspire You

Conversation Enhancers

  • Accent Plugin: Makes characters speak with specific regional accents
  • Era Plugin: Sets characters to respond as if from different time periods
  • Expertise Plugin: Temporarily gives characters specialized knowledge

Interactive Experiences

  • Adventure Tracker: Shows current quest status and inventory
  • Relationship Meter: Displays connection level and recent interactions
  • Story Branch Visualizer: Maps conversation choices and their consequences

Productivity Tools

  • Learning Assistant: Tracks topics covered and suggests review questions
  • Goal Tracker: Monitors progress toward personal objectives
  • Decision Helper: Weighs pros and cons of choices discussed

The Future of Plugins

The plugin system represents a new frontier in AI character interaction. With the ability to create your own plugins, you're not just using the platform - you're actively shaping its evolution and discovering new possibilities for AI character engagement.

Each plugin you create contributes to a growing ecosystem of user-generated enhancements. As you experiment with different concepts and share innovative ideas, you're helping to define the future of AI character interaction.


Ready to enhance your conversations? Start by exploring existing plugins, then try creating your own custom plugin to bring your unique ideas to life. The only limit is your imagination.

Plugin System | Documentation | Reverie