factorio-types 1.2.49 → 1.2.51

package/dist/global.d.ts

@@ -2,7 +2,7 @@
 // Factorio API reference https://lua-api.factorio.com/latest/index.html
 // Generated from JSON source https://lua-api.factorio.com/latest/runtime-api.json
 // Definition source https://github.com/sguest/factorio-types
-// Factorio version 2.0.66
+// Factorio version 2.0.69
 // API version 6
 
 /**
@@ -64,4 +64,4 @@ declare function log(this: void, string: runtime.LocalisedString): void;
  *
  * Note that `table_size()` does not work correctly for {@link LuaCustomTable | runtime:LuaCustomTable}, their size has to be determined with {@link LuaCustomTable::length_operator | runtime:LuaCustomTable::length_operator} instead.
  */
-declare function table_size(this: void, table: runtime.table): uint;
+declare function table_size(this: void, table: runtime.table): uint32;

package/dist/prototypes.d.ts

@@ -2,7 +2,7 @@
 // Factorio API reference https://lua-api.factorio.com/latest/index.html
 // Generated from JSON source https://lua-api.factorio.com/latest/prototype-api.json
 // Definition source https://github.com/sguest/factorio-types
-// Factorio version 2.0.66
+// Factorio version 2.0.69
 // API version 6
 
 declare namespace prototype {
@@ -691,6 +691,8 @@ interface ArtilleryFlarePrototype extends EntityPrototype {
     render_layer_when_on_ground?: RenderLayer;
     /**
      * The entity with the higher number is selectable before the entity with the lower number.
+     *
+     * The value `0` will be treated the same as `nil`.
      */
     selection_priority?: uint8;
     /**
@@ -859,7 +861,7 @@ interface AssemblingMachinePrototype extends CraftingMachinePrototype {
     default_recipe_finished_signal?: SignalIDConnector;
     default_working_signal?: SignalIDConnector;
     /**
-     * Defaults to true if fixed_recipe is not given.
+     * Defaults to true if `fixed_recipe` is not given.
      */
     disabled_when_recipe_not_researched?: boolean;
     draw_circuit_wires?: boolean;
@@ -981,7 +983,11 @@ interface AutoplaceControl extends Prototype {
      */
     category: 'resource' | 'terrain' | 'cliff' | 'enemy';
     /**
-     * Whether this settings being lower than default disables fight related achievements
+     * Hides the autoplace control from the map generation screen.
+     */
+    hidden?: boolean;
+    /**
+     * Whether this settings being lower than default disables fight related achievements.
      */
     related_to_fight_achievements?: boolean;
     /**
@@ -1191,7 +1197,7 @@ interface BoilerPrototype extends EntityWithOwnerPrototype {
     /**
      * The output fluid box.
      *
-     * If `mode` is `"output-to-separate-pipe"` and this has a {@link filter | prototype:FluidBox::filter}, the heated input fluid is converted to the output fluid that is set in the filter. The conversion ratio is based on the heat capacity of the fluids: `output_fluid_amount = input_fluid_amount * (output_fluid_heat_capacity / input_fluid_heat_capacity)`
+     * If `mode` is `"output-to-separate-pipe"` and this has a {@link filter | prototype:FluidBox::filter}, the heated input fluid is converted to the output fluid that is set in the filter. The conversion ratio is based on the {@link heat capacity | prototype:FluidPrototype::heat_capacity} of the fluids: `output_fluid_amount = input_fluid_amount * (output_fluid_heat_capacity / input_fluid_heat_capacity)`
      *
      * If `mode` is `"heat-fluid-inside"`, this fluidbox is unused.
      */
@@ -1397,6 +1403,9 @@ interface CargoLandingPadPrototype extends EntityWithOwnerPrototype {
     draw_copper_wires?: boolean;
     graphics_set?: CargoBayConnectableGraphicsSet;
     inventory_size: ItemStackIndex;
+    /**
+     * In chunks. The radius of how many chunks this cargo landing pad charts around itself.
+     */
     radar_range?: uint32;
     radar_visualisation_color?: Color;
     /**
@@ -1423,6 +1432,7 @@ interface CargoPodPrototype extends EntityWithOwnerPrototype {
      * Has to be of type 'pod-catalogue'.
      */
     default_shadow_graphic?: ProcessionGraphic;
+    impact_trigger?: Trigger;
     inventory_size: ItemStackIndex;
     procession_audio_catalogue?: ProcessionAudioCatalogue;
     procession_graphic_catalogue?: ProcessionGraphicCatalogue;
@@ -1925,6 +1935,7 @@ interface CorpsePrototype extends EntityPrototype {
     ground_patch_fade_out_start?: float;
     ground_patch_higher?: AnimationVariations;
     ground_patch_render_layer?: RenderLayer;
+    protected_from_tile_building?: boolean;
     remove_on_entity_placement?: boolean;
     remove_on_tile_placement?: boolean;
     /**
@@ -2582,11 +2593,11 @@ interface DecorativePrototype extends Prototype {
     /**
      * Can be defined only when decorative is not "decal" (see `render_layer`).
      */
-    stateless_visualisation?: StatelessVisualisations;
+    stateless_visualisation?: StatelessVisualisation | StatelessVisualisation[];
     /**
      * Only loaded if `stateless_visualisation` is not defined. Can be defined only when decorative is not "decal" (see `render_layer`).
      */
-    stateless_visualisation_variations?: StatelessVisualisations[];
+    stateless_visualisation_variations?: (StatelessVisualisation | StatelessVisualisation[])[];
     target_count?: uint16;
     /**
      * Mandatory if `render_layer` = "decals". This int16 is converted to a {@link TileRenderLayer | prototype:TileRenderLayer} internally. It is offset from `ground-natural`.
@@ -3275,7 +3286,7 @@ interface EntityPrototype extends Prototype {
     /**
      * Name of the entity that will be automatically selected as the upgrade of this entity when using the {@link upgrade planner | https://wiki.factorio.com/Upgrade_planner} without configuration.
      *
-     * This entity may not have "not-upgradable" flag set and must be minable. This entity mining result must not contain item product with "hidden" flag set. Mining results with no item products are allowed. This entity may not be a {@link RollingStockPrototype | prototype:RollingStockPrototype}.
+     * This entity may not have "not-upgradable" flag set and must be minable. This entity mining result must not contain item product with {@link hidden | prototype:ItemPrototype::hidden} set to `true`. Mining results with no item products are allowed. This entity may not be a {@link RollingStockPrototype | prototype:RollingStockPrototype}.
      *
      * The upgrade target entity needs to have the same bounding box, collision mask, and fast replaceable group as this entity. The upgrade target entity must have least 1 item that builds it that isn't hidden.
      * @example ```
@@ -3326,13 +3337,15 @@ interface EntityPrototype extends Prototype {
     selection_box?: BoundingBox;
     /**
      * The entity with the higher number is selectable before the entity with the lower number.
+     *
+     * The value `0` will be treated the same as `nil`.
      */
     selection_priority?: uint8;
     /**
      * The cursor size used when shooting at this entity.
      */
     shooting_cursor_size?: double;
-    stateless_visualisation?: StatelessVisualisations;
+    stateless_visualisation?: StatelessVisualisation | StatelessVisualisation[];
     /**
      * Used to set the area of the entity that can have stickers on it, currently only used for units to specify the area where the green slow down stickers can appear.
      * @example ```
@@ -3840,6 +3853,10 @@ interface FluidPrototype extends Prototype {
     ```
      */
     heat_capacity?: Energy;
+    /**
+     * Hides the fluid from the signal selection screen.
+     */
+    hidden?: boolean;
     /**
      * Path to the icon file.
      *
@@ -3974,6 +3991,10 @@ interface FluidTurretPrototype extends TurretPrototype {
  */
 interface FluidWagonPrototype extends RollingStockPrototype {
     capacity: FluidAmount;
+    /**
+     * Pumps are only allowed to connect to this fluid wagon if the pump's {@link fluid box connection | prototype:PipeConnectionDefinition} and this fluid wagon share a connection category. Pump may have different connection categories on the input and output side, connection categories will be taken from the connection that is facing towards fluid wagon.
+     */
+    connection_category?: string | string[];
     quality_affects_capacity?: boolean;
     /**
      * Must be 1, 2 or 3.
@@ -4017,6 +4038,8 @@ interface FlyingRobotPrototype extends EntityWithOwnerPrototype {
     max_energy?: Energy;
     /**
      * The maximum flying speed of the robot, including bonuses, in tiles/tick. Useful to limit the impact of {@link worker robot speed research | prototype:WorkerRobotSpeedModifier}.
+     *
+     * Must be >= speed.
      */
     max_speed?: double;
     /**
@@ -4136,14 +4159,25 @@ interface FurnacePrototype extends CraftingMachinePrototype {
      */
     source_inventory_size: ItemStackIndex;
 }
+/**
+ * Consumes a fluid to generate electricity and create another fluid.
+ */
 interface FusionGeneratorPrototype extends EntityWithOwnerPrototype {
     /**
-     * `output_flow_limit` is mandatory and must be positive.
+     * If set to `true`, the available power output is based on the {@link FluidPrototype::fuel_value | prototype:FluidPrototype::fuel_value}. Otherwise, the available power output will be based on the fluid temperature and {@link FluidPrototype::heat_capacity | prototype:FluidPrototype::heat_capacity}: `energy = fluid_amount * fluid_temperature * fluid_heat_capacity * effectivity`
+     */
+    burns_fluid?: boolean;
+    /**
+     * `1` means 100% effectivity. Must be greater than `0`. Multiplier of the energy output.
+     */
+    effectivity?: double;
+    /**
+     * `output_flow_limit` is mandatory and must be positive. `output_flow_limit` is the maximum power output of the generator.
      */
     energy_source: ElectricEnergySource;
     graphics_set?: FusionGeneratorGraphicsSet;
     /**
-     * {@link filter | prototype:FluidBox::filter} is mandatory.
+     * {@link filter | prototype:FluidBox::filter} is mandatory. The temperature (or fuel value if `burns_fluid` is true) of this fluid is used to calculate the available power output.
      */
     input_fluid_box: FluidBox;
     /**
@@ -4267,7 +4301,7 @@ interface GeneratorEquipmentPrototype extends EquipmentPrototype {
  */
 interface GeneratorPrototype extends EntityWithOwnerPrototype {
     /**
-     * If set to true, the available power output is based on the {@link FluidPrototype::fuel_value | prototype:FluidPrototype::fuel_value}. Otherwise, the available power output will be based on the fluid temperature.
+     * If set to `true`, the available power output is based on the {@link FluidPrototype::fuel_value | prototype:FluidPrototype::fuel_value}. Otherwise, the available power output will be based on the fluid temperature and {@link FluidPrototype::heat_capacity | prototype:FluidPrototype::heat_capacity}: `energy = fluid_amount * (fluid_temperature - fluid_default_temperature) * fluid_heat_capacity * effectivity`
      */
     burns_fluid?: boolean;
     /**
@@ -4743,6 +4777,10 @@ interface ItemPrototype extends Prototype {
      */
     fuel_value?: Energy;
     has_random_tint?: boolean;
+    /**
+     * Item will not appear in lists of all items such as those for logistics requests, filters, etc.
+     */
+    hidden?: boolean;
     /**
      * Path to the icon file.
      *
@@ -5050,7 +5088,7 @@ interface LabPrototype extends EntityWithOwnerPrototype {
      */
     on_animation?: Animation;
     /**
-     * If set, {@link QualityPrototype::beacon_module_slots_bonus | prototype:QualityPrototype::beacon_module_slots_bonus} will be added to module slots count.
+     * If set, {@link QualityPrototype::lab_module_slots_bonus | prototype:QualityPrototype::lab_module_slots_bonus} will be added to module slots count.
      */
     quality_affects_module_slots?: boolean;
     researching_speed?: double;
@@ -5270,6 +5308,9 @@ interface LegacyStraightRailPrototype extends RailPrototype {
      */
     collision_box?: BoundingBox;
 }
+/**
+ * Absorbs {@link lightning | prototype:LightningPrototype} and optionally converts it into electricity.
+ */
 interface LightningAttractorPrototype extends EntityWithOwnerPrototype {
     chargable_graphics?: ChargableGraphics;
     /**
@@ -5283,15 +5324,35 @@ interface LightningAttractorPrototype extends EntityWithOwnerPrototype {
     lightning_strike_offset?: MapPosition;
     range_elongation?: double;
 }
+/**
+ * Lightning randomly hits entities on planets with {@link lightning_properties | prototype:PlanetPrototype::lightning_properties}.
+ *
+ * If a {@link lightning attractor | prototype:LightningAttractorPrototype} is hit by lightning it will absorb the lightning hit for energy.
+ *
+ * If a something that is not an attractor is hit by lightning it will be damaged by the strike.
+ */
 interface LightningPrototype extends EntityPrototype {
     attracted_volume_modifier?: float;
+    /**
+     * Effect that is triggered when lightning hits  a {@link lightning attractor | prototype:LightningAttractorPrototype}. Triggered after the attractor is charged by the lightning hit.
+     */
+    attractor_hit_effect?: Trigger;
+    /**
+     * When lightning strikes something that is not a lightning attractor, this damage is applied to the target.
+     */
     damage?: double;
     effect_duration: uint16;
+    /**
+     * When lightning hits a {@link lightning attractor | prototype:LightningAttractorPrototype}, this amount of energy is transferred to the lightning attractor.
+     */
     energy?: Energy;
     graphics_set?: LightningGraphicsSet;
     sound?: Sound;
     source_offset?: Vector;
     source_variance?: Vector;
+    /**
+     * Effect that is triggered when lightning strikes something that is not a lightning attractor. Triggered before `damage` is applied.
+     */
     strike_effect?: Trigger;
     /**
      * Must be less than or equal to `effect_duration`.
@@ -5687,7 +5748,11 @@ interface MiningDrillPrototype extends EntityWithOwnerPrototype {
      */
     resource_drain_rate_percent?: uint8;
     /**
-     * The distance from the centre of the mining drill to search for resources in.
+     * Offset of the `resource_searching_radius` from the entity center when the mining drill is facing north.
+     */
+    resource_searching_offset?: Vector;
+    /**
+     * The distance from the center of the mining drill to search for resources in.
      *
      * This is 2.49 for electric mining drills (a 5x5 area) and 0.99 for burner mining drills (a 2x2 area). The drill searches resource outside its natural boundary box, which is 0.01 (the middle of the entity); making it 2.5 and 1.0 gives it another block radius.
      */
@@ -6307,7 +6372,7 @@ interface ProjectilePrototype extends EntityPrototype {
 }
 interface Prototype extends PrototypeBase {
     /**
-     * Allows to add extra description items to the tooltip and factoriopedia.
+     * Allows to add extra description items to the tooltip and Factoriopedia.
      */
     custom_tooltip_fields?: CustomTooltipField[];
     /**
@@ -6711,7 +6776,7 @@ interface RailRampPrototype extends RailPrototype {
      */
     collision_box?: BoundingBox;
     /**
-     * Defaults to the mask from {@link UtilityConstants::default_collision_masks | prototype:UtilityConstants::default_collision_masks} when indexed by `"allow_on_deep_oil_ocean"`.
+     * Defaults to the mask from {@link UtilityConstants::default_collision_masks | prototype:UtilityConstants::default_collision_masks} when indexed by `"rail-ramp/allow_on_deep_oil_ocean"`.
      */
     collision_mask_allow_on_deep_oil_ocean?: CollisionMaskConnector;
     /**
@@ -6782,7 +6847,7 @@ interface RailSupportPrototype extends EntityWithOwnerPrototype {
      */
     build_grid_size?: 2;
     /**
-     * Defaults to the mask from {@link UtilityConstants::default_collision_masks | prototype:UtilityConstants::default_collision_masks} when indexed by `"allow_on_deep_oil_ocean"`.
+     * Defaults to the mask from {@link UtilityConstants::default_collision_masks | prototype:UtilityConstants::default_collision_masks} when indexed by `"rail-support/allow_on_deep_oil_ocean"`.
      */
     collision_mask_allow_on_deep_oil_ocean?: CollisionMaskConnector;
     /**
@@ -6998,6 +7063,10 @@ interface RecipePrototype extends Prototype {
      * The amount of time it takes to make this recipe. Must be `> 0.001`. Equals the number of seconds it takes to craft at crafting speed `1`.
      */
     energy_required?: double;
+    /**
+     * Hides the recipe from crafting menus and other recipe selection lists.
+     */
+    hidden?: boolean;
     hide_from_bonus_gui?: boolean;
     /**
      * Hides the recipe from the player's crafting screen. The recipe will still show up for selection in machines.
@@ -7500,7 +7569,7 @@ interface RoboportPrototype extends EntityWithOwnerPrototype {
     max_logistic_slots?: LogisticFilterIndex;
     open_door_trigger_effect?: TriggerEffect;
     /**
-     * Defaults to the max of logistic range or construction range rounded up to chunks.
+     * In chunks. The radius of how many chunks this roboport charts around itself. Defaults to the max of logistic range or construction range rounded up to chunks.
      */
     radar_range?: uint32;
     radar_visualisation_color?: Color;
@@ -7521,6 +7590,10 @@ interface RoboportPrototype extends EntityWithOwnerPrototype {
      * The light emitted when charging a robot.
      */
     recharging_light?: LightDefinition;
+    /**
+     * Whether to render the {@link no charge | prototype:UtilitySprites::recharge_icon} icon if the roboport has less energy than `recharge_minimum` in its internal buffer and is recovering from a blackout.
+     */
+    render_recharge_icon?: boolean;
     request_to_open_door_timeout: uint32;
     /**
      * Unused.
@@ -7568,6 +7641,12 @@ interface RobotWithLogisticInterfacePrototype extends FlyingRobotPrototype {
      * The robot's cargo carrying capacity. Can be increased by {@link worker robot cargo size research | prototype:WorkerRobotStorageModifier}.
      */
     max_payload_size: ItemCountType;
+    /**
+     * The robot's maximum possible cargo carrying capacity, including bonuses. Useful to limit the impact of {@link worker robot cargo size research | prototype:WorkerRobotStorageModifier}.
+     *
+     * Must be >= max_payload_size.
+     */
+    max_payload_size_after_bonus?: ItemCountType;
     /**
      * Only the first frame of the animation is drawn. This means that the graphics for the idle state cannot be animated.
      */
@@ -8148,7 +8227,7 @@ interface SimpleEntityPrototype extends EntityWithHealthPrototype {
     /**
      * Loaded and drawn with all `pictures`, `picture` and `animations`. If graphics variation is larger than number of `lower_pictures` variations this layer is not drawn.
      */
-    stateless_visualisation_variations?: StatelessVisualisations[];
+    stateless_visualisation_variations?: (StatelessVisualisation | StatelessVisualisation[])[];
 }
 /**
  * By default, this entity will be a priority target for units/turrets, who will choose to attack it even if it does not block their path. Setting {@link EntityWithOwnerPrototype::is_military_target | prototype:EntityWithOwnerPrototype::is_military_target} to `false` will turn this off, which then makes this type equivalent to {@link SimpleEntityWithOwnerPrototype | prototype:SimpleEntityWithOwnerPrototype}.
@@ -8193,7 +8272,7 @@ interface SimpleEntityWithOwnerPrototype extends EntityWithOwnerPrototype {
      * Used to determine render order for entities with the same `render_layer` in the same position. Entities with a higher `secondary_draw_order` are drawn on top.
      */
     secondary_draw_order?: int8;
-    stateless_visualisation_variations?: StatelessVisualisations[];
+    stateless_visualisation_variations?: (StatelessVisualisation | StatelessVisualisation[])[];
 }
 /**
  * Abstract entity that has an animation.
@@ -8457,6 +8536,10 @@ interface SpaceLocationPrototype extends Prototype {
      * A value which modifies platform speed; is subtracted when traveling from this location and added when traveling to this location.
      */
     gravity_pull?: double;
+    /**
+     * Hides the space location from the planet selection lists and the space map.
+     */
+    hidden?: boolean;
     /**
      * Path to the icon file.
      *
@@ -8635,6 +8718,9 @@ interface SpiderUnitPrototype extends EntityWithOwnerPrototype {
     height: float;
     max_pursue_distance?: double;
     min_pursue_time?: uint32;
+    /**
+     * In chunks. The radius of how many chunks this spider unit charts around itself.
+     */
     radar_range?: uint32;
     spawning_time_modifier?: double;
     spider_engine: SpiderEngineSpecification;
@@ -8712,6 +8798,22 @@ interface SpidertronRemotePrototype extends SelectionToolPrototype {
  * A {@link splitter | https://wiki.factorio.com/Splitter}.
  */
 interface SplitterPrototype extends TransportBeltConnectablePrototype {
+    circuit_connector?: [
+        CircuitConnectorDefinition,
+        CircuitConnectorDefinition,
+        CircuitConnectorDefinition,
+        CircuitConnectorDefinition
+    ];
+    /**
+     * The maximum circuit wire distance for this entity.
+     */
+    circuit_wire_max_distance?: double;
+    default_input_left_condition?: CircuitConditionConnector;
+    default_input_right_condition?: CircuitConditionConnector;
+    default_output_left_condition?: CircuitConditionConnector;
+    default_output_right_condition?: CircuitConditionConnector;
+    draw_circuit_wires?: boolean;
+    draw_copper_wires?: boolean;
     frozen_patch?: Sprite4Way;
     /**
      * The name of the {@link TransportBeltPrototype | prototype:TransportBeltPrototype} which is used for the sound of the underlying belt.
@@ -9159,6 +9261,10 @@ interface TechnologyPrototype extends Prototype {
      * Whether the technology should be shown in the technology tree GUI when "Show only essential technologies" is enabled.
      */
     essential?: boolean;
+    /**
+     * Hides the technology from the tech screen.
+     */
+    hidden?: boolean;
     /**
      * Path to the icon file.
      *
@@ -9234,7 +9340,13 @@ interface TemporaryContainerPrototype extends ContainerPrototype {
     destroy_on_empty?: boolean;
     time_to_live?: uint32;
 }
+/**
+ * Consumes two fluids as fuel to produce thrust for a space platform.
+ */
 interface ThrusterPrototype extends EntityWithOwnerPrototype {
+    /**
+     * If a {@link filter | prototype:FluidBox::filter} is set for this fluidbox it determines what the thruster considers the first fuel.
+     */
     fuel_fluid_box: FluidBox;
     graphics_set?: ThrusterGraphicsSet;
     /**
@@ -9242,6 +9354,9 @@ interface ThrusterPrototype extends EntityWithOwnerPrototype {
      */
     max_performance: ThrusterPerformancePoint;
     min_performance: ThrusterPerformancePoint;
+    /**
+     * If a {@link filter | prototype:FluidBox::filter} is set for this fluidbox it determines what the thruster considers the second fuel.
+     */
     oxidizer_fluid_box: FluidBox;
     plumes?: PlumesSpecification;
 }
@@ -9634,7 +9749,7 @@ interface TreePrototype extends EntityWithHealthPrototype {
      * Mandatory if `variations` is not defined.
      */
     pictures?: SpriteVariations;
-    stateless_visualisation_variations?: StatelessVisualisations[];
+    stateless_visualisation_variations?: (StatelessVisualisation | StatelessVisualisation[])[];
     variation_weights?: float[];
     /**
      * If defined, it can't be empty.
@@ -9923,6 +10038,9 @@ interface UnitPrototype extends EntityWithOwnerPrototype {
      * Movement speed of the unit in the world, in tiles per tick. Must be equal to or greater than 0.
      */
     movement_speed: float;
+    /**
+     * In chunks. The radius of how many chunks this unit charts around itself.
+     */
     radar_range?: uint32;
     render_layer?: RenderLayer;
     rotation_speed?: float;
@@ -10227,6 +10345,10 @@ interface UtilityConstants extends PrototypeBase {
     max_fluid_flow: FluidAmount;
     max_logistic_filter_count: LogisticFilterIndex;
     max_terrain_building_size: uint8;
+    /**
+     * Cap for how many steps of quality the output of something (miner/crafter) may be higher than the input (resource/ingredients). Must be >= 1.
+     */
+    maximum_quality_jump: uint8;
     maximum_recipe_overload_multiplier: uint32;
     medium_area_size: float;
     medium_blueprint_area_size: float;
@@ -10251,6 +10373,7 @@ interface UtilityConstants extends PrototypeBase {
      */
     player_colors: PlayerColorData[];
     probability_product_count_tint: Color;
+    quality_selector_dropdown_threshold: uint8;
     rail_planner_count_button_color: Color;
     rail_segment_colors: Color[];
     recipe_step_limit: uint32;
@@ -11046,6 +11169,9 @@ interface VehiclePrototype extends EntityWithOwnerPrototype {
      * Must be positive. There is no functional difference between the two ways to set braking power/force.
      */
     braking_power: Energy | double;
+    /**
+     * In chunks. The radius of the radar range of the vehicle, so how many chunks it charts around itself.
+     */
     chunk_exploration_radius?: uint32;
     crash_trigger?: TriggerEffect;
     /**