Factorio API Docs

1.1.52 <>

Class LuaEntityPrototype

Prototype of an entity.

has_flag(flag)
boolean

Test whether this entity prototype has a certain flag set.


uint

Gets the base size of the given inventory on this entity or nil if the given inventory doesn't exist.


help()
string

All methods and properties that this object supports.


:: string
[R]

Type of this prototype.


:: string
[R]

Name of this prototype.




:: float
[R]

Max health of this entity.


:: boolean
[R]

Is this resource infinite?


:: uint
[R]

Minimum amount of this resource.


:: uint
[R]

The normal amount for this resource.


:: uint
[R]

Every time this infinite resource 'ticks' down it is reduced by this amount.


:: string
[R]

Name of the category of this resource or nil when not a resource.


:: table
[R]

Whether this entity is minable and what can be obtained by mining it.


:: array[SimpleItemStack]
[R]

Items that, when placed, will produce this entity.


[R]

The bounding box used for collision checking.


[R]

The secondary bounding box used for collision checking, or nil if it doesn't have one.


[R]

The bounding box used for map generator collision checking.


[R]

The bounding box used for drawing selection.


[R]

The bounding box used for drawing the entity icon.


[R]

The bounding box used to attach sticker type entities.


[R]

The collision masks this entity uses



[R]

The hardcoded default collision mask (with flags) for this entity prototype type.


:: string
[R]

Order string of this prototype.


[R]

Group of this entity.


[R]

Subgroup of this entity.


:: float
[R]

Amount this entity can heal per tick.


:: double
[R]

Amount of pollution emissions per second this entity will create.


:: dictionary[stringLuaEntityPrototype]
[R]

Corpses used when this entity is destroyed.


:: boolean
[R]

Is this entity selectable?


:: uint
[R]

The selection priority of this entity - a value between 0 and 255


:: double
[R]

The weight of this vehicle prototype or nil if not a vehicle prototype.


:: dictionary[stringResistance]
[R]

List of resistances towards each damage type.


:: string
[R]

The group of mutually fast-replaceable entities.


[R]

The next upgrade for this entity or nil.


:: array[Loot]
[R]

Loot that will be dropped when this entity is killed.


:: uint
[R]

Repair-speed modifier for this entity.


:: uint
[R]

The range of this turret or nil if this isn't a turret related prototype.


[R]

Autoplace specification for this entity prototype.


:: double
[R]

The speed of this transport belt or nil if this isn't a transport belt related prototype.


[R]

The result units and spawn points with weight and evolution factor for a biter spawner entity.


:: array[TriggerItem]
[R]

The attack result of this entity if the entity has one, else nil.


:: array[TriggerItem]
[R]

The final attack result for projectiles nil if not a projectile


[R]

The attack parameters for this entity or nil if the entity doesn't use attack parameters.


:: table
[R]

The spawning cooldown for this enemy spawner prototype or nil.


:: double
[R]

The mining radius of this mining drill prototype or nil if this isn't a mining drill prototype.


:: double
[R]

The mining speed of this mining drill/character prototype or nil.


:: string
[R]

The logistic mode of this logistic container or nil if this isn't a logistic container prototype.


:: uint8
[R]

The max underground distance for underground belts and underground pipes or nil if this isn't one of those prototypes.


[R]

The flags for this entity prototype.


:: array[LuaEntityPrototype]
[R]

The remains left behind when this entity is mined.


:: array[LuaEntityPrototype]
[R]

Entities this entity can be pasted onto in addition to the normal allowed ones.


:: boolean
[R]

When false copy-paste is not allowed for this entity.


:: double
[R]

The cursor size used when shooting at this entity.


:: table
[R]

The smoke trigger run when this entity is built or nil.


:: array[TriggerItem]
[R]

The trigger run when this entity is created or nil.


:: Color
[R]

The map color used when charting this entity if a friendly or enemy color isn't defined or nil.


:: Color
[R]

The friendly map color used when charting this entity.


:: Color
[R]

The enemy map color used when charting this entity.


:: double
[R]

The evolution requirement to build this entity as a base when expanding enemy bases.


[R]

The instruments for this programmable speaker or nil.


:: uint
[R]

The maximum polyphony for this programmable speaker or nil.


:: uint
[R]

The module inventory size or nil if this entity doesn't support modules.


:: uint
[R]

The max number of ingredients this crafting-machine prototype supports or nil if this isn't a crafting-machine prototype.


:: double
[R]

The crafting speed of this crafting-machine or nil.


:: dictionary[stringboolean]
[R]

The crafting categories this entity supports.


:: dictionary[stringboolean]
[R]

