Skip to content
Chummer 5 Is Alive edited this page Dec 6, 2022 · 1 revision

spells.xml (and custom_spells.xml, see Custom Data Files) contains all of the information on spells.

Structure

<chummer>
   <spells>
      <spell />
   </spells>
</chummer>

spell nodes describe individual spells.

spell Node

<spell>
   <id />
   <hide />
   <ignoresourcedisabled />
   <name />
   <page />
   <source />
   <category />
   <damage />
   <descriptor />
   <duration />
   <dv />
   <range />
   <type />
   <bonus />
   <forbidden />
   <required />
</spell>

id (required): the internal name of the spell. All ID fields are standard GUIDs, which can be generated by external websites or plugins.

hide (optional): Is the spell hidden from the standard selection window. Considered to be true if this is present.

ignoresourcedisabled (optional): Is the spell available even if the sourcebook is disabled. Considered to be true if this is present.

name (required): the name of the spell.

page (required): the page number this item can be found on in the Sourcebook.

source (required): the code for the Sourcebook that this entry comes from. See books.xml.

category (required): the Category that this Spell belongs to. This must match one of the Categories defined in the categories Node.

damage (required): String. Whether the spell deals Physical (P), Stun (S) or other damage

bonus (optional): a bonus node that describes any bonuses this entry grants. See Improvement Manager for more information.

required (optional): the spell has certain requirements that the character must meet before it can be selected. See required Node for more information.