qualities.xml

Modified on 2013/07/11 11:13 by Keith Rudolph — Categorized as: Chummer SR5 - Data Files

qualities.xml (and custom_qualities.xml, see Custom Data Files) contains all of the information for Qualities.

Structure

<chummer>
   <categories>
      <category />
   </categories>
   <qualities>
      <quality />
   </qualities>
</chummer>

categories nodes describe the different Categories of Qualities.

quality nodes describe the individual Qualities.

categories Node

<categories>
   <category />
</categories>

category (required): the name of the Category. This list populates the Category list found in the Select Quality window. Categories are used to group Qualities into groups such as Positive and Negative. Additional Categories should not be created for Qualities.

quality Node

<quality>
   <id />
   <name />
   <contributetolimit />
   <cost />
   <category />
   <selectable />
   <metagenetic />
   <mutant />
   <print />
   <limit />
   <bonus />
   <conditional />
   <addweapon />
   <required />
   <forbidden />
   <addqualities />
   <powers />
   <source />
   <page />
</grade>

id (required): a unique identifier (GUID) for the Quality.

name (required): the name of the Quality.

contributetolimit (optional): if present, this must be set to no. This Quality does not count towards the BP limit for Positive and Negative Qualities.

cost (required): the Karma Cost for the Quality. This is a negative number in the case of Negative Qualities since they award additional Karma.

category (required): the Category of the Quality. This must match one of the Categories defined in the categories Node.

selectable (optional): whether or not this Quality can be selected from the list of Qualities. Must be no if present. This is used to control certain Metatype Qualities like Low-Light Vision, allowing them to be added to the character when the Metatype is defined but not actually selectable by the player.

metagenetic (optional): whether or not this Quality is part of the Metagenetic Quality set. Must be set to yes if present.

mutant (optional): whether or not this Quality can is part of the Mutant Critters Quality set. Must be set to yes if present.

print (optional): if present, this must be set to no. This suppresses the Quality from appearing on printouts.

limit (optional): allows the Quality to be selected multiple times. Each time this Quality is selected, a new copy of it is added to the Quality list. Must be a numeric value which defines how many times the Quality may be taken by the character.

bonus (required): a bonus node that describes any bonuses this entry grants. See Improvement Manager for more information. May be left empty is the Quality does not provide any bonuses.

conditional (required): identical to the bonus node except that it creates conditional Improvements that can be turned on or off.

addweapon (optional): when this Quality is added, Chummer looks for a Weapon in weapons.xml and adds it to the character. The value must match the name of a Weapon exactly. This is used to add Quality-specific Weapons, such as Fangs, to a character.

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

forbidden (optional): the Quality cannot be taken if the character meets certain requirements. See forbidden Node for more information.

addqualities (optional): the Quality forces additional Qualities to be added to the character when selected. This can cause the character to exceed their standard 35BP/-35BP Quality restrictions. See addqualities Node for more information.

powers (optional): adds Critter Powers to the character when the Quality is added. See powers 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.

required Node

<required>
   <oneof />
   <allof />
</required>

oneof (optional): at least one of the requirements listed in this node must be met in order for the Quality to be selected. May be used in combination with allof node. When used together, at least one of the items in oneof must be met and all of the items in allof must be met. See oneof and allof Nodes for more information.

allof (optional): all of the requirements listed in this node must be met in order for the Quality to be selected. May be used in combination with oneof node. When used together, at least one of the items in oneof must be met and all of the items in allof must be met. See oneof and allof Nodes for more information.

forbidden Node

<forbidden>
   <oneof />
</forbidden>

oneof (required): if any of the requirements listed in this node are met this Quality cannot be selected. See oneof and allof Nodes for more information.

oneof and allof Nodes

<oneof> or <allof>
   <inherited />
   <quality />
   <metatype />
   <metatypecategory />
   <metavariant />
   <careerkarma />
   <attribute />
   <attributetotal />
   <cyberwares />
   <damageresistance />
   <ess />
   <skill />
   <skillgrouptotal />
   <streetcredvsnotoriety />
</oneof> or </allof>