The resource categories this character or mining drill supports, or nil if not a character or mining dill.


:: double
[R]

The supply area of this electric pole, beacon, or nil if this is neither.


:: double
[R]

The maximum wire distance for this entity.


:: double
[R]

The maximum circuit wire distance for this entity.


:: double
[R]

The direct energy usage of this entity or nil if this entity doesn't have a direct energy usage.


:: double
[R]

The theoretical maximum energy usage for this entity.


:: double
[R]

The theoretical maximum energy production for this this entity.


:: double
[R]

The effectivity of this car prototype, generator prototype or nil.


:: double
[R]

The energy consumption of this car prototype or nil if not a car prototype.


:: double
[R]

The friction of this vehicle prototype or nil if not a vehicle prototype.


:: double
[R]

The braking force of this vehicle prototype or nil if not a vehicle prototype.


:: double
[R]

The air resistance of this rolling stock prototype or nil if not a rolling stock prototype.


:: boolean
[R]

If this car prototype uses tank controls to drive or nil if this is not a car prototype.


:: double
[R]

The rotation speed of this car prototype or nil if not a car prototype.


:: double
[R]

The turret rotation speed of this car prototype or nil if not a car prototype.


:: dictionary[stringLuaItemPrototype]
[R]

The guns this prototype uses or nil.


:: double
[R]

The default speed of this flying robot, rolling stock or unit, nil if not one of these.


:: float
[R]

The speed multiplier when this flying robot is out of energy or nil.


:: uint
[R]

The max payload size of this logistics or construction robot or nil.


:: boolean
[R]

Whether this logistics or construction robot renders its cargo when flying or nil.


:: double
[R]

The energy consumed per tile moved for this flying robot or nil.


:: double
[R]

The energy consumed per tick for this flying robot or nil.


:: double
[R]

The max energy for this flying robot or nil.


:: float
[R]

The minimum energy for this flying robot before it tries to recharge or nil.


:: float
[R]

The maximum energy for this flying robot above which it won't try to recharge when stationing or nil.


[R]

The burner energy source prototype this entity uses or nil.


[R]

The electric energy source prototype this entity uses or nil.


[R]

The heat energy source prototype this entity uses or nil.


[R]

The fluid energy source prototype this entity uses or nil.


[R]

The void energy source prototype this entity uses or nil.


:: uint
[R]

The log2 of grid size of the building


:: double
[R]

The fluid usage of this generator prototype or nil.


:: double
[R]

The maximum fluid temperature of this generator prototype or nil.


:: double
[R]

The target temperature of this boiler prototype or nil.


[R]

The fluid this offshore pump produces or nil.


:: double
[R]

The fluid capacity of this entity or 0 if this entity doesn't support fluids.


:: double
[R]

The pumping speed of this offshore pump, normal pump, or nil.


:: boolean
[R]

If this inserter is a stack-type.


:: boolean
[R]

If this inserter allows custom pickup and drop vectors.


:: boolean
[R]

If this inserter allows burner leeching.


:: double
[R]

The extension speed of this inserter or nil.


:: double
[R]

The rotation speed of this inserter or nil.


:: Vector
[R]

The pickup position for this inserter or nil.


:: Vector
[R]

The drop position for this inserter or nil.


:: boolean
[R]

True if this inserter chases items on belts for pickup or nil.


:: boolean
[R]

If this simple-entity is counted as a rock for the deconstruction planner "trees and rocks only" filter.


:: uint
[R]

The filter count of this inserter, loader, or logistic chest or nil.


:: uint
[R]

The time to live for this prototype or 0 if prototype doesn't have time_to_live or time_before_removed.


:: double
[R]

The distribution effectivity for this beacon prototype or nil if not a beacon prototype.


:: double
[R]

Does this explosion have a beam or nil if not an explosion prototype.


:: double
[R]

Does this explosion rotate or nil if not an explosion prototype.


:: uint8
[R]

If it is a tree, return the number of colors it supports.


:: boolean
[R]

Does this entity with health prototype alert when damaged?


:: boolean
[R]

Does this turret prototype alert when attacking?


:: Color
[R]

The color of the prototype, or nil if the prototype doesn't have color.


:: boolean
[R]

Does this prototype collision mask collide with itself?


:: boolean
[R]

Does this prototype collision mask collide with tiles only?


:: boolean
[R]

Does this prototype collision mask consider tile transitions?


:: dictionary[stringboolean]
[R]

The allowed module effects for this entity or nil.


:: uint
[R]

The rocket parts required for this rocket silo prototype or nil.


:: uint8
[R]

The rocket rising delay for this rocket silo prototype or nil.


