Skip to content

Bonuses

John Arena III edited this page Oct 13, 2026 · 9 revisions

Overview

Bonuses are a collection of tracked effects, conditions, or value modifications that are applied to a pilot, mech, or NPC. Bonuses are handled mechanically by COMP/CON to modify values on NPCs, Pilots, Mechs, other items or features, etc. In-game effects that are unable to be represented by bonuses should be handled by effect text and/or a synergy object.

Definition

In these documents, the data form for Bonuses are represented by IBonusData objects, structured as follows:

{
  "id": string,
  "val"?: string | number | boolean | string[] | number[],
  "accuracy"?: number,
  "damage_types"?: DamageType[],
  "range_types"?: RangeType[],
  "weapon_types"?: WeaponType[],
  "weapon_sizes"?: WeaponSize[],
  "overwrite"?: boolean,
  "replace"?: boolean,
  "condition"?: string,
  "max"?: number,
  "detail"?: string
}

Required Fields

id

The id of a bonus from the Bonus List.

val

A value of the type the bonus id expects. val may be omitted on a bonus that only grants accuracy, and on flag bonuses such as no_cascade and superheavy_mounting.

Most bonuses that take an integer can also take a special string. These values can be used to create dynamic bonuses based on the current state of the pilot, mech, or NPC.

Optional Fields

The damage_types, range_types, weapon_types, and weapon_sizes fields are exclusive, meaning that an item must satisfy all conditions to receive the bonus. For example, a Bonus that included an Explosive damage type and a Launcher weapon type would only apply to Launchers that dealt Explosive damage.

To create eg. a system that increases the damage of all explosive weapons and all ranged weapons, two Bonus objects should be used.

Filter values are matched without regard to case, so "rifle" and "Rifle" are the same. Omit a filter to match everything.

accuracy

An integer. Adds Accuracy (if positive) or Difficulty (if negative) to rolls of the kind named by the bonus ID. It is read on these IDs:

id roll
attack every attack roll; with weapon_types or weapon_sizes, only attacks with a matching weapon
melee melee attack rolls
tech_attack tech attack rolls
grapple, ram the Grapple or Ram roll
save every save the character makes
check every check, including structure, overheating and burn checks
hull, agility, systems, engineering checks and saves with that skill
<skill>_check, <skill>_save only checks, or only saves, with that skill

mount_accuracy is different: it uses val, and applies to the mount the CORE Bonus is assigned to.

damage_types

An array of damage types that the bonus applies to. If this field is not present, the bonus will apply to all damage types (if applicable). Valid damage types are: Kinetic, Explosive, Energy, Heat, and Burn.

range_types

An array of range types that the bonus applies to. If this field is not present, the bonus applies to all range types (if applicable). Valid range types are: Range, Threat, Thrown, Line, Cone, Blast, and Burst.

weapon_types

An array of weapon types that the bonus applies to. If this field is not present, the bonus applies to all weapon types. Valid weapon types are: Rifle, Cannon, Launcher, CQB, Nexus, Melee, and Improvised.

weapon_sizes

An array of weapon sizes that the bonus applies to. If this field is not present, the bonus applies to all sizes. Valid weapon sizes are: Auxiliary, Main, Heavy, and Superheavy.

overwrite

The overwrite flag will overwrite any integer value bonus with the highest bonus of the same type from any source that has an overwrite flag. Which is to say: all applicable bonuses of that bonus ID will be collected and everything will be discarded except for the bonus of the highest value that has an overwrite flag.

Eg: a mech with items that give +4, +2, +3 (overwrite) and +2 (overwrite) bonus will result in a +3 bonus. This flag is not necessary for non-integer values.

If replace bonuses of the same ID are also present, their total becomes the base first, and the highest overwrite bonus is then added to it. To set a final value outright, use overwrite and replace together on the same bonus (see below).

replace

