balatrosaveeditor's Introduction

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

Clone this repo

git clone https://github.com/TeddyHuang-00/BalatroSaveEditor.git && cd BalatroSaveEditor
# or
git clone [email protected]:TeddyHuang-00/BalatroSaveEditor.git && cd BalatroSaveEditor

Install dependencies
```
pip install -r requirements.txt
```

Usage

List all options
```
python main.py -h
```
View save file
```
python main.py view <save_file>
```
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>
```