RPG Companion is a SillyTavern browser extension automating character stats, quests, inventory, and game state tracking. It enhances roleplaying immersion with AI-generated content and a customizable UI, targeting SillyTavern users seeking deeper game state management and dynamic narrative elements.

How It Works

The extension operates in two primary generation modes: "Together Mode," where tracker data is embedded within and extracted from the main AI response, and "Separate Mode," which utilizes a dedicated API call solely for tracker data generation. This choice allows users to balance response speed and roleplay cleanliness. The system is context-aware, dynamically influencing narrative elements based on tracked user stats, character states, and environmental information.

Quick Start & Requirements

• Install via the SillyTavern Extensions tab by pasting the GitHub repository URL: https://github.com/SpicyMarinara/rpg-companion-sillytavern.
• Requires SillyTavern version 1.11.0 or higher.
• Compatible with all major AI backends, including OpenAI, Claude, and KoboldAI.
• Official quick-start and detailed configuration instructions are available within the project's README.

Highlighted Details

• Core Functionality: Features highly customizable user stats with progress bars, skills, and inventory management; an info box dashboard for date, weather, and location; multi-character tracking with custom fields and relationship badges; and optional floating thought bubbles for characters.
• Advanced Features: Includes dynamic plot progression, integration of immersive HTML/CSS/JS elements, advanced multi-location inventory management, and classic RPG attribute tracking with dice roll support.
• Customization & UI: Offers live editing of all tracker fields, extensive configuration options for trackers and widgets, multiple built-in themes (Cyberpunk, Fantasy, Minimal, Dark, Light), and a responsive design with mobile support.
• Generation Modes: "Together Mode" uses a single API call for faster responses, while "Separate Mode" employs a second API call for cleaner roleplay output.

Maintenance & Community

This project is officially DEPRECATED by the original author, with ongoing development and maintenance transitioned to the community-maintained Marinara Engine frontend. A Discord community is available for support and discussion.

Licensing & Compatibility

Licensed under the GNU Affero General Public License v3 (or any later version). This strong copyleft license may impose restrictions on integration with closed-source or proprietary systems, requiring derivative works to be shared under the same terms.

Limitations & Caveats

The project's deprecated status means future development, feature additions, and bug fixes are dependent on community efforts rather than dedicated author support. The "Separate Mode" generation strategy incurs an additional API call, which may increase operational costs and introduce slight latency compared to the "Together Mode."