What is REPENTOGON?

REPENTOGON is an unofficial script extender for The Binding of Isaac: Repentance. It significantly expands the modding API to address long-standing issues and introduces new possibilities for modders. As a nice bonus, REPENTOGON also comes with a small handful of optional quality-of-life improvements and bug fixes.

My Antivirus says the REPENTOGON Installer is a virus! Is it safe?

Yes. Antivirus programs may flag the REPENTOGON installer due to how it was programmed. This issue will be fixed in the future. For now, you will have to use the manual download method or exclude the installer from your antivirus.

If you are still unsure on whether or not REPENTOGON is safe, you can view the source code of everything pertaining to the project here[github.com]. REPENTOGON will always remain open source.

How do I disable REPENTOGON?

Add to the game's Steam launch options. If you are playing on an unsupported version of the game, REPENTOGON will auto-disable itself.

How do I uninstall REPENTOGON?

If you are using the REPENTOGON installer, open it and click on Uninstall. Otherwise, delete from the game’s directory and verify file integrity via Steam.

Does REPENTOGON work on Linux/Steam Deck/Mac?

Yes, via Proton/Wine. However, you will need to use the manual installation method and add the following launch option:

Note for Mac users: Only the Steam version is supported.

Is REPENTOGON compatible with existing mods?

Generally, yes. However, some mods may encounter issues due to stricter validation (e.g., malformed XML files or dividing vectors by zero). Unlike the base API, REPENTOGON now catches these issues to prevent certain bugs.

Will REPENTOGON break when the game updates?

Yes, and this is unavoidable. For smaller updates, we can update REPENTOGON relatively quickly. However, larger updates (such as the release of Repentance+) will take longer.

The process of updating REPENTOGON for larger updates is significantly than it should be due to the lack of debug symbols present in the game. Even though the game has always been shipped with debug symbols on other platforms, Nicalis has never included them in the Steam release. This has harmed REPENTOGON by making the process of adapting to larger updates much more difficult and time-consuming than it should be.

We nonetheless respect Nicalis' decision and ask you to not pester them about it.

Does REPENTOGON make the game faster?

Yes. Not only do we optimize some aspects of the existing modding API, but we have also reduced how long it takes for the game to launch. You can expect further performance gains as mods drop their performance-heavy workarounds and adapt REPENTOGON’s features directly.

Keep in mind that REPENTOGON is not a cure to lag, especially if you have a lot of large content mods installed. Due to how the game was programmed, there’s only so much we can do with optimization. We will continue to look into ways to further optimize the game.

Does REPENTOGON work on GOG/Epic Games Store?

No, as these versions of the game are outdated. If Nicalis updates them to be the same version as Steam, we will look into supporting them.

Does REPENTOGON work for Afterbirth+/Afterbirth/Rebirth?

No, we do not have plans on supporting older DLCs.

How do I open the REPENTOGON menu?

Press the key to open the debug console and use the top bar to access REPENTOGON’s menus.

For non-US keyboards, you can see which key is needed to open the debug console here[bindingofisaacrebirth.wiki.gg].

Does REPENTOGON add anything to the game?

No. It includes optional quality-of-life tweaks and bug fixes, which can be toggled in the REPENTOGON menu.

How do I disable the mod error popup?

Dismiss it by opening the debug console or clicking the message. We will not add a permanent option to disable it as it would lead to users ignoring these issues and not reporting them to mod developers, harming the modding ecosystem.

This decision is final.

Help! I found a bug! Where do I report it?

Before reporting a bug, please disable all mods first. Many bugs that users report tend to be caused by mods and not REPENTOGON itself.

If you are absolutely certain it is a bug with REPENTOGON itself, please create an issue on our GitHub here[github.com].

Does REPENTOGON have a Discord server?

The Modding of Isaac Discord server has a channel dedicated to REPENTOGON and most of the developers are active there. You can join it here[discord.com].


Can I install REPENTOGON by subscribing to the mod?

No. The Steam Workshop mod serves only as a dependency for REPENTOGON-reliant mods and alerts users to install REPENTOGON if it’s missing.

To actually install REPENTOGON, go here[repentogon.com].

The installer says that Installation must be performed from the game’s directory!

Move the installer to the game’s directory and run it from there.

To Locate the game directory on Steam:

• Open the game’s Steam library page.
  
• Click on the gear icon (⚙️) → Manage → Browse local files

I followed the steps installing REPENTOGON but the game says it’s not installed!

Some things you can do to troubleshoot the issue:

• If you are on Linux/Steam Deck/Mac, you added the launch option
  WINEDLLOVERRIDES=dsound=n,b %command%
  .
• Close the game entirely before installing.
  
• Exclude the installer from your antivirus or use the manual download method[repentogon.com].

If none of the above works, you may be facing a rare Windows issue that is blocking one of our DLLs from loading. This will be fixed in the future.

The game is frozen when launching REPENTOGON!

If the game is frozen and not responding when launching the game, try the following steps in order:

• Wait for a little bit. Sometimes the game might freeze when launching it.
  
• Restart your PC if you just installed REPENTOGON to see if that fixes the issue.
  
• As a last resort, disable auto-updates. To disable auto updates manually, go to the game's directory and open the "dsound.ini" file. In it you'll see the line "CheckForUpdates = 1". Change it to "CheckForUpdates = 0" and save the file.