Steamodded 1.0.0-beta-0827c

Steamodded - A Balatro Modding Framework

Introduction
Steamodded is a mod loader and injector for the game Balatro. Much like the LÖVE framework itself, it is built using Lua. It is made with modularity and extensibility in mind, providing a large selection of APIs and other features to facilitate bringing your ideas to life.

Installation

Steamodded currently only works with the Steam version of Balatro. The Microsoft Store version is unsupported as of now.

Step 1: Anti-virus setup

Steamodded uses a runtime injector called Lovely to modify Balatro's code. Since it behaves similarly to a Trojan, some antivirus software may incorrectly flag it as malware. Lovely is not malicious, is open source, and can even be built from source.

In order to get Lovely and Steamodded running properly, you will have to whitelist Balatro's installation folder in whatever anti-virus software you may be using. You may also need to temporarily disable real-time protection to avoid having files deleted while moving them around.

Example: steps for Windows Defender

Differences may occur if you're using different software.

1. Navigate to the game's directory by right-clicking the game in Steam, hovering "Manage", and selecting "Browse local files". Copy the file path of this directory.
2. Open Windows Security and navigate to Virus & threat protection > Manage settings.
3. Disable Real-time protection. Windows will automatically re-enable this afterwards.
4. Scroll down to Add or remove exclusions and confirm if prompted.
5. Add a folder exclusion. When an explorer window opens, paste the path you copied in step 1 into the address bar and confirm.

Step 2: Installing Lovely

You're now ready to install the Lovely injector. You can follow Lovely's general instructions here, or instead follow these specific install steps for Balatro (recommended):

1. Download the latest Lovely release for Windows. This will be lovely-x86_64-pc-windows-msvc.zip. If your browser is blocking this download, use Firefox instead.
2. Navigate to your Balatro game directory in your file explorer. This can easily be done by right-clicking the game in Steam, hovering "Manage", and selecting "Browse local files".
3. Open the .zip archive, and extract Lovely's version.dll from the archive into the game directory.
4. Launch Balatro through Steam and you should see a second window pop up alongside the game named something like Lovely x.x.x. If it does, you have installed Lovely correctly and are ready to proceed to the next section. If it does not, please make sure you have followed the previous steps correctly.

Step 3: Installing Steamodded

Once you have installed Lovely correctly, you can install Steamodded:

1. Download the latest Steamodded release by clicking "Source code (zip)" at the bottom of the page.
2. Extract the downloaded zip file.
3. In your file explorer, navigate to Balatro's save directory: %AppData%/Balatro