:: uint8
[R]

The rocket launch delay for this rocket silo prototype or nil.


:: double
[R]

The light blinking speed for this rocket silo prototype or nil.


:: double
[R]

The door opening speed for this rocket silo prototype or nil.


:: double
[R]

The rising speed for this rocket silo rocket prototype or nil.


:: double
[R]

The engine starting speed for this rocket silo rocket prototype or nil.


:: double
[R]

The flying speed for this rocket silo rocket prototype or nil.


:: double
[R]

The flying acceleration for this rocket silo rocket prototype or nil.


:: string
[R]

The fixed recipe name for this assembling machine prototype or nil.


:: double
[R]

The construction radius for this roboport prototype or nil.


:: double
[R]

The logistic radius for this roboport prototype or nil.


:: double
[R]

The energy used per hitpoint taken for this vehicle during collisions or nil.


:: boolean
[R]

If this prototype will attempt to create a ghost of itself on death.


:: uint
[R]

The time it takes this land mine to arm.


[R]

Collision mask entity must collide with to make landmine blowup


[R]

The fluidbox prototypes for this entity.







:: uint
[R]

The amount of ammo that inserters automatically insert into this ammo-turret or artillery-turret or nil.


:: double
[R]

The max speed of this projectile prototype or flying robot prototype or nil.


:: float
[R]

Value between 0 and 1 darkness where all lamps of this lamp prototype are on or nil.


:: float
[R]

Value between 0 and 1 darkness where all lamps of this lamp prototype are off or nil.


:: boolean
[R]

Whether the lamp is always on (except when out of power or turned off by the circuit network) or nil.


:: float
[R]

The minimum darkness at which this unit spawner can spawn entities.


:: float
[R]

The maximum darkness at which this unit spawner can spawn entities.



:: double
[R]

Count of enemies this spawner can sustain.


:: double
[R]

How many friendly units are required within the spawning_radius of this spawner for it to stop producing more units.


:: double
[R]

How far from the spawner can the units be spawned.


:: double
[R]

What spaces should be between the spawned units.


:: double
[R]

The radius of this entity prototype.


:: string
[R]

The item prototype name used to destroy this cliff or nil.


[R]

The rocket entity prototype associated with this rocket silo prototype or nil.


:: boolean
[R]

Whether this unit, car, or character prototype has belt immunity, nil if not car, unit, or character prototype.


:: double
[R]

The vision distance of this unit prototype or nil.


:: float
[R]

The amount of pollution that has to be absorbed by the unit's spawner before the unit will leave the spawner and attack the source of the pollution.


:: uint
[R]

The minimum pursue time of this unit prototype or nil.


:: double
[R]

The maximum pursue distance of this unit prototype or nil.


:: uint
[R]

The radar range of this unit prototype or nil.


:: boolean
[R]

Whether this unit prototype can move while shooting or nil.


:: boolean
[R]

Whether this unit prototype can open gates or nil.


:: boolean
[R]

Whether this unit prototype is affected by tile walking speed modifiers or nil.


:: uint
[R]

The distraction cooldown of this unit prototype or nil.


:: double
[R]

The spawning time modifier of this unit prototype or nil.


:: Vector
[R]

The alert icon shift of this entity prototype.


:: array[string]
[R]

The item prototype names that are the inputs of this lab prototype or nil.


:: double
[R]

The base researching speed of this lab prototype or nil.


:: uint
[R]

The item slot count of this constant combinator prototype or nil.


:: double
[R]

The base productivity of this crafting machine, lab, or mining drill, or nil.


:: boolean
[R]

If this market allows access to all forces or just friendly ones.


:: boolean
[R]

If this entity prototype could possibly ever be rotated.


:: float
[R]

The terrain friction modifier for this vehicle.


:: boolean
[R]

If this vehicle allows passengers.


:: uint
[R]

The radius of the area this radar can chart, in chunks.


:: uint
[R]

The radius of the area constantly revealed by this radar, in chunks.


[R]

The bounding box that specifies which tiles adjacent to the offshore pump should be checked.


[R]

Tiles adjacent to the offshore pump must not collide with this collision mask.


[R]

If this mask is not empty, tiles adjacent to the offshore pump must not collide with this collision mask.


[R]

The collision mask used only for collision test with tile directly at offshore pump position.


[R]

The equipment grid prototype for this entity or nil.




:: double
[R]

Gets the built-in stack size bonus of this inserter prototype.


:: boolean
[R]

True if this entity prototype should be included during tile collision checks with LuaTilePrototype::check_collision_with_entities enabled.


:: boolean
[R]

