Repository navigation
Bonuses
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.
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
}The id of a bonus from the Bonus List.
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.
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.
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.
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.
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.
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.
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.
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).
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.
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.
An integer. Read only by add_mount: the mount is added only while the frame has fewer than max mounts. See add_mount.
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.
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 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.
| 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 |
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.
val is one value or an array of values.
- A damage type (
kinetic,energy,explosive,heat,burn) orallgrants 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. -
immunityalso accepts Status and Condition ids (eg.impaired). The character cannot gain that status.
{ "id": "immunity", "val": ["impaired", "burn"] }
{ "id": "resistance", "val": "all" }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.
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.
Pilot Data
Licensed Data
NPC Data
Other
- Manifest (lcp_manifest.json)
- Base Actions (actions.json)
- Downtime Actions (actions.json)
- Environments (environments.json)
- Manufacturers (manufacturers.json)
- SITREPs (sitreps.json)
- Statuses & Conditions (statuses.json)
- Tables (tables.json)
- Lists (lists.json)
- Tags (tags.json)
- Custom Stat Data (custom_stats.json)