The replace flag will replace any integer value in the target item, pilot, or mech with the total collected replace bonus value. Eg. a mech with a base HP of 8 and the following bonuses: +1, +1 and 3 (replace) will result in a mech with a final HP of 5 (8 replaced by 3, then +1 +1).

A bonus with both overwrite and replace sets the final value: the base, overwrite bonuses, replace bonuses and additive bonuses of the same id are all ignored. If several bonuses of the same id carry both flags, the highest one is used. Eg: a base of 8 with +1, 3 (replace), 5 (overwrite) and 2 (overwrite + replace) ends at 2.

overwrite and replace are read for stat bonuses (hp, armor, evasion, the pilot_* ids, custom stats and so on), for drone_* and deployable_* stats, and for sizes. On threat only replace is read. Weapon range and damage bonuses are always added; the one exception is a damage bonus with both flags and weapon_types: ["Improvised"], which replaces Improvised Attack damage.

condition

A string. The bonus applies only while the condition evaluates to a non-zero value. It is evaluated like a special value expression, with one addition: a status or condition id in braces is 1 while the character has that status and 0 otherwise. Eg. "condition": "{exposed}" applies the bonus only while the mech is Exposed.

max

An integer. Read only by add_mount: the mount is added only while the frame has fewer than max mounts. See add_mount.

detail

A string. Replaces the description COMP/CON would otherwise generate for the bonus. Use it when the bonus has a condition the automatically generated tip text cannot express.

PC Bonuses

Bonuses are collected and added to the pilot, meaning that they will persist as long as the item granting the bonus is equipped or active. The definition of "active" can change based on item type:

Item Active State Condition
Talent Always active
Frame / Frame Trait Always active
Passive CORE Power Always active
CORE Bonus Always active
Active CORE Power CORE Power has been activated, bonus removed when CORE Power deactivates
Mod Mod is equipped to equipment that is not destroyed
Pilot Gear Always active unless the gear is destroyed
Reserve Always active until reserve is used or deleted
System Always active unless system is destroyed or in cascade
Weapon Always active unless weapon is destroyed
Weapon Profile Active only when the profile is selected and the weapon is not destroyed
Deployable Deployable has been deployed

Bonuses inside an item's active_effects are collected also. If the effect has condition text, only bonuses that carry their own condition are taken; a bonus without one is ignored, because COMP/CON cannot tell when the effect is on. Bonuses inside a CORE system's active_effects apply while CORE Power is active.

A pilot outside their mech receives no mech bonuses. Only the pilot_* ids and custom stat ids change a pilot's own stats.

NPC Bonuses

NPC bonuses are collected and added to the NPC, meaning that they will persist as long as the feature granting the bonus is equipped or active. Bonuses on NPC deployables will be applied to the deployable itself.

NPC bonus values can be a single value, an array of three values, or a string of three values separated by / (eg. "2/3/4"), one per tier. A single value is used for all three tiers.

Bonus List

