Mod Config Menu is a library that enables other mods to feature a settings menu. This particular version removes all the hacky API overrides used by the original author—a terrible programming practice that can
Disclaimer: I am not the author of this mod. I am only posting it here. If you want me to remove this mod page, just message me. Krampus | GravatarDisclaimer 2: If you are downloading from here, you are not using the Steam version. That said, it does work — in fact, you can download my Vortex support extension. Here.Before posting a comment, please read the FAQ below. Comments that ask questions already covered will be deleted.
Introduction
Mod Config Menu is a library that allows other mods to add a settings menu. Only subscribe to this mod if you have other mods that require it.
This specific version of Mod Config Menu removes all the hacky API overrides used by the original author—an awful programming practice that can cause issues with other elements in the Isaac ecosystem. That's why I call it the "Pure" version.
This mod is open-source. You can help with development by
Contributing on GitHub[github.com]
Credit goes to piber20 for originally creating this library and Chifilly for updating it for Repentance.
Using Mod Config Menu
To use Mod Config Menu Pure, do not use the "require," "dofile," or "pcall" functions. Instead, just check if the global variable "ModConfigMenu" exists, something like this:
local MOD_NAME = "My Mod"
local VERSION = "1.0"
local function setupMyModConfigMenuSettings()
if ModConfigMenu == nil then return end
ModConfigMenu.AddSpace(MOD_NAME, "Info")
ModConfigMenu.AddText(MOD_NAME, "Info", function() return MOD_NAME end)
ModConfigMenu.AddSpace(MOD_NAME, "Info")
ModConfigMenu.AddText(MOD_NAME, "Info", function() return "Version " .. VERSION end)
end
Troubleshooting
Note that the "Pure" version of Mod Config Menu will not work properly if:
– You have subscribed to the "Pure" version and another version at the same time. This may cause a conflict.
– You are subscribed to a mod that uses a standalone version of Mod Config Menu, which will cause a conflict.
– You are subscribed to a mod that uses the "require", "dofile", or "pcall" functions to initialize or invoke the Mod Config Menu.
Navigation
Keyboard:
– Use arrow keys or WASD to move.
– Esc, Backspace, or Q can be used to go back.
– E, space, or enter can be used to select an item.
– Press L to open the menu by default.
– F10 will always open the menu; this cannot be changed.
Controller:
– Both control sticks can be used to move.
– Press B to go back.
– Press A to select an item.
– Press the right stick to open the menu.
FAQ
**A:** Yes, it's compatible with Repentance.
A: Yes.
Q: Does it work with Afterbirth+?
A: No, because it uses features exclusive to Repentance to adjust the HUD offset.
A: Try checking for mod updates or compatibility patches first. If the issue persists, report it to the mod author with details about your setup and the specific mod.
A: This is likely because the mod uses the "require", "dofile", or "pcall" functions to initialize or call Mod Config Menu. Please contact the specific mod author to fix this issue—do not leave a comment here.
A: Mod Config Menu Continued is a mod configuration menu framework.
A: The original Mod Config Menu was created by piber20. Mod Config Menu Continued is an updated version by Chifilly, aimed at compatibility with the Repentance DLC and fixing certain bugs. Mod Config Menu Pure is a further update of Mod Config Menu Continued, focused on resolving additional bugs. Therefore, Mod Config Menu Continued is not the same as Mod Config Menu Pure.
Q: What are the differences between the original Mod Config Menu, Mod Config Menu Continued, and Mod Config Menu Pure?
A: There are some minor technical differences. But for the average player, you’d never notice them—other than the fact that certain versions work with some mods and others don’t. So, use whichever version gives you the fewest bugs for the specific mod combination you want to play. (Or reach out to the authors of the other mods you're using to make them compatible with Mod Config Menu Pure, if they aren’t already.)
A: As a player, do I need to subscribe to both this mod and other versions of the Mod Config Menu at the same time?
A: No. You should only subscribe to one specific version of Mod Config Menu at a time.
Q: What do I do if my mod settings don’t save between game sessions?
A: Mod Config Menu only handles saving data for the "General" and "Mod Config Menu" pages. If a specific mod fails to save its data correctly, please contact that mod's author.
Q: Does this have the same API functionality as other versions of Mod Config Menu?
A: Yes, but it may not work as a direct drop-in replacement for mods that use "require," "dofile," or "pcall" functions to initialize or call Mod Config Menu. Another common issue is using outdated properties like "ModConfigMenuOptionType.BOOLEAN" instead of "ModConfigMenu.OptionType.BOOLEAN." If you're a mod author looking to switch to the pure version, make sure to test everything thoroughly.
Q: What does it mean to "remove API overrides"?
A: The original version overwrote some Lua and Isaac API functions, like `pcall` and `RequireMod`. This version does not overwrite any API functions.
A: Go to the main menu and check the bottom-left corner for the version number.
A: There are three ways. First, you can check the version in the console. Second, you can find it in the game's "log.txt" file. Third, you can see it at the top of the file "C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac Rebirth\mods\!mod config menu_2681875787\scripts\modconfig.lua".
Q: Where is the game’s "log.txt" file located?
A: By default, it is located here:
C:\Users\james\Documents\My Games\Binding of Isaac Repentance\log.txt
Q: Where is the save data for Mod Config Menu located?
A: By default, it's located here: C:\Program Files (x86)\Steam\steamapps\common\The Binding of Isaac Rebirth\data\!!mod config menu\save#.dat
Q: Why doesn’t Mod Config Menu work for me?
A: It works for everyone else, so it has to be something wrong with you. Start by uninstalling the game, completely removing all leftover game files, reinstalling the game, and then only subscribing to this mod on the workshop and nothing else. For more information on where the various game files are located, see
My Directories & Save Files Explained[github.com]
Q: What changed in the last update?
A: Like any other open source piece of software, you can find the changes.
on GitHub[github.com]