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.

bosscolors.xml[edit | edit source]

  • The bosscolors.xml file contains all champion variants of bosses.
  • The root element is <bosscolors> which contains separate <boss> elements inside it.

Boss[edit | edit source]

The individual <boss> elements are used to define champion variants for each boss. It contains the id and variant of the boss.

Attribute Explanation
id Boss entity id.
variant Boss variant.

Color[edit | edit source]

  • The <color> element is a child of <boss> and is used to determine the champion's color, scale and HP.
  • Multiple <color> elements can be added in each <boss> element in order to add more champion variants in the game.
Attribute Explanation
idx Color index. Ranges from 1 to 23.
health Health multiplier that is applied to the health amount of the non-champion boss variant. Defaults to 1.0. For example, if set to 1.15, this will make the champion have 15% more HP than the non-champion variant.
scale Scale multiplier that will be used for the boss' sprite. Defaults to 1.0. For example, if set to 0.85, this will make the champion appear 15% smaller than the non-champion variant.

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 (commas in Afterbirth †). 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.


Collectible Dataminer icon.png Modding Collectible Dataminer icon.png
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 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