Use the Extensions tab to enable/disable
the RPG Companion extension entirely
Enable User Stats that track your persona's statistics, mood, attributes, skills, etc.
Display location, time, weather, and recent events.
Display character portraits with their current thoughts and status.
Display character thoughts as overlay bubbles next to their messages.
Track items carried, clothing worn, stored items, and assets.
Manage main and optional quests with objectives.
Display lock/unlock icons on tracker items to prevent AI from modifying them.
Display a toggle button to enable/disable HTML formatting in messages.
Display a toggle button to enable/disable colored dialogue formatting.
Display a toggle button to enable/disable special formatting of lies and deceptions crafted by the model, allowing it to easily track whenever one was committed, without showing it to the user.
Display a toggle button to enable/disable "Choose Your Own Adventure" formatting instruction that makes the model produce five possible actions/dialogues for you to choose from at the end of the output.
Display Spotify music player with AI-suggested scene-appropriate tracks.
Display a toggle button to enable/disable animated weather effects.
Display weather effects behind the chat (standard behavior).
Display weather effects in front of the chat (experimental).
Display a toggle button to enable/disable narrator mode (infer characters from context).
Display a toggle button to automatically generate avatars for characters without images.
Display button for AI-generated random plot progression prompts.
Display button for context-aware narrative continuation prompts.
Display button to initiate interactive combat encounters.
Display the "Last Roll" indicator in the panel
Mobile Button Widgets
Show compact info widgets around the floating button on mobile. Widgets are positioned automatically.
Master toggle to show info widgets around the mobile floating button.
Desktop Collapsed Strip Widgets
Show compact info widgets in the collapsed panel strip on desktop. Displays stats vertically without needing to expand the panel.
Shows widgets in the collapsed panel strip for quick access to stats.
Advanced
Together: Adds RPG
tracking to main roleplay. Separate: Generates RPG data separately (manual or auto).
External API
Configuration
OpenAI-compatible
endpoint (e.g., OpenAI, OpenRouter, local LLM server)
Your API key for
the external service
Model identifier
(e.g., gpt-4o-mini, claude-3-haiku, mistral-7b)
Number of recent messages
to include (Separate/External mode)
Automatically refresh RPG info after each message.
Number of recent messages to include in combat initialization.
Save detailed combat logs to file for future reference and analysis.
When set, the extension will not inject tracker prompts, examples, or HTML instructions according to
the selected mode when a guided generation (via `instruct` or `quiet_prompt`) is detected. Useful
when using GuidedGenerations or similar extensions.
Edit all AI prompts used for generation, plot progression, and combat encounters.
Resets all floating action buttons (toggle, refresh) to default top-left positions.
Useful if buttons are off-screen.
Clears committed and displayed tracker data for your currently active chat.
Roll Dice
Rolling...
Result:
Edit Trackers
Customize Prompts
Customize the AI prompts used throughout the extension. Leave fields empty to use defaults.
Injected when "Enable Immersive HTML" is enabled. Affects all generation modes.
Injected when "Enable Dialogue Coloring" is enabled. Affects all generation modes.
Injected when "Enable Deception System" is enabled. Instructs AI to mark lies and deceptions with hidden tags.
Injected when "Enable CYOA" is enabled. Instructs AI to end responses with numbered action choices. Uses very high priority (depth 102) to ensure it's the last instruction.
Injected when "Enable Spotify Music" is enabled. Asks AI to suggest appropriate music for the scene.
Injected when "Narrator Mode" is enabled. Instructs AI to infer characters from context.
Injected when the "Randomized Plot" button is clicked. Introduces random elements to the story.
Injected when the "Natural Plot" button is clicked. Progresses the story naturally.
Instructions for LLM when generating avatar image prompts. Used by Auto-generate Missing Avatars feature.
Instruction portion only (format specification is hardcoded). {userName} will be replaced with the user's name.
Instructions added after tracker format specifications, telling the AI how to continue the narrative.
Writing style instructions for combat encounters. Includes prose quality guidelines and anti-repetition rules. {userName} will be replaced with the user's name.
Welcome to RPG Companion v.3.2.0!
⚠️ Important: Due to a change in the tracker format, we recommend that you use Clear Extension Cache in the Settings before you start using this version!
What's new?
Switched to the JSON format for the trackers.
You can now lock/unlock trackers that you don't want the model to change between generations.
Removed features that were half-baked or didn't work.
Organized Settings and Edit Trackers windows.
All features of the extension are now accessible from the main panel view.
Added Colored Dialogues option that makes the model color dialogue lines differently depending on the speaker.
Introduced Dynamic Weather Effects that add visual effects to your SillyTavern window depending on the current weather from the trackers.
All prompts used for the extension's features are now editable.
Made the user's level optional in the Edit Trackers.
Bug Fixes:
Fixed tracker logic in Together generation mode.
Fixed various UI bugs (too many to count).
Upgraded mobile view.
Spotify Music widget is more visible now, plus it works in the mobile view.
Auto-update after messages option is now available for External API generation mode.
Fixed the display of the thoughts window and its mobile display.
Mobile UI fixes (panel viewport and z-index issues).
Fixed the regex issue in Together mode (JSON blocks now hidden from display).
Fixed parsing error appearing when loading or switching chats.
Fixed adding new relationships in Edit Trackers (unique naming).
Added migration support for importing older tracker presets.
Lifted attributes cap from 100 to 999.
Fixed lock icon positioning on mobile devices.
Fixed smaller bugs.
Recommended Models:
For the extension to work properly, **it is not recommended to use any models below 20B, especially if they're old.** It works best with the SOTA models such as Deepseek, Claude, GPT, or Gemini.
Special thanks to all the other contributors for this project:
Paperboygold, Munimunigamer, Subarashimo, Lilminzyu, Claude (???), IDeathByte, Chungchandev, Joenunezb, Amauragis, and Tomt610.
Join our Discord server to share your feedback, report bugs, or request new features!