True if this is entity-with-owner


:: boolean
[R]

True if this entity-with-owner is military target


:: boolean
[R]

True if this entity-with-owner's is_military_target can be changed run-time (on the entity, not on the prototype itself)


:: double
[R]

Gets the current movement speed of this character, including effects from exoskeletons, tiles, stickers and shooting.
















:: boolean
[R]

Is this object valid?


:: string
[R]

The class name of this object.

Methods

has_flag (flag) → boolean

Test whether this entity prototype has a certain flag set.

Parameters

flag
:: string

The flag to test. See EntityPrototypeFlags for a list of flags.

Return value

true if this prototype has the given flag set.


get_inventory_size (index) → uint

Gets the base size of the given inventory on this entity or nil if the given inventory doesn't exist.

Parameters


help () → string

All methods and properties that this object supports.

Attributes

type :: string [Read]

Type of this prototype.


name :: string [Read]

Name of this prototype.


localised_name :: LocalisedString [Read]


localised_description :: LocalisedString [Read]


max_health :: float [Read]

Max health of this entity. Will be 0 if this is not an entity with health.


infinite_resource :: boolean [Read]

Is this resource infinite? Will be nil when used on a non-resource.


minimum_resource_amount :: uint [Read]

Minimum amount of this resource. Will be nil when used on a non-resource.


normal_resource_amount :: uint [Read]

The normal amount for this resource. nil when not a resource.


infinite_depletion_resource_amount :: uint [Read]

Every time this infinite resource 'ticks' down it is reduced by this amount. nil when not a resource. Meaningless if this isn't an infinite type resource.


resource_category :: string [Read]

Name of the category of this resource or nil when not a resource.

Note

During data stage this property is named "category".


mineable_properties :: table [Read]

Whether this entity is minable and what can be obtained by mining it.

Table fields

minable
:: boolean

Is this entity mineable at all?


mining_time
:: double

Energy required to mine an entity.


mining_particle
:: string
Optional

Prototype name of the particle produced when mining this entity. Will only be present if this entity produces any particle during mining.


products
:: array[Product]
Optional

Products obtained by mining this entity.


fluid_amount
:: double
Optional

The required fluid amount if any.


required_fluid
:: string
Optional

The prototype name of the required fluid if any.


mining_trigger
:: array[TriggerItem]
Optional

The mining trigger if any.


items_to_place_this :: array[SimpleItemStack] [Read]

Items that, when placed, will produce this entity. It is an array of items, or nil if no items place this entity. Construction bots will always choose the first item in this list to build this entity.


collision_box :: BoundingBox [Read]

The bounding box used for collision checking.


secondary_collision_box :: BoundingBox [Read]

The secondary bounding box used for collision checking, or nil if it doesn't have one. This is only used in rails and rail remnants.


map_generator_bounding_box :: BoundingBox [Read]

The bounding box used for map generator collision checking.


selection_box :: BoundingBox [Read]

The bounding box used for drawing selection.


drawing_box :: BoundingBox [Read]

The bounding box used for drawing the entity icon.


sticker_box :: BoundingBox [Read]

The bounding box used to attach sticker type entities.


collision_mask :: CollisionMask [Read]

The collision masks this entity uses


collision_mask_with_flags :: CollisionMaskWithFlags [Read]


default_collision_mask_with_flags :: CollisionMaskWithFlags [Read]

The hardcoded default collision mask (with flags) for this entity prototype type.


order :: string [Read]

Order string of this prototype.


group :: LuaGroup [Read]

Group of this entity.


subgroup :: LuaGroup [Read]

Subgroup of this entity.


healing_per_tick :: float [Read]

Amount this entity can heal per tick.


emissions_per_second :: double [Read]

Amount of pollution emissions per second this entity will create.


corpses :: dictionary[stringLuaEntityPrototype] [Read]

Corpses used when this entity is destroyed. It is a dictionary indexed by the corpse's prototype name.


selectable_in_game :: boolean [Read]

Is this entity selectable?


selection_priority :: uint [Read]

The selection priority of this entity - a value between 0 and 255


weight :: double [Read]

The weight of this vehicle prototype or nil if not a vehicle prototype.


resistances :: dictionary[stringResistance] [Read]

List of resistances towards each damage type. It is a dictionary indexed by damage type names (see data/base/prototypes/damage-type.lua).


fast_replaceable_group :: string [Read]

The group of mutually fast-replaceable entities. Possibly nil.


next_upgrade :: LuaEntityPrototype [Read]

The next upgrade for this entity or nil.


loot :: array[Loot] [Read]

Loot that will be dropped when this entity is killed. nil if there is no loot.