ID Detail Values Applies
range Add Range (including Threat) to weapons integer All
damage Add Damage to weapons All
hp Add Mech/NPC HP integer All
armor Add Mech/NPC Armor integer All
structure Add Mech/NPC Structure integer All
stress Add Mech/NPC Reactor Stress integer All
heatcap Add Mech/NPC Heat Capacity integer All
heat_cap Alias of heatcap integer All
repcap Add Mech/NPC Repair Capacity integer All
speed Add Mech/NPC Speed integer All
evasion Add Mech/NPC Evasion integer All
edef Add Mech/NPC E-Defense integer All
sensor Add Mech/NPC Sensor Range integer All
attack Add to Attack Bonus. With weapon_types or weapon_sizes, added only to attacks with a matching weapon integer All
melee Accuracy on melee attack rolls (use accuracy) accuracy All
tech_attack Add Mech/NPC Tech Attack integer All
grapple Add Mech/NPC Grapple Value integer All
ram Add Mech/NPC Ram Value integer All
save Add Mech/NPC Save Target. accuracy applies to save rolls integer All
sp Add Mech/NPC SP integer All
size Add Mech/NPC Size integer All
boost Add Mech/NPC Boost Speed integer All
armor_max Add to the maximum Armor of a mech (base 4) integer PC only
accuracy Add Accuracy to non-combat skill checks. Shown on the sheet, not applied to a roll integer PC only
thrown Give matching weapons Thrown of at least this value integer All
threat Add Threat to weapons integer All
min_range Floor for weapon range. Applies to the listed range_types (Range and Threat if omitted); adds Threat if the weapon has none integer All
knockback Add Knockback to matching weapons. Stacks with the weapon's own Knockback tag. Shown on the weapon, not applied to movement integer All
add_weapon_type Matching weapons also count as this weapon type WeaponType All
hull Hull checks and saves (use accuracy) accuracy All
agility Agility checks and saves (use accuracy) accuracy All
engineering Engineering checks and saves (use accuracy) accuracy All
systems Systems checks and saves (use accuracy) accuracy All
check Accuracy on every check (use accuracy) accuracy All
hull_check, agility_check, systems_check, engineering_check Accuracy on checks with that skill only accuracy All
hull_save, agility_save, systems_save, engineering_save Accuracy on saves with that skill only accuracy All
immunity Immunity to damage types and/or statuses. See immunity and resistance string, string[] All
resistance Resistance to damage types. See immunity and resistance string, string[] All
deployable_hp Add HP to all deployed Deployables integer All
deployable_size Add size to all deployed Deployables integer All
deployable_charges Add charges to all deployed Deployables integer All
deployable_armor Add armor to all deployed Deployables integer All
deployable_evasion Add evasion to all deployed Deployables integer All
deployable_edef Add edef to all deployed Deployables integer All
deployable_heatcap Add heatcap to all deployed Deployables integer All
deployable_repcap Add repcap to all deployed Deployables integer All
deployable_sensor_range Add sensor range to all deployed Deployables integer All
deployable_tech_attack Add tech attack to all deployed Deployables integer All
deployable_save Add save to all deployed Deployables integer All
deployable_speed Add speed to all deployed Deployables integer All
deployable_resist Resistance for deployed Deployables: a damage type or all. Toggled on the deployable in Active Mode string All
drone_hp Add HP to all deployed Drones integer All
drone_size Add size to all deployed Drones integer All
drone_charges Add charges to all deployed Drones integer All
drone_armor Add armor to all deployed Drones integer All
drone_evasion Add evasion to all deployed Drones integer All
drone_edef Add edef to all deployed Drones integer All
drone_heatcap Add heatcap to all deployed Drones integer All
drone_repcap Add repcap to all deployed Drones integer All
drone_sensor_range Add sensor range to all deployed Drones integer All
drone_tech_attack Add tech attack to all deployed Drones integer All
drone_save Add save to all deployed Drones integer All
drone_speed Add speed to all deployed Drones integer All
drone_resist Resistance for deployed Drones: a damage type or all. Toggled on the drone in Active Mode string All
deploy_count Gain additional deployable deploy action integer All
extra_action Extra actions per round string All
skill_point Add Pilot Skill Trigger point integer PC only
mech_skill_point Add Mech Skill (HASE) point integer PC only
talent_point Add Pilot Talent point integer PC only
license_point Add Pilot License point integer PC only
cb_point Add Pilot CORE Bonus point integer PC only
ai_cap Add AI Capacity integer PC only
no_cascade AI systems on this mech do not cascade flag PC only
cheap_struct Half cost for Structure repairs. Not applied yet integer PC only
cheap_stress Half cost for Reactor Stress repairs. Not applied yet integer PC only
core_power Restore CORE Power. Not applied yet integer PC only
overcharge Overcharge Track DieRoll[] PC only
limited_bonus Add Limited equipment uses integer PC only
pilot_hp Add Pilot HP integer PC only
pilot_armor Add Pilot Armor integer PC only
pilot_evasion Add Pilot Evasion integer PC only
pilot_edef Add Pilot E-Defense integer PC only
pilot_speed Add Pilot Speed integer PC only
pilot_armor_slots Increase Pilot Armor capacity integer PC only
pilot_gear_slots Increase Pilot Gear capacity integer PC only
pilot_weapon_slots Increase Pilot Weapon capacity integer PC only
mount_accuracy Add Accuracy to all mounted weapons integer PC only
mount_range Add Range to all mounted weapons. Not applied yet integer PC only
mount_damage Add Damage to all mounted weapons. Not applied yet integer PC only
add_mount Gain an additional mount. See add_mount mount type PC only
superheavy_mounting Gain a Superheavy mount if the frame has fewer than 3 mounts flag PC only
sizes Add NPC creation size choices. With overwrite or replace, the list is replaced number[] NPC only
activations Add Activations per round integer NPC only
activations_pct Additional activation/round @ PC count X integer NPC only
no_mods Listed on integrated weapons as "cannot take mods". Display only: the Integrated Weapon mount blocks mods by itself boolean All
hp_per_player, min_damage, pilot_gear, set_weapon_type, unstable_system Reserved ids. Not applied yet

