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

# Factorio Runtime Docs Version 2.0.77

# BlueprintEntity - Runtime Docs

## BlueprintEntity :: table

The representation of an entity inside of a blueprint.

#### Table fields

entity_number | :: uint32 | The entity's unique identifier in the blueprint.
The entity's unique identifier in the blueprint.
name | :: string | The prototype name of the entity.
The prototype name of the entity.
position | :: MapPosition | The position of the entity.
The position of the entity.
direction | :: defines.direction? | The direction the entity is facing. Only present for entities that can face in different directions and when the entity is not facing north.
The direction the entity is facing. Only present for entities that can face in different directions and when the entity is not facing north.
mirror | :: boolean? | Whether this entity is mirrored.
Whether this entity is mirrored.
quality | :: string? | The prototype name of the entity's quality.
The prototype name of the entity's quality.
items | :: array[BlueprintInsertPlan]? | The items that the entity will request when revived, if any.
The items that the entity will request when revived, if any.
tags | :: Tags? | The entity tags of the entity, if there are any.
The entity tags of the entity, if there are any.
wires | :: array[BlueprintWire]? | Wires connected to this entity in the blueprint.
Wires connected to this entity in the blueprint.
burner_fuel_inventory | :: BlueprintInventoryWithFilters? | Used by entities with a burner energy source.
Used by entities with a burner energy source.

Other attributes may be specified depending on the type of entity:

#### `accumulator`

control_behavior | :: AccumulatorBlueprintControlBehavior? |

#### `agricultural-tower`

control_behavior | :: AgriculturalTowerBlueprintControlBehavior? |

#### `ammo-turret`

priority-list | :: array[SlotFilter]? |
ignore-unprioritised | :: boolean? | Defaults to `false`.
Defaults to `false`.
control_behavior | :: TurretBlueprintControlBehavior? |

#### `arithmetic-combinator`

player_description | :: string? |
control_behavior | :: ArithmeticCombinatorBlueprintControlBehavior? |

#### `artillery-turret`

artillery_auto_targeting | :: boolean? | Defaults to `true`.
Defaults to `true`.
control_behavior | :: ArtilleryTurretBlueprintControlBehavior? |

#### `artillery-wagon`

stock_connections | :: BlueprintRollingStockConnection? |
artillery_auto_targeting | :: boolean? | Defaults to `true`.
Defaults to `true`.
color | :: Color? |
enable_logistics_while_moving | :: boolean |
grid | :: array[BlueprintEquipment]? |
orientation | :: RealOrientation |
copy_color_from_train_stop | :: boolean |

#### `assembling-machine`

recipe | :: string? |
recipe_quality | :: string? |
control_behavior | :: AssemblingMachineBlueprintControlBehavior? |

#### `asteroid-collector`

result-inventory | :: BlueprintInventory |
chunk-filter | :: array[SlotFilter]? |
control_behavior | :: AsteroidCollectorBlueprintControlBehavior? |

#### `car`

request_filters | :: BlueprintLogisticSections |
enable_logistics_while_moving | :: boolean |
grid | :: array[BlueprintEquipment]? |
trunk_inventory | :: BlueprintInventoryWithFilters |
ammo_inventory | :: BlueprintInventoryWithFilters |
driver_is_main_gunner | :: boolean |
selected_gun_index | :: ItemStackIndex |
orientation | :: RealOrientation |

#### `cargo-landing-pad`

bar | :: uint32? |
request_filters | :: BlueprintLogisticSections |
control_behavior | :: CargoLandingPadBlueprintControlBehavior? |

#### `cargo-wagon`

stock_connections | :: BlueprintRollingStockConnection? |
color | :: Color? |
enable_logistics_while_moving | :: boolean |
grid | :: array[BlueprintEquipment]? |
orientation | :: RealOrientation |
copy_color_from_train_stop | :: boolean |
inventory | :: BlueprintInventoryWithFilters |

#### `constant-combinator`

player_description | :: string? |
control_behavior | :: ConstantCombinatorBlueprintControlBehavior? |

#### `container`

filters | :: array[BlueprintItemFilter]? |
bar | :: uint32? |
control_behavior | :: ContainerBlueprintControlBehavior? |

#### `decider-combinator`

