How to Enable Mods in Balatro: A Complete Setup Guide

Balatro's modding community has grown quickly since the game's release, adding everything from new jokers and card decks to full gameplay overhauls. Enabling mods isn't built into the base game through an official launcher or settings menu — it requires a small amount of manual setup. Here's what you need to know about how modding works in Balatro and what factors shape the experience depending on your platform and comfort level.

How Balatro Modding Actually Works

Balatro is built on the LÖVE2D framework, a Lua-based game engine. This architecture makes the game relatively mod-friendly compared to many commercial titles — the game's logic is accessible in a way that allows community-built tools to hook into it cleanly.

The primary modding tool for Balatro is Steamodded, an open-source mod loader that acts as a bridge between the base game and individual mods. Rather than patching the game's files directly, Steamodded injects mod content at load time, which keeps the base game intact and makes it easier to add or remove mods without breaking anything permanently.

There is also Lovely, a Lua injection tool that some mods require as a dependency alongside Steamodded. Newer mods increasingly list both as requirements, so understanding which layer does what helps when troubleshooting.

Step-by-Step: Enabling Mods on PC (Steam)

The most common setup — and the one with the most community documentation — is Balatro on PC via Steam.

1. Download Steamodded Visit the official Steamodded GitHub repository and download the latest release. The repository is the authoritative source; third-party mirrors may be outdated.

2. Locate the Balatro game folder In Steam, right-click Balatro → Manage → Browse Local Files. This opens the directory where the game's executable and core files live.

3. Install Steamodded Place the Steamodded files into the game directory as instructed in the repository's README. Typically this involves placing a specific file or folder at the root of the game directory.

4. Install Lovely (if required) Some mods need Lovely as an additional injection layer. This also gets placed in the game directory. The Lovely GitHub page includes platform-specific instructions since the installation step differs slightly depending on OS.

5. Create a Mods folder Inside the game directory (or in the Balatro save/appdata folder, depending on the mod loader version), create a folder named Mods. Individual mods go here as subfolders or .lua files, following whatever structure the mod author specifies.

6. Add mods and launch the game Drop your chosen mods into the Mods folder, then launch Balatro normally through Steam. Steamodded will detect compatible mods and load them automatically.

Platform Differences Matter 🎮

Not every version of Balatro supports mods in the same way — and this is one of the most important variables to understand before you start.

If you're playing on a console or mobile, the modding ecosystem simply doesn't extend there — at least not through any official or safe method. The community-developed tools exist exclusively for desktop environments where players have direct file system access.

What Affects Your Modding Experience

Even on PC, outcomes vary based on a few key variables:

Game version compatibility — Mods are built against specific versions of Balatro. When the base game updates, mods may break until their authors push an update. Checking a mod's last update date against your current game version is a habit worth building.

Steamodded version — The mod loader itself updates to keep pace with game patches. Running an old version of Steamodded with a new game version (or vice versa) is a common source of crashes and blank load screens.

Lovely dependency — Not all mods need it, but those that do will fail silently or crash if it's missing. Mod pages on NexusMods or GitHub usually list dependencies clearly.

Mod conflicts — Running multiple mods simultaneously can create conflicts, especially if two mods touch the same game systems (e.g., two mods that modify how joker scoring is calculated). Some mod authors publish compatibility notes; others rely on users to discover conflicts through trial and error.

Technical comfort level — The process is manageable without programming knowledge, but it does require navigating file directories, reading GitHub pages, and occasionally editing paths or configuration files. Users who haven't done this kind of setup before may need to budget extra time for the first installation.

Where to Find Balatro Mods

NexusMods hosts a growing Balatro library with version tags, dependency lists, and user reviews. GitHub is where most mod authors publish source files and changelogs. The Balatro subreddit and the game's official Discord both have active modding channels where community members share recommendations and help troubleshoot installs.

The Variable the Guide Can't Resolve

The mechanical steps above are consistent — but how smoothly they go, which mods enhance your particular playstyle, and whether your current game version plays nicely with the mod loader you download today all depend on your specific setup at the moment you try this. The modding scene moves fast, and what's stable one week may need a patch the next. Your platform, version, and willingness to do a bit of troubleshooting are the pieces of the puzzle only you can see. 🧩