repair_speed_modifier :: uint [Read]

Repair-speed modifier for this entity. Actual repair speed will be tool_repair_speed * entity_repair_speed_modifier. May be nil.


turret_range :: uint [Read]

The range of this turret or nil if this isn't a turret related prototype.


autoplace_specification :: AutoplaceSpecification [Read]

Autoplace specification for this entity prototype. nil if none.


belt_speed :: double [Read]

The speed of this transport belt or nil if this isn't a transport belt related prototype.


result_units :: array[UnitSpawnDefinition] [Read]

The result units and spawn points with weight and evolution factor for a biter spawner entity.


attack_result :: array[TriggerItem] [Read]

The attack result of this entity if the entity has one, else nil.


final_attack_result :: array[TriggerItem] [Read]

The final attack result for projectiles nil if not a projectile


attack_parameters :: AttackParameters [Read]

The attack parameters for this entity or nil if the entity doesn't use attack parameters.


spawn_cooldown :: table [Read]

The spawning cooldown for this enemy spawner prototype or nil.

Table fields

min
:: double

max
:: double

mining_drill_radius :: double [Read]

The mining radius of this mining drill prototype or nil if this isn't a mining drill prototype.


mining_speed :: double [Read]

The mining speed of this mining drill/character prototype or nil.


logistic_mode :: string [Read]

The logistic mode of this logistic container or nil if this isn't a logistic container prototype. One of "requester", "active-provider", "passive-provider", "buffer", "storage", "none".


max_underground_distance :: uint8 [Read]

The max underground distance for underground belts and underground pipes or nil if this isn't one of those prototypes.


flags :: EntityPrototypeFlags [Read]

The flags for this entity prototype.


remains_when_mined :: array[LuaEntityPrototype] [Read]

The remains left behind when this entity is mined.


additional_pastable_entities :: array[LuaEntityPrototype] [Read]

Entities this entity can be pasted onto in addition to the normal allowed ones.


allow_copy_paste :: boolean [Read]

When false copy-paste is not allowed for this entity.


shooting_cursor_size :: double [Read]

The cursor size used when shooting at this entity.


created_smoke :: table [Read]

The smoke trigger run when this entity is built or nil.

Table fields

smoke_name
:: string

offsets
:: array[Vector]

offset_deviation

initial_height
:: float

max_radius
:: float
Optional

speed
:: Vector

speed_multiplier
:: float

speed_multiplier_deviation
:: float

starting_frame
:: float

starting_frame_deviation
:: float

starting_frame_speed
:: float

starting_frame_speed_deviation
:: float

speed_from_center
:: float

speed_from_center_deviation
:: float

created_effect :: array[TriggerItem] [Read]

The trigger run when this entity is created or nil.


map_color :: Color [Read]

The map color used when charting this entity if a friendly or enemy color isn't defined or nil.


friendly_map_color :: Color [Read]

The friendly map color used when charting this entity.


enemy_map_color :: Color [Read]

The enemy map color used when charting this entity.


build_base_evolution_requirement :: double [Read]

The evolution requirement to build this entity as a base when expanding enemy bases.


instruments :: array[ProgrammableSpeakerInstrument] [Read]

The instruments for this programmable speaker or nil.


max_polyphony :: uint [Read]

The maximum polyphony for this programmable speaker or nil.


module_inventory_size :: uint [Read]

The module inventory size or nil if this entity doesn't support modules.


ingredient_count :: uint [Read]

The max number of ingredients this crafting-machine prototype supports or nil if this isn't a crafting-machine prototype.


crafting_speed :: double [Read]

The crafting speed of this crafting-machine or nil.


crafting_categories :: dictionary[stringboolean] [Read]

The crafting categories this entity supports. Only meaningful when this is a crafting-machine or player entity type.

Note

The value in the dictionary is meaningless and exists just to allow the dictionary type for easy lookup.


resource_categories :: dictionary[stringboolean] [Read]

The resource categories this character or mining drill supports, or nil if not a character or mining dill.

Note

The value in the dictionary is meaningless and exists just to allow the dictionary type for easy lookup.


supply_area_distance :: double [Read]

The supply area of this electric pole, beacon, or nil if this is neither.


max_wire_distance :: double [Read]

The maximum wire distance for this entity. 0 when the entity doesn't support wires.


max_circuit_wire_distance :: double [Read]

The maximum circuit wire distance for this entity. 0 when the entity doesn't support circuit wires.


energy_usage :: double [Read]

The direct energy usage of this entity or nil if this entity doesn't have a direct energy usage.


max_energy_usage :: double [Read]

