mentors.xml (and custom_mentors.xml, see
Custom Data Files) contains all of the information for Mentor Spirits. paragons.xml (and custom_paragons.xml) contains all of the information for Paragons. Despite the file name difference, the structure of the two files are identical.
Structure
<chummer>
<categories>
<category />
</categories>
<mentors>
<mentor />
</mentors>
</chummer>
categories describes the different Categories of Mentor Spirits/Paragons.
mentor nodes describe the individual Mentor Spirits/Paragons.
categories Node
<categories>
<category />
</categories>
category (required): the name of the Category. This list populates the Category list found in the Select Mentor Spirit/Paragon window. Categories are used to group Mentor Spirits/Paragons into groups such as
Animal and
Toxic.
mentor Node
<mentor>
<id />
<name />
<category />
<advantage />
<disadvantage />
<bonus />
<choices />
<source />
<page />
</mentor>
id (required): a unique identifier (GUID) for the Mentor Spirit/Paragon.
name (required): the name of the Mentor Spirit/Paragon.
category (required): the Category that this Mentor Spirit/Paragon belongs to. This must match one of the Categories defined in the
categories Node.
advantage (required): describes the advantages that the Mentor Spirit/Paragon provides.
disadvantage (required): describes the disadvantages that the Mentor Spirit/Paragon provides.
bonus (optional): a bonus node that describes any bonuses this entry grants. See
Improvement Manager for more information.
choices (optional): a list of additional bonuses that the Mentor Spirit/Paragon grants. The character must choose one of these bonuses to receive. See
choices Node for more information.
source (required): the code for the Sourcebook that this entry comes from. See
books.xml.
page (required): the page number this item can be found on in the Sourcebook.
choices Node
<choices>
<choice>
<name />
<bonus />
</choice>
</choices>
name (required): the name of one of the choices the character can select.
bonus (required): a bonus node that describes any bonuses this choice grants. These bonuses are in addition to those granted by the Mentor Spirit/Paragon's static ones. If the choice does not provide a bonus, or does not provide a bonus to a Skill or Attribute,
<selecttext />
must be used. See
Improvement Manager for more information.