balatro-vs

About The Mod

Versus mod for balatro, try to win a first to 10 round against another player.

This mod feature:

• Peer to peer Online 1o1 netplay (Random matchmaking and friendlies)
• Some new disruptives jokers for interaction
• Auto-update (disabled when installed via Thunderstore — update through the manager instead)
• Android support
• Probably won't work with other non cosmetic mods

More info at How 2 play (this will probably move to the wiki at some point)

Requirements

• lovely-injector v0.9.0 (latest to this day). Any previous version will mostly crash at startup.
• Steamodded 1.0.0-beta-1620a. The mod will not work without it. Further update might work but not guaranted as soon as they are available,will probably need some patchs adjustement. You will get a warning like this if not installed

Install

This mod has primarily been developed and tested on Windows. Android is also supported (see below). iOS support is technically possible (see also below)

Also this mod was developed for the 1.0.X version of the game, meaning it will break when an official major update drops (will need some adjustments).

Before starting, i suggest to make a backup of your current save file just in case. You can find your saves in your computer at %AppData%/Balatro with folder 1 to 3 being the profiles and the settings.jkr file being the current game settings (steam_autocloud.vdf is probably some steam related stuff, i think it can be ignored). Copy those somewhere to backup if needed for some reason

Windows

This mod runs with lovely-injector v0.9.0:

• Start by installing lovely-injector following the manual installation (the first two steps)

• Grab and extract latest release

• In the Release folder, copy the balatro-vs folder to lovely mod folder Step 3 of lovely manual installation . If this is the first time you are doing this, then create the folder Mods at %AppData%/Balatro

• Copy the winmm.dll file to your balatro game folder

[!IMPORTANT] Respect the mod architecture.
winmm.dll file goes to your balatro game folder (something like .../Steam/steamapps/common/Balatro).

balatro-vs folder goes to lovely Mods folder at %AppData%/Balatro/Mods.

The mod won't work if not

• Launch the game and confirm that lovely console opened and a versus button is present at the main screen

• Enjoy ! Do not hesitate to open an issue if you encounter a bug or something isn't working

Thunderstore

A thunderstore build is a windows build, you can follow the same steps as above

[!IMPORTANT] If you installed the mod via Thunderstore, the auto-updater is disabled. Updates must be applied through your Thunderstore mod manager.

Android

[!IMPORTANT] Android support requires a Steam version of Balatro. You need to build the Android version of the game using LMM (Lovely Mobile Maker).

• Follow the LMM instructions to build the Android version of your Steam copy of Balatro and install the APK on your device
• Launch the LMM app at least once so it creates the external storage folder used by the mod
• Grab the latest release zip ending in -android from the releases page
• Extract the contents of the -android zip into the external storage folder created by the LMM app on your device into the mods folder (the path on your device need to be Balatro/ASET/Mods/balatro-vs)
• Launch the game and confirm that a versus button is present at the main screen

iOS

iOS support is technically feasible using LMM (Lovely Mobile Maker), but the mod need to build an additionnal native lib winm that i think requires a Mac, Xcode, and familiarity with the iOS build process. If you have that knowledge and would like to contribute, help is very welcome — feel free to open an issue or a pull request or ask for help!

Known issue

• For some obscure reason, connection between 2 players might fail. For now, just cancel and restart the matching (Note for me : failed to open data channel: there already exists a stream with identifier is what i need to check)

Building (Developer)

• Clone this repository
• Build the core project
• Optionaly,set the environment variable BALATRO_GAME_PATH pointing to your own game install (something like ../Steam/steamapps/common/BALATRO/) for copying the built dll to your game path
• Optionaly, if you also want to copy lua patch to lovely mod folder, build the copy_lua_patchs project and run the command

cargo run -p copy_lua_patchs

The mod use a matchbox server for matchmaking. You can use the provided signaling server for testing.

The file you want to update to put your server url is bvs.json config file in the patchs folder.

Social

Bsky : Dshad66

Twitter : DShad - @DShad66

Discord : dshad (was DShad#4670)