The theoretical maximum energy usage for this entity.


max_energy_production :: double [Read]

The theoretical maximum energy production for this this entity.


effectivity :: double [Read]

The effectivity of this car prototype, generator prototype or nil.


consumption :: double [Read]

The energy consumption of this car prototype or nil if not a car prototype.


friction_force :: double [Read]

The friction of this vehicle prototype or nil if not a vehicle prototype.


braking_force :: double [Read]

The braking force of this vehicle prototype or nil if not a vehicle prototype.


air_resistance :: double [Read]

The air resistance of this rolling stock prototype or nil if not a rolling stock prototype.


tank_driving :: boolean [Read]

If this car prototype uses tank controls to drive or nil if this is not a car prototype.


rotation_speed :: double [Read]

The rotation speed of this car prototype or nil if not a car prototype.


turret_rotation_speed :: double [Read]

The turret rotation speed of this car prototype or nil if not a car prototype.


guns :: dictionary[stringLuaItemPrototype] [Read]

The guns this prototype uses or nil.


speed :: double [Read]

The default speed of this flying robot, rolling stock or unit, nil if not one of these.

Note

For rolling stocks, this is their max_speed.


speed_multiplier_when_out_of_energy :: float [Read]

The speed multiplier when this flying robot is out of energy or nil.


max_payload_size :: uint [Read]

The max payload size of this logistics or construction robot or nil.


draw_cargo :: boolean [Read]

Whether this logistics or construction robot renders its cargo when flying or nil.


energy_per_move :: double [Read]

The energy consumed per tile moved for this flying robot or nil.


energy_per_tick :: double [Read]

The energy consumed per tick for this flying robot or nil.


max_energy :: double [Read]

The max energy for this flying robot or nil.


min_to_charge :: float [Read]

The minimum energy for this flying robot before it tries to recharge or nil.


max_to_charge :: float [Read]

The maximum energy for this flying robot above which it won't try to recharge when stationing or nil.


burner_prototype :: LuaBurnerPrototype [Read]

The burner energy source prototype this entity uses or nil.


electric_energy_source_prototype :: LuaElectricEnergySourcePrototype [Read]

The electric energy source prototype this entity uses or nil.


heat_energy_source_prototype :: LuaHeatEnergySourcePrototype [Read]

The heat energy source prototype this entity uses or nil.


fluid_energy_source_prototype :: LuaFluidEnergySourcePrototype [Read]

The fluid energy source prototype this entity uses or nil.


void_energy_source_prototype :: LuaVoidEnergySourcePrototype [Read]

The void energy source prototype this entity uses or nil.


building_grid_bit_shift :: uint [Read]

The log2 of grid size of the building


fluid_usage_per_tick :: double [Read]

The fluid usage of this generator prototype or nil.


maximum_temperature :: double [Read]

The maximum fluid temperature of this generator prototype or nil.


target_temperature :: double [Read]

The target temperature of this boiler prototype or nil.


fluid :: LuaFluidPrototype [Read]

The fluid this offshore pump produces or nil.


fluid_capacity :: double [Read]

The fluid capacity of this entity or 0 if this entity doesn't support fluids.

Note

Crafting machines will report 0 due to their fluid capacity being what ever a given recipe needs.


pumping_speed :: double [Read]

The pumping speed of this offshore pump, normal pump, or nil.


stack :: boolean [Read]

If this inserter is a stack-type.


allow_custom_vectors :: boolean [Read]

If this inserter allows custom pickup and drop vectors.


allow_burner_leech :: boolean [Read]

If this inserter allows burner leeching.


inserter_extension_speed :: double [Read]

The extension speed of this inserter or nil.


inserter_rotation_speed :: double [Read]

The rotation speed of this inserter or nil.


inserter_pickup_position :: Vector [Read]

The pickup position for this inserter or nil.


inserter_drop_position :: Vector [Read]

The drop position for this inserter or nil.


inserter_chases_belt_items :: boolean [Read]

True if this inserter chases items on belts for pickup or nil.


count_as_rock_for_filtered_deconstruction :: boolean [Read]

If this simple-entity is counted as a rock for the deconstruction planner "trees and rocks only" filter.


filter_count :: uint [Read]

The filter count of this inserter, loader, or logistic chest or nil. For logistic containers, nil means no limit.


time_to_live :: uint [Read]

The time to live for this prototype or 0 if prototype doesn't have time_to_live or time_before_removed.


distribution_effectivity :: double [Read]

The distribution effectivity for this beacon prototype or nil if not a beacon prototype.


explosion_beam :: double [Read]

Does this explosion have a beam or nil if not an explosion prototype.


