Major changes are coming to the Wiki! To learn more and let your voice be heard, please go here.
Additionally, we are currently experiencing some bugs and glitches. We're working on fixing them, but please be aware this means certain images, such as the collection grid for items, will be replaced by errors for the time being.
Modding | |
---|---|
Rebirth & Afterbirth | Afterbirth † |
Modding is now officially supported in Afterbirth+, enabling users to mod the game using the Lua programming language and to upload their creations to the Steam Workshop.
- 1Installing Mods
- 3Ensuring stability
Installing Mods[edit | edit source]
Mods can be installed in a few different ways, depending on how the author chose to share it. Mods can typically be found in the Steam Workshop or in various community sources.
Steam Workshop[edit | edit source]
Mods found in the Steam Workshop can be installed by navigating to the mod's page and clicking Subscribe. The game must be started to install the mod into the game.
Manual installation[edit | edit source]
Mods that do not use the Steam Workshop can be installed by downloading them and extracting them to the appropriate location.
OS | Path |
---|---|
Windows | Documents/My Games/Binding of Isaac Afterbirth+ Mods |
Linux | ~/.local/share/binding of isaac afterbirth+ mods |
Mac | ~/Library/Application Support/Binding of Isaac Afterbirth+ Mods |
Enabling unlocks[edit | edit source]
In Afterbirth+, having any enabled mod will disable the ability to unlock any achievements to encourage new players to play the game without any. To enable unlocking achievements with mods enabled, you need to defeat Mom at least once with all of your mods disabled.
Ensuring stability[edit | edit source]
While introducing official modding support, mods for this game are infamous for not working properly due to how the API was constructed and the lack of suitable, comprehensible documentation.
Save data[edit | edit source]
Many mods do not or cannot retain save data in a continued game. This could be due to the mod author not knowing how to enable this, or the mod's data being too complicated to save. It is recommended to avoid continuing any saved games if any mods are enabled.
Some mods may have their save data cleared if one of the situations below occurs:
- The mod was recently updated.
- The mod was unsubscribed from and then resubscribed to, forcing the mod to be downloaded again.
If any installed mods contain save data that must be kept between runs (for example, custom unlockables) then this would be a big concern, as deleting the mod's save data would remove this progress. Some ways to work around these issues include:
- Backing up the save.dat files included in the mods after most sessions.
- Installing the Mod Compatibility Hack, which will back up the saves of other mods within itself.
Assets[edit | edit source]
Most mod assets do not load properly if one of the situations below occurs:
- Playing the game after the first time the game has loaded after subscribing to or unsubscribing from a mod on the Steam Workshop.
- Playing the game after a mod on the Steam Workshop updates.
- Continuing to play the game after enabling or disabling a mod from within the in-game mods menu. (this can also lead to a crash when leaving the menu).
When this happens, many textures and animation files will not be applied in-game. For example, a custom monster added by a mod affected by this issue may appear invisible. Some ways to work around these issues include:
- Restarting the game after loading it if a mod was recently subscribed to. If there is a long pause and a black screen when starting the game, the game may be installing the mods. Restart the game after it has finished loading past this screen.
- When the process of enabling or disabling mods in-game is complete, do not leave the menu. Instead, press Alt+F4 to close the game without ever leaving the menu and risking a crash or improperly loaded assets. Then simply start up the game again.
Resources[edit | edit source]
Listed below are resources that can assist you in making your own mods.
A built-in console to use various commands to test mods: give items, go to stage x, reload lua script and so on.
A list of tools that can help in mod creation and debugging (Official and unofficial tools are included).
![How How](/uploads/1/2/3/7/123729731/850252938.jpg)
User updated Doxygen lua reference for The Binding of Isaac Afterbirth + Lua API based on the official lua reference, useful when coding mods.
User made reference for The Binding of Isaac Afterbirth + Lua API hosted on this wiki.
Links to external tutorials about modding, ranging from animations to spriting and Lua programming.
Information about modding XML files. This is needed for examples to add new costumes, items or player types to mods.
Mod Hosts[edit | edit source]
The official mod repository, these mods only work for Afterbirth+. Importerror: module use of python35.dll conflicts with this version of python.
A service by the community to host mods created primarily for Rebirth and Afterbirth, though Afterbirth+ mods can be hosted here too.
A section of NexusMods which is home to Isaac mods. Not very active.
Community[edit | edit source]
A subreddit to discuss mods and modding.
A Discord server to discuss mods and modding.
Modding Rebirth & Afterbirth | Afterbirth † | ||
---|---|---|
References | Modding Tutorials - XML Modding - Lua Reference - Modding of Isaac Lua Reference | |
Tools | Debug Console - Modding Tools - Basement Renovator | |
Releases | Modding of Isaac - Steam Workshop - NexusMods | |
Community | Modding of Isaac Subreddit - Modding of Isaac Discord Server |
The Binding of Isaac: Rebirth |
---|
Retrieved from 'https://bindingofisaacrebirth.gamepedia.com/index.php?title=Modding_(Afterbirth_†)&oldid=198308'
Posted by2 years ago
Archived
Just a quick tutorial on how to install AND upload mods to the Steam Workshop using sample mods from the blog.
And yes, Afterbirth+ has a Steam Workshop (!!!). However, it doesn't seem to be accessible to everyone just yet, but you can still view your own mods.
Obviously I don't have any mods that I made myself yet, so I'll use the mod samples Tyrone provided on the Isaac blog instead. Here's the link.
How to install mods
Binding Of Isaac Rebirth
- Extract the folders Hothead and PoopingMonstro
- Go to DocumentsMy GamesBinding of Isaac Afterbirth+ Mods and place the two folders there
- Done! You can now activate or deactivate the mods in the Mods menu when you start the game!
![Isaac Isaac](/uploads/1/2/3/7/123729731/710399431.jpg)
How to upload your mod to the Steam Workshop
- VERY IMPORTANT: Run the game at least ONCE, AFTER you installed your mods -> this will create a file you will need for the ModUploader tool later
- Go to SteamsteamappscommonThe Binding of Isaac RebirthtoolsModUploader and run ModUploader.exe
- Click Choose Mod and browse to the mod folders on DocumentsMy GamesBinding of Isaac Afterbirth+ Mods
- Go into either the Hothead or PoopingMonstro folder and select the metadata.xml file -> this is the file that was generated when you ran the game once
- Fill out the rest of the form any way you want and click Upload Mod
- Done! Now you can click on View Mod to view your mod on the Steam Workshop
I uploaded both the sample mods already on the Steam Workshop, so once the Steam Workshop is public, these links should work (not claiming they're mine, obviously, I'll remove them later):
4 comments