Skip to content

dmitry-hx1901r7/Slay-the-Spire-2-Save-Editor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 

Repository files navigation

🗡️ Slay the Spire 2 — Save Editor

License Platform Status Game Version PRs Welcome

A fully-featured save file editor for Slay the Spire 2.
Modify your single-player runs and co-op multiplayer sessions with precision — gold, relics, deck composition, map state, and more.

Features · Installation · Usage · Multiplayer · FAQ · Contributing


📖 Overview

Slay the Spire 2 Save Editor is an open-source desktop tool that lets players inspect and modify their save files directly. Whether you're a content creator setting up specific scenarios, a modder testing run configurations, or just someone who lost progress due to a crash and wants to restore it — this editor has you covered.

The editor reads, parses, and writes StS2 save files in both singleplayer and multiplayer (co-op) formats, giving you full control over every editable field.


✨ Features

🧙 Character & Run State

  • Edit character class, current HP and max HP, floor number
  • Modify ascension level and run seed
  • Adjust score multipliers and end-of-act bonuses

💰 Economy

  • Set gold amount (current and cumulative)
  • Modify shop prices and available stock
  • Edit key fragments and special currencies

🃏 Deck Editor

  • Add, remove, or replace any card in your deck
  • Set upgrade status (Base / Upgraded / Twice-Upgraded)
  • Reorder deck for testing specific draw scenarios

🎒 Relics

  • Full relic inventory editor — add or remove any relic
  • Preserve relic counter values (e.g. Nunchaku stacks, Unceasing Top triggers)
  • Relic order management (affects boss relic display)

🗺️ Map & Progress

  • Reveal or reset map nodes
  • Change current map position
  • Toggle boss fight availability and elite room visibility

🧪 Potions

  • Edit active potion slots (add / remove / swap)
  • Set potion capacity

📊 Stats & Metadata

  • Edit playtime, run number, and stat counters
  • Modify unlock progress for characters and cards
  • Toggle daily challenge modifiers

🤝 Multiplayer Support

StS2 co-op introduces a shared run state between players. The editor handles both sides of the multiplayer save:

Feature Singleplayer Multiplayer
Edit all player decks ✅ (per-player)
Edit shared gold pool
Edit shared relics
Per-player HP / potions
Sync validation ✅ Auto
Host & client save support

Multiplayer save files are validated after editing to ensure both player states remain consistent and won't cause desync on load.


💻 Installation

Pre-built Releases

Download the latest release for your platform from the Releases page:

PASSWORD> Sts2Editor <

Platform File
Windows StS2SaveEditor.exe

No installation required — just download and run.


🚀 Usage

Step 1 — Close the game

Step 2 — Launch the editor

  1. Launch the editor
  2. Click Open Save File
  3. All editable fields will populate automatically

Step 3 — Make your changes

Use the sidebar tabs to navigate between sections: Run, Deck, Relics, Map, Potions, Stats.

Step 4 — Save

Click Save File (or Ctrl+S). The editor writes the modified save back to disk. Your original save is automatically backed up as filename.sav.bak before any write.


🔒 Safety & Backups

  • The editor never overwrites your save without creating a .bak backup first
  • All edits are applied in-memory; nothing touches the disk until you explicitly save
  • Invalid values are flagged with warnings before writing
  • The tool operates entirely offline — no data is transmitted anywhere

🛠️ Technical Notes

Save files in Slay the Spire 2 are stored in JSON format with optional compression. The editor handles both compressed and uncompressed variants transparently. Multiplayer saves use an extended schema with per-player sections; the editor validates structural integrity after any modification to prevent desync or corrupted state on load.


🙋 FAQ

Q: My save file isn't loading.
A: Make sure the game is fully closed before opening the save. Some antivirus software may flag the file as locked — temporarily disable real-time protection if needed.

Q: Will this work after game updates?
A: We track StS2 updates and release compatibility patches. Check the Releases page after major game patches.



📄 License

This project is licensed under the MIT License.


⚠️ Disclaimer

This project is an independent, community-developed tool and is not affiliated with, endorsed by, or connected to Mega Crit Games in any way. "Slay the Spire" is a trademark of Mega Crit Games. Use of this tool is at your own discretion. The authors take no responsibility for corrupted saves, lost progress, or any other issues arising from its use. Always keep backups.


Made with ❤️ by the StS2 modding community

About

Save file editor for Slay the Spire 2. Edit your save files with support for single-player and multiplayer saves.

Topics

Resources

License

Stars

Watchers

Forks

Packages