explosion_rotate :: double [Read]

Does this explosion rotate or nil if not an explosion prototype.


tree_color_count :: uint8 [Read]

If it is a tree, return the number of colors it supports. nil otherwise.


alert_when_damaged :: boolean [Read]

Does this entity with health prototype alert when damaged? or nil if not entity with health prototype.


alert_when_attacking :: boolean [Read]

Does this turret prototype alert when attacking? or nil if not turret prototype.


color :: Color [Read]

The color of the prototype, or nil if the prototype doesn't have color.


collision_mask_collides_with_self :: boolean [Read]

Does this prototype collision mask collide with itself?


collision_mask_collides_with_tiles_only :: boolean [Read]

Does this prototype collision mask collide with tiles only?


collision_mask_considers_tile_transitions :: boolean [Read]

Does this prototype collision mask consider tile transitions?


allowed_effects :: dictionary[stringboolean] [Read]

The allowed module effects for this entity or nil.


rocket_parts_required :: uint [Read]

The rocket parts required for this rocket silo prototype or nil.


rocket_rising_delay :: uint8 [Read]

The rocket rising delay for this rocket silo prototype or nil.


launch_wait_time :: uint8 [Read]

The rocket launch delay for this rocket silo prototype or nil.


light_blinking_speed :: double [Read]

The light blinking speed for this rocket silo prototype or nil.


door_opening_speed :: double [Read]

The door opening speed for this rocket silo prototype or nil.


rising_speed :: double [Read]

The rising speed for this rocket silo rocket prototype or nil.


engine_starting_speed :: double [Read]

The engine starting speed for this rocket silo rocket prototype or nil.


flying_speed :: double [Read]

The flying speed for this rocket silo rocket prototype or nil.


flying_acceleration :: double [Read]

The flying acceleration for this rocket silo rocket prototype or nil.


fixed_recipe :: string [Read]

The fixed recipe name for this assembling machine prototype or nil.


construction_radius :: double [Read]

The construction radius for this roboport prototype or nil.


logistic_radius :: double [Read]

The logistic radius for this roboport prototype or nil.


energy_per_hit_point :: double [Read]

The energy used per hitpoint taken for this vehicle during collisions or nil.


create_ghost_on_death :: boolean [Read]

If this prototype will attempt to create a ghost of itself on death.

Note

If this is false then a ghost will never be made, if it's true a ghost may be made.


timeout :: uint [Read]

The time it takes this land mine to arm.


trigger_collision_mask :: CollisionMask [Read]

Collision mask entity must collide with to make landmine blowup


fluidbox_prototypes :: array[LuaFluidBoxPrototype] [Read]

The fluidbox prototypes for this entity.


neighbour_bonus :: double [Read]


container_distance :: double [Read]


belt_distance :: double [Read]


belt_length :: double [Read]


is_building :: boolean [Read]


automated_ammo_count :: uint [Read]

The amount of ammo that inserters automatically insert into this ammo-turret or artillery-turret or nil.


max_speed :: double [Read]

The max speed of this projectile prototype or flying robot prototype or nil.


darkness_for_all_lamps_on :: float [Read]

Value between 0 and 1 darkness where all lamps of this lamp prototype are on or nil.


darkness_for_all_lamps_off :: float [Read]

Value between 0 and 1 darkness where all lamps of this lamp prototype are off or nil.


always_on :: boolean [Read]

Whether the lamp is always on (except when out of power or turned off by the circuit network) or nil.


min_darkness_to_spawn :: float [Read]

The minimum darkness at which this unit spawner can spawn entities.


max_darkness_to_spawn :: float [Read]

The maximum darkness at which this unit spawner can spawn entities.


call_for_help_radius :: double [Read]


max_count_of_owned_units :: double [Read]

Count of enemies this spawner can sustain.


max_friends_around_to_spawn :: double [Read]

How many friendly units are required within the spawning_radius of this spawner for it to stop producing more units.


spawning_radius :: double [Read]

How far from the spawner can the units be spawned.


spawning_spacing :: double [Read]

What spaces should be between the spawned units.


radius :: double [Read]

The radius of this entity prototype.


cliff_explosive_prototype :: string [Read]

The item prototype name used to destroy this cliff or nil.


rocket_entity_prototype :: LuaEntityPrototype [Read]

The rocket entity prototype associated with this rocket silo prototype or nil.


has_belt_immunity :: boolean [Read]

Whether this unit, car, or character prototype has belt immunity, nil if not car, unit, or character prototype.


vision_distance :: double [Read]

The vision distance of this unit prototype or nil.


pollution_to_join_attack :: float [Read]

