Prototype/Projectile
The prototype docs have moved to a new website with an improved format. This documentation page can now be found here: https://lua-api.factorio.com/latest/prototypes/ProjectilePrototype.html
This wiki page is no longer updated and will be removed at some point in the future, so please update your browser bookmarks or other links that sent you here. If you'd like to contribute to the new docs, you can leave your feedback on the forums.
Prototype definitions » PrototypeBase » Prototype/Entity » Prototype/Projectile
Entity with limited lifetime that can hit other entities and has triggers when this happens.
Mandatory properties
This prototype inherits all the properties from Prototype/Entity.
acceleration
Type: double
Must be != 0 if turning_speed_increases_exponentially_with_projectile_speed is true.
Optional properties
animation
Type: Animation
rotatable
Type: bool
Default: true
Whether the animation of the projectile is rotated to match the direction of travel.
enable_drawing_with_mask
Type: bool
Default: false
direction_only
Type: bool
Default: false
Setting this to true can be used to disable projectile homing behaviour.
hit_at_collision_position
Type: bool
Default: false
When true the entity is hit at the position on its collision box the projectile first collides with. When false the entity is hit at its own position.
force_condition
Type: ForceCondition
Default: "all"
piercing_damage
Type: float
Default: 0
Whenever an entity is hit by the projectile, this number gets reduced by the health of the entity. If the number is then below 0, the final_action is applied and the projectile destroyed. Otherwise, the projectile simply continues to its destination.
max_speed
Type: double
Default: MAX_DOUBLE
Must be greater than or equal to 0.
turn_speed
Type: float
Default: 1
Must be greater than or equal to 0.
speed_modifier
Type: vector
Default: {1, 1}
height
Type: double
Default: 1
action
Type: Trigger
Executed when the projectile hits something.
final_action
Type: Trigger
Executed when the projectile hits something, after action and only if the entity that was hit was destroyed. The projectile is destroyed right after the final_action.
light
Type: LightDefinition
smoke
Type: Array of SmokeSource
hit_collision_mask
Type: CollisionMask
Default: {"player-layer", "train-layer"}
turning_speed_increases_exponentially_with_projectile_speed
Type: bool
Default: false
shadow
Type: Animation