add_mount

val is the type of mount to add: Main, Heavy, Aux, Aux/Aux, Main/Aux, Flex, or Superheavy. Case does not matter.

The optional max field is an integer. If present, the mount is added only while the frame has fewer than max mounts of its own. Without max the mount is always added.

{ "id": "add_mount", "val": "main", "max": 3 }

This adds a Main mount to any mech whose frame has 2 or fewer mounts.

Each add_mount bonus adds one mount. Integrated mounts and mounts added by other bonuses are not counted toward max.

immunity and resistance

val is one value or an array of values.

  • A damage type (kinetic, energy, explosive, heat, burn) or all grants immunity or resistance to that damage. It is set on the mech or NPC when it enters an encounter and can be changed by the GM afterwards.
  • immunity also accepts Status and Condition ids (eg. impaired). The character cannot gain that status.
{ "id": "immunity", "val": ["impaired", "burn"] }
{ "id": "resistance", "val": "all" }

DieRoll

Certain fields take a "DieRoll" format. This is a shorthand for rolling dice within COMP/CON. The format is:

XdY+N

Where X is number of dice, Y is number of die sides, and N (optional) is a flat bonus. Examples:

1d6   2d20-2    3d6+1d20

DieRolls can be chained together with + and - operators. For example:

1d6+2d20-2+3d6+1d20

This will roll 1d6, 2d20, subtract 2, add 3d6, and add 1d20. The result will be the sum of all the rolls.

Special Values

Any integer type bonus can be replaced with one of the following special value strings surrounded in brackets (eg. "{ll}"):

ID Value Mech Pilot NPC
ll Pilot License Level yes yes no
grit Pilot Grit yes yes no
tier NPC Tier no no yes
hull HASE Hull yes yes yes
agi HASE Agility yes yes yes
sys HASE Systems yes yes yes
eng HASE Engineering yes yes yes
size Size yes no yes
hp Max HP yes yes yes
armor Armor yes yes no
speed Speed yes yes yes
evasion Evasion yes yes yes
edef E-Defense yes yes yes
heatcap Heat Capacity yes no yes
sensors Sensor Range yes no yes
save Save Target yes no yes
structure Structure yes no no
stress Reactor Stress yes no no
repcap Repair Capacity yes no no
sp SP yes no no
overshield Overshield yes no no

A value that is not available on the character is dropped from the expression, which usually makes the whole expression evaluate to 0.

additionally, strings will be evaluated as an expression, then rounded up to the nearest integer, so "2 + {ll}" or ({grit}/2) + 1 are both valid expressions.

Clone this wiki locally