Prototype/Inserter

From Official Factorio Wiki
Jump to navigation Jump to search

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/InserterPrototype.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/EntityWithHealth » Prototype/EntityWithOwner » Prototype/Inserter


An inserter.


Prototype/Inserter — inserter
energy_source::EnergySource
extension_speed::double
hand_base_picture::Sprite
hand_base_shadow::Sprite
hand_closed_picture::Sprite
hand_closed_shadow::Sprite
hand_open_picture::Sprite
hand_open_shadow::Sprite
insert_position::vector
pickup_position::vector
platform_picture::Sprite4Way
rotation_speed::double
allow_burner_leech::bool (optional)
allow_custom_vectors::bool (optional)
chases_belt_items::bool (optional)
circuit_connector_sprites::table of CircuitConnectorSprites (optional)
circuit_wire_connection_points::table of WireConnectionPoint (optional)
circuit_wire_max_distance::double (optional)
default_stack_control_input_signal::SignalIDConnector (optional)
draw_circuit_wires::bool (optional)
draw_copper_wires::bool (optional)
draw_held_item::bool (optional)
draw_inserter_arrow::bool (optional)
energy_per_movement::Energy (optional)
energy_per_rotation::Energy (optional)
filter_count::uint8 (optional)
hand_size::double (optional)
stack::bool (optional)
stack_size_bonus::uint8 (optional)
use_easter_egg::bool (optional)
Inherited from Prototype/EntityWithOwner
allow_run_time_change_of_is_military_target::bool (optional)
is_military_target::bool (optional)
Inherited from Prototype/EntityWithHealth
alert_when_damaged::bool (optional)
attack_reaction::AttackReaction (optional)
corpse::string or table of strings (optional)
create_ghost_on_death::bool (optional)
damaged_trigger_effect::TriggerEffect (optional)
dying_explosion::ExplosionDefinition or table of ExplosionDefinition (optional)
dying_trigger_effect::TriggerEffect (optional)
healing_per_tick::float (optional)
hide_resistances::bool (optional)
integration_patch::Sprite4Way (optional)
integration_patch_render_layer::RenderLayer (optional)
loot::Loot (optional)
max_health::float (optional)
random_corpse_variation::bool (optional)
repair_sound::Sound (optional)
repair_speed_modifier::float (optional)
resistances::Resistances (optional)
Inherited from Prototype/Entity
icons, icon, icon_size (IconSpecification)::IconSpecification
additional_pastable_entities::table of string (optional)
alert_icon_scale::float (optional)
alert_icon_shift::vector (optional)
allow_copy_paste::bool (optional)
autoplace::AutoplaceSpecification (optional)
build_base_evolution_requirement::double (optional)
build_grid_size::uint8 (optional)
build_sound::Sound (optional)
close_sound::Sound (optional)
collision_box::BoundingBox (optional)
collision_mask::CollisionMask (optional)
created_effect::Trigger (optional)
created_smoke::CreateTrivialSmokeEffectItem (optional)
drawing_box::BoundingBox (optional)
emissions_per_second::double (optional)
enemy_map_color::Color (optional)
fast_replaceable_group::string (optional)
flags::EntityPrototypeFlags (optional)
friendly_map_color::Color (optional)
hit_visualization_box::BoundingBox (optional)
map_color::Color (optional)
map_generator_bounding_box::BoundingBox (optional)
minable::MinableProperties (optional)
mined_sound::Sound (optional)
mining_sound::Sound (optional)
next_upgrade::string (optional)
open_sound::Sound (optional)
placeable_by::ItemToPlace or table of ItemToPlace (optional)
protected_from_tile_building::bool (optional)
radius_visualisation_specification::RadiusVisualisationSpecification (optional)
remains_when_mined::string or table of string (optional)
remove_decoratives::string (optional)
rotated_sound::Sound (optional)
selectable_in_game::bool (optional)
selection_box::BoundingBox (optional)
selection_priority::uint8 (optional)
shooting_cursor_size::double (optional)
sticker_box::BoundingBox (optional)
subgroup::string (optional)
tile_height::uint32 (optional)
tile_width::uint32 (optional)
trigger_target_mask::TriggerTargetMask (optional)
vehicle_impact_sound::Sound (optional)
water_reflection::WaterReflectionDefinition (optional)
working_sound::WorkingSound (optional)
Inherited from PrototypeBase
name::string
type::string
localised_description::LocalisedString (optional)
localised_name::LocalisedString (optional)
order::Order (optional)

Mandatory properties

This prototype inherits all the properties from Prototype/EntityWithOwner.

extension_speed

Type: double

rotation_speed

Type: double

insert_position

Type: vector

pickup_position

Type: vector

platform_picture

Type: Sprite4Way

hand_base_picture

Type: Sprite

hand_open_picture

Type: Sprite

hand_closed_picture

Type: Sprite

energy_source

Type: EnergySource
Defines how this inserter gets energy. The emissions set on the energy source are ignored so inserters cannot produce pollution.

Optional properties

energy_per_movement

Type: Energy
Default: 0

energy_per_rotation

Type: Energy
Default: 0

stack

Type: bool
Default: false
Whether this inserter is considered a stack inserter. Relevant for determining how Inserter capacity bonus (research) applies to the inserter.

allow_custom_vectors

Type: bool
Default: false
Whether pickup and insert position can be set run-time.

allow_burner_leech

Type: bool
Default: false
Whether this burner inserter can fuel itself from the fuel inventory of the entity it is picking up items from.

draw_held_item

Type: bool
Default: true
Whether the item that the inserter is holding should be drawn.

use_easter_egg

Type: bool
Default: true
Whether the inserter should be able to fish fish.

filter_count

Type: uint8
Default: 0
How many filters this inserter has. Maximum count of filtered items in inserter is 5.

hand_base_shadow

Type: Sprite

hand_open_shadow

Type: Sprite

hand_closed_shadow

Type: Sprite

hand_size

Type: double
Default: 0.75
Used to determine how long the arm of the inserter is when drawing it. Does not affect gameplay. The lower the value, the straighter the arm. Increasing the value will give the inserter a bigger bend due to its longer parts.

circuit_wire_max_distance

Type: double
Default: 0
The maximum circuit wire distance for this entity.

draw_copper_wires

Type: bool
Default: true

draw_circuit_wires

Type: bool
Default: true

default_stack_control_input_signal

Type: SignalIDConnector

draw_inserter_arrow

Type: bool
Default: true
Whether the yellow arrow that indicates the drop point of the inserter and the line that indicates the pickup position should be drawn.

chases_belt_items

Type: bool
Default: true
Whether the inserter hand should move to the items it picks up from belts, leading to item chasing behaviour. If this is off, the inserter hand will stay in the center of the belt and any items picked up from the edges of the belt "teleport" to the inserter hand.

stack_size_bonus

Type: uint8
Default: 0
Stack size bonus that is inherent to the prototype without having to be researched.

circuit_wire_connection_points

Type: table of WireConnectionPoint

circuit_connector_sprites

Type: table of CircuitConnectorSprites