BalatroSaveEditor

This is a helper for managing saves of Balatro, including merging and editing.

🛑 This project is not affiliated with Balatro. 🛑

💾 Please make sure you have backups in case of unexpected bugs. 💾

⚠️ The script is built without prior knowledge of how the game works, so bugs are expected when test cases don't fully cover or the game gets updates.

⚠️ Please file an issue if you encounter any bug or the game crashes.

Where to find save files

• Windows: %APPDATA%\Roaming\Balatro
• macOS: ~/Library/Application Support/Balatro

Installation

1. Clone this repo

   git clone https://github.com/TeddyHuang-00/BalatroSaveEditor.git && cd BalatroSaveEditor
   # or
   git clone git@github.com:TeddyHuang-00/BalatroSaveEditor.git && cd BalatroSaveEditor

2. Install dependencies

   pip install -r requirements.txt

Usage

• List all options

  python main.py -h

• View save file

  This will print the save file in a human-readable JSON format.

  python main.py view <save_file>

  Optionally, you can specify the output format by using -f or --format option. Currently, json and lua are supported.

  python main.py view <save_file> -f <json|lua>

• Merge save files

  This will merge left_save_file and right_save_file with the most progress kept.

  python main.py merge <left_save_file> <right_save_file>

  You can change this behavior by using -p or --prefer option. This will make sure the progress of the specified save file is kept if there is any conflict.

  python main.py merge <left_save_file> <right_save_file> -p <left|right>

  You can also specify the output file by using -o or --output option.

  python main.py merge <left_save_file> <right_save_file> -o <output_save_file>

• Edit save file

  This will export the save file to a JSON file which can be edited.

  python main.py export <save_file>

  You can edit the JSON file and import it back to the save file.

  python main.py import <json_file>

  You can also specify the output file by using -o or --output option for both exporting and importing.

  python main.py export <save_file> -o <output_json_file>

License

Open sourced under the MIT license.

Contributing

Feel free to submit a pull request if you find any bugs or want to add new features.