How to Install Balatro Mods: A Complete Guide for PC and Steam Deck Players

Balatro's modding community has grown rapidly since the game's release, adding everything from new jokers and decks to visual overhauls and gameplay tweaks. Installing mods isn't officially supported out of the box, but the process is straightforward once you understand the tools involved — and it works reliably across most setups.

What You Need Before Installing Balatro Mods

Balatro mods rely almost entirely on a mod loader called Steamodded. Think of it as the bridge between the game's Lua-based code and any mods you want to run. Without it, most mods simply won't load.

Before you start, make sure you have:

  • A legitimate copy of Balatro (Steam version is the most widely supported)
  • Steamodded — the community's primary mod loader
  • The mod files themselves (downloaded from sources like Nexus Mods or the Balatro Discord)
  • Basic comfort with file browsing on your operating system

You don't need to know how to code. Most of the process is copying files into the right folders.

How Steamodded Works

Steamodded works by injecting itself into Balatro's startup process. When the game launches, it scans a designated Mods folder inside the game's directory and loads any compatible .lua mod files it finds there.

This matters because:

  • Mods that aren't Steamodded-compatible may require a different loader or won't work at all
  • The load order of mods can sometimes affect behavior if two mods modify the same game system
  • Updating the game can occasionally break Steamodded until the loader is updated to match the new version

Understanding this prevents confusion when something doesn't work as expected.

Step-by-Step: Installing Mods on PC (Windows)

1. Install Steamodded

  • Download the latest Steamodded release from its GitHub repository
  • Inside the downloaded files, you'll find installation instructions — typically involving copying files directly into Balatro's root game folder
  • The root folder is usually located at: Steam/steamapps/common/Balatro/

2. Create or Locate the Mods Folder

Once Steamodded is installed and you've launched the game once to let it initialize, a Mods folder will appear inside the Balatro directory. If it doesn't appear automatically, you can create one manually with that exact name.

3. Download Your Mods

Mods are distributed as .lua files or folders containing a main .lua file. Download them from trusted community sources. The Balatro subreddit and official Discord server are good starting points for finding well-maintained mods.

4. Drop Mods into the Mods Folder

Copy the mod file or folder into the Mods directory. The structure typically looks like:

Balatro/ └── Mods/ ├── YourMod.lua └── AnotherMod/ └── AnotherMod.lua 

5. Launch the Game

Start Balatro normally through Steam. Steamodded will scan the Mods folder on launch. If a mod loaded successfully, you'll usually see a mods menu or visual indicator added to the main screen.

Installing Mods on Steam Deck 🎮

The Steam Deck runs Balatro through Proton (a compatibility layer), which adds a small wrinkle to the folder structure.

  • Switch to Desktop Mode on the Steam Deck
  • Navigate to the Balatro game folder — it's typically buried within the ~/.local/share/Steam/steamapps/common/Balatro/ path
  • The installation steps for Steamodded and the Mods folder are otherwise identical to the Windows process

Some players find it easier to use a file manager app in Desktop Mode rather than the terminal, especially if they're less comfortable with Linux-style directory navigation.

Key Variables That Affect Your Experience

Not every setup behaves the same way. Several factors determine how smoothly mod installation goes:

VariableWhy It Matters
Game versionMods built for older versions may break after updates
Steamodded versionMust be compatible with the current game version
Mod sourceCommunity-maintained mods vary in update frequency and quality
Number of mods loadedMore mods increase the chance of conflicts
Operating systemWindows is most straightforward; Linux/Deck requires extra path navigation

When Mods Don't Load

If a mod isn't appearing in-game, the most common causes are:

  • Mismatched versions between Steamodded and the current game build
  • Incorrect folder placement — the .lua file is one level too deep or too shallow
  • Mod conflicts — two mods editing the same joker or game mechanic
  • A missing dependency — some mods require another mod to function

Checking the Steamodded GitHub issues page and the Balatro modding Discord channels usually surfaces the solution quickly, since these problems are well-documented by the community.

The Spectrum of Mod Complexity

Balatro mods range from dead simple to surprisingly involved:

  • Single-file mods (one .lua drop-in) — easiest, minimal risk
  • Multi-file mod packages — require keeping a folder structure intact
  • Mods with dependencies — need other mods installed first
  • Total conversion mods — alter core systems and require more careful version matching ⚙️

A player who wants one new joker type has a very different installation experience than someone trying to run ten mods simultaneously with custom UI changes. Both are achievable, but the second scenario demands more attention to compatibility and load order.

Your specific combination of game version, operating system, and chosen mods is ultimately what determines how straightforward — or how layered — the process becomes. 🔧