Installation

This guide covers installing the BalatroBot mod for Balatro.

Prerequisites

1. Balatro (v1.0.1+) - Purchase from Steam
2. Lovely Injector (v0.8.0+) - Follow the installation guide
3. Steamodded (v1.0.0-beta-1221a+) - Follow the installation guide

Mod Installation

1. Download BalatroBot

Download the latest release from the releases page or clone the repository.

2. Copy to Mods Folder

Copy the following files/folders to your Balatro Mods directory:

balatrobot/
├── balatrobot.json    # Mod manifest
├── balatrobot.lua     # Entry point
└── src/lua/           # API source code

Mods directory location:

Platform	Path
Windows	%AppData%/Balatro/Mods/balatrobot/
macOS	~/Library/Application Support/Balatro/Mods/balatrobot/
Linux	~/.local/share/Steam/steamapps/compatdata/2379780/pfx/drive_c/users/steamuser/AppData/Roaming/Balatro/Mods/

3. Launch Balatro

Start Balatro with the BalatroBot CLI:

balatrobot --fast --debug

For detailed CLI options and usage, see the CLI Reference.

4. Verify Installation

Start Balatro, then test the connection:

curl -X POST http://127.0.0.1:12346 \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "health", "id": 1}'

Expected response:

{"jsonrpc":"2.0","result":{"status":"ok"},"id":1}

Troubleshooting

• Connection refused: Ensure Balatro is running and the mod loaded successfully
• Mod not loading: Check that Lovely and Steamodded are installed correctly
• Port in use: Use balatrobot --port PORT to specify a different port

For more troubleshooting help, see the CLI Reference.