Variable Editor
The Variable Editor lets you view and modify Ren’Py game variables while a game is running.
Accessing the Variable Editor
Section titled “Accessing the Variable Editor”- While in a game, tap the overlay button to open the Game Overlay
- Tap the wrench icon to open the Variable Editor
The Variable Editor is hidden on iPhone in portrait orientation due to screen width constraints. Rotate to landscape to access it.
Features
Section titled “Features”- Real-time variable display — Shows current game variable values
- Search and filter — Find specific variables
- Edit values — Modify variable values directly
- Auto-refresh — Variables update automatically (default: every 2 seconds)
- Freeze — Switches to a faster 1-second refresh interval for closer inspection of rapidly changing values
Variable Types
Section titled “Variable Types”The editor supports common Ren’Py variable types:
- Strings
- Numbers (integers and floats)
- Booleans (True/False)
Settings
Section titled “Settings”| Setting | Default | Description |
|---|---|---|
| Auto Refresh | On | Automatically update variable values |
| Refresh Interval | 2.0s | How often to refresh |
| Freeze Interval | 1.0s | Update rate when frozen |
| Window Size | 500x250 | Editor window dimensions |
Use Cases
Section titled “Use Cases”- Debugging — Check why a game isn’t behaving as expected
- Progress adjustment — Modify story flags or relationship points
- Testing — Quickly set game state for testing different paths
Caution
Section titled “Caution”Modifying game variables can cause unexpected behavior, crashes, or broken save files. Use this feature carefully and back up your saves beforehand.