To install mods for The Binding of Isaac: Repentance , the easiest method is using the Steam Workshop, though manual installation is also possible for non-Steam versions. 1. Steam Workshop Installation (Recommended) This is the standard way for most players to add mods.
However, installing mods for Repentance is not as simple as dragging and dropping files. Due to how the game handles its DLC and anti-cheat mechanics, there are specific steps you must follow. This guide will walk you through everything—from the first workshop subscription to troubleshooting common issues.
Even if you've subscribed to a mod, you must ensure it is active within the game's engine. Launch The Binding of Isaac: Repentance. From the Main Menu, select Stats, then select Mods. You will see a list of your subscribed mods.
Conflicts, load order, and compatibility
- If a mod causes crashes, remove it and test mods one-by-one to isolate the issue.
- Some mods override the same assets or scripts and will conflict; check mod pages for compatibility notes.
- Keep mods updated; outdated mods often break after game patches.
Extract Files: Create a new folder inside the mods directory named after your mod, and extract the downloaded contents into it.
After installing mods, you may need to configure them to work properly. Some mods require you to configure their settings or choose specific options to work correctly. Check the mod's documentation or settings menu to configure the mod to your liking.
“I installed a character mod, but they don’t appear on the selection screen.”
Fix:
Problem 4: "Mods" button is greyed out?
- Cause: You’re using a cracked or GOG version of the game. The official mod API only works with Steam’s DRM and the latest Repentance patch.
- Fix: Buy the game on Steam (and the DLCs in order: Rebirth → Afterbirth → Afterbirth+ → Repentance).