An immersive RPG extension for browsers that tracks character stats, scene information, and character thoughts in a beautiful, customizable UI panel. All automated! Works with any preset. Choose between Together or Separate generation modes for context and generation control.
- Fixed the bugs in the encounter system where you couldn't use the buttons after performing any custom action.
- Improved combat actions and made them dynamic, depending on the current situation.
- Added Russian as a supported language.
Special thanks to all the other contributors for this project: Paperboygold, Munimunigamer, Subarashimo, Lilminzyu, Claude, IDeathByte, Chungchandev, Joenunezb, Amauragis, and Tomt610.
-
Open SillyTavern
-
Go to the Extensions tab (cubes icon at the top)
-
Go to Install extension
-
Copy-paste this link: https://github.com/SpicyMarinara/rpg-companion-sillytavern
-
Press Install for all users/Install just for me
- 📊 User Stats Tracker: Fully customizable stats with visual progress bars, custom status fields, skills section, and dynamic inventory management
- 🌍 Info Box Dashboard: Configurable widgets for date, weather, temperature, time, location, and recent events
- 💭 Present Characters Panel: Track multiple characters with custom fields, relationship badges, character-specific stats, and internal thoughts
- 🎭 Floating Thought Bubbles: Optional thought bubbles positioned next to character avatars in chat
- 🎲 Classic RPG Stats: STR, DEX, CON, INT, WIS, CHA attributes with dice roll support
- 📦 Advanced Inventory System: Multi-location storage (On Person, Stored locations, Assets) with v2 format
- 🎯 Character Stats: Track health, energy, or any custom stats for each present character with color interpolation
- 📜 Immersive HTML: Enhance the immersion by including creative HTML/CSS/JS elements in your roleplay
- ➡️ Plot Progression: Progress the plot with randomized events or natural progression with a click of a button
- 🎨 Multiple Themes: Cyberpunk, Fantasy, Minimal, Dark, Light, and Custom themes
- ✏️ Live Editing: Edit all tracker fields directly in the panels with auto-save
- 💾 Per-Swipe Data Storage: Each swipe preserves its own tracker data
- 🎛️ Tracker Configuration: Customize every aspect of trackers - add/remove stats, fields, widgets, and more
- 🔄 Swipe Detection: Automatically handles swipes and maintains correct tracker context
- 📝 Context-Aware: Weather, stats, and character states naturally influence the narrative
- 🎭 Multiple Characters: Tracks thoughts, relationships, and stats for all present characters
- 📍 Thought Bubbles in Chat: Optional floating thought bubbles positioned next to character avatars
- 🌈 Customizable Colors: Create your own theme with custom color schemes
- 📱 Mobile Support: Responsive design with horizontal scrolling for stats
- 🔧 Advanced Configuration: Add custom stats, fields, and widgets through Tracker Settings
- 🎨 Color Interpolation: Stats smoothly transition from low to high colors based on values
- 💬 Multi-line Format: Clean, structured format for AI generation and parsing
- 🧹 Auto-cleanup: Automatically removes placeholder brackets from AI responses
- Allow users to use a different model for the separate trackers generation
- Panel Position: Left or Right side of the chat
- Theme: Choose from 6 built-in themes or create a custom
- Auto-update after messages: Automatically refresh RPG data after each message
- Context Messages: How many recent messages to include when generating updates (only for Separate generation mode)
- Show User Stats: Display the character stats panel
- Show Info Box: Display the scene information panel
- Show Character Thoughts: Display the AI character's internal thoughts
Tracker data is generated within the main AI response and automatically extracted:
Example: User: walks into the tavern
AI: Trackers + Full roleplay response
↓ Extension extracts tracker data from the response
↓ Displays in sidebar panels
↓ Main chat shows clean roleplay text
Pros:
- Single API call
- Faster response
- Simpler setup
Cons:
- Tracker formatting mixed in AI response
- May affect roleplay quality slightly
Tracker data is generated in a separate API call after the main response:
Example: User: walks into the tavern
AI: Pure roleplay response - no tracker data
AI: Separate call with just the tracker data
↓ Extension sends a separate request with context
↓ AI generates only tracker data
↓ Displays in sidebar panels
↓ Context summary injected into the next generation
Pros:
- Clean roleplay responses
- Better roleplay quality
- Contextual summary enhances immersion
Cons:
- Extra API call
- Slightly slower
- Use main chat model: Use the same model as your chat (recommended)
- Custom model selection (coming soon)
- Enable the extension in the Extensions tab
- Choose your generation mode: Together or Separate
- Select which panels to display (User Stats, Info Box, Character Thoughts)
- Start chatting! The tracker updates automatically
You can edit most fields by clicking on them:
- User Stats: Click on stat percentages, mood emoji, status fields, skills, inventory items, or quests
- Info Box: Click on date fields, weather, temperature, time, location, or recent events
- Present Characters: Click on character emoji, name, custom fields, relationship badge, or stats
- Thought Bubbles: Click on thought text to edit (bubble will refresh to maintain positioning)
Access comprehensive customization through the Tracker Settings button:
User Stats Configuration:
- Add/remove custom stats with unique names
- Configure Status section (mood emoji + custom fields)
- Configure Skills section with custom skill fields
- Toggle RPG attributes display
Info Box Configuration:
- Enable/disable individual widgets (Date, Weather, Temperature, Time, Location, Recent Events)
- Choose temperature unit (Celsius/Fahrenheit)
Present Characters Configuration:
- Add custom character fields (appearance, action, demeanor, etc.)
- Configure relationship status options
- Enable character-specific stats tracking
- Customize thought bubble label and description
- All fields are dynamically generated in prompts
The extension fully supports swipes:
- Each swipe stores its own tracker data
- Swiping loads the data for that specific swipe
- New swipe generation uses the committed data from before the swipe
- User edits are preserved across swipes
You can click the "Refresh RPG Info" button in the settings to refresh the RPG data at any time in separate generation mode.
This extension detects when a "guided generation" prompt is submitted (for example, via the GuidedGenerations extension which injects an ephemeral instruct prompt), and will avoid adding its tracker injection instructions (requests for stats, info box, and context prompts) to the generation context. This prevents conflicting instructions and ensures guided generations behave as the user expects.
If you want tracker prompts to apply during a guided generation, run the update via separate generation or temporarily disable guided generation in the other extension.
There is a new setting "Skip Tracker & HTML Injections during Guided Generations" in the RPG Companion settings (Advanced section). It now supports three modes:
- none: never skip (always inject the tracker prompts as usual, default)
- impersonation: only skip when an impersonation-style guided generation is detected
- guided: skip whenever a guided
instructorquiet_promptgeneration is detected
Choose from 6 beautiful themes:
- Cyberpunk: Neon pink and cyan with futuristic vibes
- Fantasy: Purple and gold with mystical aesthetics
- Minimal: Clean monochrome design
- Dark: Deep blacks and subtle accents
- Light: Bright and airy interface
- Custom: Create your own with custom colors
If you ever have an awesome idea to do your own SillyTavern extension, don't.
- Refresh your browser
- Restart SillyTavern
- Ensure it's enabled in the Extensions tab
- Check that "Auto-update" is enabled
- Try clicking "Manual Update" to test
- Verify your AI backend is responding correctly
- Check console for error messages
- Try refreshing the page
- Check if other extensions are conflicting
- Verify CSS is loading correctly
- Bubbles use a fixed 350px width for consistent positioning
- Bubbles refresh after edits to maintain alignment
- If issues persist, try toggling the Character Thoughts display
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
Copyright (C) 2024 marinara_spaghetti
If you enjoy this extension, consider supporting development:
Contributors: SpicyMarinara, Paperboygold, Munimunigamer, Subarashimo, Lilminzyu, Claude, IDeathByte, Chungchandev, Joenunezb, Amauragis, and Tomt610.
- Support for selecting a different model for RPG updates
- Context Messages: Start with 4 messages and adjust based on your needs. More messages = better context, but slower updates
- Performance: If updates are slow, consider reducing the context depth or using a faster model
- Customization: You can modify the prompts in index.js to add your own stat categories or change the format
- Requires SillyTavern 1.11.0 or higher
- Works with all AI backends (OpenAI, Claude, KoboldAI, etc.)
Made with ❤️ by Marinara
PS I'm looking for a job or a sponsor to fund my custom AI frontend, contact me if interested: mgrabower97@gmail.com