Welcome Guest, you are in: Login

Chummer Wiki

RSS RSS

Navigation







Search the wiki
»
gear.xml (and custom_gear.xml, see Custom Data Files) contains all of the information for Street Gear. Ammunition is treated as Street Gear.

Structure

<chummer>
   <categories>
      <category />
   </categories>
   <gears>
      <gear/>
   </gears>
</chummer>

categories describe the different Categories of Gear.

gear nodes describe the individual pieces of Gear.

categories Node

<categories>
   <category />
</categories>

category (required): the name of the Gear Category. This list populates the Category list found in the Select Gear window. Categories are used to group Gear into groups such as Ammunition, Compounds, and Misc. Electronics. May contain the show attribute which, when set to "false", hides the Category from the Category list unless it is explicitly listed specified as an addon Category for an item.

gear Node

<gear>
   <name />
   <category />
   <addoncategory />
   <rating />
   <minrating />
   <capacity />
   <armorcapacity />
   <firewall />
   <system />
   <response />
   <signal />
   <avail />
   <avail3 />
   <avail6 />
   <avail10 />
   <addweapon />
   <cost3 />
   <cost6 />
   <cost10 />
   <costfor />
   <cost />
   <weaponbonus />
   <bonus />
   <childcostmultiplier />
   <childavailmodifier />
   <source />
   <page />
   <gears />
</gear>

name (required): the name of the Gear.

category (required): the Category that this Gear belongs to. This should match one of the Categories defined in the categories Node. This may be set to General if this piece of Gear is only intended to be an add-on to another piece of Gear.

addoncategory (optional): by default, Gear can only have add-ons from its own Category and the General Category. You can add additional add-on Categories by using addoncategory. This must match either one of the Categories defined in the categories Node, or a Category of another item not in the Category list.

rating (required): the maximum Rating for this piece of Gear. Set to 0 if Ratings are not enabled for this piece of Gear.

minrating (optional): the minimum Rating for this piece of Gear.

capacity (optional): the Capacity for this piece of Gear. Pieces that consume Capacity should be enclosed in square brackets, identical to the style found in the Shadowrun 4 sourcebook.

armorcapacity (optional): the Capacity for this piece of Gear when placed in Armor. Pieces that consume Capacity should be enclosed in square brackets, identical to the style found in the Shadowrun 4 sourcebook. This Capacity amount only applies to Armor Suits as standard Armor instead uses the item's Rating to determine the Capacity consumed (see Maximum Armor Modifications and Armor Suit Capacity found on AR 44).

firewall (optional): required for Gear in the Commlink Operating System Category. The Operating System's Firewall.

system (optional): required for Gear in the Commlink Operating System Category. The Operating System's System.

response (optional): required for Gear in the Commlink Category. The Commlink's Response.

signal (optional): required for Gear in the Commlink Category. The Commlink's Signal.

avail (required): the Availability for this Gear. May use the Rating keyword if Rating is enabled. May use mathematical formula such as (Rating * 3)F. avail can start with + to indicate that it increases the base Gear'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.

avail3 (optional): the Availability for this Gear from Ratings 1 - 3. May use the Rating keyword if Ratings are enabled. May use mathematical formula such as Rating * 3.

avail6 (optional): the Availability for this Gear from Ratings 4 - 6. May use the Rating keyword if Ratings are enabled. May use mathematical formula such as Rating * 4.

avail10 (optional): the Availability for this Gear from Ratings 7 - 10. This is only needed when the Gear can go above Rating 6 and its Availability formula differs from avail. May use the Rating keyword if Ratings are enabled. May use mathematical formula such as Rating * 10.

addweapon (optional): when this piece of Gear 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 Grenades and Missiles to a character.

cost3 (optional): the Cost for the Gear from Ratings 1 - 3. If cost3 is specified, you must also include cost6 but cannot include cost. May use the Rating keyword if Ratings are enabled. May use mathematical formula such as Rating * 50.

cost6 (optional): the Cost for the Gear from Ratings 4 - 6. If cost6 is specified, you must also include cost3 but cannot include cost. May use the Rating keyword if Ratings are enabled. May use mathematical formula such as Rating * 50.

cost10 (optional): the Cost for the Gear from Ratings 7 - 10. May use the Rating keyword if Ratings are enabled. May use mathematical formula such as Rating * 50. This is only needed when the Gear can go above Rating 6 and its Cost formula differs from cost6.

costfor (optional): required for Gear in the Ammunition Category. This is used when there are multiple quantities of an item in each purchase, such as 10 bullets or 20 Security Tags. Applies only to cost, not cost3, cost6 or cost10.

cost (optional): the Cost for this Gear. If cost is not specified, you must instead specify cost3 and cost6. May use the Rating keyword if Ratings are enabled. May use mathematical formula such as Rating * 50. May contain mathematical formula involving Gear Cost such as Gear Cost * 0.2 which uses the cost of the parent piece of Gear. 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.

weaponbonus (optional): applies to Ammunition only. When present, loading the Ammo into a Weapon provides bonuses to the Weapon. See weaponbonus 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.

childcostmultiplier (optional): multiplies the cost of all plugins attached to this item by the amount specified.

childavailmodifier (optional): modifies the Availability of all plugins attached to this item by the amount specified.

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.

gears (optional): used to define individual components that make up a single purchasable piece of Gear. This is typically used to define Matrix Software Suites that are purchased as a single item but made up of several pieces of Matrix Software Gear that are able to be purchased individually. See gears Node for more information.

weaponbonus Node

<weaponbonus>
   <ap />
   <apreplace />
   <damage />
   <damagereplace />
   <damagetype />
   <pool />
   <rangebonus />
   <rc />
</weaponbonus>

ap (optional): modifies the Weapon's AP value by the specified amount.

apreplace (optional): replaces the Weapon's AP value with the new value.

damage (optional): modifies the Weapon's Damage Value by the specified amount.

damagereplace (optional): replaces the Weapon's Damage Value with the new value.

damagetype (optional): replaces the Weapon's Damage type with the new value.

pool (optional): adjusts the size of the Weapon's Dice Pool by the specified amount.

rangebonus (optional): adjusts the range of the Weapon by the specified percent.

rc (optional): modifies the Weapon's RC value by the specified amount.

gears Node

<gears>
   <gear />
   <usegear />
</gears>

gear (optional): used to create a fake piece of Gear that isn't available for purchase on its own. This is only used to create the individual components for Pre-Packaged Nexi. See gear Sub-Node for more Information.

usegear (optional): used to directly reference an existing Gear item as being a part of this package. See usegear Node for more information.

gear Sub-Node

<gear>
   <name />
   <category />
</gear>

name (required): the name of the Gear.

category (required): the category of the Gear.

usegear Node

<usegear>
   <name />
   <category />
   <rating />
   <gears />
</usegear>

name (required): exact name of the Gear to create as a plugin for the parent Gear. May use the select attribute to automatically select a value from any prompt that results by creating the Gear.

category (required): the Category that this Gear can be found in. This should match one of the Categories defined in the categories Node. This is used to identify which item to select since two items may have the same name but different Category and purpose.

rating (optional): the Rating at which to add the Gear at.

gears (optional): can be used to create plugins for the current plugin, allowing an infinite level or recursion. See gears Node for more information.

© ChummerGen.com, 2013