UnitPrototype

Entity that moves around and attacks players, for example biters and spitters.

Parent

• EntityWithOwnerPrototype

Properties

run_animation

• Type: RotatedAnimation
• Optional: false
• Override: false

attack_parameters

• Type: AttackParameters
• Optional: false
• Override: false

Requires animation in attack_parameters. Requires ammo_type in attack_parameters.

warcry

• Type: Sound
• Optional: true
• Override: false

A sound the unit makes when it sets out to attack.

movement_speed

• Type: float
• Optional: false
• Override: false

Movement speed of the unit in the world, in tiles per tick. Must be equal to or greater than 0.

distance_per_frame

• Type: float
• Optional: false
• Override: false

How fast the run_animation frames are advanced. The animations are advanced animation_speed frames per distance_per_frame that the unit moves.

frames_advanced = (distance_moved ÷ distance_per_frame) * animation_speed

distraction_cooldown

• Type: uint32
• Optional: false
• Override: false

vision_distance

• Type: double
• Optional: false
• Override: false

Max is 100.

Note: Setting to 50 or above can lead to undocumented behavior of individual units creating groups on their own when attacking or being attacked.

rotation_speed

• Type: float
• Optional: true
• Override: false

dying_sound

• Type: Sound
• Optional: true
• Override: false

The sound file to play when entity dies.

min_pursue_time

• Type: uint32
• Optional: true
• Override: false

In ticks.

has_belt_immunity

• Type: boolean
• Optional: true
• Override: false

If the unit is immune to movement by belts.

max_pursue_distance

• Type: double
• Optional: true
• Override: false

radar_range

• Type: uint32
• Optional: true
• Override: false

In chunks. The radius of how many chunks this unit charts around itself.

ai_settings

• Type: UnitAISettings
• Optional: true
• Override: false

move_while_shooting

• Type: boolean
• Optional: true
• Override: false

can_open_gates

• Type: boolean
• Optional: true
• Override: false

affected_by_tiles

• Type: boolean
• Optional: true
• Override: false

render_layer

• Type: RenderLayer
• Optional: true
• Override: false

light

• Type: LightDefinition
• Optional: true
• Override: false

absorptions_to_join_attack

• Type: Dict<AirbornePollutantID, float>
• Optional: true
• Override: false

spawning_time_modifier

• Type: double
• Optional: true
• Override: false

walking_sound

• Type: Sound
• Optional: true
• Override: false

alternative_attacking_frame_sequence

• Type: UnitAlternativeFrameSequence
• Optional: true
• Override: false

running_sound_animation_positions

• Type: Array<float>
• Optional: true
• Override: false

Only loaded if walking_sound is defined.

is_military_target

• Type: true
• Optional: true
• Override: true

Whether this prototype should be a high priority target for enemy forces. See Military units and structures.

allow_run_time_change_of_is_military_target

• Type: false
• Optional: true
• Override: true

If this is true, this entities is_military_target property can be changed runtime (on the entity, not on the prototype itself).