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
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. 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.
|
Modding resources
- Debug Console
- Lua Reference
- Modding
- Modding Tools
- Modding Tutorials
- XML Modding