vehicles.xml (and custom_vehicles.xml, see
Custom Data Files) contains all of the information for Vehicles and Vehicle Modifications.
Structure
<chummer>
<categories>
<category />
</categories>
<vehicles>
<vehicle />
</vehicles>
<mods>
<mod />
</mods>
</chummer>
categories describes the different Categories of Vehicles.
vehicle nodes describe the individual Vehicles.
mod nodes describe the individual Vehicle Modifications.
categories Node
<categories>
<category />
</categories>
category (required): the name of the Vehicle Category. This list populates the Category list found in the Select Vehicle window. Categories are used to group Vehicles into groups such as
Bikes,
Cars, and
Trucks.
vehicle Node
<vehicle>
<id />
<name />
<category />
<handling />
<accel />
<speed />
<pilot />
<body />
<armor />
<sensor />
<devicerating />
<avail />
<cost />
<mods />
<gears />
<weapons />
<source />
<page />
</vehicle>
id (required): a unique identifier (GUID) for the Vehicle.
name (required): the name of the Vehicle.
category (required): the Category that this Vehicle belongs to. This should match one of the Categories defined in the
categories Node.
handling (required): the Vehicle's Handling.
accel (required): the Vehicle's Acceleration. This must be entered as
x/y to show the Vehicle's "walking" and "running" Acceleration rates. If the Vehicle only has once Acceleration rate (such as 4), then it must be entered as
4/4.
speed (required): the Vehicle's Speed.
pilot (required): the Vehicle's Pilot.
body (required): the Vehicle's Body.
armor (required): the Vehicle's Armor.
sensor (required): the Vehicle's Sensor.
devicerating (required): the Vehicle's Device Rating.
avail (required): the Availability for this Vehicle.
cost (required): the Cost for this Vehicle.
mods (optional): lists the Weapon Accessories that come pre-installed with the Vehicle. See
mods Node for more information.
gears (optional): lists the Gear that comes pre-installed with the Vehicle. See
gears Node for more information.
weapons (optional): lists the Weapons that come pre-installed with the Vehicle. See
weapons 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.
mods Node
<mods>
<addslots />
<name />
</mods>
addslots (optional): adds an additional number of Vehicle Modification Slots equal to the value specified.
name (optional): specifies a Vehicle Modification that comes pre-installed with the Vehicle. This node may appear multiple times. The value entered here must match the name of a Vehicle Modification. See
mod Node for more information. This node may also have the
rating attribute which specifies the Rating of the Vehicle Modification installed. (
<name rating="4">My Vehicle Mod</name>
)
mod Node
<mod>
<name />
<category />
<rating />
<subsystems />
<response />
<signal />
<firewall />
<system />
<pilot />
<limit />
<weaponmount />
<slots />
<avail />
<cost />
<required />
<bonus />
<source />
<page />
</accessory>
name (required): the name of the Vehicle Modification.
category (required): the Category of the Vehicle Modification. This is for informational purposes only. This may be used to restrict Vehicle Modifications to the proper Vehicle types at a later date, so it is recommended that these follow the Vehicle Modification Categories found in the Arsenal sourcebook. Acceptable values:
All,
Standard,
Minidrones.
rating (required): the maximum Rating for the Vehicle Modification. Vehicle Modifications that do not allow Ratings should set this value to
0.
subsystems (optional): categories of Cyberware that may be added to this Vehicle Mod. See
cyberware.xml for more information.
response (optional): the new Response Rating value for the Vehicle.
signal (optional): the new Signal Rating value for the Vehicle.
firewall (optional): the new Firewall Rating for the Vehicle.
system (optional): the new System Rating for the Vehicle.
pilot (optional): the new Pilot Rating for the Vehicle.
limit (optional): the type of Vehicles that the Vehicle Modification is limited to, such as
Watercraft Only. This is for informational purposes only.
weaponmount (optional): whether or not the Vehicle Modification can be used to mount weapons. Acceptable values are
true and
false.
slots (required): the number of Vehicle Modification Slot that the Vehicle Modification consumes. May contain the
Rating
keyword if Ratings are enabled.
avail (required): the Availability for this Vehicle Weapon Modification. May contain the
Rating
keyword if Ratings are enabled. May contain mathematical formula such as
Rating * 3
.
cost (required): the Cost for this Vehicle Modification. May contain the
Rating
keyword if Ratings are enabled. May contain the
Body
keyword to use the Vehicle's Body. May contain the
Accel
keyword to use the Vehicle's Acceleration (Walking). May contain the
Accel(Running)
keyword to use the Vehicle's Acceleration (Running). May contain the
Speed
keyword to use the Vehicle's Speed. May contain mathematical formula such as
Accel * Body * 25
.
required (optional): the requirements the Vehicle must meet in order to accept the Vehicle Modification. See
required Node for more information.
bonus (optional): different from the traditional bonus nodes. This provides bonuses exclusively to the vehicle. See
bonus 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.
gears Node
<gears>
<gear />
</gears>
gear (required): specifies a piece of Gear that comes pre-installed with the Vehicle. This node may appear multiple times. The value entered here must match the name of a piece of Gear. This node may also have the
rating attribute which specifies the Rating of the Gear installed. (
<gear rating="4">ECCM</gear>
)
weapons Node
<weapons>
<weapon>
<name />
</weapon>
</gears>
name (required): specifies a Weapons that comes pre-installed with the Vehicle. This node may appear multiple times. The value entered here must match the name of a Weapon.
required Node
<required>
<accel />
<bodymax />
<bodymin />
<pilotmin />
<speed />
</required>
accel (optional): the minimum Acceleration value that Vehicle must have to accept the Vehicle Modification.
bodymax (optional): the maximum Body value the Vehicle may have and still accept the Vehicle Modification.
bodymin (optional): the minimum Body value the Vehicle must have to accept the Vehicle Modification.
pilotmin (optional): the minimum Pilot value the Vehicle must have to accept the Vehicle Modification.
speed (optional): the minimum Speed value the Vehicle must have to accept the Vehicle Modification.
bonus Node
<bonus>
<accel />
<armor />
<body />
<handling />
<speed />
</bonus>
accel (optional): multiplies the Vehicle's base Acceleration values by the amount specified and applies the amount to the Vehicle's total Acceleration values.
armor (optional): changes the Vehicle's Armor to the specified value. May contain the
Rating
keyword if Ratings are enabled.
body (optional): adjusts the Vehicle's Body value by the amount specified.
handling (optional): adjusts the Vehicle's Handling value by the amount specified.
speed (optional): multiplies the Vehicle's base Speed value by the amount specified and applies the amount to the Vehicle's total Speed value.