Bionics

When adding a new bionic, if it's not included with another one, you must also add the corresponding CBM item as described here. Even for a faulty bionic.

Fields

Identifier	Description
id	(mandatory) Unique string id
name	(mandatory) In game name of the bionic
description	(mandatory) In game description of the bionic
flags	(optional) Array of json flags. See the list
capacity	(optional) Bionic power gained from this bionic
act_cost	(optional) Power cost to activate bionic.
deact_cost	(optional) Power cost to deactivate bionic.
trigger_cost	(optional) Power cost on triggering bionic effect.
kcal_trigger_cost	(optional) Calorie cost on triggering bionic effect
react_cost	(optional) How much power to consume every time ticks
time	(optional) How long between consuming react_cost power
stat_bonus	(optional) Array of arrays, interior array is ["STAT", integer bonus]
fuel_options	(optional) Itype Ids accepted for fueling this bionic
fuel_capacity	(optional) Charges of fuel stored by the bionic
fuel_efficiency	(optional) Multiplier on the power generated by consuming fuel
fuel_multiplier	(optional) Multiplies the amount of fuel loaded into the bionic per charge
passive_fuel_efficiency	(optional) fuel_efficiency but the bionic is inactive, also used for PERPETUAL fuels
coverage_power_gen_penalty	(optional) multiplies fuel_efficiency by coverage from items of occupied_bodyparts and this value ( 50% bodypart coverage + )
exothermic_power_gen	(optional) If fuel not converted to power is converted to heat
remote_fuel_draw	(optional) Power draw from a connected exterior cable ( I.E. Cable Charger System )
power_gen_emission	(optional) field id to produce while making power
weight_capacity_modifier	(optional) Multiplier on weight capacity
weight_capacity_bonus	(optional) Addition on weight capacity
upgraded_bionic	(optional) Bionic id which can be upgraded by installing this bionic
required_bionics	(optional) Array of bionic ids that are required to install it
included_bionics	(optional) Array of bionic ids given upon installing it
included	(optional) boolean, is this bionic included by another bionic
available_upgrades	(optional) Array of bionic ids this can upgrade to
env_protec	(optional) Array of arrays, interior array is ["bodypart", integer], where integer is environmental protection on bodypart
bash_protec	(optional) Array of arrays, interior array is ["bodypart", integer], where integer is bash protection on bodypart
cut_protec	(optional) Array of arrays, interior array is ["bodypart", integer], where integer is cut protection on bodypart
bullet_protec	(optional) Array of arrays, interior array is ["bodypart", integer], where integer is ballistic protection on bodypart
occupied_bodyparts	(optional) Array of arrays, interior array is ["bodypart", integer], where integer is bionic slots occupied on bodypart
encumbrance	(optional) Array of arrays, interior array is ["bodypart", integer], where integer is encumbrance on bodypart
canceled_mutations	(optional) Array of trait ids which are canceled on install and prevented afterwards
learned_spells	(optional) Array of arrays, interior array is ["spell", integer], where integer is the level you learn the spell
enchantments	(optional) Array of enchantment ids to give with the bionic
bio_enchantments	(optional) Array of inline enchantments to give with the bionic
fake_item	(optional) Item that the bionic gives. With BIONIC_TOOLS it gives it as a tool, with BIONIC_TOGGLED it will be wielded, and with BIONIC_GUN it will be fired
can_uninstall	(optional) If the bionic can be uninstalled
no_uninstall_reason	(optional) Required with can_uninstall, message displayed with inability to uninstall
starting_bionic	(optional) If true can start with the bionic
points	(optional) Number of points it takes on character creation

{
  "id": "bio_chaos",
  "name": "Complete Chaos",
  "description": "This does a lot of things that makes little sense",
  "flags": ["BIONIC_TOGGLED", "BIONIC_NPC_USABLE", "COMBAT_NPC_USE"],
  "capacity": "100 kJ",
  "act_cost": "5 J",
  "deact_cost": "5 J",
  "trigger_cost": "5 J",
  "react_cost": "5 J",
  "kcal_trigger_cost": 5,
  "time": 1,
  "stat_bonus": [["STR", 2]],
  "fuel_options": ["gasoline"],
  "fuel_capacity": 500,
  "fuel_efficiency": 0.25,
  "fuel_multiplier": 2,
  "coverage_power_gen_penalty": 0.5,
  "passive_fuel_efficiency": 0.125,
  "exothermic_power_gen": true,
  "remote_fuel_draw": "1 kJ",
  "powergen_emission": "fd_fire",
  "weight_capacity_modifier": 2.0,
  "weight_capacity_bonus": "20 kg",
  "upgraded_bionic": "bio_chaos_v1",
  "required_bionics": ["bio_chaos_base"],
  "included_bionics": ["bio_chaos_stuff", "bio_chaos_morestuff"],
  "included": false,
  "available_upgrades": ["bio_chaos_v50"],
  "env_protec": [["eyes", 7]],
  "bash_protec": [["eyes", 3]],
  "cut_protec": [["eyes", 3]],
  "bullet_protec": [["eyes", 3]],
  "occupied_bodyparts": [["torso", 1]],
  "encumbrance": [["mouth", 10]],
  "canceled_mutations": ["ASTHMA"],
  "learned_spells": [["mint_breath", 2]],
  "enchantments": ["ENCH_UNCANNY_DODGE"],
  "bio_enchantments": [
    { "condition": "ALWAYS", "values": [{ "value": "SPEED", "multiply": 0.1 }] },
  ],
  "can_uninstall": false,
  "no_uninstall_reason": "The telescopic lenses are part of the patient's eyes now, remove them and the patient would become blind",
  "starting_bionic": true,
  "points": 1,
}

Paired Item Definition

{
  "id": "bio_adrenaline", // Must match the bionic id exactly
  "copy-from": "bionic_general", // There are a few variants of this but this is the basic thing
  "type": "BIONIC_ITEM", // Required type
  // The rest is general item fields
  "name": { "str": "Adrenaline Pump CBM" },
  "looks_like": "bio_int_enhancer",
  "description": "A stimulator system that is implanted alongside the adrenal glands, allowing the user to trigger their body's adrenaline response at the cost of some bionic power.",
  "price": "40 USD",
  "weight": "250 g",
  "difficulty": 6
},