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.
XML Modding is an aspect of Modding that applies to altering XML files. The capabilities are limited depending on the XML file that is being modded. In Afterbirth+, mods can add new content to an existing XML file under the content folder of the mod.
players.xml[edit | edit source]
The players.xml file contains information and statistics about the different characters.
Players[edit | edit source]
The root element is
<players>, which may contain attributes that identify the root directories for graphics.
|root||Character skin directory.|
|nameimageroot||Character name sprite directory.|
|portraitroot||Character portrait sprite directory.|
|bigportraitroot||Large character portrait sprite directory.|
Player[edit | edit source]
The meat of the file are the individual
<player> elements. These contain the file names and a number of statistics of each character.
|name||Used to identify the character by name.|
|cache||Every time the cache is evaluated, these items are updated. Separated by spaces. Accepted values: |
|hp||The amount of filled red hearts the character starts with. 1 per half heart.|
|armor||The amount of soul hearts the character starts with. 1 per half heart.|
|black||The amount of black hearts the character starts with. 1 per half heart.|
|coins||The amount of coins the character starts with.|
|bombs||The amount of bombs the character starts with.|
|items||The ids of the items the character starts with. Separated by spaces. Does not work with custom items.|
|card||The id of the card the character starts with. Does not work with custom items.|
|pill||The id of the pill the character starts with. Does not work with custom items.|
|trinket||The id of the trinket the character starts with. Does not work with custom items.|
|skin||The file name of the character's skin. Searches the |
|nameimage||The file name of the character's name sprite. Searches the |
|portrait||The file name of the character's portrait sprite. Searches the |
|bigportrait||The file name of the character's large portrait sprite. Searches the |
|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|
|Achievements||Attributes||Bosses||Cards and Runes||Challenges||Chapters|