The amount of pollution that has to be absorbed by the unit's spawner before the unit will leave the spawner and attack the source of the pollution. nil when prototype is not a unit prototype.


min_pursue_time :: uint [Read]

The minimum pursue time of this unit prototype or nil.


max_pursue_distance :: double [Read]

The maximum pursue distance of this unit prototype or nil.


radar_range :: uint [Read]

The radar range of this unit prototype or nil.


move_while_shooting :: boolean [Read]

Whether this unit prototype can move while shooting or nil.


can_open_gates :: boolean [Read]

Whether this unit prototype can open gates or nil.


affected_by_tiles :: boolean [Read]

Whether this unit prototype is affected by tile walking speed modifiers or nil.


distraction_cooldown :: uint [Read]

The distraction cooldown of this unit prototype or nil.


spawning_time_modifier :: double [Read]

The spawning time modifier of this unit prototype or nil.


alert_icon_shift :: Vector [Read]

The alert icon shift of this entity prototype.


lab_inputs :: array[string] [Read]

The item prototype names that are the inputs of this lab prototype or nil.


researching_speed :: double [Read]

The base researching speed of this lab prototype or nil.


item_slot_count :: uint [Read]

The item slot count of this constant combinator prototype or nil.


base_productivity :: double [Read]

The base productivity of this crafting machine, lab, or mining drill, or nil.


allow_access_to_all_forces :: boolean [Read]

If this market allows access to all forces or just friendly ones.


supports_direction :: boolean [Read]

If this entity prototype could possibly ever be rotated.


terrain_friction_modifier :: float [Read]

The terrain friction modifier for this vehicle.


allow_passengers :: boolean [Read]

If this vehicle allows passengers.


max_distance_of_sector_revealed :: uint [Read]

The radius of the area this radar can chart, in chunks.


max_distance_of_nearby_sector_revealed :: uint [Read]

The radius of the area constantly revealed by this radar, in chunks.


adjacent_tile_collision_box :: BoundingBox [Read]

The bounding box that specifies which tiles adjacent to the offshore pump should be checked.


adjacent_tile_collision_mask :: CollisionMask [Read]

Tiles adjacent to the offshore pump must not collide with this collision mask.


adjacent_tile_collision_test :: CollisionMask [Read]

If this mask is not empty, tiles adjacent to the offshore pump must not collide with this collision mask.


center_collision_mask :: CollisionMask [Read]

The collision mask used only for collision test with tile directly at offshore pump position.


grid_prototype :: LuaEquipmentGridPrototype [Read]

The equipment grid prototype for this entity or nil.


remove_decoratives :: string [Read]


related_underground_belt :: LuaEntityPrototype [Read]


inserter_stack_size_bonus :: double [Read]

Gets the built-in stack size bonus of this inserter prototype. nil if this is not an inserter.


protected_from_tile_building :: boolean [Read]

True if this entity prototype should be included during tile collision checks with LuaTilePrototype::check_collision_with_entities enabled.


is_entity_with_owner :: boolean [Read]

True if this is entity-with-owner


is_military_target :: boolean [Read]

True if this entity-with-owner is military target


allow_run_time_change_of_is_military_target :: boolean [Read]

True if this entity-with-owner's is_military_target can be changed run-time (on the entity, not on the prototype itself)


running_speed :: double [Read]

Gets the current movement speed of this character, including effects from exoskeletons, tiles, stickers and shooting.


maximum_corner_sliding_distance :: double [Read]


build_distance :: uint [Read]


drop_item_distance :: uint [Read]


reach_distance :: uint [Read]


reach_resource_distance :: double [Read]


item_pickup_distance :: double [Read]


loot_pickup_distance :: double [Read]


enter_vehicle_distance :: double [Read]


ticks_to_keep_gun :: uint [Read]


ticks_to_keep_aiming_direction :: uint [Read]


ticks_to_stay_in_combat :: uint [Read]


respawn_time :: uint [Read]


damage_hit_tint :: Color [Read]


character_corpse :: LuaEntityPrototype [Read]


valid :: boolean [Read]

Is this object valid? This Lua object holds a reference to an object within the game engine. It is possible that the game-engine object is removed whilst a mod still holds the corresponding Lua object. If that happens, the object becomes invalid, i.e. this attribute will be false. Mods are advised to check for object validity if any change to the game state might have occurred between the creation of the Lua object and its access.


object_name :: string [Read]

The class name of this object. Available even when valid is false. For LuaStruct objects it may also be suffixed with a dotted path to a member of the struct.

|<

Classes

Events

Concepts

Defines

Builtin types

>|