inherited (optional): the Quality must be listed in the Metatype's <qualityrestriction> node in order to be selected. See metatypes.xml for more information.

quality (optional): the name of a Quality the character must have in order to select this Quality.

metatype (optional): the name of a Metatype that is required to select this Quality. See metatypes.xml for more information.

metatypecategory (optional): the name of a Metatype Category that is required to select this Quality.

metavariant (optional): the name of a Metavariant that is required to select this Quality. See metatypes.xml for more information.

careerkarma (optional): the amount of Career Karma the character must earn before they can select this Quality. Applies to <required /> only.

attribute (optional): the character must meet the specified Attribute requirement before they can select this Quality. See attribute Node for more information.

attributetotal (optional): the combined values of the Attributes specified must meet the specified total before the character can select this Quality. See attributetotal Node for more information.

cyberwares (optional): the character must have a specified number of Cyberware/Bioware enhancements from the specified list before they can select this Quality. See cyberwares Node for more information.

damageresistance (optional): the character must have a Damage Resistance Pool greater than or equal to the number specified before they can select this Quality.

ess (optional): the amount of Essence the character requires to select this Quality. When positive, the character's Essence must be greater than or equal to the number specified. When negative, the character's Essence must be lower than the number specified.

skill (optional): the character must have the Active Skill at the specified Rating or higher to qualify for the Quality. See skill Node for more information.

skillgrouptotal (optional): the character's combined Rating in a series of Skill Groups must meet or exceed a specified value in order to qualify for the Quality. See skillgrouptotal Node for more information.

streetcredvsnotoriety (optional): the character's Street Cred must be higher than their Notoriety in order to select this Quality.

addqualities Node

<addqualities>
   <addquality />
</addqualities>

addquality (required): the name of a Quality that the character will be forced to accept.

powers Node

<powers>
   <power />
</powers>

power (required): a Critter Powers that is added to the character when the Quality is added. May have the select attribute to specify specific values for the Critter Power. May appear multiple times to add multiple Critter Powers.

attribute Node

<attribute>
   <name />
   <total />
</attribute>

name (required): the three-character abbreviation for the Attribute to check.

total (required): the character's Attribute must equal or exceed this value in order to qualify for the Quality.

attributetotal Node

<attributetotal>
   <attributes />
   <val />
</attributetotal>

attributes (required): the list of Attributes that will be tested for meeting this condition. This must be written as Attribute 1+Attribute 2. For example, to test WIL + CHA, the expression would be written as WIL+CHA.

val (required): the combined total of the Attributes must meet or exceed this value in order to quality for the Quality.

cyberwares Node

<cyberwares>
   <cyberware />
   <cyberwarecategory />
   <cyberwarecontains />
   <cyberwareplugin />
   <bioware />
   <biowarecontains />
   <count />
</cyberwares>

cyberware (optional): the exact name of a piece of Cyberware that counts towards the required number of items to qualify for the Quality.

cyberwarecategory (optional): the name of a Cyberware Category that counts towards the required number of items to qualify for the Quality.

cyberwarecontains (optional): the partial name of a piece of Cyberware that counts towards the required number of items to qualify for the Quality. This is primarily to handle items that exist in both SR4 and SR2050 sourcebooks.

cyberwareplugin (optional): the name of a Cyberware plugin that counts towards the required number of items to qualify for the Quality.

bioware (optional): the exact name of a piece of Bioware that counts towards the required number of items to qualify for the Quality.

biowarecontains (optional): the partial name of a piece of Bioware that counts towards the required number of items to qualify for the Quality. This is primarily to handle items that exist in both SR4 and SR2050 sourcebooks.

count (required): the number of matching items the character must have in order to qualify for the Quality.

skill Node

<skill>
   <name />
   <val />
</skill>

name (required): the name of an Active Skill the character must have.

val (required): the minimum Rating the Active Skill must be at in order to qualify for the Quality.

skillgrouptotal Node

<skillgrouptotal>
   <skillgroups />
   <val />
</skillgrouptotal>

skillgroups (required): the names of Skill Groups to sum together.

val (required): the combined Rating of the specified Skill Groups must be greater than or equal to this value in order to qualify for the Quality.