XML Modding

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.

For modding Challenges, see Custom Challenges.

bosscolors.xml[]

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

Boss[]

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[]

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[]

The players.xml file contains information and statistics about the different characters.

Players[]

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[]

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.