-
Notifications
You must be signed in to change notification settings - Fork 36
Weapons
Weapons are essentially mounted systems that furnish the "Skirmish" and "Barrage" actions. They can take damage and range data, and must take MountType and WeaponType properties. Weapons added as "integrated" weapons from anywhere (including other weapons) are assigned unmodifiable Integrated Mounts.
weapons.json
{
"id": string,
"name": string,
"source": string,
"license": string,
"license_id": string,
"license_level": number,
"effect": string,
"mount": MountType,
"type": WeaponType | WeaponType[],
"ammo"?: IAmmoData[],
"cost"?: number
"barrage"?: boolean,
"skirmish"?: boolean,
"no_attack"?: boolean,
"no_mods"?: boolean,
"no_core_bonus"?: boolean,
"damage"?: IDamageData[],
"range"?: IRangeData[],
"tags"?: ITagData[],
"sp"?: number,
"description": string,
"effect"?: string | EffectObject,
"on_attack"?: string | EffectObject,
"on_hit"?: string | EffectObject,
"on_crit"?: string | EffectObject,
"on_miss"?: string | EffectObject,
"active_effects"?: IEffectObject[],
"actions"?: IActionData[],
"bonuses"?: IBonusData[]
"no_bonus"?: boolean
"synergies"?: ISynergyData[],
"no_synergy"?: boolean,
"deployables"?: IDeployableData[],
"counters"?: ICounterData[],
"integrated"?: string[]
"special_equipment"?: string[]
"profiles"?: IWeaponProfile[] //see note below
}Internal identifier. This must be globally unique. See Item ID Guidelines for more information.
The display name of the item
The source field must match a Manufacturer ID. This field is not required if the item is included in a License Collection.
The license field is the display name of the item's containing license. Usually this is the name of the Frame in the license. This field is not required if the item is included in a License Collection.
The license_id field must match a Frame ID. This field is not required if the item is included in a License Collection.
The license_level represents the license level of at which the equipment is unlocked for use. This is a value from 0-3, with 0 being available to all PCs at LL0.
Rules text. HTML syntax is allowed.
Flavor text for Compendium and expanded item cards. HTML syntax is allowed.
mount is the required mount size for this weapon. The valid weapon mount strings are: "Main" | "Heavy" | "Aux" | "Superheavy"
Must be a single string or array of the following values: "Rifle" | "Cannon" | "Launcher" | "CQB" | "Nexus" | "Melee"
Currently used only for Walking Armory in the LANCER Core Book, it's genericised for use in homebrew LCPs. Ammo arrays populate a list of ammunition selections on every equipped weapon of the specified type
"name": string,
"description": string,
"cost"?: number,
"allowed_types"?: WeaponType[], // weapon types the ammo CAN be applied to
"allowed_sizes"?: WeaponSize[], // weapon sizes the ammo CAN be applied to
"restricted_types"?: WeaponType[], // weapon types the ammo CAN NOT be applied to
"restricted_sizes"?: WeaponSize[], // weapon sizes the ammo CAN NOT be applied toLike mods, omitting an allowed value will apply the ammo element to all weapons of that type/size. Restrictions overrule allowances.
if cost is omitted the value is automatically set to 1.
cost refers to the usage cost per attack with this weapon. It defaults to 1.
barrage denotes that this weapon can be fired as part of a barrage, and skirmish denotes that this weapon can be fired as part of a skirmish. If neither of these flags are set, barrage will be set to true by default for all weapons, and skirmish will be set to true by default for all non-Superheavy weapons.
no_attack suppresses creation of Skirmish/Barrage actions for this weapon, intended for use with special or weapon-mounted systems (eg. the Goblin's Autopod)
no_bonus and no_synergy inhibit the collection and display of Bonuses and Synergies respectively (eg. the Pegasus Autogun)
no_mods inhibits the addition of mods to this weapon (eg. Pegasus Mimic Gun)
no_core_bonus inhibits the display of mount-sensitive core bonuses, when making attacks with this weapon (eg. Pegasus Mimic Gun)
Usage cost of the item, only required if the item has the "limited" tag. Defaults to 1.
Only allows this weapon to be used as a Barrage action. Defaults to false, and overrides skirmish.
Only allows this weapon to be used as a Skirmish action. Defaults to false, and overrides barrage.
Suppresses creation of Skirmish/Barrage actions for this weapon, intended for use with special or weapon-mounted systems (eg. the Goblin's Autopod)
Suppresses the addition of mods to this weapon (eg. Pegasus Mimic Gun)
Prevents any bonuses or modifications mount-sensitive core bonuses.
See ItemDamageData
See ItemRangeData
See Tags
System Point cost of the item. Must be an integer. Defaults to 0.
This may be an EffectObject or string (HTML syntax is allowed).
Rules or effects that apply if the player makes an attack action with this weapon. Applies prior to any Hit or Damage rolls/calculations. This is used for things like "on attack" effects, or other effects that are triggered when the weapon is used. This may be an EffectObject or string (HTML syntax is allowed).
Rules or effects that apply if the player makes a successful attack with this weapon. Applies after any Hit rolls but before Damage rolls/calculations. This is used for things like "on hit" effects, or other effects that are triggered when the weapon successfully hits. This may be an EffectObject or string (HTML syntax is allowed).
Rules or effects that apply if the player makes a critical hit with this weapon. These apply only on critical hit attack rolls. This is used for things like "on crit" effects, or other effects that are triggered when the weapon successfully crits. This may be an EffectObject or string (HTML syntax is allowed).
Rules or effects that apply if the player makes a miss with this weapon. Applies after any Hit rolls but before Damage rolls/calculations (such as Reliable). This is used for things like "on miss" effects, or other effects that are triggered when the weapon successfully misses. This may be an EffectObject or string (HTML syntax is allowed).
See Effect Objects
See ItemActionData
See ItemBonusData
Prevent this weapon from registering or being affected by Bonuses. This defaults to false.
See ItemSynergyData
Prevent this weapon from being marked by, or contributing to, Synergies. This defaults to false.
See ItemCounterData
An array of integrated An array of integrated Mech Equipment IDs.
NB: COMP/CON does not sanity check the integrated equipment against the parent item. Things like recursively referencing an integrated weapon will not be caught and will crash the app.
NB: COMP/CON does not sanity check the integrated weapons against the parent item. Things like recursively referencing an integrated weapon will not be caught and will crash the app.
An array of An array of integrated Mech Equipment IDs.
Unlike integrated items, these are not automatically installed to the frame when their parent item is equipped. Instead, they are made available in the Mech Equipment selector when the parent item is equipped.
Weapon profiles are stored as an array of abbreviated IWeaponData data as an optional property of a weapon. C/C won't look for or render profile data within profiles, so it's not possible to nest a profile more than one deep.
Actions, Effects, and Synergies will only be available to the player while the profile is active.
For a weapon with multiple profiles, the default profile will be the first (index 0) item in the profile array, and will be used for things like damage sorting.
"name": string,
"effect"?: string,
"skirmish"?: boolean,
"barrage"?: boolean,
"cost"?: number,
"on_miss"?: string | EffectObject,
"on_attack"?: string | EffectObject,
"on_hit"?: string | EffectObject,
"on_crit"?: string | EffectObject,
"active_effects"?: IEffectObject[],
"damage"?: IDamageData[],
"range"?: IRangeData[],
"actions"?: IActionData[],
"bonuses"?: IBonusData[],
"synergies"?: ISynergyData[],
"deployables"?: IDeployableData[],
"counters"?: ICounterData[],
"integrated"?: string[],
"special_equipment"?: string[]All Weapon Profile fields are equivalent to their base Weapon representations.
Note that, aside from the name field, all fields on a profile are optional. If a field is not provided, a Weapon Profile will fall back to whatever is in container weapon data.
{
"id": "mw_smartgun",
"name": "Smartgun",
"mount": "Main",
"type": "Rifle",
"damage": [
{
"type": "Kinetic",
"val": 4
}
],
"range": [
{
"type": "Range",
"val": 15
}
],
"tags": [
{
"id": "tg_accurate"
},
{
"id": "tg_seeking"
},
{
"id": "tg_smart"
}
],
"source": "HORUS",
"license": "Pegasus",
"license_level": 1,
"description": "“Smart weapon” is a broad term that describes any and all weapons capable of interacting with onboard systems in order to boost their combat efficacy. Smartguns are weapons that come pre-loaded with companion software and the necessary hardware in order to interact with targeting systems and host NHPs. A popular addition to many HORUS mechs, smart weapons make for reliable kinetic delivery systems.",
"sp": 2,
"license_id": "mf_pegasus"
},