Types/AmmoType

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/types/AmmoType.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.

Basics

Definition of actual parameters used in attack.

Mandatory properties

category

Type: Types/string

Name of a Prototype/AmmoCategory. Defines whether the attack will be affected by upgrades.

Optional properties

action

Type: Types/Trigger

Describes actions taken upon attack happening.

clamp_position

Type: Types/bool

Default: false

When true, the gun will be able to shoot even when the target is out of range. Only applies when target_type is position. The gun will fire at the maximum range in the direction of the target position. Defaults to false.

energy_consumption

Type: Types/Energy

Energy consumption of a single shot, if applicable.

range_modifier

Type: Types/double

Default: 1

Affects the range value of the shooting gun prototype's Types/BaseAttackParameters to give a modified maximum range. The min_range value of the gun is unaffected.

This has no effect on artillery turrets and wagons even though the bonus appears in the GUI.[1]

cooldown_modifier

Type: Types/double

Default: 1

consumption_modifier

Type: Types/float

Default: 1

target_type

Type: Types/string

Default: "entity"

Either "entity", "position" or "direction". If this is "entity", clamp_position is forced to be false. "entity" fires at an entity, "position" fires directly at a position, "direction" fires in a direction.