player_description | :: string? |
control_behavior | :: DeciderCombinatorBlueprintControlBehavior? |

#### `display-panel`

text | :: string? |
icon | :: SignalID? |
always_show | :: boolean? | Defaults to `false`.
Defaults to `false`.
show_in_chart | :: boolean? | Defaults to `false`.
Defaults to `false`.
control_behavior | :: DisplayPanelBlueprintControlBehavior? |

#### `electric-energy-interface`

power_production | :: double? |
power_usage | :: double? |
buffer_size | :: double |

#### `electric-turret`

priority-list | :: array[SlotFilter]? |
ignore-unprioritised | :: boolean? | Defaults to `false`.
Defaults to `false`.
control_behavior | :: TurretBlueprintControlBehavior? |

#### `fluid-turret`

priority-list | :: array[SlotFilter]? |
ignore-unprioritised | :: boolean? | Defaults to `false`.
Defaults to `false`.
control_behavior | :: TurretBlueprintControlBehavior? |

#### `fluid-wagon`

stock_connections | :: BlueprintRollingStockConnection? |
color | :: Color? |
enable_logistics_while_moving | :: boolean |
grid | :: array[BlueprintEquipment]? |
orientation | :: RealOrientation |
copy_color_from_train_stop | :: boolean |

#### `furnace`

control_behavior | :: FurnaceBlueprintControlBehavior? |

#### `heat-interface`

temperature | :: double? |
mode | :: HeatSettingMode? |

#### `infinity-cargo-wagon`

stock_connections | :: BlueprintRollingStockConnection? |
color | :: Color? |
enable_logistics_while_moving | :: boolean |
grid | :: array[BlueprintEquipment]? |
orientation | :: RealOrientation |
copy_color_from_train_stop | :: boolean |
inventory | :: BlueprintInventoryWithFilters |
infinity_settings | :: BlueprintInfinityInventorySettings |

#### `infinity-container`

filters | :: array[BlueprintItemFilter]? |
bar | :: uint32? |
request_filters | :: BlueprintLogisticSections |
infinity_settings | :: BlueprintInfinityInventorySettings |
control_behavior | :: LogisticContainerBlueprintControlBehavior? |

#### `infinity-pipe`

infinity_settings | :: InfinityPipeFilter |

#### `inserter`

filters | :: array[BlueprintItemFilter]? |
filter_mode | :: `"whitelist"` or `"blacklist"`? | Defaults to `"whitelist"`.
Defaults to `"whitelist"`.
use_filters | :: boolean? | Defaults to `false`.
Defaults to `false`.
override_stack_size | :: uint8? |
spoil_priority | :: BlueprintSpoilPriority? |
drop_position | :: Vector? | Present if position is non-default.
Present if position is non-default.
pickup_position | :: Vector? | Present if position is non-default.
Present if position is non-default.
control_behavior | :: InserterBlueprintControlBehavior? |

#### `lamp`

color | :: Color? |
always_on | :: boolean? | Defaults to `false`.
Defaults to `false`.
control_behavior | :: LampBlueprintControlBehavior? |

#### `lane-splitter`

filter | :: ItemFilter? |
input_priority | :: SplitterPriority? |
output_priority | :: SplitterPriority? |

#### `linked-belt`

type | :: BeltConnectionType |
belt_link | :: uint32? |

#### `linked-container`

link_id | :: uint32 |

#### `loader`

filters | :: array[BlueprintItemFilter]? |
filter_mode | :: PrototypeFilterMode? | Defaults to `"none"`.
Defaults to `"none"`.
type | :: BeltConnectionType |
belt_stack_size_override | :: uint8? |
control_behavior | :: LoaderBlueprintControlBehavior? |

#### `loader-1x1`

filters | :: array[BlueprintItemFilter]? |
filter_mode | :: PrototypeFilterMode? | Defaults to `"none"`.
Defaults to `"none"`.
type | :: BeltConnectionType |
belt_stack_size_override | :: uint8? |
control_behavior | :: LoaderBlueprintControlBehavior? |

#### `locomotive`

