Save Editor
The Save Editor lets you view and modify the contents of Ren’Py save files and persistent data without launching the game. You can change character names, adjust stats, toggle flags, and browse the full internal state of any save.
Accessing the Save Editor
Section titled “Accessing the Save Editor”- Open the Save Manager for a game
- Tap a save slot to open its detail view
- Tap Edit Save Data to open the Save Editor
Interface
Section titled “Interface”The Save Editor has two tabs:
Browse Tab
Section titled “Browse Tab”A tree-based view of all data inside the save file. You can navigate into nested structures like dictionaries, lists, and class instances.
- Search — Filter entries by key or value name
- Breadcrumb path — Shows your current location in the data tree; tap any segment to jump back
- Hidden variables — Internal Ren’Py keys (starting with
_and engine internals likerollback_log) are hidden by default. Tap the eye icon to toggle visibility. - Color-coded types — Each value type has a distinct color badge for quick identification
Changes Tab
Section titled “Changes Tab”Lists all edits you’ve made with the old and new values. You can revert individual changes or use Revert All to undo everything.
Editable Types
Section titled “Editable Types”| Type | Editable | Input |
|---|---|---|
| String | Yes | Text field |
| Integer | Yes | Number pad |
| Float | Yes | Decimal pad |
| Boolean | Yes | True / False picker |
| Dict | Navigate | Drill into keys |
| List | Navigate | Drill into items |
| Tuple | Navigate | Drill into items |
| Set / Frozenset | Navigate | Drill into items |
| Object (class) | Navigate | View __state__ and __args__ |
| None | View only | — |
| Bytes | View only | — |
Saving Changes
Section titled “Saving Changes”When you’re done editing, you have two options:
- Overwrite Save — Replaces the original save file with your changes
- Save as New Slot — Creates a new save slot, preserving the original
The editor automatically handles re-signing save files to match Ren’Py’s expected signature format. If the game uses save file signing, your edited saves will be properly signed.
Editing Persistent Data
Section titled “Editing Persistent Data”You can also edit persistent data (the persistent file that stores progress, unlocks, and preferences across all save slots). When editing persistent data:
- All variables are shown by default (including hidden ones)
- The title changes to “Edit Persistent”
- Only “Overwrite” is available (no “Save as New Slot”)
Practical Uses
Section titled “Practical Uses”- Change character names — Edit string variables in the save
- Adjust currency or stats — Modify integer/float values for in-game resources
- Toggle story flags — Flip boolean values to unlock routes or change choices
- Fix broken saves — Correct corrupted or incorrectly set variables
- Unlock content — Set persistent flags to mark content as seen
Live Variable Editor (In-Game)
Section titled “Live Variable Editor (In-Game)”Spark also has a separate Variable Editor accessible from the in-game overlay while a game is running. Unlike the Save Editor which works on files on disk, the live Variable Editor injects changes directly into the running Ren’Py session. See the Variable Editor guide for details.