SteamoddedNX - A Balatro ModLoader port for Nintendo Switch

Prelude

Warning!

By using this mod you AGREE not to ask for help in the official Balatro server! Discussion of any sort of unofficial console modding of Balatro is forbidden (for their safety.) Doing so will likely result in a warning or a ban from the server. Just don't do it. Secondly, do not bother Steamo or any mod makers on the topic of making their mods work on older versions of Steamodded. Find older versions that work and don't use lovely! Ask for help on the GBATemp thread, over here!

Limitations

• Lovely is not supported on the Switch, so mods that require it will NOT work.
• Limited to mods that function on 0.9.8 version of sMOD. You may need to find an older version of a mod to use it.
• Card suit customization introduced in version 1.0.1g (Friends of Jimbo) will not work.

Installation

Requirements

• A modded switch
• A legal copy of Balatro for the switch, with the latest update
• A valid python install

How to Install SteamoddedNX

• Download this repo by clicking the green Code button near the top and clicking Download ZIP, and extract it somewhere safe.
• Follow the steps to dump your current update of Balatro, in NCA FS or romFS format using your favorite NX dump tool.
• Once complete, connect your SD card to your computer, navigate to the dumped update location. Copy the Patch RomFS folder to inside your repo extraction folder. Now enter the folder and ZIP the contents of the Patch RomFS into a standard ZIP, ensuring that your ZIP contains the dumped files at the root, and are NOT nested in an additional folder inside the ZIP.
• Copy your dumped ZIP inside the safe location of your extracted repo on your computer.
• Open a terminal/command window: and run python -m pip install requests
• Drag the ZIP onto SteamoddedNX_injector.py and wait for the injector to complete. If you see Process completed successfully. Press any key to exit... then continue, if not, check your zip structure.
• Extract the contents of the modded ZIP into the included \atmosphere\contents\0100CD801CE5E000\romfs directory.
• This step is not needed but if you would like to see exact crash errors from your mods: while in your romfs folder, open globals.lua and jump to line 62 self.F_NO_ERROR_HAND = Now replace true with false
• Copy your prepped atmosphere folder to your switch SD card and ensure Balatro launches and functions with the included example mods! More mods can be found below.

Steps for Dumping

• Open NXDumptool_rw_poc
• Select User titles menu
• Select 0100CD801CE5E000 - Balatro
• Select nca / nca fs dump options
• Select dump update
• Press Y to set the dump mode into nca fs selection mode (so if its selected correctly, you'll see "raw nca mode", because the mode that is currently selected is nca fs mode, which is what you want.)
• Select Program #0
• Select FS selection #2 Patch RomFS
• Start NCA fs dump.

Where to Find Additional Mods

⭐ Jaded's 0.9.8 Mod Collection

🥇 Awesome Balatro repo by jie65535

🥈 Nexus Mods Balatro page

🥉 Balatro Discord Mods thread Click here to join the server.

How to Install a Mod

• Find and download a sMOD 0.9.8 compatible mod (see Limitions.)
• Navigate to your Mods directory (see the installation instructions.)
• Put the mod into that directory (the mod can be a single file if there is only one file provided, or it can be a whole folder.)
• Launch the game and enjoy!

Thanks

Thanks to Steamo and co for helping develop such a versatile tool that literally works on any platform. I only needed to make a couple of minor adjustments and patches to make it launch on Switch. Thank you to the mod community that make amazing add-ons and of course thanks to localthunk for making such an amazing, addictive game.

License

This project is licensed under the GNU General Public License. This ensures that the software is free to use, modify, and distribute. For more details, click here.