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.2 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 IP or IP:port 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.

Remote connections through a TCP tunnel

The Join field accepts a LAN or public IPv4 address. To use a tunnel with a different external port, enter IP:port, for example 203.0.113.10:14908 (example address only). Without a port, the mod uses 22122.

The host creates the room normally and configures their tunnel to forward TCP traffic to 127.0.0.1:22122 on the host PC. Give the guest the tunnel's public IPv4 and external port. The displayed Your LAN IP is still the local address; the mod cannot discover your tunnel endpoint automatically.

Both players must use the same BalatroCoop version. This does not add matchmaking, a hosted relay or reconnection. Actual remote connectivity depends on the tunnel service and network configuration.

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