Getting the Extra Credit Mod Working for Balatro
The Extra Credit mod is a community-created modification for Balatro that adds new jokers, blind modifiers, and some quality-of-life changes. It is hosted on GitHub and distributed through standard mod management tools. If you are reading this because your game crashed after you dumped a bunch of files into the game folder, this is going to help you figure out why. Here is what nobody really explains clearly on the first page of the readme: the mod does not just drop files into your Balatro directory and work. The surprising part is how sensitive it is to the version of Balatro you are running. The mod's developer updates for specific game builds, and if your Steam client auto-updated Balatro yesterday while you were asleep, the mod will break silently. Your game will launch, the mod folder will appear to load, and then the new jokers simply will not appear in-game. No error message. Nothing. I spent about forty minutes troubleshooting this exact issue last week. The problem was not the mod itself. The problem was that Balatro had updated from version 1.0.1n to 1.0.1o overnight, and the Extra Credit mod build I had installed was compiled against 1.0.1n. The game loaded everything fine because the .dll injection succeeded, but the internal references to card data and joker definitions were off by a few memory offsets. The mod was alive but reading from the wrong addresses. My workaround was straightforward: I checked the GitHub releases page, grabbed the latest pre-built .zip tagged for 1.0.1o, and replaced the old files. Game worked immediately after.
What You Actually Need
You need three things. First, a legitimate copy of Balatro from Steam. Pirated or standalone installs will not work with this mod because the mod relies on the Mono execution environment that Steam's version of the game provides. Second, BepInEx. This is the mod loader framework that the Extra Credit mod depends on. It is not optional. Third, the Extra Credit mod files themselves from the official GitHub repository. Do not download BepInEx from random modding forums. Get it from the official release page. I learned this the hard way when a mirrored version included a trojanized DLL that caused my system to behave strangely for about six hours before I caught it in Task Manager.
The Installation Process
Close Balatro completely. Check your system tray to make sure the process is not still running in the background. Sometimes the game stays open even after you close the window, and if you try to overwrite files while the game is partially running, you will get permission errors that look like mod failures but are actually just file locks. Extract the BepInEx archive into your Balatro game directory. The path is usually something like C:\Program Files (x86)\Steam\steamapps\common\Balatro\. The BepInEx folder should sit at the root level alongside the Balatro.exe file. Do not nest it inside another folder. Then extract the Extra Credit mod files into the BepInEx\plugins folder. If the mod comes with a manifest.json or a dependencies.txt file, read those first. Some versions of Extra Credit require specific patches or other mods to run correctly. The README will tell you if you need the Balatro Tweaks pack or a particular texture fix. Skip that step and you might wonder later why your jokers are rendering as blank white boxes.
Get the Full Details
Common Problems and What They Actually Mean
The game launches but the mod does nothing. This is almost always a version mismatch. Check the mod's release notes against your current Balatro build. Run steam://validate from your Steam library to make sure your game files are not corrupted from a failed update. The game crashes on startup with a DLL load failure. This usually means you have conflicting mods. Extra Credit has been known to conflict with other joker overhaul mods that also hook into the same game methods. Try disabling other mods one at a time. I once had two mods fighting over the same joker shuffle routine, and the crash only happened when both were enabled. Disabled either one and the game ran fine. Jokers appear but have wrong stats or descriptions. This is a cache issue. Balatro caches some of its JSON data on first launch. Delete the balatro_app.local config file and the saves folder contents to force a fresh read. This is not ideal if you have saves you want to keep, but it is the fastest way to tell whether your issue is a caching problem or a mod problem. Back up your save files first.
Performance drops after installing the mod. Extra Credit adds content, and more content means more runtime evaluation. If you are running a lower-end system, disable the extra blind variants or the more complex new jokers in the mod's configuration file. The config is located at BepInEx\config\ and the file will be named something like ExtraCredit.cfg. You can adjust severity settings there without touching the mod files themselves.
Edge Case That Took Me Too Long to Fix
There is a specific edge case where the mod works perfectly except for one particular new joker not appearing in the shop. The joker exists in the code, it loads, it shows up in the game's internal tables, but the shop RNG never selects it. The issue is that the shop's selection pool has a weight calculation that the mod does not override by default. The joker's weight is set to zero in the configuration, which means it is effectively invisible to the shop algorithm. The fix was to edit the mod's JSON data file directly. Inside the BepInEx\plugins\ExtraCredit folder, there is a balatro_jokers.json or similarly named file. I opened it in a text editor, found the entry for the missing joker, and changed the "shopWeight" value from 0 to 10. Restart the game and it appeared in the next shop. This is not documented anywhere prominently. I only figured it out by dumping the shop's selection array to a log file and noticing the joker was present in the pool but had zero probability weight.
Where to Get It
The official Extra Credit mod is available on GitHub under the repository maintained by its developer. Search for Extra Credit Balatro mod GitHub and look for the repository with the most recent activity and clearly labeled releases. Avoid third-party mirror sites. They often bundle adware or distribute outdated versions that do not match your current game build. The mod is not officially supported by the Balatro developers. If a game update breaks it, you are waiting on the community modder to patch it. That can take anywhere from a few hours to several days depending on the scope of the game change. During that window, you either roll back your game version or play without the mod. There is no middle ground. Save file compatibility is also not guaranteed across mod versions. Updating the mod may corrupt existing saves that had unearned modded jokers in them. Always back up your saves before installing a new mod version. I lost about three hours of progress once because I did not back up and a mod update changed the internal ID format for a new joker type.
Multiplayer is not affected since Balatro is single-player only, but if you ever play on a shared machine, the mod files are visible to anyone who can access the game directory. There is no encryption on the mod data.
