XML Modding

From Binding of Isaac: Rebirth Wiki
Jump to: navigation, search

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.

Attribute Explanation
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.

Attribute Explanation
name Used to identify the character by name.
cache Every time the cache is evaluated, these items are updated. Separated by spaces. Accepted values: damage, familiars, firedelay, flying, luck, range, shotspeed, speed, tearcolor, tearflag, and weapon. You can also use all if you want it to affect every value.
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 root attribute's directory from the <players> element.
nameimage The file name of the character's name sprite. Searches the nameimageroot attribute's directory from the <players> element.
portrait The file name of the character's portrait sprite. Searches the portraitroot attribute's directory from the <players> element.
bigportrait The file name of the character's large portrait sprite. Searches the bigportraitroot attribute's directory from the <players> element.


Dataminer Icon.png Modding Dataminer Icon.png
Rebirth & Afterbirth | Afterbirth †

References Modding Tutorials - XML Modding - Added in Afterbirth † Lua Reference - Added in Afterbirth † Modding of Isaac Lua Reference
Tools Added in Afterbirth † Debug Console - Modding Tools - Basement Renovator
Releases Modding of Isaac - Added in Afterbirth † Steam Workshop - NexusMods
Community Modding of Isaac Subreddit - Modding of Isaac Discord Server
The Binding of Isaac: Rebirth The Binding of Isaac: Rebirth The Binding of Isaac: Rebirth
Achievements Achievements Attributes Attributes Bosses Bosses TarotCard.png Cards and Runes Challenges Challenges Chapters Chapters
Characters Characters MainPageBabies.png Co-op Items Items Item Pools Item Pools Monsters Monsters Objects Objects
Pickups Pickups Pills Pills Rooms Rooms Seeds Seeds Transformations Transformations Trinkets Trinkets