Factorio.com|Forums|Wiki|Mod Portal|API Docs

# Factorio Runtime Docs Version 2.0.77

# TriggerEffectItem - Runtime Docs

## TriggerEffectItem :: table

#### Table fields

type | :: TriggerEffectItemType |
repeat_count | :: uint16 |
repeat_count_deviation | :: uint16 |
probability | :: float |
affects_target | :: boolean |
show_in_tooltip | :: boolean |
damage_type_filters | :: DamageTypeFilters? |

Other attributes may be specified depending on `type`:

#### `activate-impact`

deliver_category | :: string |

#### `camera-effect`

duration | :: uint8 |
ease_in_duration | :: uint8 |
ease_out_duration | :: uint8 |
delay | :: uint8 |
full_strength_max_distance | :: uint16 |
max_distance | :: uint16 |
strength | :: float |

#### `create-asteroid-chunk`

asteroid_name | :: string |
offsets | :: array[Vector] |
offset_deviation | :: BoundingBox |

#### `create-decorative`

decorative | :: string |
spawn_min | :: uint16 |
spawn_max | :: uint16 |
spawn_min_radius | :: float |
spawn_max_radius | :: float |
radius_curve | :: float |
apply_projection | :: boolean |
spread_evenly | :: boolean |

#### `create-entity`

entity_name | :: string |
offsets | :: array[Vector] |
offset_deviation | :: BoundingBox |
trigger_created_entity | :: boolean |
check_buildability | :: boolean |
only_when_visible | :: boolean |
tile_collision_mask | :: CollisionMask |
as_enemy | :: boolean |
ignore_no_enemies_mode | :: boolean |
protected | :: boolean |
find_non_colliding_position | :: boolean |
abort_if_over_space | :: boolean |
non_colliding_search_radius | :: double |
non_colliding_search_precision | :: double |
non_colliding_fail_result | :: array[TriggerItem]? |

#### `create-explosion`

entity_name | :: string |
offsets | :: array[Vector] |
offset_deviation | :: BoundingBox |
trigger_created_entity | :: boolean |
check_buildability | :: boolean |
only_when_visible | :: boolean |
tile_collision_mask | :: CollisionMask |
as_enemy | :: boolean |
ignore_no_enemies_mode | :: boolean |
protected | :: boolean |
find_non_colliding_position | :: boolean |
abort_if_over_space | :: boolean |
non_colliding_search_radius | :: double |
non_colliding_search_precision | :: double |
non_colliding_fail_result | :: array[TriggerItem]? |
max_movement_distance | :: float |
max_movement_distance_deviation | :: float |
inherit_movement_distance_from_projectile | :: boolean |
cycle_while_moving | :: boolean |

#### `create-fire`

entity_name | :: string |
offsets | :: array[Vector] |
offset_deviation | :: BoundingBox |
trigger_created_entity | :: boolean |
check_buildability | :: boolean |
only_when_visible | :: boolean |
tile_collision_mask | :: CollisionMask |
as_enemy | :: boolean |
ignore_no_enemies_mode | :: boolean |
protected | :: boolean |
find_non_colliding_position | :: boolean |
abort_if_over_space | :: boolean |
non_colliding_search_radius | :: double |
non_colliding_search_precision | :: double |
non_colliding_fail_result | :: array[TriggerItem]? |
initial_ground_flame_count | :: uint8? |

#### `create-particle`

particle_name | :: string |
offsets | :: array[Vector] |
offset_deviation | :: BoundingBox |
tile_collision_mask | :: CollisionMask |
initial_height | :: float |
initial_height_deviation | :: float |
initial_vertical_speed | :: float |
initial_vertical_speed_deviation | :: float |
speed_from_center | :: float |
speed_from_center_deviation | :: float |
frame_speed | :: float |
frame_speed_deviation | :: float |
movement_multiplier | :: float |
tail_length | :: uint8? |
tail_length_deviation | :: uint8? |
tail_width | :: float? |
rotate_offsets | :: boolean |
only_when_visible | :: boolean |
tint | :: Color? |
apply_tile_tint | :: ApplyTileTint? |

#### `create-smoke`

entity_name | :: string |
offsets | :: array[Vector] |
offset_deviation | :: BoundingBox |
trigger_created_entity | :: boolean |
check_buildability | :: boolean |
only_when_visible | :: boolean |
tile_collision_mask | :: CollisionMask |
as_enemy | :: boolean |
ignore_no_enemies_mode | :: boolean |
protected | :: boolean |
find_non_colliding_position | :: boolean |
abort_if_over_space | :: boolean |
non_colliding_search_radius | :: double |
non_colliding_search_precision | :: double |
non_colliding_fail_result | :: array[TriggerItem]? |
initial_height | :: float |
speed | :: Vector |
speed_multiplier | :: float |
speed_multiplier_deviation | :: float |
starting_frame | :: float |
starting_frame_deviation | :: float |
speed_from_center | :: float |
speed_from_center_deviation | :: float |

#### `create-sticker`

sticker | :: string |
trigger_created_entity | :: boolean |

#### `create-trivial-smoke`

smoke_name | :: string |
offsets | :: array[Vector] |
offset_deviation | :: BoundingBox |
initial_height | :: float |
max_radius | :: float? |
speed | :: Vector |
speed_multiplier | :: float |
speed_multiplier_deviation | :: float |
starting_frame | :: float |
starting_frame_deviation | :: float |
speed_from_center | :: float |
speed_from_center_deviation | :: float |

#### `damage`

damage | :: DamageParameters |
apply_damage_to_trees | :: boolean |
vaporize | :: boolean |
use_substitute | :: boolean |
lower_distance_threshold | :: uint16 |
upper_distance_threshold | :: uint16 |
lower_damage_modifier | :: float |
upper_damage_modifier | :: float |

#### `damage-tile`

damage | :: DamageParameters |
radius | :: float |

#### `destroy-cliffs`

radius | :: float |

#### `destroy-decoratives`

radius | :: float |
from_render_layer | :: RenderLayer |
to_render_layer | :: RenderLayer |
include_soft_decoratives | :: boolean |
include_decals | :: boolean |
invoke_decorative_trigger | :: boolean |
decoratives_with_trigger_only | :: boolean |

#### `insert-item`

item | :: string |
quality | :: string |
count | :: ItemCountType |

#### `invoke-tile-trigger`

tile_collision_mask | :: CollisionMask |

#### `nested-result`

action | :: array[TriggerItem] |

#### `play-sound`

min_distance | :: float |
max_distance | :: float |
play_on_target_position | :: boolean |

#### `push-back`

distance | :: float |

#### `script`

effect_id | :: string |

#### `set-tile`

tile_name | :: string |
radius | :: float |
apply_projection | :: boolean |
apply_on_space_platform | :: boolean |
tile_collision_mask | :: CollisionMask |

#### `show-explosion-on-chart`

scale | :: float |

Concept used in

- LuaAsteroidChunkPrototype::dying_trigger_effect
- LuaDecorativePrototype::trigger_effect
- LuaDecorativePrototype::placed_effect
- LuaEntityPrototype::spawn_decoration
- LuaEntityPrototype::dying_trigger_effect
- LuaEntityPrototype::damaged_trigger_effect
- LuaParticlePrototype::regular_trigger_effect
- LuaParticlePrototype::ended_in_water_trigger_effect
- LuaParticlePrototype::ended_on_ground_trigger_effect
- LuaTilePrototype::trigger_effect
- SpiderLegSpecification
- TriggerDelivery
- TriggerEffectWithCooldown
- TriggerItem