stock_connections | :: BlueprintRollingStockConnection? |
schedule | :: BlueprintSchedule? |
color | :: Color? |
enable_logistics_while_moving | :: boolean |
grid | :: array[BlueprintEquipment]? |
orientation | :: RealOrientation |
copy_color_from_train_stop | :: boolean |

#### `logistic-container`

filters | :: array[BlueprintItemFilter]? |
bar | :: uint32? |
request_filters | :: BlueprintLogisticSections |
control_behavior | :: LogisticContainerBlueprintControlBehavior? |

#### `mining-drill`

filter | :: BlueprintMiningDrillFilter? |
control_behavior | :: MiningDrillBlueprintControlBehavior? |

#### `power-switch`

switch_state | :: boolean? |
control_behavior | :: PowerSwitchBlueprintControlBehavior? |

#### `programmable-speaker`

parameters | :: ProgrammableSpeakerParameters |
alert_parameters | :: ProgrammableSpeakerAlertParameters |
control_behavior | :: ProgrammableSpeakerBlueprintControlBehavior? |

#### `proxy-container`

control_behavior | :: ProxyContainerBlueprintControlBehavior? |

#### `pump`

fluid_filter | :: string? |
control_behavior | :: PumpBlueprintControlBehavior? |

#### `rail-chain-signal`

rail_layer | :: `"ground"` or `"elevated"`? | Defaults to `"ground"`.
Defaults to `"ground"`.
control_behavior | :: RailSignalBaseBlueprintControlBehavior? |

#### `rail-signal`

rail_layer | :: `"ground"` or `"elevated"`? | Defaults to `"ground"`.
Defaults to `"ground"`.
control_behavior | :: RailSignalBaseBlueprintControlBehavior? |

#### `reactor`

control_behavior | :: ReactorBlueprintControlBehavior? |

#### `roboport`

request_filters | :: BlueprintLogisticSections |
control_behavior | :: RoboportBlueprintControlBehavior? |

#### `rocket-silo`

recipe | :: string? |
recipe_quality | :: string? |
use_transitional_requests | :: boolean? |
launch_to_orbit_automatically | :: boolean? |
control_behavior | :: RocketSiloBlueprintControlBehavior? |

#### `selector-combinator`

player_description | :: string? |
control_behavior | :: SelectorCombinatorParameters? |

#### `space-platform-hub`

bar | :: uint32? |
request_filters | :: BlueprintLogisticSections |
request_missing_construction_materials | :: boolean |
control_behavior | :: SpacePlatformHubBlueprintControlBehavior? |

#### `splitter`

filter | :: ItemFilter? |
input_priority | :: SplitterPriority? |
output_priority | :: SplitterPriority? |
control_behavior | :: SplitterBlueprintControlBehavior? |

#### `spider-vehicle`

request_filters | :: BlueprintLogisticSections |
enable_logistics_while_moving | :: boolean |
grid | :: array[BlueprintEquipment]? |
trunk_inventory | :: BlueprintInventoryWithFilters |
ammo_inventory | :: BlueprintInventoryWithFilters |
driver_is_main_gunner | :: boolean |
automatic_targeting_parameters | :: VehicleAutomaticTargetingParameters |
selected_gun_index | :: ItemStackIndex |
color | :: Color? |
label | :: string? |

#### `storage-tank`

control_behavior | :: StorageTankBlueprintControlBehavior? |

#### `train-stop`

station | :: string |
color | :: Color? |
manual_trains_limit | :: uint32? |
priority | :: uint8? |
control_behavior | :: TrainStopBlueprintControlBehavior? |

#### `transport-belt`

control_behavior | :: TransportBeltBlueprintControlBehavior? |

#### `turret`

priority-list | :: array[SlotFilter]? |
ignore-unprioritised | :: boolean? | Defaults to `false`.
Defaults to `false`.
control_behavior | :: TurretBlueprintControlBehavior? |

#### `underground-belt`

type | :: BeltConnectionType |

#### `valve`

valve_threshold_override | :: float? |

#### `wall`

control_behavior | :: WallBlueprintControlBehavior? |

Concept used in

- LuaItemCommon::get_blueprint_entities()
- LuaItemCommon::set_blueprint_entities()
- LuaRecord::get_blueprint_entities()
- LuaRecord::set_blueprint_entities()
- BlueprintWireEnd
- UndoRedoAction