BalatroCoop

A 2-player LAN co-op mod for Balatro.

Both players play through the same run together. Blind scores are combined, progression is synchronized, and both players share the shop.

Current version: 0.2.1 Alpha

This is an early release, so bugs and desyncs may still happen.

Installation

Thunderstore

If you're using the Thunderstore Mod Manager / r2modman, install BalatroCoop normally and let the manager install its dependencies.

BalatroCoop requires:

• Steamodded
• Lovely

Manual installation

Install the dependencies first:

• Steamodded
• Lovely

Then:

1. Download BalatroCoop.

2. Extract the ZIP.

3. Open File Explorer.

4. Click the address bar and paste:

   %AppData%\Balatro\Mods

5. Copy the entire BalatroCoop folder into the Mods folder.

The final path should look like:

%AppData%\Balatro\Mods\BalatroCoop\main.lua

Do not copy only main.lua, and make sure you don't end up with:

BalatroCoop\BalatroCoop\main.lua

How to play

Both players need BalatroCoop installed.

1. Open CO-OP / LAN.
2. One player clicks Create Room.
3. Send the displayed LAN IP to the other player.
4. The second player enters that address into Host LAN IP and clicks Join Room.
5. Both players choose their decks and click Ready.
6. The host clicks Start Together.

For two game instances on the same PC, use:

127.0.0.1

BalatroCoop uses TCP port:

22122

If Windows Firewall asks for permission, allow Balatro on your Private network.

Features

• 2-player LAN co-op
• Combined blind scoring
• Separate decks for both players
• Shared shop
• Synced blind selection and skips
• Synced round progression
• Shared purchase and reroll state
• Remote player Jokers and consumables
• Other player's played-card animations
• LAN IP detection
• Environment and connection diagnostics

Compatibility

Currently focused on:

• Windows 10/11
• Steam Balatro
• 2-player LAN
• Steamodded
• Lovely

Recent Steamodded and Lovely versions are allowed even if they have not all been individually tested.

Large gameplay-changing mods are not officially tested yet. For the most reliable experience, try BalatroCoop with only Steamodded and Lovely first.

Current limitations

This is an Alpha release.

Currently there is:

• no reconnect after disconnecting
• no matchmaking
• no dedicated server
• no official macOS/Linux support yet
• limited compatibility testing with other large mods

Do not expose TCP port 22122 directly to the public internet.

Bug reports

If something breaks, please include:

• BalatroCoop version
• Balatro version
• Steamodded version
• Lovely version
• whether you were Host or Guest
• what happened before the problem
• screenshot, video, or crash log if available