StsCompanion

Real-time card selection recommendations based on community win rate data. Display ratings on card rewards, event selections, and store cards, and hover to see detailed analysis. At the same time, automatically upload completed game records and synchronize your ongoing games to the STS Tracker browser companion page.

Card rewards helper (StsCompanion)

🎮 **Card Selection Assistant** Connect your game to sttracker.app, a community data platform for Slay the Spire 2. It provides **real-time recommendations** based on aggregate win rate data from thousands of uploaded game records.

---

✨ Core Functions

🃏 **Card Rating**

When a card is provided after combat, during an event, or in the store, the mod will rate each option and display a color-coded badge beneath the card. Hover over the badge to see detailed analysis:

• **Basic Win Rate**
• **Card deck genre fit**
• **Synergies with your current cards**
• **Copy number effect**
• **Upgrade Value**

⚖️ **Ancient Choice Rating**

At the start of each chapter, Ancient Blessings displays win rate and pick rate statistics for each option, filtered by your character.

🛒 **Shop Relics and Potions Rating**

• **Relic**: Shows the win rate change value (the correlation between owning this relic and winning).
• **Potion**: Shows pick rate (how often players select this potion when encountering it).

☁️ **Automatic upload and synchronization**

• **AUTO-UPLOAD**: Completed gameplay records are automatically uploaded to your STS Tracker profile.
• **Real-time synchronization**: Your current game progress will be synchronized to the browser companion page in real time.

---

🛠️ Installation and configuration

• **Unzip the files**: Unzip the `StsCompanion` folder to your STS2 module directory:

`C:/Program Files (x86)/Steam/steamapps/common/Slay the Spire 2/mods/`

• **Get API Token**: Go to sttracker.app, log in and generate an API token in settings.

• **Configuration Token**: Open the `sts_companion_config.cfg` file in the mod folder and paste your token into the `apiToken` field.

```json

{

"apiToken": "Paste your API token here",

"apiUrl": "

"overlayEnabled": true,

"autoUploadRuns": true,

"syncActiveRun": true,

"badgeScale": 1.0,

"tooltipScale": 1.0

}

```

• **Start the game**: Start the game and the module will be loaded automatically.

⚠️ **NOTE**: If you are using `rusty-sts` for automatic sync, please disable it to avoid duplicate uploads. Just choose one of the two to use.

---

🔧 Function List

✅ **In-game rating coverage**: post-battle rewards, event card selection, store cards.

✅ **Ancient Blessing Rating**: Displays the winning rate and selection rate.

✅ **Store Item Analysis**: Relic win rate correlation, potion selection rate.

✅ **Intuitive Color Coding**: Green (Strong), Yellow (Medium), Red (Weaker), with the best option having a gold border.

✅ **Detailed Hover Tips**: Contains rating details for 5 factors.

✅ **Automatic Data Management**: Automatically upload completed records and synchronize ongoing games in real time.

✅ **HIGHLY CONFIGURABLE**: Overlays, auto-uploads and real-time sync can be independently switched on and off.

---

🤝 Recommended modules

• **UnifiedSavePath**: If you want to keep the progress of the original game and the mod game consistent (mod games are saved separately by default).
• **ModConfig**: Allows configuration changes directly in the game (but you still need to manually add the API key to the config file).

---

📞 Contact and Support

• **Email**: dr.neko17@gmail.com
• **GitHub Project**:

Hopefully this assistant will help you make smarter choices and climb higher spires! 🏔️