Installation

This guide covers installing the BalatroBot mod for Balatro.

Prerequisites

• Balatro (v1.0.1+) - Purchase from Steam
• Lovely Injector (v0.8.0+) - Follow the installation guide
• Steamodded (v1.0.0-beta-1221a+) - Follow the installation guide
• Uv (v0.9.21+) - 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:

Mods/
├── smods/                # Mods loader
├── DebugPlus/            # required just for debugging
└── balatrobot/           # BalatroBot directory
    ├── balatrobot.json   # BalatroBot manifest
    ├── balatrobot.lua    # BalatroBot 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 (Steam)	~/.local/share/Steam/steamapps/compatdata/2379780/pfx/drive_c/users/steamuser/AppData/Roaming/Balatro/Mods/
Linux (Native)	~/.config/love/Mods/balatrobot/

3. Launch Balatro

Start Balatro with the BalatroBot CLI:

uvx balatrobot

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.