Welcome Guest, you are in: Login

Chummer Wiki

RSS RSS

Navigation







Search the wiki
»
cyberware.xml (and custom_cyberware.xml, see Custom Data Files) contains all of the information for Cyberware.

Structure

<chummer>
   <grades>
      <grade />
   </grades>
   <categories>
      <category />
   </categories>
   <cyberwares>
      <cyberware />
   </cyberwares>
   <suites>
      <suite />
   </suites>
</chummer>

grade nodes describe different Grades of Cyberware.

categories describes the different Categories of Cyberware.

cyberware nodes describe the individual pieces of Cyberware.

suite nodes describe Cyberware Suites.

grade Node

<grade>
   <name />
   <ess />
   <cost />
   <avail />
   <source />
</grade>

name (required): the name of the Grade.

ess (required): the Essence multiplier for the Grade.

cost (required): the Cost multiplier for the Grade.

avail (required): the Availability adjustment for the Grade. Negative numbers bring the item's Grade closer to 0.

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

categories Node

<categories>
   <category />
</categories>

category (required): the name of the Cyberware Category. This list populates the Category list found in the Select Cyberware window. Categories are used to group Cyberware into groups such as Headware, Eyeware, and Cyberlimb.

cyberware Node

<cyberware>
   <name />
   <category />
   <limbslot />
   <rating />
   <minrating />
   <ess />
   <capacity />
   <avail />
   <addweapon />
   <cost />
   <allowgear />
   <bonus />
   <forcegrade />
   <subsystems />
   <source />
   <page />
</cyberware>

name (required): the name of the Cyberware.

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

limbslot (optional): if this is a Cyberlimb, what type of "limb slot" does it use on the character. Acceptable values: arm, head, leg, torso.

rating (optional): when present, Ratings for this piece of Cyberware are enabled. The maximum Rating is equal to the value specified here.

minrating (optional): the minimum Rating for this piece of Cyberware. If used, <rating> must also be specified.

ess (required): the Essence cost for this piece of Cyberware. May contain the Rating keyword if Ratings are enabled. May contain mathematical formula such as Rating * 0.1. May used FixedValues if necessary. See Using Fixed Values for more information.

capacity (required): the Capacity used by this piece of Cyberware. Pieces that may be used as plugins (that is, those that can be placed inside of a larger part like a cyberlimb) must be enclosed in square brackets, identical to the style found in the Shadowrun 4 book. For example, [3]. May used FixedValues if necessary. See Using Fixed Values for more information.

avail (required): the Availability for this piece of Cyberware. May contain the Rating keyword if Ratings are enabled. May contain mathematical formula such as (Rating * 3)F. avail can start with + to indicate that it increases the base Cyberware's Availability instead. avail starting with + can also include R or F to change its Availability. For example +3R would add 3 to the parent item's Availability and make it Restricted if it was not already. This will not downgrade an item from Forbidden to Restricted - this highest restriction is always kept. May used FixedValues if necessary. See Using Fixed Values for more information.

addweapon (optional): when this piece of Cyberware 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 Cyberweapons to a character.

cost (required): the Cost for this piece of Cyberware. May contain the Rating keyword if Ratings are enabled. May contain mathematical formula such as Rating * 3000. May contain a variable value such as Variable(20-100) or Variable(10000+) to give the item a variable cost if it does not use Ratings. May used FixedValues if necessary. See Using Fixed Values for more information.

allowgear (optional): This is used to allow Gear to be attached to a piece of Cyberware. See allowgear Node for more information.

bonus (optional): a bonus node that describes any bonuses this entry grants. Values may contain the Rating keyword if Ratings are enabled. See Improvement Manager for more information.

forcegrade (optional): forces the Cyberware to be added using the Grade specified. This must match one of the Grades specified in the grades Node.

subsystems (optional): By default, Cyberware may only have plugins from their own Category. This is used to specify additional Categories of Cyberware that can be added to this piece of Cyberware. See subsystems 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.

subsystems Node

<subsystems>
   <subsystem />
</subsystems>

subsystem (required): specifies an additional Category of Cyberware that may be included as a plugin for the current piece of Cyberware. This must match one of the Categories defined in the categories Node. This may appear multiple times to allow multiple Categories of Cyberware to be added.

allowgear Node

<allowgear>
   <gearcategory />
</allowgear>

gearcategory (required): specifies a Category of Gear that may be attached as a plugin for the current piece of Cyberware. This must match one of the Categories defined in the gear.xml data file. This may appear multiple times to allow multiple Categories of Gear to be added.

suite Node

<suite>
   <name />
   <grade />
   <cyberwares />
</suite>

name (required): the name of the Cyberware Suite.

grade (required): the Grade that the Cyberware Suite should be created with. This must match one of the Grades specified in the grades Node.

cyberwares (required): the list of Cyberware components that make up the Cyberware Suite. See cyberwares Node (Cyberware Suite).

cyberwares Node (Cyberware Suite)

<cyberwares>
   <cyberware />
</cyberwares>

cyberware (required): a reference to a piece of Cyberware. See cyberware Node (Cyberware Suite).

cyberware Node (Cyberware Suite)

<cyberware>
   <name />
   <rating />
   <cyberwares />
</cyberware>

name (required): the name of a piece of Cyberware that is a part of the Cyberware Suite. This must match one of the pieces of Cyberware specified in the cyberware Node. This node may include the select attribute to specify a value for a piece of Cyberware that prompts for one, such as a side of the body.

rating (optional): when present, the Cyberware is added at the Rating specified.

cyberwares (optional): specifies a list of Cyberware plugins that will be added to the current piece of Cyberware. See cyberwares Node (Cyberware Suite).

Using FixedValues

When an element does not follow a particular formula, values may be assigned to each Rating using FixedValues. FixedValues negates the need to create multiple copies of something like Cybereyes because one or two elements stray from the formula the other versions of it use, or that follow no formula at all. FixedValues uses a comma-separated list of values to specify the element's value at each Rating of the Cyberware. One item must exist per Rating of the Cyberware. For example, Cybereyes' Cost is 500, 750, 1000, and 1500 respectively. Since the last Rating of Cybereyes strays from the formula, FixedValues can be used. The Cost would then be written as <cost>FixedValues(500,750,1000,1500)</cost>

© ChummerGen.com, 2013