Official Factorio Wiki - User contributions [en]

Circuit network

2022-05-06T22:41:24Z

Ignatio: /* Virtual signals */ Clarified corner cases when `everything`, `anything`, and `each` are matched against signals.

{{Languages}}
'''Circuit networks''' are built using [[Red wire|red]] or [[green wire]], and enable the control of receivers, based upon information broadcast onto the network by connected senders. Most senders are storage devices, and broadcast their information onto a specific channel, based on the item or liquid the storage device contains. Each circuit network contains a channel for every kind of item, as well as 48 extra [[#Virtual signals|virtual signals]] which act as user-definable channels. 'Everything', 'Anything' and 'Each' are also available wildcards.

[[File:shared_circuit_network.png|thumb|600px|right|Two circuit networks shared over one [[small electric pole]].]]

== Usage ==
=== Send information ===
Senders broadcast the amount of items or fluids they contain or other data definable by the player. Each amount is broadcast as a numeric value on a 'channel' corresponding to the item. For example, a Storage Tank containing 1000 Crude Oil will broadcast 1000 on the Crude Oil channel.

The channels are separated from each other, so each network can simultaneously carry a number for each item and fluid in the game, and for each of the extra user-defined channels (digits 0-9, letters A-Z, and 9 different colors). All unused channels have the value zero.

Multiple broadcasts of the same item or fluid are additive: If there are two connected Storage Tanks with 1000 Crude Oil each, the value of the Crude Oil channel within the network will be 2000.

All wires of the same color which are connected together by junctions form a network, i.e. they will pass their signals to each other. For example, if two red wires are connected to the same combinator input, each wire receives the content from the other. This can result in feedback if care is not taken; see Feedback (under [[#Combinators|arithmetic combinator]], below) for discussion.

Numbers are in the signed 32 bit integer range, i.e. from -2147483648 to 2147483647 inclusive, and are encoded in [https://en.wikipedia.org/wiki/Two%27s_complement two's complement representation]. The numbers wrap around on overflow, so e.g. 2147483647 + 10 becomes -2147483639. When entering a number in a combinator it can appear to exceed the 32 bit limit until the GUI is closed, at which point the number will overflow/underflow. [https://forums.factorio.com/58419]

=== Control devices ===
Receivers can use broadcast information, in most cases to enable/disable the device. They can either compare results between different channels, or compare a channel to a specific value.

Receiving devices sum all signals from each wire connected to them, even red and green wires. For example, if an inserter is connected to a red wire carrying a signal for 20 copper plates and a green wire with 10 copper plates, the input signal set for that receiver will be 30 copper plates.

Multiple wires of the same color will share & sum their signals. For example, 3 chests A, B and C connected in a row (A -> B -> C) with green wire will output the sum of their contents along any green wire connected to any of the chests. However, if a red wire connects chest A to an inserter, that inserter will only be given the contents of A as its input signal.

== Devices ==

Each device that is able to be connected to a circuit network has a [[File:Circuit network panel.png]] icon located in the top right corner of its info pane. Clicking this icon will display the available circuit network options for that device (note: a red or green wire must be connected, otherwise the message "not connected" will display instead). Clicking the [[File:Logistic network panel.png]] icon next to it, the device can be connected to a logistic network if in range of one, which also allows conditions to be set.

Conditions can be set for both circuit (signals of red and green wires are summed) and logistic network, which will together act as a logical AND.

The following devices can be connected to a circuit network:

{| class="wikitable mw-collapsible"
|-
! Icon !! Name !! Possible output signals !! Possible circuit control !! Possible logistic network control
|-
| {{Icon|Transport belt||Transport belts}} || [[Transport belts]] || Transport belts can send their content to the circuit network.
*''Pulse mode'': The signal is sent for only 1 tick when the item enters the belt.
*''Hold mode'': The signal is sent continuously as long as the items are on the belt.
|| Transport belts can be enabled on a condition.
|| Transport belts can be enabled on a logistic network condition.
|-
| {{Icon|Inserter||Inserters}} || [[Inserters]] || All inserters can send their held items to the circuit network.
*''Pulse mode'': The signal is sent for only 1 tick when the item is picked up.
*''Hold mode'': The signal is sent continuously as long as the inserter is holding the item.
|| All inserters can be enabled on a condition. The inserter stack size can also be overridden from a control signal (configurable).
|| All inserters can be enabled on a logistic network condition.
|-
| {{Icon|Filter inserter}} || [[Filter inserter]] || Same as above. || The filter inserters can additionally set their filters from the circuit network: up to 5 items whose corresponding signal has a positive value are whitelisted. || Same as above.
|-
| {{Icon|Wooden chest||Chests}} || [[Chests]] || All chests can send their contents to the circuit network. Logistic chests automatically send their contents to the [[logistic network]]. ||
|-
| {{Icon|Requester chest}} || [[Requester chest]] || Can send its contents to the circuit network. Does ''not'' send its content to the [[logistic network]]. || Its requested items can be set by the circuit network. ||
|-
| {{Icon|Storage tank}} || [[Storage tank]] || The storage tank can send its fluid content to the circuit network. ||
|-
| {{Icon|Gate}} || [[Gate]] || Gates can send a signal to the circuit network.
*''Default'': Player detected = [[File:Signal-G.png|16px]]
|| Gates can be opened on a condition. ||
|-
| {{Icon|Rail signal}} || [[Rail signal]] || Rail signals can send their state to the circuit network.
*''Default'': [[File:Signal-Red.png|16px]][[File:Signal-Yellow.png|16px]][[File:Signal-Green.png|16px]]
Note: If red due to circuit network, does NOT output red signal
|| Rail signals can be set to red on a condition. ||
|-
| {{Icon|Rail chain signal}} || [[Rail chain signal]] || Rail chain signals can send their state to the circuit network.
*''Default'': [[File:Signal-Red.png|16px]][[File:Signal-Yellow.png|16px]][[File:Signal-Green.png|16px]][[File:Signal-Blue.png|16px]]
||
|-
| {{Icon|Train stop}} || [[Train stop]] || Train stops can send the contents of a stopped train to the circuit network as well as read a unique train identifier code. The amount of trains going to the train stop can be read by the circuit network. When reading the content of a stopped train, fluid amounts are rounded down to the nearest integer, except when the fluid amount is < 1, then it is is rounded to 1.
*''Default'': Train Count (en route) = [[File:Signal-C.png|16px]]
*''Default'': Stopped Train ID = [[File:Signal-T.png|16px]]
|| Train stops can send the contents of the circuit network to the train to use it for wait conditions, as well as enable/disable the stop itself. The maximum amount of trains that can go to the train stop ("train limit") can be set by the circuit network.
*''Default'': Set Limit = [[File:Signal-L.png|16px]]
|| Train stops can be enabled on a logistic network condition.
|-
| {{Icon|Accumulator}} || [[Accumulator]] || It can send its charge level in percent to the circuit network.
*''Default'': Charge % = [[File:Signal-A.png|16px]]
||
||
|-
| {{Icon|Roboport}} || [[Roboport]] || It can send its logistic network contents and/or its robot statistics to the circuit network. The signals used for robot statistics are configurable.
*''Default'': Available Logistics Bots = [[File:Signal-X.png|16px]]
*''Default'': Total Logistics Bots = [[File:Signal-Y.png|16px]]
*''Default'': Available Construction Bots = [[File:Signal-Z.png|16px]]
*''Default'': Total Construction Bots = [[File:Signal-T.png|16px]]
||
|-
| {{Icon|Burner mining drill}} || [[Mining drill]]s || All mining drills can send the expected resources, either from the drill itself or from the whole ore patch the drill is on. || Mining drills can be enabled on a condition. || Mining drills can be enabled on a logistic network condition.
|-
| {{Icon|Pumpjack}} || [[Pumpjack]] || It can output the current oil mining rate. || It can be enabled on a condition. || It can be enabled on a logistic network condition.
|-
| {{Icon|Power switch}} || [[Power switch]] || || Power switches can connect power networks on a condition. || It can be enabled on a logistic network condition.
|-
| {{Icon|Programmable speaker}} || [[Programmable speaker]] || || Shows alerts and plays sounds based on circuit network signals. It can be used to make simple tunes.
|-
| {{Icon|Lamp}} || [[Lamp]] || || The lamp can be enabled on a condition. If it receives color signals, it can set the given color. || The lamp can be enabled on a logistic network condition.
|-
| {{Icon|Offshore pump}} || [[Offshore pump]] || || The offshore pump can be enabled on a condition. || The offshore pump can be enabled on a logistic network condition.
|-
| {{Icon|Pump}} || [[Pump]] || || The pump can be enabled on a condition. || The pump can be enabled on a logistic network condition.
|}

== Physical network structure ==
A circuit network consists only of those devices connected together with the same color wire. Wire can be strung directly from device to device, or across any intervening power poles. Wire length is limited by its previous connection.

Note that each connected set of wires forms a separate network. For example, it's entirely possible to have four red-wire networks and three green-wire networks. If red and green wires happen to touch the same power pole or device, the red and green networks will remain separate and will not link up. However, two red cables or two green cables will link if they touch. Use different colored cables to separate networks in close proximity.

* To connect wires or cables to a power pole, simply click on one entity, then on the base of the power pole.
* To erase a wire or cable connection, place the same color wire over an existing connection. You don't get the wire/cable back.
* To remove '''all''' connections from a power pole, shift-click on the pole. The first shift-click will remove all electrical connections, and the second will remove all red and green wires. You don't get the wires back.
* When connecting to a [[arithmetic combinator]] or [[decider combinator]], take care to connect the wire to the correct input or output side. Use "Show details" mode to see the orientation of the combinator.
* Hovering the mouse cursor over an item will highlight all wires which connect to the item.
* Hovering the mouse cursor over a power pole which is part of a network will display the signals on its network. Some items like combinators will also display their input and output signals when hovered over.

== Combinators ==
Combinators can function as both receiving and sending devices and allow more advanced functions to be used on a circuit network.

*The [[constant combinator]] broadcasts up to 20 values on any of the channels for whatever networks it is connected to. (You cannot currently specify whether a value should be on the red or green channel; if you need different values, use two combinators, one for each color wire.) You can use any item channel or any of the [[#Virtual signals|virtual signal]] channels.
**Note that using two of the 20 slots to broadcast values on the '''same''' channel is the same as broadcasting the sum of the two values from one slot.
*The [[arithmetic combinator]] performs arithmetic operations on input values and broadcasts the result to the specified output channel. The input and output channels can be any item channel or any of the virtual signal channels.
** Connecting: The arithmetic combinator connects to a red or green network on its '''input''' side (the terminals are set into the main body and look like spark plugs) and performs an arithmetic calculation which is broadcast into the specified channel on its '''output''' side (the output wires appear to stretch out a bit from the body of the device).
** Feedback: Note that the input network and the output network '''are not the same network'''. Connecting the output network back to the input network will result in a feedback loop. For example, adding 1 to the value for copper plates and broadcasting it as copper plates is an action that results in an infinite loop if output is connected back to input. The value for copper plates will rapidly (but not instantly) shoot upward. (The rate at which it climbs is determined by the current tick rate.) This technique can be combined with decider combinator logic to make electronic clocks, gates, and other systems; see [[Tutorial:Combinator tutorial|Combinator Tutorial]] for advanced techniques.
** Each: This combinator can use the 'Each' signal for both input and output, in which case '''all''' non-zero input channels will have the combinator's operation performed and broadcast on the output side. Having Each signals for input and output and using a non-changing operation (like adding zero) is equivalent to having a 'one-way' wire; all the information from the input network is copied to the output network, but the reverse is not true.
**Multi-network: The arithmetic combinator can be joined to both red and green networks on the input side and will sum their inputs.
*The [[decider combinator]] functions much like an arithmetic combinator, but is designed to compare values. Essentially, it is a conditional. In terms of connecting, feedback, and the Each signal it functions as specified above. In addition, it can handle the Everything and Anything signals, and performs more complex functions than summing when attached to multiple networks. See the [[decider combinator]] page for more details on how to use this.

== Virtual signals ==
[[File:Virtual Signals dialog box.png|thumb|Virtual Signals available for use in the circuit network]]
Virtual signals are special non-item signals. Other than the three logic signals, virtual signals do not behave differently from item signals.

48 virtual signals can be sent over a network. They include the digits zero through nine, the letters A through Z, a check-mark, dot and info icon, and the colors red, green, blue, yellow, magenta, cyan, white, gray and black.

=== Logic signals ===
[[File:logic_signals.png|300px|thumb|The icons of the three logic signals]]
Three of the virtual signals cannot be sent over a network but apply special logic to multiple signals.

==== Everything ====
''Everything'' can be used on the left side in conditionals. The condition will be true when the condition is true for each input signal. The condition is also true if there are no signals. This means that the ''everything'' signal behaves as [[:Wikipedia:universal quantification|universal quantification]].

If a signal (rather than a constant number) is used on the right side of the comparison with ''everything'', it is implicitly excluded from the set of signals that ''everything'' checks, so the signal is not matched against itself. That means it is meaningful test e.g. ''everything'' > ''X'', without getting a trivially false result on ''X'' > ''X''.

The output of a [[decider combinator]] may also use ''everything'', unless the input is set to ''each''. When used, the combinator will output signal on every channel with non-zero input as long as the condition is true; the value will either be the input value or 1, depending on the corresponding setting.

==== Anything ====
''Anything'' can be used on the left side of conditions. It will be false when there are no inputs. The condition will be true when the condition is true for at least one signal. This means the ''anything'' signal behaves as [[:Wikipedia:existential quantification|existential quantification]].

If a signal (rather than a constant number) is used on the right side of the comparison with ''anything'', it is implicitly excluded from the set of signals that ''anything'' checks, so the signal is not matched against itself. That means it is meaningful test e.g. ''anything'' >= ''X'', without getting a trivially true result on ''X'' >= ''X''.

When used in both the input and output of a decider combinator, ''anything'' will return one of the signals that matched.

==== Each ====
''Each'' can only be used in left input side and output of [[decider combinator|decider]] and [[arithmetic combinator|arithmetic]] combinators. The signal can only be used as an output when also used as an input. When used in both the input and output, it makes a combinator perform its action on each input signal individually. The combinator will output the sum of each of the actions if only used in the input.

Unlike ''everything'' and ''anything'' above, if a signal is used on the right hand side of an ''each'' operation, it is NOT implicitly excluded. So if you e.g. have ''each'' * ''X'' then you will also get ''X'' multiplied with itself in the output.

== Tutorials ==
*'''[[Tutorial:Circuit network cookbook]]''' - ''Example-heavy tutorials; for beginners who want to get to know and use the benefits of the circuit network.''
*'''[[Tutorial:Combinator tutorial]]''' - ''Mainly textual and detailed tutorials.''

== Logistic network ==
The logistic network used by [[logistic robot]]s is essentially a third network (a wireless one), along with the green and red wired networks. The logistic network is based on coverage by [[roboport]]s.

Some devices can also be connected to the logistic network and enabled based on a condition. If a device has conditions set for circuit and for logistic network, it will become activated if both conditions are true. Devices that can also be controlled with the logistic network:
* Transport belts
* Inserters
* Train stop
* Mining drills
* Pumpjack
* Power switch
* Lamp
* Offshore pump
* Pump

See the [[logistic network]] and [[roboport]] articles for more information.

== History ==

{{history|0.15.0|
* Significantly improved circuit network performance. Up to 25 times less CPU usage and 10% less memory usage.
* Added the Programmable Speaker: it shows alerts and plays sounds based on circuit network signals. It can be used to make simple songs.
* Train Stop can output the contents of the stopped train's cargo.
* Train Stop can be disabled using the circuit network. Trains will skip disabled Train Stops, allowing simple train control.
* Mining Drills can be turned on and off using the circuit network. They can also output the remaining expected resources.
* Pumpjacks can be turned on and off using the circuit network. They can also output the current oil mining rate.
* Added Modulo, Power, Left Bit Shift, Right Bit Shift, Bitwise AND, Bitwise OR and Bitwise XOR to the Arithmetic Combinator.
* Added additional operators to the Decider Combinator and Circuit Conditions.}}

{{history|0.13.0|
* Many machines are now connectible to the circuit network.
* Wire disconnecting is incorporated into the latency hiding.
* Wires are now highlighted on entity mouseover.
* Reduced memory usage of circuit network.}}

{{history|0.12.33|
* Fluid values are rounded to the closest value instead of rounding down when transmitted to circuit network.}}

{{history|0.12.1|
* One can copy paste circuit network conditions between the [[inserter]], [[lamp]], [[pump]] and [[offshore pump]]. }}

{{history|0.12.0|
* Improvements to circuit network connection, one can connect multiple wires of the same color to the same entity.
* The [[lamp]], [[storage tank]], [[pump]] and [[offshore pump]] can be connected to the circuit network.
}}

{{history|0.10.0|
* [[Blueprint]]s copy circuit network connections.}}

{{history|0.8.3|
* Circuit network contents info has colored slots to specify the network it represents.}}

{{history|0.1.0|
* Introduced}}

[[Category: Circuit network]]

Transport belts/Physics

2019-05-02T12:14:15Z

Ignatio: Add the number of positions an item takes, and extend the example with it.

{{Languages}}
The [[belt transport system]] in Factorio is among the most detailed simulations in the game. Items in chests and other containers are stored simply as summed totals, and items on uninterrupted stretches of belts are [https://www.factorio.com/blog/post/fff-176 moved in aggregate] as an optimization, but in the end items on belts are simulated individually, especially when they get picked up or put down by inserters. This leads to some intricate behaviors, in particular when it comes to [[Inserters#Inserter_Throughput|inserter throughput]].

== Belt properties ==

* '''Density'''. How many items fit onto a certain length of belt, measured in items per [[Map_structure#Tile|tile]] per belt lane. This is 4 on a straight belt, regardless of the type of item and type of belt. The item density on belts can be different from what they take up when just dropped on the ground (using the Z key).

* '''Speed'''. The speed of items on a belt is measured for practical reasons in tiles per second. Note that internally it is measured in positions (1/256 tile) per tick (1/60 sec). More on that below. The speed of a basic [[transport belt]] is 1.875 tiles per [[game-second]]. [[Fast transport belt]] is twice as fast, and [[express transport belt]] is three times as fast.

* '''Throughput'''. How many items per second that are moved from one tile to the next. That is density (items per tile) multiplied by speed (tiles per second), e.g. for a basic belt it is 4 * 1.875 = 7.5 items per second, for one belt lane. For both lanes it is doubled, i.e. 15 items per second.

* '''Compression'''. If there is no empty space between items on the belt it is called ''fully compressed'', otherwise its compression is only partial and it does not have optimal throughput. Entities that put items onto belts - [[inserters]], [[splitters]], other belts coming from the side, mining drills, etc - make room for their item by [https://forums.factorio.com/viewtopic.php?f=3&t=57993 enlarging a small gap] until it is exactly big enough for the item. That means belts naturally become fully compressed before items start to back up.

* '''Lanes'''. Belts have two parallel lanes, and the density and speed of each lane is constant and independent of the other one, regardless of twists and turns. So items in the inner lane of a turn exit it before those in the outer lane, since their speeds are equal and the inner lane is shorter than the outer one.

== Belt speeds ==

Given the values above we can calculate the speed and throughput of the three types of belts. Measurements confirm these values.

{| class="wikitable"
! rowspan=2 | Belt type || colspan=2 | Speed || colspan=4 | Throughput
|-
! Factor || Tiles/sec || Single lane, items/sec || Single lane, items/min || Both lanes, items/sec || Both lanes, items/min
|- align="center"
| align="left" | {{Imagelink|Transport belt|Transport belt}} || 1 || 1.875 || 7.5 || 450 || 15 || 900
|- align="center"
| align="left" | {{Imagelink|Fast transport belt|Fast transport belt}} || 2 || 3.75 || 15 || 900 || 30 || 1800
|- align="center"
| align="left" | {{Imagelink|Express transport belt|Express transport belt}} || 3 || 5.625 || 22.5 || 1350 || 45 || 2700
|}

== Items on belts ==

As mentioned earlier, items take space on belts in terms of density and compression. However, every item on a belt is logically ''on'' exactly one belt tile at any moment in time.

For example, even though in a screenshot it might look like an item is halfway out from one tile and halfway onto the next, it will be accounted to exactly one of the two tiles:
* If you stop the belt tile the item is on, it stops; else it continues moving - there are no in-between states.
* If you connect the two belt tiles to a circuit network and get them to [[Belt_transport_system#Circuit_network|report statistics]] about the items they carry, you will see the item being accounted to exactly one of them.
* An inserter can only pick up items that are logically on the tile in front of it, not items butting in from the neighboring tiles.

In this sense it is useful to think of items as points with a certain minimum distance between them, rather than things with an area lying next to each other. For belt calculations and circuit networks involving belts it doesn't really matter where those "center points" are within the graphic of the item, but they appear to be in the middle:

[[Image:Belts-with-one-tick-offsets.png|center]]

In the image above the belts have been started at 1 tick offsets, then all the top row tiles have been stopped at once, causing the front-most stopped items to poke out by varying amounts. The items on the leftmost belt are almost halfway into the next tile, which means their center points are the closest to the edge of the upper stopped tile.

Below is a schematic example showing some items moving over two straight [[fast transport belt]] tiles and what their read signals would be at each tick. Their center points are marked with <code>*</code>. (The space between belt tile 1 and 2 is only for visualisation - in the game there are no such gaps between tiles.)

<pre>
Tick Belt tile 1 Belt tile 2 Read belt tile 1 Read belt tile 2
|------------------------------| |------------------------------| Pulse Hold Pulse Hold
0 <---*--> <---*--> <---*-- ><---*--> <---*--> 0 3 0 2
1 <---*--> <---*--> <---* --><---*--> <---*--> 0 3 0 2
2 <---*--> <---*--> <-- -*--><---*--> <---*-- 0 2 1 3
3 <---*--> <---*--> < ---*--><---*--> <---* 0 2 0 3
4 -> <---*--> <---*--> <---*--><---*--> <-- 0 2 0 2
5 *--> <---*--> <---*- -> <---*--><---*--> < 1 3 0 2
6 --*--> <---*--> <--- *--> <---*--><---*--> 0 2 1 3
7 <---*--> <---*--> <- --*--> <---*--><---*--> 0 2 0 3
8 <---*--> <---*--> <---*--> <---*--><---*--> 0 2 0 3
</pre>

== Belt positions and lengths ==

[https://forums.factorio.com/viewtopic.php?f=5&t=70055 Careful measurement] shows that the outer lane of a turn is exactly 1.15234375 times longer than a straight belt, or 295/256 in fractional format. That means each straight belt tile has 256 ''positions'' an item can be in, even though measuring the position with that precision can only be done indirectly.

Here are the speeds and lengths of the various types of belt tiles in terms of these positions:

{| class="wikitable"
! colspan=2 | What || Number of positions
|-
| colspan=2 | Basic [[transport belt]] speed, per tick || align="center" | 8
|-
| colspan=2 | [[Fast transport belt]] speed, per tick || align="center" | 16
|-
| colspan=2 | [[Express transport belt]] speed, per tick || align="center" | 24
|-
| colspan=2 | Length of an item on a belt (of any speed) || align="center" | 64
|-
| colspan=2 | Length of one lane of a straight belt tile, underground belt, and splitter || align="center" | 256
|-
| colspan=2 | Length of the inner lane of a turn || align="center" | 106
|-
| colspan=2 | Length of the outer lane of a turn || align="center" | 295
|-
| style="border-right: 0px" | Length travelled by an item sideloaded late on a straight belt or underground exit
| style="border-left: 0px" | [[Image:Sideload-late.gif]] || align="center" | 68
|-
| style="border-right: 0px" | Length travelled by an item sideloaded early on a straight belt or underground entrance
| style="border-left: 0px" | [[Image:Sideload-early.gif]] || align="center" | 188
|}

For example, given the figures above, we can deduce the speed of a basic belt:

: 8 (positions per tick) / 256 (positions per straight belt tile) * 60 (ticks per second) = 1.875 tiles per second

Its throughput per belt lane is:

: 8 (positions per tick) / 64 (positions per item) * 60 (ticks per second) = 7.5 items per second

== See also ==
* [[Belt transport system]]
* Jan 04 FFF #276: [https://www.factorio.com/blog/post/fff-276 Belt item spacing & Script rendering]
* Feb 03 FFF #176: [https://www.factorio.com/blog/post/fff-176 Belts optimization for 0.15]
* [https://forums.factorio.com/viewtopic.php?f=5&t=70055 Accurate belt segment measurements] (discusses 0.17)

{{C|Belt transport system}}

Transport belts/Physics

2019-05-01T00:04:53Z

Ignatio: Updated to 0.17, more precise belt lengths, and clarifications of the belt mechanics, including some new images

{{Languages}}
{{sublinks}}

The [[belt transport system]] in Factorio is among the most detailed simulations in the game. Items in chests and other containers are stored simply as summed totals, and items on uninterrupted stretches of belts are [https://www.factorio.com/blog/post/fff-176 moved in aggregate] as an optimization, but in the end items on belts are simulated individually, especially when they get picked up or put down by inserters. This leads to some intricate behaviors, in particular when it comes to [[Inserters#Inserter_Throughput|inserter throughput]].

== Belt properties ==

* '''Density'''. How many items fit onto a certain length of belt, measured in items per [[Map_structure#Tile|tile]] per belt lane. This is 4 on a straight belt, regardless of the type of item and type of belt. The item density on belts can be different from what they take up when just dropped on the ground (using the Z key).

* '''Speed'''. The speed of items on a belt is measured for practical reasons in tiles per second. Note that internally it is measured in positions (1/256 tile) per tick (1/60 sec). More on that below. The speed of a basic [[transport belt]] is 1.875 tiles per [[game-second]]. [[Fast transport belt]] is twice as fast, and [[express transport belt]] is three times as fast.

* '''Throughput'''. How many items per second that are moved from one tile to the next. That is density (items per tile) multiplied by speed (tiles per second), e.g. for a basic belt it is 4 * 1.875 = 7.5 items per second, for one belt lane. For both lanes it is doubled, i.e. 15 items per second.

* '''Compression'''. If there is no empty space between items on the belt it is called ''fully compressed'', otherwise its compression is only partial and it does not have optimal throughput. Entities that put items onto belts - [[inserters]], [[splitters]], other belts coming from the side, mining drills, etc - make room for their item by [https://forums.factorio.com/viewtopic.php?f=3&t=57993 enlarging a small gap] until it is exactly big enough for the item. That means belts naturally become fully compressed before items start to back up.

* '''Lanes'''. Belts have two parallel lanes, and the density and speed of each lane is constant and independent of the other one, regardless of twists and turns. So items in the inner lane of a turn exit it before those in the outer lane, since their speeds are equal and the inner lane is shorter than the outer one.

== Belt speeds ==

Given the values above we can calculate the speed and throughput of the three types of belts. Measurements confirm these values.

{| class="wikitable"
! rowspan=2 | Belt type || colspan=2 | Speed || colspan=4 | Throughput
|-
! Factor || Tiles/sec || Single lane, items/sec || Single lane, items/min || Both lanes, items/sec || Both lanes, items/min
|- align="center"
| align="left" | {{Imagelink|Transport belt|Transport belt}} || 1 || 1.875 || 7.5 || 450 || 15 || 900
|- align="center"
| align="left" | {{Imagelink|Fast transport belt|Fast transport belt}} || 2 || 3.75 || 15 || 900 || 30 || 1800
|- align="center"
| align="left" | {{Imagelink|Express transport belt|Express transport belt}} || 3 || 5.625 || 22.5 || 1350 || 45 || 2700
|}

== Items on belts ==

As mentioned earlier, items take space on belts in terms of density and compression. However, every item on a belt is logically ''on'' exactly one belt tile at any moment in time.

For example, even though in a screenshot it might look like an item is halfway out from one tile and halfway onto the next, it will be accounted to exactly one of the two tiles:
* If you stop the belt tile the item is on, it stops; else it continues moving - there are no in-between states.
* If you connect the two belt tiles to a circuit network and get them to [[Belt_transport_system#Circuit_network|report statistics]] about the items they carry, you will see the item being accounted to exactly one of them.
* An inserter can only pick up items that are logically on the tile in front of it, not items butting in from the neighboring tiles.

In this sense it is useful to think of items as points with a certain minimum distance between them, rather than things with an area lying next to each other. For belt calculations and circuit networks involving belts it doesn't really matter where those "center points" are within the graphic of the item, but they appear to be in the middle:

[[Image:Belts-with-one-tick-offsets.png|center]]

In the image above the belts have been started at 1 tick offsets, then all the top row tiles have been stopped at once, causing the front-most stopped items to poke out by varying amounts. The items on the leftmost belt are almost halfway into the next tile, which means their center points are the closest to the edge of the upper stopped tile.

Below is a schematic example showing some items moving over two straight [[fast transport belt]] tiles and what their read signals would be at each tick. Their center points are marked with <code>*</code>. (The space between belt tile 1 and 2 is only for visualisation - in the game there are no such gaps between tiles.)

<pre>
Tick Belt tile 1 Belt tile 2 Read belt tile 1 Read belt tile 2
|------------------------------| |------------------------------| Pulse Hold Pulse Hold
0 <---*--> <---*--> <---*-- ><---*--> <---*--> 0 3 0 2
1 <---*--> <---*--> <---* --><---*--> <---*--> 0 3 0 2
2 <---*--> <---*--> <-- -*--><---*--> <---*-- 0 2 1 3
3 <---*--> <---*--> < ---*--><---*--> <---* 0 2 0 3
4 -> <---*--> <---*--> <---*--><---*--> <-- 0 2 0 2
5 *--> <---*--> <---*- -> <---*--><---*--> < 1 3 0 2
6 --*--> <---*--> <--- *--> <---*--><---*--> 0 2 1 3
7 <---*--> <---*--> <- --*--> <---*--><---*--> 0 2 0 3
8 <---*--> <---*--> <---*--> <---*--><---*--> 0 2 0 3
</pre>

== Belt positions and lengths ==

[https://forums.factorio.com/viewtopic.php?f=5&t=70055 Careful measurement] shows that the outer lane of a turn is exactly 1.15234375 times longer than a straight belt, or 295/256 in fractional format. That means each straight belt tile has 256 ''positions'' an item can be in, even though measuring the position with that precision can only be done indirectly.

Here are the speeds and lengths of the various types of belt tiles in terms of these positions:

{| class="wikitable"
! colspan=2 | What || Number of positions
|-
| colspan=2 | Basic [[transport belt]] speed, per tick || align="center" | 8
|-
| colspan=2 | [[Fast transport belt]] speed, per tick || align="center" | 16
|-
| colspan=2 | [[Express transport belt]] speed, per tick || align="center" | 24
|-
| colspan=2 | Length of one lane of a straight belt tile, underground belt, and splitter || align="center" | 256
|-
| colspan=2 | Length of the inner lane of a turn || align="center" | 106
|-
| colspan=2 | Length of the outer lane of a turn || align="center" | 295
|-
| style="border-right: 0px" | Length travelled by an item sideloaded late on a straight belt or underground exit
| style="border-left: 0px" | [[Image:Sideload-late.gif]] || align="center" | 68
|-
| style="border-right: 0px" | Length travelled by an item sideloaded early on a straight belt or underground entrance
| style="border-left: 0px" | [[Image:Sideload-early.gif]] || align="center" | 188
|}

Given the figures above, we can deduce the speed of a basic belt: 8 (positions per tick) / 256 (positions per straight belt tile) * 60 (ticks per second) = 1.875 tiles per second.

== History ==
'''This is outdated and should be outsourced from this article but not deleted, because it is an interesting fact.'''
<div class="toccolours mw-collapsible mw-collapsed" style="width:800px">
Kept for historical purposes, expand to view
<div class="mw-collapsible-content">

; Theory

{| class="wikitable"
|+Expected results 13.2 or older
|-
! scope="col" | belt-type
! scope="col" | factor basic belt speed
! scope="col" | speed (tiles/tick)
! scope="col" | speed (tiles/sec)
! scope="col" | speed (tiles/min)
! scope="col" | density (single lane) items/tile
! scope="col" | throughput (2 lanes) items/sec
! scope="col" | throughput items/min
|-
|Basic
|align="center" |1
|align="center" |0.03125
|align="center" |1.875
|align="center" |112.5
|align="center" |3.571
|align="center" |13.39125
|align="center" |803.475
|-
|Fast
|align="center" |2
|align="center" |0.0625
|align="center" |3.75
|align="center" |225
|align="center" |3.571
|align="center" |26.7825
|align="center" |1606.95
|-
|Express
|align="center" |3
|align="center" |0.09375
|align="center" |5.625
|align="center" |337.5
|align="center" |3.571
|align="center" |40.17375
|align="center" |2410.425
|}

; Measured Results for v0.11 or Older

With Factorio v0.12 new belt physics was introduced. Before that the items where moved as real objects (which means, they need to look forward, if there is space to move), with 0.12 the items are moved "per lane". Also the physics in curves changed so that curves are now not longer have lower throughput.

{| class="wikitable"
| This results have been measured with a special designed factory (a complicated setup to guarantee, that only the running items on a belt are measured and a "timer" which stops the measuring exactly) and Factorio v0.6.x, so this has to be redone.
See [http://www.factorioforums.com/forum/viewtopic.php?f=8&t=1144&start=10#p8361 forum article]
|}

{| class="wikitable"
|+Simple straight belt
|-
! scope="col"| belt-type
! scope="col"| throughput items/min
! scope="col"| throughput items/sec
! scope="col"| percent of awaited
! scope="col"| comments
|-
|Basic
|align="center" | 719
|align="center" | 11.98
|align="center" | 90%
|
|-
|Fast
|align="center" | 1184
|align="center" | 19.73
|align="center" | 74%
|This is NOT double as fast as basic! it's only 1.65 times faster
|-
|Express
|align="center" | 1775
|align="center" | 29.58
|align="center" | 74%
|About 2.5 times faster than basic
|}

{| class="wikitable"
|+Belt with 4 turns (2 left, 2 right, see down into next chapter)
|-
! scope="col"| belt-type
! scope="col"| throughput items/min
! scope="col"| comments
|-
|Basic
|align="center" | 477-486
| About 1.5 times slower. This is because the '''inner lane''' of a belt in a turn has only the half speed.
|-
|Fast
|align="center" | 786-792
|
|-
|Express
|align="center" |1038-1042
|
|}

{| class="wikitable"
|+Belt with 4 turns (2 left, 2 right), but faster belt at the edges
|-
! scope="col"| belt-type
! scope="col"| throughput items/min
! scope="col"| comments
|-
|Basic with fast edge-belts
|align="center" | 674-683
|
|-
|Fast with express edge-belts
|align="center" | 1058-1061
|The fast belt with express edge seems to be faster, than pure express belt!
|}

; Comments to the results

The first surprising result is, that the theoretic throughput differs from real measured. Too much to be just measurement errors.The second result is, that the more speed a belt has, the more ineffective it becomes. That is in the first moment not clearly explainable. The awaited result is, that a fast belt can transport exactly the double amount of items, than a basic, because it is double as fast (1.875 tiles/sec vs. 3.75 tiles/sec).

The reason for this difference is the distance of the items on the belt when running. Items on the belt cannot run completely compressed, they need a small distance. This is the same problem as in a traffic jam: You cannot drive, when the first car drives, you need to wait until the car before you drives and then you have a reaction-time of about 1/2 second before yourself begin to drive. The same is it with the items on the belt and the reaction-time here is 1/60 or one tick [currently not really validated, but not more than 2 ticks; this can be calculated by measuring how fast the standing wave goes through the items (needs to built a very complicated testing factory)]. You can see this reaction time running through your items as a standing wave, when you have a belt, which is completely filled and only sometimes an item is removed. When you compare the speed of this standing waves, you can see clearly, that they are the same speed for all types of belts.

The reaction-distance for items on a basic belt is
(1.875 tiles/sec) / 1 tick = 1.875 tiles/sec / 1/60 sec = 0.031125 tiles
or in other words: An item on a moving belt is not 0.28 tiles long, it is 0.31125 tiles, which makes it 11.2% longer

Overview for all belts:
Basic: 0.28 tiles + 0.03125 tiles = 0.31125 tiles => 11.2%
Fast: 0.28 tiles + 0.0625 tiles = 0.3425 tiles => 22.3%
Express: 0.28 tiles + 0.09375 tiles = 0.37375 tiles => 33.5%
This explains the reduction to 90% of speed for basic belt and the 74% for the fast belt (all inside measuring errors), but doesn't explain the results for express belt. This is part of further research.

This shows clearly, that the faster a belt is, the more distance the items have on a moving belt. More distance means, the density is lighter and this means, there are not so many items transported.

(This may explain the discrepancy in transported items, but don't use the numbers for real calculations, because they need to be redone!)
(This is eventually one reason: http://www.factorioforums.com/forum/viewtopic.php?f=8&t=3630 )

A possible reason for this: http://www.factorioforums.com/forum/viewtopic.php?f=16&t=6817

</div></div>

== See also ==
* [[Belt transport system]]
* Jan 04 FFF #276: [https://www.factorio.com/blog/post/fff-276 Belt item spacing & Script rendering]
* Feb 03 FFF #176: [https://www.factorio.com/blog/post/fff-176 Belts optimization for 0.15]
* [https://forums.factorio.com/viewtopic.php?f=5&t=70055 Accurate belt segment measurements] (discusses 0.17)
* [https://forums.factorio.com/viewtopic.php?f=18&t=33685 Factorio: a quantitative guide] (discusses 0.14)

{{C|Belt transport system}}

File:Belts-with-one-tick-offsets.png

2019-04-30T23:09:20Z

Ignatio:

File:Sideload-early.gif

2019-04-30T21:01:46Z

Ignatio: Animation showing sideloading from the "early" position.

== Summary ==
Animation showing sideloading from the "early" position.

File:Sideload-late.gif

2019-04-30T21:01:00Z

Ignatio: Animation showing sideloading from the "late" position.

== Summary ==
Animation showing sideloading from the "late" position.

Console

2019-04-27T01:20:10Z

Ignatio: Add command to turn off the wind effect

{{Languages}}
== Overview ==
The '''Console''' is Factorio's command-line interface.

The in-game console is used for:

* Chatting with other players
* Running commands / scripts / cheats
* Occasional status updates

There are three types of commands:

* '''[[#Normal commands|Normal]]''' - Display information about the game and customize your experience.
* '''[[#Multiplayer commands|Multiplayer]]''' - Message filtering, banning users, etc.
* '''[[#Scripting and cheat commands|Scripting/Cheating]]''' - Run small Lua scripts (but they disable achievements for the save game)

=== Using the console ===
The console display can be toggled with the {{keybinding|/}} (slash) or {{keybinding|~}} (tilde) keys.

You can customize the keys via '''Options Menu → Keyboard → Toggle Lua console'''.
When the console is open, you'll see a blinking cursor at the bottom of the screen; type your message or command and hit '''Return''' to send it (this will also close the console).
Documentation about message and command prefixes can be found further down this page.

The console supports [[rich text]] tags. These tags are useful for sharing blueprints, marking map locations in chat or adding icons to map markers and train stations. Ctrl+alt clicking the map or ground will automatically insert a gps tag and post it into the console. Shift clicking most things with the console open will insert a tag for that thing into chat.

When console is closed, only the most recent messages/commands will be displayed, but they will gradually fade away (opening the console will immediately re-display all recent messages).
Note that by default, all executed commands are made visible to all users. You can set the fade out time via '''Options Menu → Other Settings → Message Delay'''.

If you want to immediately hide the console, open the console and then press '''Escape''' key (or press '''Return''' without entering any message/command).
This not only closes the console, but it also hides all the recent messages/commands.
The console can be cleared with the '''/clear''' command.

Note that the console can also accept raw Lua code as well as game commands.

=== Console history ===

The console has an inbuilt history; it's a bit like a text editor where only one line of text is displayed at a time.

Use the {{keybinding|↑}} and {{keybinding|↓}} keys to scroll through the console history.

Use the {{keybinding|←}} and {{keybinding|→}} keys to cursor through the currently displayed message or command, which you can edit (delete, insert, etc.) and resend (by pressing '''Return''').

The {{keybinding|Tab}} key will auto-complete commands and player ids.

== Normal commands ==

{| class="wikitable"
|-
! style="width:25%"| Command
! style="width:25%"| Example
! style="width:46%"| Description
! style="width:4%"| Admin only
|-
| /alerts <enable/disable/mute/unmute> <alert>
| /alerts disable turret_fire
| Enables, disables, mutes, or unmutes the given alert type. Available alerts: entity_destroyed, entity_under_attack, not_enough_construction_robots, no_material_for_construction, not_enough_repair packs, turret_fire, custom, no_storage.
| No
|-
| /clear
| /clear
| Clears the console.
| No
|-
| /color <color>
| /color 20 255 255 100
| Changes your color. Can either be one of the pre-defined colors or [[:Wikipedia:RGBA_color_space|RGBA value]] in the format of “# # # #”. Available colors: default, red, green, blue, orange, yellow, pink, purple, white, black, gray, brown, cyan, acid.
| No
|-
| /evolution
| /evolution
| Prints info about the alien evolution factor.
| No
|-
| /help [command]
| /help
| Prints a list of available commands, the optional argument can specify the command that should be described.
| No
|-
| /h [command]
| /h
| Same as /help.
| No
|-
| /mute-programmable-speaker <mute/unmute> <local/everyone>
| /mute-programmable-speaker mute local
| Mutes or unmutes the global sounds created by the Programmable Speaker. Use “local” to mute just the local client. Admins can use “everyone” to mute the sounds for everyone on the server.
| No
|-
| /perf-avg-frames <number>
| /perf-avg-frames 100
| Number of ticks/updates used to average performance counters. Default is 100. Value of 5-10 is recommended for fast convergence, but numbers will jitter more rapidly.
| No
|-
| /permissions
| /permissions
| Opens the permissions GUI.
| Yes
|-
| /screenshot [x resolution] [y resolution] [zoom]
| /screenshot
| Takes a screenshot with the GUI hidden, centered on the player. It is saved in the "script-output" subfolder of your [[User data directory]]. Resolution is optional and defaults to the current window size. Zoom is optional and defaults to 1.
| No
|-
| /seed
| /seed
| Prints the starting map seed.
| No
|-
| /time
| /time
| Prints info about how old the map is.
| No
|-
| /toggle-action-logging
| /toggle-action-logging
| Toggles logging all input actions performed by the game. This value isn’t persisted between game restarts and only affects your local game in multiplayer sessions.
| Yes
|-
| /toggle-heavy-mode
| /toggle-heavy-mode
| Used to investigate [[Desynchronization#Using_heavy_mode_command|desyncs]]. Will slow down the game and make multiplayer unplayable.
| Yes
|-
| /toggle-rockets-sent-gui
| /toggle-rockets-sent-gui
| Toggles if the rockets sent button is shown in the upper left corner of the screen.
| No
|-
| /unlock-shortcut-bar
| /unlock-shortcut-bar
| Unlocks all shortcut bar items.
| No
|-
| /version
| /version
| Prints the current game version.
| No
|-
|}

== Multiplayer commands ==

{| class="wikitable"
|-
! style="width:25%"| Command
! style="width:25%"| Example
! style="width:46%"| Description
! style="width:4%"| Admin only
|-
| <message>
| Hello team!
| Console input that does not start with {{keybinding|/}} is shown as a chat message to your team.
| No
|-
| /admin
| /admin
| Opens the player management GUI.
| Yes
|-
| /admins
| /admins
| Prints a list of game admins.
| No
|-
| /ban <player> <reason>
| /ban xTROLLx Throwing grenades in base
| Bans the specified player.
| Yes
|-
| /banlist <add/remove/get/clear> <player>
| /banlist get
| Adds or removes a player from the banlist. Same as /ban or /unban.
| No
|-
| /config <get/set> <option> <value>
| /config set password hunter2
| Gets or sets various multiplayer game settings. Available configs are: afk-auto-kick, allow-commands, allow-debug-settings, autosave-interval, autosave-only-on-server, ignore-player-limit-for-returning-players, max-players, max-upload-speed, only-admins-can-pause, password, require-user-verification, visibility-lan, visibility-public.
| Yes
|-
| /delete-blueprint-library <player>
| /delete-blueprint-library everybody confirm
| Deletes the blueprint library storage for the given offline player from the save file. Enter “everybody confirm” to delete the storage of all offline players.
| Yes
|-
| /demote <player>
| /demote AzureDiamond
| Demotes the player from admin.
| Yes
|-
| /ignore <player>
| /ignore Cthon98
| Prevents the chat from showing messages from this player. Admin messages are still shown.
| No
|-
| /ignores
| /ignores
| Prints a list of ignored players.
| No
|-
| /kick <player> <reason>
| /kick xTROLLx Throwing grenades in base
| Kicks the specified player.
| Yes
|-
| /mute <player>
| /mute Cthon98
| Prevents the player from saying anything in chat.
| Yes
|-
| /mutes
| /mutes
| All players that are muted (can’t talk in chat).
| No
|-
| /open <player>
| /open AzureDiamond
| Opens another player’s inventory.
| Yes
|-
| /o <player>
| /o AzureDiamond
| Same as /open.
| Yes
|-
| /players [online/o/count/c]
| /players
| Prints a list of players in the game. (parameter online/o, it prints only players that are online, count/c prints only count)
| No
|-
| /promote <player>
| /promote AzureDiamond
| Promotes the player to admin.
| Yes
|-
| /purge <player>
| /purge Cthon98
| Clears all the messages from this player from the chat log.
| Yes
|-
| /reply <message>
| /reply oh, really?
| Replies to the last player that whispered to you.
| No
|-
| /r <message>
| /r oh, really?
| Same as /reply.
| No
|-
| /server-save
| /server-save
| Saves the game on the server in a multiplayer game.
| Yes
|-
| /shout <message>
| /shout Hello world!
| Sends a message to all players including other forces.
| No
|-
| /s <message>
| /s Hello world!
| Same as /shout.
| No
|-
| /swap-players <player> [player]
| /swap-players AzureDiamond
| Swaps your character with the given player’s character, or if two players are given swaps the two player characters.
| Yes
|-
| /unban <player>
| /unban xTROLLx
| Unbans the specified player.
| Yes
|-
| /unignore <player>
| /unignore Cthon98
| Allows the chat to show messages from this player.
| No
|-
| /unmute <player>
| /unmute Cthon98
| Allows the player to talk in chat again.
| Yes
|-
| /whisper <player> <message>
| /whisper AzureDiamond thats what I see
| Sends a message to the specified player.
| No
|-
| /w <player> <message>
| /w AzureDiamond thats what I see
| Same as /whisper.
| No
|-
| /whitelist <add/remove/get/clear> [player]
| /whitelist get
| Adds or removes a player from the whitelist, where only whitelisted players can join the game. Enter nothing for “player” when using “get” to print a list of all whitelisted players. An empty whitelist disables the whitelist functionality allowing anyone to join.
| No
|}

== Scripting and cheat commands ==
{| class="wikitable"
|-
! Command
! Description
|-
| /cheat <all>
| Researches all technologies and enables cheat mode. Using the '''all''' option also gives the player some additional items.
|-
| /command <command>
| Executes a Lua command.
|-
| /c <command>
| Executes a Lua command.
|-
| /editor
| Toggles the map editor.
|-
| /measured-command <command>
| Executes a Lua command and measures time it took.
|-
| /silent-command <command>
| Executes a Lua command without printing it to the console.
|}

This is a very powerful feature, which also allows cheating, and as such achievements will be permanently disabled for the save as soon as you use a script command.

=== Make new force and change your force to it ===

<syntaxhighlight lang="lua">
/c local name = game.player.name
if not game.forces[name] then game.create_force(name) end
game.player.force = name
</syntaxhighlight>

== Basic example scripts ==

=== Use it as calculator ===
<syntaxhighlight lang="lua">
/c game.player.print(1234*5678)
</syntaxhighlight>

=== Zoom beyond normal bounds ===
Note that zooming too far out can cause performance hits. Be careful.
<syntaxhighlight lang="lua">
/c game.player.zoom=0.1
</syntaxhighlight>

=== Mine faster ===
<syntaxhighlight lang="lua">
/c game.player.force.manual_mining_speed_modifier=1000
</syntaxhighlight>

=== Craft faster ===
<syntaxhighlight lang="lua">
/c game.player.force.manual_crafting_speed_modifier=1000
</syntaxhighlight>

=== Unlock and research all technologies ===
<syntaxhighlight lang="lua">
/c game.player.force.research_all_technologies()
</syntaxhighlight>

Undo this with the command in the next section.

=== Unresearch all technologies ===
This does not reset manually applied bonuses
<syntaxhighlight lang="lua">
/c for _, tech in pairs(game.player.force.technologies) do
tech.researched=false
game.player.force.set_saved_technology_progress(tech, 0)
end
</syntaxhighlight>

=== Reset your force ===
This resets all data for your force, including kill and production statistics, technologies, bonuses and charting status.
<syntaxhighlight lang="lua">
/c game.player.force.reset()
</syntaxhighlight>

=== Always show rail block visualization ===
Permanently show the rail block visualization instead of only when holding a rail signal. Disable by replacing true with false.

<syntaxhighlight lang="lua">
/c game.player.game_view_settings.show_rail_block_visualisation = true
</syntaxhighlight>

== Inventory manipulation scripts ==

=== Cheat mode ===
Allows for infinite free crafting. Disable by replacing true with false.
<syntaxhighlight lang="lua">
/c game.player.cheat_mode=true
</syntaxhighlight>

=== Refill resources (refill oil, iron etc.) ===
While holding the cursor over a resource tile in-game
<syntaxhighlight lang="lua">
/c game.player.selected.amount=7500
</syntaxhighlight>

Alternatively you can refill all resources in the map with the following command. Change ore.amount to the desired value.
<syntaxhighlight lang="lua">
/c surface = game.player.surface
for _, ore in pairs(surface.find_entities_filtered({type="resource"})) do
ore.amount = 10000
end
</syntaxhighlight>

=== Add items to the player's inventory ===
Replace iron-plate with the [[data.raw|internal name]] of the item desired.
<syntaxhighlight lang="lua">
/c game.player.insert{name="iron-plate", count=100}
</syntaxhighlight>

For instance, here's a stack of the god-mode energy system interface:
<syntaxhighlight lang="lua">
/c game.player.insert{name="electric-energy-interface"}
</syntaxhighlight>

Add a powerful armor with equipment and some tools for construction:
<syntaxhighlight lang="lua">
/c local player = game.player
player.insert{name="power-armor-mk2", count = 1}
local p_armor = player.get_inventory(5)[1].grid
p_armor.put({name = "fusion-reactor-equipment"})
p_armor.put({name = "fusion-reactor-equipment"})
p_armor.put({name = "fusion-reactor-equipment"})
p_armor.put({name = "exoskeleton-equipment"})
p_armor.put({name = "exoskeleton-equipment"})
p_armor.put({name = "exoskeleton-equipment"})
p_armor.put({name = "exoskeleton-equipment"})
p_armor.put({name = "energy-shield-mk2-equipment"})
p_armor.put({name = "energy-shield-mk2-equipment"})
p_armor.put({name = "personal-roboport-mk2-equipment"})
p_armor.put({name = "night-vision-equipment"})
p_armor.put({name = "battery-mk2-equipment"})
p_armor.put({name = "battery-mk2-equipment"})
player.insert{name="construction-robot", count = 25}
</syntaxhighlight>

== World manipulation scripts ==

=== Reveal the map around the player ===

Reveals the map around the player, similar to a [[radar]].
<syntaxhighlight lang="lua">
/c local radius=150
game.player.force.chart(game.player.surface, {{game.player.position.x-radius, game.player.position.y-radius}, {game.player.position.x+radius, game.player.position.y+radius}})
</syntaxhighlight>
or from start position
<syntaxhighlight lang="lua">
/c game.forces.player.chart(game.player.surface, {{x = -2000, y = -2000}, {x = 2000, y = 2000}})
</syntaxhighlight>
Change 150 to the desired radius, higher values take longer.

=== Delete chunks ===
If much of the map is revealed, it increases the size of the save file. The following command cancels the generation of all chunks that are currently queued for generation and removes chunks outside a 32 chunks radius around 0,0. Note that this will remove player entities if there are any on these chunks.
<syntaxhighlight lang="lua">
/c local surface = game.player.surface;
game.player.force.cancel_charting(surface);
local chunk_radius = 32;
for chunk in surface.get_chunks() do
if (chunk.x < -chunk_radius or chunk.x > chunk_radius or chunk.y < -chunk_radius or chunk.y > chunk_radius) then
surface.delete_chunk(chunk)
end
end
</syntaxhighlight>

=== Turn off night ===
Enables eternal day.
<syntaxhighlight lang="lua">
/c game.player.surface.always_day=true
</syntaxhighlight>

=== Turn off wind ===
This freezes the moving clouds that cast slight shadows on the ground. Can be useful when recording videos, together with turning off night above.
<syntaxhighlight lang="lua">
/c game.player.surface.wind_speed=0
</syntaxhighlight>

=== Change game speed ===
0.5 is half speed, 1 is default, 2 is double speed, etc. Minimum is 0.01. This can be used for a lot of things like when you know you will have to wait for long periods of time for something to complete. Increasing will decrease performance, be careful.
<syntaxhighlight lang="lua">
/c game.speed=X
</syntaxhighlight>

=== Expensive (marathon) or normal mode ===
To change from normal to expensive mode preset (this changes the research cost and intermediate product cost):
<syntaxhighlight lang="lua">
/c game.difficulty_settings.recipe_difficulty=1
game.difficulty_settings.technology_difficulty=1
game.difficulty_settings.technology_price_multiplier=4
</syntaxhighlight>

To change back to normal:
<syntaxhighlight lang="lua">
/c game.difficulty_settings.recipe_difficulty=0
game.difficulty_settings.technology_difficulty=0
game.difficulty_settings.technology_price_multiplier=1
</syntaxhighlight>

=== Freeze time ===
Stops the advancement of the time if you replace "BOOL" with "true" or unfreezes it if you replace it with "false".
<syntaxhighlight lang="lua">
/c game.player.surface.freeze_daytime=BOOL
</syntaxhighlight>

=== Remove all pollution ===
<syntaxhighlight lang="lua">
/c game.player.surface.clear_pollution()
</syntaxhighlight>

=== Completely turn off pollution ===

<syntaxhighlight lang="lua">
/c for _, surface in pairs(game.surfaces) do
surface.clear_pollution()
end
game.map_settings.pollution.enabled = false
</syntaxhighlight>

=== Add a lot of pollution ===
<syntaxhighlight lang="lua">
/c game.player.surface.pollute(game.player.position, 1000000)
</syntaxhighlight>

=== Where speakers are, by who ===
<syntaxhighlight lang="lua">
/c speakers = game.player.surface.find_entities_filtered{force = "player", type="programmable-speaker"}
for key, speaker in pairs(speakers) do
game.player.print(speaker.last_user.name .. " placed a speaker at X=" .. speaker.position.x .. ", Y=" .. speaker.position.y)
end
</syntaxhighlight>

=== Disable friendly fire for your force ===
<syntaxhighlight lang="lua">
/c game.player.force.friendly_fire = false
</syntaxhighlight>

=== Add new resource patch ===
This creates a new 11×11 patch of resources, centered on the player character, where the ground is not water.
The patch it creates is perfectly square but it randomizes the amount similar to natural generation, with fewer ore at the edges and more ore in the center.
The default numbers result in a patch with 2500-3000 ore.

If you want a larger patch, change "local size = 5" to a larger number.
A larger patch will have exponentially more ore.
Entering a number above 30 is not recommended.

If you want a richer patch, change "local density = 10" to a larger number.
Entering a very large number shouldn't hurt anything but you probably don't need to go above 100.

To choose which resource is spawned, change "stone" near the bottom to "iron-ore", "copper-ore", "coal", or "uranium-ore".

<syntaxhighlight lang="lua">
/c local surface=game.player.surface
local ore=nil
local size=5
local density=10
for y=-size, size do
for x=-size, size do
a=(size+1-math.abs(x))*10
b=(size+1-math.abs(y))*10
if a<b then
ore=math.random(a*density-a*(density-8), a*density+a*(density-8))
end
if b<a then
ore=math.random(b*density-b*(density-8), b*density+b*(density-8))
end
if surface.get_tile(game.player.position.x+x, game.player.position.y+y).collides_with("ground-tile") then
surface.create_entity({name="stone", amount=ore, position={game.player.position.x+x, game.player.position.y+y}})
end
end
end
</syntaxhighlight>

=== Remove resources around the player ===
Removes all resource patches from the ground in a 50 x 50 area around the player.

<syntaxhighlight lang="lua">
/c local surface=game.player.surface
local size=50
local pos=game.player.position

for _, e in pairs(surface.find_entities_filtered{area={{pos.x-size, pos.y-size},{pos.x+size, pos.y+size}}, type="resource"})
do e.destroy()
end
</syntaxhighlight>

=== Add new oil patch ===
This creates 9 crude oil patches in a 3×3 square.
<syntaxhighlight lang="lua">
/c for y=0,2 do
for x=0,2 do
game.player.surface.create_entity({name="crude-oil", amount=100000, position={game.player.position.x+x*7-7, game.player.position.y+y*7-7}})
end
end
</syntaxhighlight>

or randomly without any collision:
<syntaxhighlight lang="lua">
/c local position=nil
for i=1,9 do
position=game.player.surface.find_non_colliding_position("crude-oil", game.player.position, 0, i/2+1.5)
if position then
game.player.surface.create_entity({name="crude-oil", amount=100000, position=position})
end
end
</syntaxhighlight>

=== Create 10 fishes ===
This creates 10 fishes around of player. The player must be on the water edge.
<syntaxhighlight lang="lua">
/c local player = game.player
local surface = player.surface
for i = 1, 10 do
local position = surface.find_non_colliding_position('fish', player.position, 10, 1)
if not position then return end
surface.create_entity {name = 'fish', position = position}
end
</syntaxhighlight>

=== Count entities ===
Counts all entities whose name includes the string in local entity.
<syntaxhighlight lang="lua">
/c local entity="belt"
local surface=game.player.surface
local count=0
for key, ent in pairs(surface.find_entities_filtered({force=game.player.force})) do
if string.find(ent.name,entity) then
count=count+1
end
end
game.player.print(count)
</syntaxhighlight>

=== Emptying all pipes, underground pipes and pumps ===
Useful when pipes contain a fluid you dont want.
<syntaxhighlight lang="lua">
/c local surface = game.player.surface
local deleted=0
for key, entity in pairs(surface.find_entities_filtered({force=game.player.force})) do
if string.find(entity.name, "pipe") or
string.find(entity.name, "pump")
then
for i=1,#entity.fluidbox do
deleted = deleted + 1
entity.fluidbox[i] = nil;
end
end
end
game.player.print("Fluids removed from "..deleted .." entities")
</syntaxhighlight>

=== Turn off cliff generation ===
Sets size to "none". Only effective on chunks that are generated after using this command. Use [[#Remove all cliffs]] to delete existing cliffs.

<syntaxhighlight lang="lua">
/c local mgs = game.player.surface.map_gen_settings
mgs.cliff_settings.cliff_elevation_0 = 1024
game.player.surface.map_gen_settings = mgs</syntaxhighlight>

=== Remove all cliffs ===
Removes all cliffs existing cliffs from the world. Use [[#Turn off cliff generation]] to turn off cliff generation in new chunks.

<syntaxhighlight lang="lua">
/c for _, v in pairs(game.player.surface.find_entities_filtered{type="cliff"}) do
v.destroy()
end</syntaxhighlight>

=== Delete all decoratives ===
Delete the decoratives that can be found in the world.

<syntaxhighlight lang="lua">
/c local surface = game.player.surface
for c in surface.get_chunks() do
surface.destroy_decoratives({{c.x*32, c.y*32}, {c.x*32+32, c.y*32+32}})
end</syntaxhighlight>

=== Change map generation settings ===
This allows to change the map generation settings for new chunks; it does not alter already generated chunks. [[#Delete chunks|Deleted chunks]] are affected by the setting change because they are newly generated when they get explored again.

To change resource generation settings, replace "iron-ore" with the [[Data.raw#resource|resource]] that should be changed and replace "very-high" with the desired [https://lua-api.factorio.com/latest/Concepts.html#MapGenSize MapGenSize] in the following command. Replace "iron-ore" with "enemy-base" to change the enemy base generation settings.

<syntaxhighlight lang="lua">
/c local surface = game.player.surface
local resource = "iron-ore"
local autoplace = surface.map_gen_settings.autoplace_controls
autoplace[resource].size = "very-high"
autoplace[resource].frequency = "very-high"
autoplace[resource].richness = "very-high"
surface.map_gen_settings.autoplace_controls = autoplace</syntaxhighlight>

To change water generation settings, replace "very-high" with the desired [https://lua-api.factorio.com/latest/Concepts.html#MapGenSize MapGenSize] in the following command.

<syntaxhighlight lang="lua">
/c local surface = game.player.surface
local mgs = surface.map_gen_settings
mgs.water = "very-high" --[[ size]]
mgs.terrain_segmentation = "very-high" --[[ frequency]]
surface.map_gen_settings = mgs </syntaxhighlight>

== Enemy/evolution scripts ==

=== Set evolution factor ===
Ranges from 0 (new game) to 1.
<syntaxhighlight lang="lua">
/c game.forces["enemy"].evolution_factor=X
</syntaxhighlight>

=== Disable time-based evolution & increases pollution-based evolution ===
<syntaxhighlight lang="lua">
/c game.map_settings.enemy_evolution.time_factor=0
/c game.map_settings.enemy_evolution.pollution_factor=game.map_settings.enemy_evolution.pollution_factor*2
</syntaxhighlight>

The "2" at the end of the last command will double the default pollution factor. You can substitute another number to increase (or decrease) the pollution factor further.

=== Kill all biters on the "enemy" force ===
Note that this will kill only mobile units, spawners will not be killed.
<syntaxhighlight lang="lua">
/c game.forces["enemy"].kill_all_units()
</syntaxhighlight>

=== Kill all enemies ===
This will kill all biters, bases and worms. Anything that is an enemy will be completely destroyed. This only affects enemies in the explored world, so any unexplored parts of the map which still need to be generated will still have enemies. You can [[#Prevent biters being on newly generated chunks|prevent biters being on newly generated chunks]] if desired.
<syntaxhighlight lang="lua">
/c local surface=game.player.surface
for key, entity in pairs(surface.find_entities_filtered({force="enemy"})) do
entity.destroy()
end
</syntaxhighlight>

=== Kill all nearby enemies ===

This will kill all biters, bases and worms in a configurable radius. The default, 250 tiles, is about two zoomed-out screen widths on full HD. After destruction, it shows how many objects were destroyed.

<syntaxhighlight lang="lua">
/c local radius = 250
local surface=game.player.surface
local pp = game.player.position
local cnt = 0
for key, entity in pairs(surface.find_entities_filtered({force="enemy"})) do
if entity.position.x > pp.x - radius and entity.position.x < pp.x + radius
and entity.position.y > pp.y - radius and entity.position.y < pp.y + radius then
cnt = cnt+1
entity.destroy()
end
end
game.player.print(cnt)
</syntaxhighlight>

=== Enable/Disable peaceful mode ===
Enabling peaceful mode prevents biter attacks until provoked. Substitute true for false to disable. Already existing biters are not affected by this command so attacks could continue for a while after activating peaceful mode.
<syntaxhighlight lang="lua">
/c game.player.surface.peaceful_mode = true
</syntaxhighlight>

=== Enable/Disable biter expansion ===
Biter expansion allows biters to create new nests, it is enabled by default. Substitute true for false to disable.
<syntaxhighlight lang="lua">
/c game.map_settings.enemy_expansion.enabled = true
</syntaxhighlight>

=== Prevent biters being on newly generated chunks ===
On newly generated chunks no biters will be present, however all current biters will remain unaffected. Equivalent of setting the Enemy Base Size to None under the Terrain settings during map generation but achieved mid game by [[#Change map generation settings|changing map generation settings]].
<syntaxhighlight lang="lua">
/c local surface = game.player.surface
local mgs = surface.map_gen_settings
mgs.autoplace_controls["enemy-base"].size = "none"
surface.map_gen_settings = mgs
</syntaxhighlight>

== Player character scripts ==
Commands concerning the player directly.
=== Get player position ===
Prints coordinates of your current position.
<syntaxhighlight lang="lua">
/c game.player.print(game.player.position.x .. ", " .. game.player.position.y)
</syntaxhighlight>

=== Teleport player ===
Moves the player to the specified location. You should be able to teleport to a specific player if you obtain their coordinates via them executing the previous command and giving them to you.
<syntaxhighlight lang="lua">
/c game.player.teleport({X, Y})
</syntaxhighlight>

To teleport to the world's origin, use 0,0.

=== Enable god mode ===
God mode removes your player character allowing you to fly over obstacles and take no damage.

Disassociate your controls from the player:
<syntaxhighlight lang="lua">
/c game.player.character=nil
</syntaxhighlight>

Then, hover the mouse over the useless player and destroy it by typing:
<syntaxhighlight lang="lua">
/c game.player.selected.destroy()
</syntaxhighlight>

To undo, spawn a player character. This will spawn a new player at the spawn point of the world, and connect your controls to it.
<syntaxhighlight lang="lua">
/c game.player.create_character()
</syntaxhighlight>

=== Enable long reach ===
Enables long reach, which allows the player to build and interact with entities at a greater distance. The default reach is 10.
<syntaxhighlight lang="lua">
/c local reach = 10000
game.player.force.character_build_distance_bonus = reach
game.player.force.character_reach_distance_bonus = reach
</syntaxhighlight>

== Research scripts ==

=== Enable Research Queue ===
Enable the research queue for the players current team. Can be done after the game has started if it was forgotten during the map's setup.
<syntaxhighlight lang="lua">
/c game.player.force.research_queue_enabled = true
</syntaxhighlight>

=== Enable faster research ===
<syntaxhighlight lang="lua">
/c game.player.force.laboratory_speed_modifier=1
</syntaxhighlight>
1 is normal speed, 2 is double speed 3 is triple etc.

=== Research specific technologies ===
The internal technology names can be found in the infoboxes on their respective pages.
<syntaxhighlight lang="lua">
/c game.player.force.technologies['electric-energy-distribution-1'].researched=true
/c game.player.force.technologies['steel-processing'].researched=true
</syntaxhighlight>

=== Unresearch specific technologies ===
The internal technology names can be found in the infoboxes on their respective pages.
<syntaxhighlight lang="lua">
/c game.player.force.technologies['electric-energy-distribution-1'].researched=false; game.player.force.set_saved_technology_progress('electric-energy-distribution-1', 0)
/c game.player.force.technologies['steel-processing'].researched=false; game.player.force.set_saved_technology_progress('steel-processing', 0)
</syntaxhighlight>

=== Enabling specific recipes ===
The internal recipe/item names can be found in the infoboxes on their respective pages.
<syntaxhighlight lang="lua">
/c game.player.force.recipes["electric-energy-interface"].enabled=true
/c game.player.force.recipes["rocket-silo"].enabled=true
/c game.player.force.recipes.loader.enabled=true
</syntaxhighlight>

=== Enable all recipes ===
<syntaxhighlight lang="lua">
/c for name, recipe in pairs(game.player.force.recipes) do recipe.enabled = true end
</syntaxhighlight>

== Command line parameters ==
'''As of Game Version 0.17.5'''

Command line parameters can be used to set settings in the command line before the game launches, this is useful mainly for advanced users or server hosts.

{|
|'''General options:'''
|-
| -h, --help
| display help
|-
| --version
|show version information
|-
| -v, --verbose
|enable verbose logging
|-
| -c, --config PATH
|config file to use
|-
| --no-log-rotation
|don't rotate log file
|-
| --mod-directory PATH
|Mod directory to use
|-
| --check-unused-prototype-data
|Print a warning for all prototype values that were not accessed
|-
| --executable-path PATH
|Override autodetected __PATH__executable. Usually not needed except on very weird systems.
|}

{|
|'''Running options:'''
|-
| -s, --map2scenario arg
|map to scenario conversion
|-
| -m, --scenario2map arg
|scenario to map conversion
|-
| --apply-update arg
|immediately apply update package
|-
| --create FILE
|create a new map
|-
| --map-gen-settings FILE
|Map generation settings for use with --create, --start-server-load-scenario or --generate-map-preview. See data/map-gen-settings.example.json
|-
| --map-gen-seed SEED
|Map generation seed for use with --create, --start-server-load-scenario or --generate-map-preview. Will override seed specified in map gen settings
|-
| --map-settings FILE
|Map settings for use with --create or --start-server-load-scenario. See data/base/prototypes/map-settings.lua
|-
| --preset arg
|Name of the map generation preset to be used.
|-
| --enable-runtime-autoplace-modification
|Allows changing autoplace specifications runtime in non-multiplayer non-replay enabled games for debug purposes.
|-
| --generate-map-preview PNGFILE
|Generate preview images of the map
|-
| --generate-tile-properties-csv CSVFILE
|Generate tile properties into a CSV file; can be used with --generate-map-preview
|-
| --map-preview-size SCALE
|Size (in pixels) of map preview (default: 1024)
|-
| --map-preview-scale SCALE
|Scale (meters per pixel) of map preview (default: 1)
|-
| --map-preview-offset X,Y
|Offset of the center of the map, in meters (default: 0,0)
|-
| --noise-outputs TAG,TAG...
|Indicate which variables of noise program to output
|-
| --slope-shading SHADEAMOUNT
|Apply elevation shading to map preview
|-
| --slope-shade-property SHADEPROP
|Property to apply slope shading to (default: elevation)
|-
| --report-quantities PROTOTYPE,...
|When generating map preview, report approximate quantities of the named entity prototypes
|-
| --threads THREADCOUNT
|Number of threads to use when generating map previews
|-
| --disable-migration-window
|Disables the gui that is shown when opening a save with migrated content
|-
| --start-server FILE
|start a multiplayer server
|-
| --start-server-load-scenario [MOD/]NAME
|start a multiplayer server and load the specified scenario. The scenario is looked for inside the given mod. If no mod is given, it is looked for in the top-level scenarios directory.
|-
| --start-server-load-latest
|start a multiplayer server and load the latest available save
|-
| --until-tick TICK
|run a save until given map tick
|-
| --benchmark FILE
|load save and run benchmark
|-
| --benchmark-ticks N
|number of ticks for benchmarking. Default is 1000 (default: 1000)
|-
| --benchmark-verbose FILE
|comma seperated list of timings to ouput each tick. "all", "timestamp" as well as all other values seen in the debug view are allowed here. An empty string disabled verbose benchmarking. (default: )
|-
| --output-perf-stats FILE
|path of file to which performance statistics measurements should be saved. Special tags {api}, {hw}, {time} and {tag} will be replaced.
|-
| --mp-connect ADDRESS
|start factorio and connect to address
|-
| --load-game FILE
|start Factorio and load a game in singleplayer
|-
| --benchmark-graphics FILE
|load save and run it with graphics for benchmark-ticks number of ticks as normal game would
|-
| --benchmark-frame FILE
|load save and benchmark graphics rendering of single frame (prepare + render) without updating the game
|-
| --force-opengl
|use OpenGL for rendering
|-
| --force-d3d
|use Direct3D for rendering
|-
| --debug-graphics
|enables debugging layer for graphics API. If DirectX is used DirectX SDK needs to be installed for this to work.
|-
| --fullscreen
|start game in windowed mode (saved to configuration)
|-
| --max-texture-size N
|maximal size of texture that the game can use (saved to configuration). Should be power of two greater than 2048
|-
| --graphics-quality arg
|accepted values: normal, low, very-low
|-
| --video-memory-usage arg
|accepted values: all, high, medium, low
|-
| --force-graphics-preset arg
|accepted values: very-low, low, mac-with-low-ram, medium-with-low-vram, medium, high, very-high, extreme
|-
| --gfx-safe-mode
|resets some graphics settings to values that should work on most configurations
|-
| --low-vram
|sprites that are not put into sprite atlases won't be allocated as texture objects
|-
| --shader arg
|enable/disable shader postprocessing (saved to configuration)
|-
| --disable-audio
|Disable audio. Mainly for faster startup during development.
|-
| --window-size arg
|Desired window resolution. For example "1680x1050". Or "maximized"
|-
| --single-thread-loading
|Disables loading of sprites in multiple threads.
|}

{|
|'''Server options:'''
|-
| --port N
|network port to use
|-
| --bind ADDRESS[:PORT]
|IP address (and optionally port) to bind to
|-
| --rcon-port N
|Port to use for RCON
|-
| --rcon-password PASSWORD
|Password for RCON
|-
| --server-settings FILE
|Path to file with server settings. See data/server-settings.example.json
|-
| --use-server-whitelist
|If the whitelist should be used.
|-
| --server-whitelist FILE
|Path to file with server whitelist.
|-
| --server-banlist FILE
|Path to file with server banlist.
|-
| --server-adminlist FILE
|Path to file with server adminlist.
|-
| --console-log FILE
|Path to file where a copy of the server's log will be stored
|-
| --server-id FILE
|Path where server ID will be stored or read from
|}

=== Multiplayer ===

--start-server SAVE

Will start a Headless (Dedicated) server, with no GUI.

--mp-connect ADDRESS
ADDRESS is the IP:port of the remote host. Port is optional.
Examples:

./factorio --mp-connect 192.168.1.101
./factorio --mp-connect 192.168.1.101:2345

As above, port can be specified by placing the port number after a colon in the address.

--map2scenario SAVE
Converts a save game to a User Scenario, allows saved game state to be loaded into map editor.
Assuming that save game name is "foo.zip", executing './factorio --map2scenario s1' will result in Factorio loading, opening the save file, and saving the scenario into the scenario folder.

== Modding tools ==
A list of the internal names of most things in the vanilla game can also be found on [[data.raw]].

=== Print to console which tile are you have under the player position ===
<syntaxhighlight lang="lua">
/c game.player.print(game.player.surface.get_tile(game.player.position.x, game.player.position.y).name)
</syntaxhighlight>

=== Write all researched technologies to file ===
<syntaxhighlight lang="lua">
/c local list = {}
for _, tech in pairs(game.player.force.technologies) do
if tech.researched then
list[#list+1] = tech.name
end
end
game.write_file("techs.lua", serpent.block(list) .. "\n", true)
</syntaxhighlight>

=== Write all enabled recipes to file ===
<syntaxhighlight lang="lua">
/c local list = {}
for _, recipe in pairs(game.player.force.recipes) do
if recipe.enabled then
list[#list+1] = recipe.name
end
end
game.write_file("recipes.lua", serpent.block(list) .. "\n", true)
</syntaxhighlight>

== See also ==

* http://lua-api.factorio.com/latest/ - Factorio API reference for latest version

Rocket silo

2018-05-28T19:16:35Z

Ignatio: That the satellite insertion time isn't included is material info - it does add noticeably in the long run. Removed another bit of the example that became pointless after the previous edit.

{{languages}}
{{:Infobox:Rocket silo}}

The '''Rocket silo''' is currently the only win condition. Once the silo has been built and placed it can be filled with [[low density structure]]s, [[rocket fuel]], and [[rocket control unit]]s which will allow [[rocket part]]s to be created within the silo.

In order to launch a rocket, 100 rocket parts need to be crafted. Each rocket part needs 10 low density structures, 10 rocket fuel, and 10 rocket control units.

When all rocket parts have been completed the rocket silo interface will be at 100% and allow the player to input a [[satellite]] component. Launching the rocket with a satellite will complete the game and a win menu will be displayed that shows all kills and the playing time, asking the player to exit the current game, continue, or view the replay. Launching a satellite also places 1000 [[space science pack]]s in the rocket result inventory.

However, launching the silo without the satellite is sadly pointless, as it won't count as a win, and will be a massive waste of resources. More resources will be needed to make another rocket.

Building a silo requires, among other things, [[electric engine unit]]s, [[engine unit]]s, and [[processing unit]]s, which must be produced in [[assembling machine]]s and cannot be crafted by hand from raw materials. The rocket itself can also only be produced in the silo.

The rocket silo result inventory can hold up to one stack of space science packs (2000). When receiving science packs from a launched satellite, the game discards all space science packs that exceed the capacity of the rocket result inventory. The "Auto launch with cargo" checkbox does '''not''' check if the rocket result inventory can hold the expected space science packs, this has to be manually ensured by the player, for example through the [[circuit network]].

== Timings ==

The duration of the rocket launch animation is 2475 [[game-tick]]s, or 41.25 seconds. This is the time from when the rocket is finished to when production on the next rocket can start, but it does not include the time to insert the payload.

The duration not affected by any modules or beacons, which can be important to take into account when planning to launch rockets quickly. E.g. to launch one rocket per minute using a single rocket silo, the production of the rocket parts must happen within 60 - 41.25 = 18.75 seconds.

== Achievements ==

The rocket silo, which is used to win the game, is directly connected to the following game win based achievements:
{{Achievement|smoke-me-a-kipper-i-will-be-back-for-breakfast}}
{{Achievement|no-time-for-chitchat}}
{{Achievement|there-is-no-spoon}}
{{Achievement|raining-bullets}}
{{Achievement|steam-all-the-way}}
{{Achievement|logistic-network-embargo}}
{{Achievement|so-long-and-thanks-for-all-the-fish}}

== History ==

{{history|0.13.9|
* Rocket parts from building rockets in the silo now show in production statistics.}}

{{history|0.12.7|
* Updated icon.}}

{{history|0.12.4|
* Rocket silo now behaves correctly when out of electricity.}}

{{history|0.12.0|
* Introduced}}

== See also ==
* [[Satellite]]

{{CombatNav}}
{{C|Defense}}

Rocket silo

2018-05-28T16:48:22Z

Ignatio: Discuss the "idle" time during a rocket launch when the silo doesn't produce rocket parts.

{{languages}}
{{:Infobox:Rocket silo}}

The '''Rocket silo''' is currently the only win condition. Once the silo has been built and placed it can be filled with [[low density structure]]s, [[rocket fuel]], and [[rocket control unit]]s which will allow [[rocket part]]s to be created within the silo.

In order to launch a rocket, 100 rocket parts need to be crafted. Each rocket part needs 10 low density structures, 10 rocket fuel, and 10 rocket control units.

When all rocket parts have been completed the rocket silo interface will be at 100% and allow the player to input a [[satellite]] component. Launching the rocket with a satellite will complete the game and a win menu will be displayed that shows all kills and the playing time, asking the player to exit the current game, continue, or view the replay. Launching a satellite also places 1000 [[space science pack]]s in the rocket result inventory.

However, launching the silo without the satellite is sadly pointless, as it won't count as a win, and will be a massive waste of resources. More resources will be needed to make another rocket.

Building a silo requires, among other things, [[electric engine unit]]s, [[engine unit]]s, and [[processing unit]]s, which must be produced in [[assembling machine]]s and cannot be crafted by hand from raw materials. The rocket itself can also only be produced in the silo.

The rocket silo result inventory can hold up to one stack of space science packs (2000). When receiving science packs from a launched satellite, the game discards all space science packs that exceed the capacity of the rocket result inventory. The "Auto launch with cargo" checkbox does '''not''' check if the rocket result inventory can hold the expected space science packs, this has to be manually ensured by the player, for example through the [[circuit network]].

== Timings ==

The time for a rocket launch is 2475 [[game-tick]]s, or 41.25 seconds. That is the time from a rocket is finished to production on the next rocket can start.

It is not affected by any modules or beacons, which can be important to take into account if you plan to launch rockets quickly. E.g. to launch one rocket per minute using a single rocket silo, you can only produce rocket parts in it for 60 - 41.25 = 18.75 seconds, which means you need a lot of speed modules for the silo. If you instead use two silos, you have 60 - (41.25/2) = 39.375 seconds - i.e. more than twice the time - to produce each rocket. That since each silo is only "inactive" for 41.25 seconds every two minutes instead of one.

Note that to be really accurate you also need to add the [[Inserters#Inserter_speed|time for an inserter]] to insert the satellite into the rocket.

== Achievements ==

The rocket silo, which is used to win the game, is directly connected to the following game win based achievements:
{{Achievement|smoke-me-a-kipper-i-will-be-back-for-breakfast}}
{{Achievement|no-time-for-chitchat}}
{{Achievement|there-is-no-spoon}}
{{Achievement|raining-bullets}}
{{Achievement|steam-all-the-way}}
{{Achievement|logistic-network-embargo}}
{{Achievement|so-long-and-thanks-for-all-the-fish}}

== History ==

{{history|0.13.9|
* Rocket parts from building rockets in the silo now show in production statistics.}}

{{history|0.12.7|
* Updated icon.}}

{{history|0.12.4|
* Rocket silo now behaves correctly when out of electricity.}}

{{history|0.12.0|
* Introduced}}

== See also ==
* [[Satellite]]

{{CombatNav}}
{{C|Defense}}

Inserters

2018-04-02T16:10:17Z

Ignatio: Update section explaining chest-to-belt throughput for compression changes in 0.16.

{{Languages}}
''For the common yellow electrical inserter, see [[Inserter]].''

'''Inserters''' are devices which are used to move items over short distances. When placed, they have a fixed direction. They can move items from behind and place them in front of them. By doing this, they can move items from one transport belt to another, but also extract items from—and insert items into—machines or storage devices.

== Types of inserters ==

{| class="wikitable"
| {{Imagelink|Burner inserter}} || The only [[fuel]]-powered inserter.
|-
| {{Imagelink|Inserter}} || The standard electrical inserter.
|-
| {{Imagelink|Long handed inserter}} || Capable of inserting and removing items from a greater distance.
|-
| {{Imagelink|Fast inserter}} || Much faster than the inserter.
|-
| {{Imagelink|Filter inserter}} || Variant of the fast inserter that can filter items by type.
|-
| {{Imagelink|Stack inserter}} || As fast as the fast inserter but can move many more items at the same time.
|-
| {{imagelink|Stack filter inserter}} || Variant of the stack inserter that can filter items by type.
|-
|}

==Mechanics==
Inserters '''will''':
* Pick up items off the ground, off of a [[Transport belts|Transport belt]], or from any object that has storage space, including [[Chests|chests]], [[furnace]]s and [[assembling machine]]s.
* Place the item onto the ground, onto a transport belt, or into any object that has storage space.
* Run at slower speeds when starved for energy.
* Pick up as many items as their [[inserter capacity bonus (research)|stack size]] allows at once, if they do not have to wait too long to pick them up.

Inserters '''will not''':
* Pick up any items that can not be inserted into the adjacent entity.
* Pick up items to place into an entity with a full inventory.
* Place more than one item at a time onto the same ground tile.
* Place items into an entity that can not hold them, for example due to [[Stack#Filtered_stacks|filtered]] or [[Stack#Stack_limitation|limited slots]].
* Fill up the entire target inventory of [[boiler]]s, [[nuclear reactor]]s, [[Category:Producers|production building]]s, [[furnace]]s, and [[turret]]s.

If two or more inserters are picking up from the same tile, the inserter who can grab the items the fastest will grab them first. Besides faster inserters, this favors inserters taking from the inner lane of a transport belt.

=== Insertion limits ===
Depending on where an inserter is moving items, it does not always fill up the entire target inventory. This allows other inserters taking from the same transport belt to pick up their share of the items. For example, if a boiler has 5 or more items of fuel in it, an inserter will not insert additional fuel. This allows the other fuel to travel further down the transport belt. When the fuel drops below 5 items, the inserter will resume inserting fuel, up to the limit of 5 items.

{| class="wikitable"
! Entity !! Item type !! Automatic insertion limit
|-
| [[Boiler]]s, [[burner inserter]]s, [[furnace]]s, and [[nuclear reactor]]s || [[Fuel]] || align="center" | 5
|-
| [[Gun turret]]s || Bullet Magazines || align="center" | 10
|-
| [[Artillery turret]]s || [[Artillery shell]]s || align="center" | 5
|-
| [[Assembling machine]]s, [[furnace]]s, [[centrifuge]]s, [[chemical plant]]s, and [[Oil refinery|oil refineries]]|| Items needed for the recipe || The ingredients for 1 craft additionally to ingredients for the number of crafts that can complete during one full inserter swing; but at least the ingredients for 2 crafts and at most the ingredients for 100 crafts.
|-
| [[Lab]]s || [[Science pack]]s || Double the number of science packs needed for one research unit.
|}

An inserter that has a higher [[inserter capacity bonus (research)|inserter capacity bonus]] than 1 can overfill the target building, due to the inserter picking up a higher amount of items than needed. Overfilling can also occur if multiple inserters are used to insert items into one building.

=== Inserters and transport belts ===
[[Transport belts]] have two lanes on which items can travel. Inserters only place items onto one side of the belt, either the far side from the inserter's perspective or if the belt is going the same or the opposite direction as the inserter the right side from the belt's perspective.

{|
| style="width:320px;" | [[File:Inserter_dropoff_locations.gif]] || [[File:Inserter_pickup_locations.gif]]
|-
| style="width:320px;" | Inserters place the item on the furthest lane. If a belt is in the same orientation as the inserter, the item will be placed on the right-hand lane, from the belt's perspective. If the item is placed on a corner piece, it will be put on the inside of the curve, regardless of orientation.
| style="width:320px;" | Inserters '''prefer''' taking items from the nearest lane. If the nearest lane is empty, the inserter will take from the far lane. If a belt is in the same orientation as the inserter, the inserter '''prefers''' taking from the left lane, from the belt's perspective. If the left lane is empty it will take from the right lane.
|}

=== Potential issues ===
Inserters may have problems picking up items:

* From very fast belts, because the items are moving too quickly.
* From the entry or exit of an underground belt (because the time they have to pick up is shorter)
* From turning belts if the item is on the inside of the corner

== Power usage ==
* Electric inserters drain energy even when they are not moving, as idle power
* The amount of energy used is the same for every turn
* The [[burner inserter]] does not drain energy when idle, but uses more energy when it is active.

== Inserter speed ==

{| class="wikitable"
! Type
! Rotation-speed (turns per [[Game-tick]]) Extension-speed ([[Tile]]s per Tick)
! Turns per [[Game-second]] Tiles per Game-second
! Game-second per full turn Game-seconds per Tile
! Ticks per full turn Ticks per Tile
|- align="center"
| align="left"| {{Imagelink|Burner inserter|Burner inserter}} || 0.01 0.0214 || 0.59 1.284 || 1.7 0.833 || 102 76
|- align="center"
| align="left"| {{Imagelink|Inserter|Inserter}} || 0.014 0.03 || 0.83 1.8 || 1.2 0.56 || 72 54
|- align="center"
| align="left"| {{Imagelink|Long handed inserter|Long handed inserter}} || 0.02 0.0457 || 1.15 2.742 || 0.867 0.416 || 52 36
|- align="center"
| align="left"| {{Imagelink|Fast inserter|Fast inserter}} {{Imagelink|Stack inserter|Stack inserter}} {{imagelink|Stack_filter_inserter|Stack filter inserter}} || 0.04 0.07 || 2.31 4.2 || 0.433 0.238 || 26 24
|-
|}

===Rotation Speed===
Convention: 2π rad = 100% of a circle rotation = '''1 turn''' (or one full rotation).

Note: an Inserter doesn't always need to make full turns. When grabbing from a transport belt, it is slightly faster when grabbing items from the closest lane.

===Extension Speed===
The extension-speed is normally not visible (only when compared to other inserters), but there are measurable speed differences when taking - for example - from the near or the far side of a belt. Also Some mods can alter the pickup and drop locations of inserters, making this stat more relevant.

==Inserter Throughput==

The following is based on [https://docs.google.com/spreadsheets/d/1OzlP2v6P1OGxK1xCFr77aqVfNNEaEKHlA89aSVmqBGw/edit?usp=sharing experimental data] gathered in version 0.15.

Inserter throughput between chests and other [[stack|stacks]] is a simple function of stack size and arm speed:

<blockquote>
''n'' = Stack size

''t_arm'' = Time to move the arm back and forth

Time per item = ''t_arm'' / ''n''

Throughput (items/sec) = 1 / Time per item = ''n'' / ''t_arm''
</blockquote>

When moving items to or from belts, the time to pick up or put down items also becomes a factor:

<blockquote>
''t_item'' = Time to pick up or put down one item

''t_cycle'' = Time to complete an arm cycle = ''t_arm'' + ''n''*''t_item''

Time per item = ''t_cycle'' / ''n'' = ''t_item'' + ''t_arm'' / ''n''

Throughput (items/sec) = 1 / (''t_item'' + ''t_arm'' / ''n'')
</blockquote>

'''Note:''' [https://forums.factorio.com/viewtopic.php?t=9141#p280529 Before 0.15.14], inserters were 1-4% less efficient when moving items from south to north.

===Chest to chest===

{| class="wikitable"
! rowspan=2 | Type
! rowspan=2 | Arm cycles per second
! colspan=6 | Items/second at [[inserter capacity bonus (research)|capacity bonus]] level (stack size)
|-
! colspan=2 | No capacity bonus
! colspan=2 | Capacity bonus 2
! colspan=2 | Capacity bonus 7
|- align="center"
| align="left"| {{Imagelink|Burner inserter|Burner inserter}} || 0.59 || 0.59 || (1) || 1.18 || (2) || 1.76 || (3)
|- align="center"
| align="left"| {{Imagelink|Inserter|Inserter}} || 0.83 || 0.83 || (1) || 1.67 || (2) || 2.50 || (3)
|- align="center"
| align="left"| {{Imagelink|Long handed inserter|Long handed inserter}} || 1.15 || 1.15 || (1) || 2.31 || (2) || 3.46 || (3)
|- align="center"
| align="left"| {{Imagelink|Fast inserter|Fast inserter}} {{Imagelink|Filter inserter|Filter inserter}} || 2.31 || 2.31 || (1) || 4.62 || (2) || 6.93 || (3)
|- align="center"
| align="left"| {{Imagelink|Stack inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 2.31 || 4.62 || (2) || 9.23 || (4) || 27.70 || (12)
|-
|}

===Chest to belt===

Throughput going from chest to belt depends on how full the belt is. An inserter will not put down an item on a belt that have items back-to-back (aka full compression) - it waits until there is a gap. However, if the gap is narrower than the item then the items upstream on the belt will stop to make room for the item being inserted.

'''Note:''' [https://forums.factorio.com/viewtopic.php?t=57993 Before 0.16.25], inserters would not insert items if gaps were too narrow.

'''Note:''' [https://forums.factorio.com/viewtopic.php?t=54600 Before 0.16.0], underground entrances and exits made it easier for the inserter to put down an item on a belt that wasn't fully compressed.

In these measurements inserters move items onto an empty perpendicular belt. Values are given for the stack sizes at three different [[inserter capacity bonus (research)|capacity bonus]] levels.

{| class="wikitable"
! rowspan=3 | Type
! colspan=12 | Items/second at [[inserter capacity bonus (research)|capacity bonus]] level (stack size)
|-
! colspan=4 | No capacity bonus
! colspan=4 | Capacity bonus 2
! colspan=4 | Capacity bonus 7
|-
! [[File:Transport belt.png|link=Transport belt]] || [[File:Fast transport belt.png|link=Fast transport belt]] || [[File:Express transport belt.png|link=Express transport belt]] ||
! [[File:Transport belt.png|link=Transport belt]] || [[File:Fast transport belt.png|link=Fast transport belt]] || [[File:Express transport belt.png|link=Express transport belt]] ||
! [[File:Transport belt.png|link=Transport belt]] || [[File:Fast transport belt.png|link=Fast transport belt]] || [[File:Express transport belt.png|link=Express transport belt]] ||
|- align="center"
| align="left"| {{Imagelink|Burner inserter|Burner inserter}} || 0.59 || 0.59 || 0.59 || (1) || 1.10 || 1.13 || 1.14 || (2) || 1.53 || 1.62 || 1.67 || (3)
|- align="center"
| align="left"| {{Imagelink|Inserter|Inserter}} || 0.83 || 0.83 || 0.83 || (1) || 1.52 || 1.58 || 1.60 || (2) || 2.05 || 2.22 || 2.31 || (3)
|- align="center"
| align="left"| {{Imagelink|Long handed inserter|Long handed inserter}} || 1.15 || 1.15 || 1.15 || (1) || 2.03 || 2.14 || 2.18 || (2) || 2.65 || 2.95 || 3.10 || (3)
|- align="center"
| align="left"| {{Imagelink|Fast inserter|Fast inserter}} {{Imagelink|Filter inserter|Filter inserter}} || 2.31 || 2.31 || 2.31 || (1) || 3.64 || 4.00 || 4.14 || (2) || 4.29 || 5.14 || 5.63 || (3)
|- align="center"
| align="left"| {{Imagelink|Stack inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 3.64 || 4.00 || 4.14 || (2) || 4.71 || 6.15 || 6.86 || (4) || 5.90 || 9.60 || 12.20 || (12)
|-
|}

To calculate the throughput for [[Stack inserter]] and [[Stack filter inserter]] at any capacity level, you can use these linearly fitted factors with the belt/chest throughput formula above:

{| class="wikitable"
! rowspan=2 | Type
! colspan=2 | {{Imagelink|Transport belt|Transport belt}}
! colspan=2 | {{Imagelink|Fast transport belt|Fast transport belt}}
! colspan=2 | {{Imagelink|Express transport belt|Express transport belt}}
|-
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
|- align="center"
| align="left"| {{Imagelink|Stack inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 0.142 || 0.292 || 0.073 || 0.360 || 0.049 || 0.384
|-
|}

See the [https://docs.google.com/spreadsheets/d/1OzlP2v6P1OGxK1xCFr77aqVfNNEaEKHlA89aSVmqBGw/edit?usp=sharing source spreadsheet] for the corresponding factors for the other inserter types. Their errors are generally well below 1%.

===Belt to chest===

When picking items from a belt, many more factors come into play besides belt fullness:

* How fast the items move (i.e. if they are queued up on the belt or move at belt speed).
* Whether the belt is perpendicular to the inserter or approaches it head on.
* Whether items are on the near or far lane of a perpendicular belt.
* Whether the belt turns or not, and whether the items are in the inner or outer side of the bend.
* If the belt is an underground entrance or exit. This shortens the time items are visible to the inserter for pickup.
* All sorts of intricate timing factors between the inserter and the items on the belt, since the game simulates the arm homing in on every item.

The test setup used below is with an inserter taking items from a perpendicular belt with items on the far lane only. The belt is fully compressed and timings are both for items that move at full speed and queued up as much as possible. Values are given for the stack sizes at three different [[inserter capacity bonus (research)|capacity bonus]] levels.

{| class="wikitable"
! rowspan=4 | Type
! colspan=15 | Items/second at [[inserter capacity bonus (research)|capacity bonus]] level (stack size)
|-
! colspan=5 | No capacity bonus
! colspan=5 | Capacity bonus 2
! colspan=5 | Capacity bonus 7
|-
! colspan=3 | Items at belt speed
! rowspan=2 | Items queued up
! rowspan=2 |
! colspan=3 | Items at belt speed
! rowspan=2 | Items queued up
! rowspan=2 |
! colspan=3 | Items at belt speed
! rowspan=2 | Items queued up
! rowspan=2 |
|-
! [[File:Transport belt.png|link=Transport belt]] || [[File:Fast transport belt.png|link=Fast transport belt]] || [[File:Express transport belt.png|link=Express transport belt]]
! [[File:Transport belt.png|link=Transport belt]] || [[File:Fast transport belt.png|link=Fast transport belt]] || [[File:Express transport belt.png|link=Express transport belt]]
! [[File:Transport belt.png|link=Transport belt]] || [[File:Fast transport belt.png|link=Fast transport belt]] || [[File:Express transport belt.png|link=Express transport belt]]
|- align="center"
| align="left"| {{Imagelink|Burner inserter|Burner inserter}} || '''0.56''' || '''0.56''' || 0.51 || 0.65 || (1) || '''1.11''' || 1.07 || 0.98 || 1.18 || (2) || 1.43 || '''1.54''' || 1.43 || 1.75 || (3)
|- align="center"
| align="left"| {{Imagelink|Inserter|Inserter}} || '''0.83''' || 0.74 || 0.77 || 0.90 || (1) || '''1.57''' || 1.48 || 1.45 || 1.62 || (2) || 2.00 || '''2.11''' || 2.07 || 2.40 || (3)
|- align="center"
| align="left"| {{Imagelink|Long handed inserter|Long handed inserter}} || '''1.16''' || 1.11 || 1.11 || 1.22 || (1) || 2.22 || '''2.22''' || 2.11 || 2.31 || (2) || 3.08 || 3.08 || '''3.16''' || 3.33 || (3)
|- align="center"
| align="left"| {{Imagelink|Fast inserter|Fast inserter}} {{Imagelink|Filter inserter|Filter inserter}} || '''2.22''' || '''2.22''' || 2.14 || 2.40 || (1) || '''4.17''' || 3.81 || 4.00 || 4.29 || (2) || '''5.71''' || 5.45 || 5.46 || 6.21 || (3)
|- align="center"
| align="left"| {{Imagelink|Stack inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || '''4.17''' || 3.81 || 4.00 || 4.29 || (2) || '''6.67''' || '''6.67''' || 6.15 || 6.67 / 7.50 / 7.74 * || (4) || 6.67 || 10.00 || '''12.00''' || 6.67 / 11.61 / 13.58 * || (12)
|-
|}

<nowiki>*)</nowiki> Throughput for basic/fast/express belt.

Since there are many more factors involved, these measurements exhibit a more complex pattern than chest-to-belt.

* Boldface cells show for which belt each inserter has the best throughput on each bonus level when items move at belt speed. Higher speed belts mean that inserters have to work harder to catch the fast moving items. The effect is most noticeable for slower inserters and smaller stack sizes.
* When items are queued up the belt type hardly matters, so there is only a single column for that. The exceptions are the stack inserters - for basic transport belts it's the belt that sets the limit for stack sizes above 4, and there is also a notable difference between fast and express belts.

Here are linearly fitted factors to get the [[Stack inserter]] and [[Stack filter inserter]] throughput at any capacity level, by using the belt/chest throughput formula above:

{| class="wikitable"
! rowspan=2 | Type
! colspan=2 | {{Imagelink|Transport belt|Transport belt}}
! colspan=2 | {{Imagelink|Fast transport belt|Fast transport belt}}
! colspan=2 | {{Imagelink|Express transport belt|Express transport belt}}
|-
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
|- align="center"
| align="left"| {{Imagelink|Stack inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 0.045* || 0.403* || 0.063 || 0.387 || 0.049 || 0.416
|-
|}

<nowiki>*)</nowiki> Since the belt is the limiting factor above stack size 4, these figures are only accurate up to that size. More than that and the throughput is fixed at 6.67 items per second.

==See Also==
* [[Electric system]]
* [[Belt transport system]]
* [[Inserter capacity bonus (research)]]: Inserter moves more than an item per turn.

{{C|Inserters}}

Inserters

2017-09-30T14:21:33Z

Ignatio: Remove reference to inserter orientation which isn't a factor any more

{{Languages}}
''For the common yellow electrical inserter, see [[Inserter]].''

'''Inserters''' are devices which are used to move items over short distances. When placed, they have a fixed direction. They can move items from behind and place them in front of them. By doing this, they can move items from one transport belt to another, but also extract items from, and insert items into machines or storage devices. There are seven types of inserters, all requiring electricity to run (except the Burner Inserter, which burns [[Fuel|fuel]]).

== Types Of Inserters ==

{| class="wikitable"
| {{Imagelink|Burner inserter|Burner inserter}} || The only [[fuel]]-powered inserter.
|-
| {{Imagelink|Inserter|Inserter}} || The standard electrical inserter.
|-
| {{Imagelink|Long handed inserter|Long handed inserter}} || Capable of inserting and removing items from a greater distance.
|-
| {{Imagelink|Fast inserter|Fast inserter}} || Much faster than the Basic inserter.
|-
| {{imagelink|filter-inserter|Filter inserter}} || Variant of the Fast inserter that can filter items by type.
|-
| {{imagelink|stack-inserter|Stack inserter}} || As fast as the Fast inserter but can move many more items at the same time.
|-
| {{imagelink|stack_filter_inserter|Stack filter inserter}} || Variant of the Stack inserter that can filter items by type.
|-
|}

==Mechanics==
Inserters '''will''':
* '''Pick up''' Items off the ground, off of a [[Transport belts|Transport belt]], or from any object that has storage space, including [[Chests|chests]], [[furnace]]s and [[assembling machine]]s.
* '''Place''' the item onto the ground, onto a transport belt, or into any object that has storage space.
* Run at slower speeds when starved for energy.

Inserters will '''not''':
* Pick up any items that can not be inserted into the connected entity.
* Pick up items into an entity with a full inventory.
* Place more than one item at a time onto the same ground tile.
* Place items into a stack limited inventory, beyond the stack limit (red slots).

Inserters act differently depending on what they are moving items to/into so as not to monopolize all of the items being picked up. This allows other machines and inserters on the same transport belt to pick up a share of the items. If two inserters are picking up from the same tile, the first placed inserter has priority.

==Insertion Limits==
Inserters will stop inserting items into certain buildings if they already have enough of that item. For example, if a boiler has 5 or more items of fuel in it, an inserter will not insert additional fuel. When the fuel drops below 5 items, the inserter will continue to insert more fuel, up to the limit of 5 items.

This is to allow for all machines to receive their share of items. The common limits on insertion are shown in the table below.

{| class="wikitable"
! Entity !! Item type !! Inserter limit !! Comment
|-
| [[Boiler]]s, [[Burner inserter]]s, [[Furnace]]s || [[Fuel]] || align="center" | 5 ||
|-
| [[Gun turret]]s || Bullet Magazines || align="center" | 10 || Since v0.8.4. Allows for 100 shots before depleting.
|-
| [[Assembling machine]]s || Items needed for the recipe || Double the number of items needed in the recipe ||
|-
| [[Furnace]]s || Items needed for the recipe || Double the number of items needed in the recipe ||
|-
| [[Lab]]s || [[Science pack]]s || Double the number of items needed for one research point ||
|}

An inserter that takes items from an object containing [[Stack|stacks]] of items (such as a chest) can overfill the target building due to the [[Inserter capacity bonus (research)]] research. Overfilling can also happen if multiple inserters are used to insert items into one building.

==Inserters And Transport Belt Interaction ==
[[Transport belts]] have two lanes on which items can travel. Inserters only place items onto one side of the belt. Which side they place it on depends on the orientation of the inserter and the belt, as described below.

<div><ul>
<li style="display:inline-block;">
{|
| style="width:300px;height:345px;" | [[File:PlaceOnFarSide.gif]]
|-
| Inserters will '''always''' place the item on the furthest lane.
|} </li>
<li style="display: inline-block;">
{|
| style="width:300px;" | [[File:TakeFromNearSide.gif]]
|-
| Inserters '''prefer''' taking items from the nearest lane. If the nearest lane is empty, the inserter will take from the far lane.
|}
</li><li style="display: inline-block;">
{|
| style="width:300px;" | [[File:PlaceOnRightSide.gif]]
|-
| If a belt is in the same orientation as the inserter, the item will be placed on the right-hand lane, from the belt's perspective.
|}
</li><li style="display: inline-block;">
{|
| style="width:300px;" | [[File:PlaceOnInsideOfCorner.gif]]
|-
| If the item is placed on a corner piece, it will be put on the inside of the curve, regardless of orientation.
|} </li>
</ul></div>

== Potential Issues ==
Inserters may have problems picking up items:

* From very fast belts, because the items are moving too quickly.
* From the entry or exit of an underground belt (because the time they have to pick up is shorter)
* From turning belts if the item is on the inside of the corner

==Inserter Item Stack Size Bonus==

If an inserter moves items from inventory to inventory (for example from an assembler into a chest), or (as of v0.13) from an inventory to a belt, it is able to transport more items at once. The secret behind this is the [[Inserter capacity bonus (research)]] research.

==Power Usage==
* Electric inserters drain energy even when they are not moving, as idle power
* The amount of energy used is the same for every movement
* The [[Burner inserter]] does not drain energy when idle, but uses more energy when it is active. It is quite useful for situations where the inserter does not need to move very often.

==Inserter Speed==

{| class="wikitable"
! Type
! Rotation-speed (turns per [[Game-tick]]) Extension-speed ([[Tile]]s per Tick)
! Turns per [[Game-second]] Tiles per Game-second
! Game-second per full turn Game-seconds per Tile
! Ticks per full turn Ticks per Tile
|- align="center"
| align="left"| {{Imagelink|Burner inserter|Burner inserter}} || 0.01 0.0214 || 0.6 1.284 || 1.667 0.833 || 102 76
|- align="center"
| align="left"| {{Imagelink|Inserter|Inserter}} || 0.014 0.03 || 0.84 1.8 || 1.191 0.56 || 72 54
|- align="center"
| align="left"| {{Imagelink|Long handed inserter|Long handed inserter}} || 0.02 0.0457 || 1.2 2.742 || 0.833 0.416 || 52 36
|- align="center"
| align="left"| {{Imagelink|Fast inserter|Fast inserter}} {{imagelink|stack-inserter|Stack inserter}} {{imagelink|Stack_filter_inserter|Stack filter inserter}} || 0.04 0.07 || 2.4 4.2 || 0.417 0.238 || 26 24
|-
|}

===Rotation Speed===
Convention: 2π rad = 100% of a circle rotation = '''1 turn''' (or one full rotation).

Note: an Inserter doesn't always need to make full turns. When grabbing from a transport belt, it is slightly faster when grabbing items from the closest lane.

===Extension Speed===
The extension-speed is normally not visible (only when compared to other inserters), but there are measurable speed differences when taking - for example - from the near or the far side of a belt. Also Some mods can alter the pickup and drop locations of inserters, making this stat more relevant.

==Inserter Throughput==

The following is based on [https://docs.google.com/spreadsheets/d/1OzlP2v6P1OGxK1xCFr77aqVfNNEaEKHlA89aSVmqBGw/edit?usp=sharing experimental data] gathered in version 0.15.

Inserter throughput between chests and other [[stack|stacks]] is a simple function of stack size and arm speed:

<blockquote>
''n'' = Stack size

''t_arm'' = Time to move the arm back and forth

Time per item = ''t_arm'' / ''n''

Throughput (items/sec) = 1 / Time per item = ''n'' / ''t_arm''
</blockquote>

When moving items to or from belts, the time to pick up or put down items also becomes a factor:

<blockquote>
''t_item'' = Time to pick up or put down one item

''t_cycle'' = Time to complete an arm cycle = ''t_arm'' + ''n''*''t_item''

Time per item = ''t_cycle'' / ''n'' = ''t_item'' + ''t_arm'' / ''n''

Throughput (items/sec) = 1 / (''t_item'' + ''t_arm'' / ''n'')
</blockquote>

'''Note:''' [https://forums.factorio.com/viewtopic.php?t=9141#p280529 Before 0.15.14], inserters were 1-4% less efficient when moving items from south to north.

===Chest to chest===

{| class="wikitable"
! rowspan=2 | Type
! rowspan=2 | Arm cycles per second
! colspan=6 | Items/second at [[inserter capacity bonus (research)|capacity bonus]] level (stack size)
|-
! colspan=2 | No capacity bonus
! colspan=2 | Capacity bonus 2
! colspan=2 | Capacity bonus 7
|- align="center"
| align="left"| {{Imagelink|Burner inserter|Burner inserter}} || 0.59 || 0.59 || (1) || 1.18 || (2) || 1.76 || (3)
|- align="center"
| align="left"| {{Imagelink|Inserter|Inserter}} || 0.83 || 0.83 || (1) || 1.67 || (2) || 2.50 || (3)
|- align="center"
| align="left"| {{Imagelink|Long handed inserter|Long handed inserter}} || 1.15 || 1.15 || (1) || 2.31 || (2) || 3.46 || (3)
|- align="center"
| align="left"| {{Imagelink|Fast inserter|Fast inserter}} {{imagelink|filter-inserter|Filter inserter}} || 2.31 || 2.31 || (1) || 4.62 || (2) || 6.93 || (3)
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 2.31 || 4.62 || (2) || 9.23 || (4) || 27.70 || (12)
|-
|}

===Chest to belt===

Throughput going from chest to belt depends on how full the belt is and how the items are spaced, i.e. if spaces are large enough to fill with items. Underground entrances and exits also makes it easier for the inserter to put down an item.

In these measurements inserters move items onto an empty perpendicular belt. Values are given for the stack sizes at three different [[inserter capacity bonus (research)|capacity bonus]] levels.

{| class="wikitable"
! rowspan=3 | Type
! colspan=12 | Items/second at [[inserter capacity bonus (research)|capacity bonus]] level (stack size)
|-
! colspan=4 | No capacity bonus
! colspan=4 | Capacity bonus 2
! colspan=4 | Capacity bonus 7
|-
! [[File:Transport belt.png|link=Transport belt]] || [[File:Fast transport belt.png|link=Fast transport belt]] || [[File:Express transport belt.png|link=Express transport belt]] ||
! [[File:Transport belt.png|link=Transport belt]] || [[File:Fast transport belt.png|link=Fast transport belt]] || [[File:Express transport belt.png|link=Express transport belt]] ||
! [[File:Transport belt.png|link=Transport belt]] || [[File:Fast transport belt.png|link=Fast transport belt]] || [[File:Express transport belt.png|link=Express transport belt]] ||
|- align="center"
| align="left"| {{Imagelink|Burner inserter|Burner inserter}} || 0.59 || 0.59 || 0.59 || (1) || 1.10 || 1.13 || 1.14 || (2) || 1.53 || 1.62 || 1.67 || (3)
|- align="center"
| align="left"| {{Imagelink|Inserter|Inserter}} || 0.83 || 0.83 || 0.83 || (1) || 1.52 || 1.58 || 1.60 || (2) || 2.05 || 2.22 || 2.31 || (3)
|- align="center"
| align="left"| {{Imagelink|Long handed inserter|Long handed inserter}} || 1.15 || 1.15 || 1.15 || (1) || 2.03 || 2.14 || 2.18 || (2) || 2.65 || 2.95 || 3.10 || (3)
|- align="center"
| align="left"| {{Imagelink|Fast inserter|Fast inserter}} {{imagelink|filter-inserter|Filter inserter}} || 2.31 || 2.31 || 2.31 || (1) || 3.64 || 4.00 || 4.14 || (2) || 4.29 || 5.14 || 5.63 || (3)
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 3.64 || 4.00 || 4.14 || (2) || 4.71 || 6.15 || 6.86 || (4) || 5.90 || 9.60 || 12.20 || (12)
|-
|}

To calculate the throughput for [[Stack inserter]] and [[Stack filter inserter]] at any capacity level, you can use these linearly fitted factors with the belt/chest throughput formula above:

{| class="wikitable"
! rowspan=2 | Type
! colspan=2 | {{Imagelink|Transport belt|Transport belt}}
! colspan=2 | {{Imagelink|Fast transport belt|Fast transport belt}}
! colspan=2 | {{Imagelink|Express transport belt|Express transport belt}}
|-
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 0.142 || 0.292 || 0.073 || 0.360 || 0.049 || 0.384
|-
|}

See the [https://docs.google.com/spreadsheets/d/1OzlP2v6P1OGxK1xCFr77aqVfNNEaEKHlA89aSVmqBGw/edit?usp=sharing source spreadsheet] for the corresponding factors for the other inserter types. Their errors are generally well below 1%.

===Belt to chest===

When picking items from a belt, many more factors come into play besides belt fullness:

* How fast the items move (i.e. if they are queued up on the belt or move at belt speed).
* Whether the belt is perpendicular to the inserter or approaches it head on.
* Whether items are on the near or far lane of a perpendicular belt.
* Whether the belt turns or not, and whether the items are in the inner or outer side of the bend.
* If the belt is an underground entrance or exit. This shortens the time items are visible to the inserter for pickup.
* All sorts of intricate timing factors between the inserter and the items on the belt, since the game simulates the arm homing in on every item.

The test setup used below is with an inserter taking items from a perpendicular belt with items on the far lane only. The belt is fully compressed and timings are both for items that move at full speed and queued up as much as possible. Values are given for the stack sizes at three different [[inserter capacity bonus (research)|capacity bonus]] levels.

{| class="wikitable"
! rowspan=4 | Type
! colspan=15 | Items/second at [[inserter capacity bonus (research)|capacity bonus]] level (stack size)
|-
! colspan=5 | No capacity bonus
! colspan=5 | Capacity bonus 2
! colspan=5 | Capacity bonus 7
|-
! colspan=3 | Items at belt speed
! rowspan=2 | Items queued up
! rowspan=2 |
! colspan=3 | Items at belt speed
! rowspan=2 | Items queued up
! rowspan=2 |
! colspan=3 | Items at belt speed
! rowspan=2 | Items queued up
! rowspan=2 |
|-
! [[File:Transport belt.png|link=Transport belt]] || [[File:Fast transport belt.png|link=Fast transport belt]] || [[File:Express transport belt.png|link=Express transport belt]]
! [[File:Transport belt.png|link=Transport belt]] || [[File:Fast transport belt.png|link=Fast transport belt]] || [[File:Express transport belt.png|link=Express transport belt]]
! [[File:Transport belt.png|link=Transport belt]] || [[File:Fast transport belt.png|link=Fast transport belt]] || [[File:Express transport belt.png|link=Express transport belt]]
|- align="center"
| align="left"| {{Imagelink|Burner inserter|Burner inserter}} || '''0.56''' || '''0.56''' || 0.51 || 0.65 || (1) || '''1.11''' || 1.07 || 0.98 || 1.18 || (2) || 1.43 || '''1.54''' || 1.43 || 1.75 || (3)
|- align="center"
| align="left"| {{Imagelink|Inserter|Inserter}} || '''0.83''' || 0.74 || 0.77 || 0.90 || (1) || '''1.57''' || 1.48 || 1.45 || 1.62 || (2) || 2.00 || '''2.11''' || 2.07 || 2.40 || (3)
|- align="center"
| align="left"| {{Imagelink|Long handed inserter|Long handed inserter}} || '''1.16''' || 1.11 || 1.11 || 1.22 || (1) || 2.22 || '''2.22''' || 2.11 || 2.31 || (2) || 3.08 || 3.08 || '''3.16''' || 3.33 || (3)
|- align="center"
| align="left"| {{Imagelink|Fast inserter|Fast inserter}} {{imagelink|filter-inserter|Filter inserter}} || '''2.22''' || '''2.22''' || 2.14 || 2.40 || (1) || '''4.17''' || 3.81 || 4.00 || 4.29 || (2) || '''5.71''' || 5.45 || 5.46 || 6.21 || (3)
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || '''4.17''' || 3.81 || 4.00 || 4.29 || (2) || '''6.67''' || '''6.67''' || 6.15 || 6.67 / 7.50 / 7.74 * || (4) || 6.67 || 10.00 || '''12.00''' || 6.67 / 11.61 / 13.58 * || (12)
|-
|}

<nowiki>*)</nowiki> Throughput for basic/fast/express belt.

Since there are many more factors involved, these measurements exhibit a more complex pattern than chest-to-belt.

* Boldface cells show for which belt each inserter has the best throughput on each bonus level when items move at belt speed. Higher speed belts mean that inserters have to work harder to catch the fast moving items. The effect is most noticeable for slower inserters and smaller stack sizes.
* When items are queued up the belt type hardly matters, so there is only a single column for that. The exceptions are the stack inserters - for basic transport belts it's the belt that sets the limit for stack sizes above 4, and there is also a notable difference between fast and express belts.

Here are linearly fitted factors to get the [[Stack inserter]] and [[Stack filter inserter]] throughput at any capacity level, by using the belt/chest throughput formula above:

{| class="wikitable"
! rowspan=2 | Type
! colspan=2 | {{Imagelink|Transport belt|Transport belt}}
! colspan=2 | {{Imagelink|Fast transport belt|Fast transport belt}}
! colspan=2 | {{Imagelink|Express transport belt|Express transport belt}}
|-
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 0.045* || 0.403* || 0.063 || 0.387 || 0.049 || 0.416
|-
|}

<nowiki>*)</nowiki> Since the belt is the limiting factor above stack size 4, these figures are only accurate up to that size. More than that and the throughput is fixed at 6.67 items per second.

==See Also==
* [[Electric network]]
* [[Transport network]]
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=5253 Inserter Power Efficiency]: Movements per energy and exact power usage numbers. See also [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=6258 this thread], where energy per movement is explained.
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=5400 Small Inserter Test]: Comparison if energy usage per item.
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=5524 Inserter heartbeats]: In some situations it is not possible to calculate the needed power usage.
===Special behavior===
* [[Inserter capacity bonus (research)]]: Inserter moves more than an item per turn.

{{C|Inserters}}

Inserters

2017-09-30T14:15:46Z

Ignatio: Small grammar fix

{{Languages}}
''For the common yellow electrical inserter, see [[Inserter]].''

'''Inserters''' are devices which are used to move items over short distances. When placed, they have a fixed direction. They can move items from behind and place them in front of them. By doing this, they can move items from one transport belt to another, but also extract items from, and insert items into machines or storage devices. There are seven types of inserters, all requiring electricity to run (except the Burner Inserter, which burns [[Fuel|fuel]]).

== Types Of Inserters ==

{| class="wikitable"
| {{Imagelink|Burner inserter|Burner inserter}} || The only [[fuel]]-powered inserter.
|-
| {{Imagelink|Inserter|Inserter}} || The standard electrical inserter.
|-
| {{Imagelink|Long handed inserter|Long handed inserter}} || Capable of inserting and removing items from a greater distance.
|-
| {{Imagelink|Fast inserter|Fast inserter}} || Much faster than the Basic inserter.
|-
| {{imagelink|filter-inserter|Filter inserter}} || Variant of the Fast inserter that can filter items by type.
|-
| {{imagelink|stack-inserter|Stack inserter}} || As fast as the Fast inserter but can move many more items at the same time.
|-
| {{imagelink|stack_filter_inserter|Stack filter inserter}} || Variant of the Stack inserter that can filter items by type.
|-
|}

==Mechanics==
Inserters '''will''':
* '''Pick up''' Items off the ground, off of a [[Transport belts|Transport belt]], or from any object that has storage space, including [[Chests|chests]], [[furnace]]s and [[assembling machine]]s.
* '''Place''' the item onto the ground, onto a transport belt, or into any object that has storage space.
* Run at slower speeds when starved for energy.

Inserters will '''not''':
* Pick up any items that can not be inserted into the connected entity.
* Pick up items into an entity with a full inventory.
* Place more than one item at a time onto the same ground tile.
* Place items into a stack limited inventory, beyond the stack limit (red slots).

Inserters act differently depending on what they are moving items to/into so as not to monopolize all of the items being picked up. This allows other machines and inserters on the same transport belt to pick up a share of the items. If two inserters are picking up from the same tile, the first placed inserter has priority.

==Insertion Limits==
Inserters will stop inserting items into certain buildings if they already have enough of that item. For example, if a boiler has 5 or more items of fuel in it, an inserter will not insert additional fuel. When the fuel drops below 5 items, the inserter will continue to insert more fuel, up to the limit of 5 items.

This is to allow for all machines to receive their share of items. The common limits on insertion are shown in the table below.

{| class="wikitable"
! Entity !! Item type !! Inserter limit !! Comment
|-
| [[Boiler]]s, [[Burner inserter]]s, [[Furnace]]s || [[Fuel]] || align="center" | 5 ||
|-
| [[Gun turret]]s || Bullet Magazines || align="center" | 10 || Since v0.8.4. Allows for 100 shots before depleting.
|-
| [[Assembling machine]]s || Items needed for the recipe || Double the number of items needed in the recipe ||
|-
| [[Furnace]]s || Items needed for the recipe || Double the number of items needed in the recipe ||
|-
| [[Lab]]s || [[Science pack]]s || Double the number of items needed for one research point ||
|}

An inserter that takes items from an object containing [[Stack|stacks]] of items (such as a chest) can overfill the target building due to the [[Inserter capacity bonus (research)]] research. Overfilling can also happen if multiple inserters are used to insert items into one building.

==Inserters And Transport Belt Interaction ==
[[Transport belts]] have two lanes on which items can travel. Inserters only place items onto one side of the belt. Which side they place it on depends on the orientation of the inserter and the belt, as described below.

<div><ul>
<li style="display:inline-block;">
{|
| style="width:300px;height:345px;" | [[File:PlaceOnFarSide.gif]]
|-
| Inserters will '''always''' place the item on the furthest lane.
|} </li>
<li style="display: inline-block;">
{|
| style="width:300px;" | [[File:TakeFromNearSide.gif]]
|-
| Inserters '''prefer''' taking items from the nearest lane. If the nearest lane is empty, the inserter will take from the far lane.
|}
</li><li style="display: inline-block;">
{|
| style="width:300px;" | [[File:PlaceOnRightSide.gif]]
|-
| If a belt is in the same orientation as the inserter, the item will be placed on the right-hand lane, from the belt's perspective.
|}
</li><li style="display: inline-block;">
{|
| style="width:300px;" | [[File:PlaceOnInsideOfCorner.gif]]
|-
| If the item is placed on a corner piece, it will be put on the inside of the curve, regardless of orientation.
|} </li>
</ul></div>

== Potential Issues ==
Inserters may have problems picking up items:

* From very fast belts, because the items are moving too quickly.
* From the entry or exit of an underground belt (because the time they have to pick up is shorter)
* From turning belts if the item is on the inside of the corner

==Inserter Item Stack Size Bonus==

If an inserter moves items from inventory to inventory (for example from an assembler into a chest), or (as of v0.13) from an inventory to a belt, it is able to transport more items at once. The secret behind this is the [[Inserter capacity bonus (research)]] research.

==Power Usage==
* Electric inserters drain energy even when they are not moving, as idle power
* The amount of energy used is the same for every movement
* The [[Burner inserter]] does not drain energy when idle, but uses more energy when it is active. It is quite useful for situations where the inserter does not need to move very often.

==Inserter Speed==

{| class="wikitable"
! Type
! Rotation-speed (turns per [[Game-tick]]) Extension-speed ([[Tile]]s per Tick)
! Turns per [[Game-second]] Tiles per Game-second
! Game-second per full turn Game-seconds per Tile
! Ticks per full turn Ticks per Tile
|- align="center"
| align="left"| {{Imagelink|Burner inserter|Burner inserter}} || 0.01 0.0214 || 0.6 1.284 || 1.667 0.833 || 102 76
|- align="center"
| align="left"| {{Imagelink|Inserter|Inserter}} || 0.014 0.03 || 0.84 1.8 || 1.191 0.56 || 72 54
|- align="center"
| align="left"| {{Imagelink|Long handed inserter|Long handed inserter}} || 0.02 0.0457 || 1.2 2.742 || 0.833 0.416 || 52 36
|- align="center"
| align="left"| {{Imagelink|Fast inserter|Fast inserter}} {{imagelink|stack-inserter|Stack inserter}} {{imagelink|Stack_filter_inserter|Stack filter inserter}} || 0.04 0.07 || 2.4 4.2 || 0.417 0.238 || 26 24
|-
|}

===Rotation Speed===
Convention: 2π rad = 100% of a circle rotation = '''1 turn''' (or one full rotation).

Note: an Inserter doesn't always need to make full turns. When grabbing from a transport belt, it is slightly faster when grabbing items from the closest lane.

===Extension Speed===
The extension-speed is normally not visible (only when compared to other inserters), but there are measurable speed differences when taking - for example - from the near or the far side of a belt. Also Some mods can alter the pickup and drop locations of inserters, making this stat more relevant.

==Inserter Throughput==

The following is based on [https://docs.google.com/spreadsheets/d/1OzlP2v6P1OGxK1xCFr77aqVfNNEaEKHlA89aSVmqBGw/edit?usp=sharing experimental data] gathered in version 0.15.

Inserter throughput between chests and other [[stack|stacks]] is a simple function of stack size and arm speed:

<blockquote>
''n'' = Stack size

''t_arm'' = Time to move the arm back and forth

Time per item = ''t_arm'' / ''n''

Throughput (items/sec) = 1 / Time per item = ''n'' / ''t_arm''
</blockquote>

When moving items to or from belts, the time to pick up or put down items also becomes a factor:

<blockquote>
''t_item'' = Time to pick up or put down one item

''t_cycle'' = Time to complete an arm cycle = ''t_arm'' + ''n''*''t_item''

Time per item = ''t_cycle'' / ''n'' = ''t_item'' + ''t_arm'' / ''n''

Throughput (items/sec) = 1 / (''t_item'' + ''t_arm'' / ''n'')
</blockquote>

'''Note:''' [https://forums.factorio.com/viewtopic.php?t=9141#p280529 Before 0.15.14], inserters were 1-4% less efficient when moving items from south to north.

===Chest to chest===

{| class="wikitable"
! rowspan=2 | Type
! rowspan=2 | Arm cycles per second
! colspan=6 | Items/second at [[inserter capacity bonus (research)|capacity bonus]] level (stack size)
|-
! colspan=2 | No capacity bonus
! colspan=2 | Capacity bonus 2
! colspan=2 | Capacity bonus 7
|- align="center"
| align="left"| {{Imagelink|Burner inserter|Burner inserter}} || 0.59 || 0.59 || (1) || 1.18 || (2) || 1.76 || (3)
|- align="center"
| align="left"| {{Imagelink|Inserter|Inserter}} || 0.83 || 0.83 || (1) || 1.67 || (2) || 2.50 || (3)
|- align="center"
| align="left"| {{Imagelink|Long handed inserter|Long handed inserter}} || 1.15 || 1.15 || (1) || 2.31 || (2) || 3.46 || (3)
|- align="center"
| align="left"| {{Imagelink|Fast inserter|Fast inserter}} {{imagelink|filter-inserter|Filter inserter}} || 2.31 || 2.31 || (1) || 4.62 || (2) || 6.93 || (3)
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 2.31 || 4.62 || (2) || 9.23 || (4) || 27.70 || (12)
|-
|}

===Chest to belt===

Throughput going from chest to belt depends on how full the belt is and how the items are spaced, i.e. if spaces are large enough to fill with items. Underground entrances and exits also makes it easier for the inserter to put down an item.

In these measurements inserters move items onto an empty perpendicular belt. Values are given for the stack sizes at three different [[inserter capacity bonus (research)|capacity bonus]] levels.

{| class="wikitable"
! rowspan=3 | Type
! colspan=12 | Items/second at [[inserter capacity bonus (research)|capacity bonus]] level (stack size)
|-
! colspan=4 | No capacity bonus
! colspan=4 | Capacity bonus 2
! colspan=4 | Capacity bonus 7
|-
! [[File:Transport belt.png|link=Transport belt]] || [[File:Fast transport belt.png|link=Fast transport belt]] || [[File:Express transport belt.png|link=Express transport belt]] ||
! [[File:Transport belt.png|link=Transport belt]] || [[File:Fast transport belt.png|link=Fast transport belt]] || [[File:Express transport belt.png|link=Express transport belt]] ||
! [[File:Transport belt.png|link=Transport belt]] || [[File:Fast transport belt.png|link=Fast transport belt]] || [[File:Express transport belt.png|link=Express transport belt]] ||
|- align="center"
| align="left"| {{Imagelink|Burner inserter|Burner inserter}} || 0.59 || 0.59 || 0.59 || (1) || 1.10 || 1.13 || 1.14 || (2) || 1.53 || 1.62 || 1.67 || (3)
|- align="center"
| align="left"| {{Imagelink|Inserter|Inserter}} || 0.83 || 0.83 || 0.83 || (1) || 1.52 || 1.58 || 1.60 || (2) || 2.05 || 2.22 || 2.31 || (3)
|- align="center"
| align="left"| {{Imagelink|Long handed inserter|Long handed inserter}} || 1.15 || 1.15 || 1.15 || (1) || 2.03 || 2.14 || 2.18 || (2) || 2.65 || 2.95 || 3.10 || (3)
|- align="center"
| align="left"| {{Imagelink|Fast inserter|Fast inserter}} {{imagelink|filter-inserter|Filter inserter}} || 2.31 || 2.31 || 2.31 || (1) || 3.64 || 4.00 || 4.14 || (2) || 4.29 || 5.14 || 5.63 || (3)
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 3.64 || 4.00 || 4.14 || (2) || 4.71 || 6.15 || 6.86 || (4) || 5.90 || 9.60 || 12.20 || (12)
|-
|}

To calculate the throughput for [[Stack inserter]] and [[Stack filter inserter]] at any capacity level, you can use these linearly fitted factors with the belt/chest throughput formula above:

{| class="wikitable"
! rowspan=2 | Type
! colspan=2 | {{Imagelink|Transport belt|Transport belt}}
! colspan=2 | {{Imagelink|Fast transport belt|Fast transport belt}}
! colspan=2 | {{Imagelink|Express transport belt|Express transport belt}}
|-
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 0.142 || 0.292 || 0.073 || 0.360 || 0.049 || 0.384
|-
|}

See the [https://docs.google.com/spreadsheets/d/1OzlP2v6P1OGxK1xCFr77aqVfNNEaEKHlA89aSVmqBGw/edit?usp=sharing source spreadsheet] for the corresponding factors for the other inserter types. Their errors are generally well below 1%.

===Belt to chest===

When picking items from a belt, many more factors come into play besides belt fullness:

* How fast the items move (i.e. if they are queued up on the belt or move at belt speed).
* Whether the belt is perpendicular to the inserter or approaches it head on.
* Whether items are on the near or far lane of a perpendicular belt.
* Whether the belt turns or not, and whether the items are in the inner or outer side of the bend.
* If the belt is an underground entrance or exit. This shortens the time items are visible to the inserter for pickup.
* All sorts of intricate timing factors between the inserter and the items on the belt, since the game simulates the arm homing in on every item.

The test setup used below is with a south-to-north inserter taking items from a perpendicular belt with items on the far lane only. The belt is fully compressed and timings are both for items that move at full speed and queued up as much as possible. Values are given for the stack sizes at three different [[inserter capacity bonus (research)|capacity bonus]] levels.

{| class="wikitable"
! rowspan=4 | Type
! colspan=15 | Items/second at [[inserter capacity bonus (research)|capacity bonus]] level (stack size)
|-
! colspan=5 | No capacity bonus
! colspan=5 | Capacity bonus 2
! colspan=5 | Capacity bonus 7
|-
! colspan=3 | Items at belt speed
! rowspan=2 | Items queued up
! rowspan=2 |
! colspan=3 | Items at belt speed
! rowspan=2 | Items queued up
! rowspan=2 |
! colspan=3 | Items at belt speed
! rowspan=2 | Items queued up
! rowspan=2 |
|-
! [[File:Transport belt.png|link=Transport belt]] || [[File:Fast transport belt.png|link=Fast transport belt]] || [[File:Express transport belt.png|link=Express transport belt]]
! [[File:Transport belt.png|link=Transport belt]] || [[File:Fast transport belt.png|link=Fast transport belt]] || [[File:Express transport belt.png|link=Express transport belt]]
! [[File:Transport belt.png|link=Transport belt]] || [[File:Fast transport belt.png|link=Fast transport belt]] || [[File:Express transport belt.png|link=Express transport belt]]
|- align="center"
| align="left"| {{Imagelink|Burner inserter|Burner inserter}} || '''0.56''' || '''0.56''' || 0.51 || 0.65 || (1) || '''1.11''' || 1.07 || 0.98 || 1.18 || (2) || 1.43 || '''1.54''' || 1.43 || 1.75 || (3)
|- align="center"
| align="left"| {{Imagelink|Inserter|Inserter}} || '''0.83''' || 0.74 || 0.77 || 0.90 || (1) || '''1.57''' || 1.48 || 1.45 || 1.62 || (2) || 2.00 || '''2.11''' || 2.07 || 2.40 || (3)
|- align="center"
| align="left"| {{Imagelink|Long handed inserter|Long handed inserter}} || '''1.16''' || 1.11 || 1.11 || 1.22 || (1) || 2.22 || '''2.22''' || 2.11 || 2.31 || (2) || 3.08 || 3.08 || '''3.16''' || 3.33 || (3)
|- align="center"
| align="left"| {{Imagelink|Fast inserter|Fast inserter}} {{imagelink|filter-inserter|Filter inserter}} || '''2.22''' || '''2.22''' || 2.14 || 2.40 || (1) || '''4.17''' || 3.81 || 4.00 || 4.29 || (2) || '''5.71''' || 5.45 || 5.46 || 6.21 || (3)
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || '''4.17''' || 3.81 || 4.00 || 4.29 || (2) || '''6.67''' || '''6.67''' || 6.15 || 6.67 / 7.50 / 7.74 * || (4) || 6.67 || 10.00 || '''12.00''' || 6.67 / 11.61 / 13.58 * || (12)
|-
|}

<nowiki>*)</nowiki> Throughput for basic/fast/express belt.

Since there are many more factors involved, these measurements exhibit a more complex pattern than chest-to-belt.

* Boldface cells show for which belt each inserter has the best throughput on each bonus level when items move at belt speed. Higher speed belts mean that inserters have to work harder to catch the fast moving items. The effect is most noticeable for slower inserters and smaller stack sizes.
* When items are queued up the belt type hardly matters, so there is only a single column for that. The exceptions are the stack inserters - for basic transport belts it's the belt that sets the limit for stack sizes above 4, and there is also a notable difference between fast and express belts.

Here are linearly fitted factors to get the [[Stack inserter]] and [[Stack filter inserter]] throughput at any capacity level, by using the belt/chest throughput formula above:

{| class="wikitable"
! rowspan=2 | Type
! colspan=2 | {{Imagelink|Transport belt|Transport belt}}
! colspan=2 | {{Imagelink|Fast transport belt|Fast transport belt}}
! colspan=2 | {{Imagelink|Express transport belt|Express transport belt}}
|-
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 0.045* || 0.403* || 0.063 || 0.387 || 0.049 || 0.416
|-
|}

<nowiki>*)</nowiki> Since the belt is the limiting factor above stack size 4, these figures are only accurate up to that size. More than that and the throughput is fixed at 6.67 items per second.

==See Also==
* [[Electric network]]
* [[Transport network]]
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=5253 Inserter Power Efficiency]: Movements per energy and exact power usage numbers. See also [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=6258 this thread], where energy per movement is explained.
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=5400 Small Inserter Test]: Comparison if energy usage per item.
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=5524 Inserter heartbeats]: In some situations it is not possible to calculate the needed power usage.
===Special behavior===
* [[Inserter capacity bonus (research)]]: Inserter moves more than an item per turn.

{{C|Inserters}}

Circuit network

2017-06-11T01:39:48Z

Ignatio: Inserter stack size can be overridden

{{Languages}}
'''Circuit networks''' are built using red or green wire, and enable the control of receivers, based upon information broadcast onto the network by connected senders. Most senders are storage devices, and broadcast their information onto a specific channel, based on the item or liquid the storage device contains. Each circuit network contains a channel for every kind of item, as well as 45 extra [[Virtual signals]] which act as user-definable channels. 'Everything', 'Anything' and 'Each' are also available wildcards.

[[File:InnerOfGreenCable.jpg|right|thumb|400px|A player drawn visualization of the interior of a circuit cable.]]

== Usage ==
=== Send Information ===
Senders broadcast the amount of [[Items]] or [[Liquids system|Fluids]] they contain or other data definable by the player. Each amount is broadcast as a numeric value on a 'channel' corresponding to the item. For example, a Storage Tank containing 1000 Crude Oil will broadcast 1000 on the Crude Oil channel.

The channels are separated from each other, so each network can simultaneously carry a number for each item and fluid in the game, and for each of the extra user-defined channels (digits 0-9, letters A-Z, and 9 different colors). All unused channels have the value zero.

Multiple broadcasts of the same item or fluid are additive: If there are two connected Storage Tanks with 1000 Crude Oil each, the value of the Crude Oil channel within the network will be 2000.

All wires of the same color which are connected together by junctions form a network, i.e. they will pass their signals to each other. For example, if two red wires are connected to the same combinator input, each wire receives the content from the other. This can result in feedback if care is not taken; see Feedback (under Arithmetic Combinator, below) for discussion.

Numbers are in the signed 32 bit integer range, i.e. from -2147483648 to 2147483647 inclusive. The numbers wrap around on overflow, so e.g. 2147483647 + 10 becomes -2147483639.

=== Control Devices ===
[[File:smart_inserter.png|thumb|250px|Example condition: "Work only if the count of Iron plates is lower than the count of Steel plates." Remember to set the filter as well.]]
Receivers can use broadcast information, in most cases to enable/disable the device.

They can either compare results between different channels, or compare a channel to a specific value. The pictured inserter works if the count of [[Iron plate|Iron plates]] is lower than the count of [[Steel plate|Steel plates]].

Receiving devices sum all signals from each wire connected to them, even red and green wires. For example, if an inserter is connected to a red wire carrying a signal for 20 iron plates, a green wire with 10 copper plates and another green wire with 5 iron plates, the input signal set for that receiver will be 25 iron plates and 10 copper plates.

== Devices ==

Since version 0.13 each entity connectable to one of the networks has icons in its top right corner. By clicking the left icon, you have access to the circuit network settings (if one is connected), by clicking the right icon, you have access to the logistic network settings, if one is reachable. There can be set conditions for both circuit (signals of red and green wires are summed) and logistic network, which will together act as a logical AND.

=== Senders ===
These devices can send signals to the circuit network.

{| class="wikitable"
| {{imagelink|basic-transport-belt|Transport belts}} || Transport belts can send their content to the Circuit network.
''Pulse mode'': The signal is sent for only 1 tick when the item enters the belt.

''Hold mode'': The signal is sent continuously as long as the items are on the belt.
|-
| {{imagelink|basic-inserter|Inserters}} || All inserters can send their held items to the Circuit network.
''Pulse mode'': The signal is sent for only 1 tick when the item is picked up.

''Hold mode'': The signal is sent continuously as long as the inserter is holding the item.
|-
| {{imagelink|wooden-chest|Chests}} || All chests can send their contents to the Circuit network. Logistic chests additionally send their contents to the [[Logistic network]].
|-
| {{imagelink|storage-tank|Storage tank}} || The storage tank can send its fluid content to the Circuit network.
|-
| {{imagelink|gate|Gate}} || Gates can send a signal to the Circuit network.
|-
| {{imagelink|rail-signal|Rail signal}} || Rail signals can send their state to the Circuit network.
|-
| {{imagelink|train-stop|Train stop}} || Train stations can send the contents of a stopped train to the circuit network as well as read a unique train identifier code.
|-
| {{imagelink|basic-accumulator|Accumulator}} || It can send its charge level in percent to the Circuit network.
|-
| {{imagelink|roboport|Roboport}} || It can send its logistic network contents or its robot statistics to the Circuit network.
|-
| {{imagelink|electric-mining-drill|Electric mining drill}} || It can send output the remaining expected resources.
|-
| {{imagelink|pumpjack|Pumpjack}} || It can output the current oil mining rate.
|}

=== Receivers ===

{| class="wikitable"
| {{imagelink|basic-transport-belt|Transport belts}} || Transport belts can be enabled on a condition.
|-
| {{imagelink|basic-inserter|Inserters}} || All inserters can be enabled on a condition. The inserter stack size can also be overridden from a control signal (configurable).
|-
| {{imagelink|filter-inserter|Filter inserter}} || The filter inserter can additionally set its filters from the Circuit network.
|-
| {{imagelink|requester-chest|Requester chest}} || Its requested items can be set by the Circuit network.
|-
| {{imagelink|gate|Gate}} || Gates can be opened on a condition.
|-
| {{imagelink|rail-signal|Rail signal}} || Rail signals can prevent trains by passing on a condition (set signal to red).
|-
| {{imagelink|small-lamp|Lamp}} || The lamp can be enabled on a condition. If it receives color signals, it can set the given color.
|-
| {{imagelink|offshore-pump|Offshore pump}} || The offshore pump can be enabled on a condition.
|-
| {{imagelink|small-pump|Small pump}} || The small pump can be enabled on a condition.
|-
| {{imagelink|train-stop|Train stop}} || Train stations can send the contents of the Circuit network to the train to use it for wait conditions, as well as enable/disable the stop itself.
|-
| {{imagelink|power-switch|Power switch}} || Power switches can connect to power networks on a condition.
|-
| {{imagelink|electric-mining-drill|Electric mining drill}} || It can be enabled on a condition.
|-
| {{imagelink|pumpjack|Pumpjack}} || It can be enabled on a condition.
|-
| {{imagelink|Programmable_speaker|Programmable speaker}} || Shows alerts and plays sounds based on circuit network signals. It can be used to make simple songs.
|}

== Physical network structure ==
A circuit network consists only of those devices connected together with the same color wire. Wire can be strung directly from device to device, or across any intervening power poles. Wire length is limited by its previous connection.

Note that each connected set of wires forms a separate network. For example, it's entirely possible to have four red-wire networks and three green-wire networks. If red and green wires happen to touch the same power pole or device, the red and green networks will remain separate and will not link up . However, two red cables or two green cables will link if they touch. Use different colored cables to separate networks in close proximity.

* To connect wires or cables to a power pole, simply click on one entity, then on the base of the power pole.
* To erase a wire or cable connection, place the same color wire over an existing connection. You don't get the wire/cable back.
* To remove '''all''' connections from a power pole, shift-click on the pole. The first shift-click will remove all electrical connections, and the second will remove all red and green wires. You don't get the wires back.
* When connecting to a [[Arithmetic Combinator]] or [[Decider Combinator]], take care to connect the wire to the correct input or output side. Use ALT-Key-Mode to see direction of combinator.
* Hovering the mouse cursor over an item will highlight all wires which form the network of the item.
* Hovering the mouse cursor over a power pole which is part of a network will display the signals on its network. Some items like combinators will also display their input and output signals when hovered over.

== Combinators ==
Combinators can function as both receiving and sending devices and allow more advanced functions to be used on a circuit network.

*The [[Constant Combinator]] broadcasts up to 15 values on any of the channels for whatever networks it is connected to. (You cannot currently specify whether a value should be on the red or green channel; if you need different values, use two combinators, one for each color wire.) You can use any item channel or any of the [[Automatic control/Virtual signals|virtual signal]] channels.
**Note that using two of the 15 slots to broadcast values on the '''same''' channel is the same as broadcasting the sum of the two values from one slot.

*The [[Arithmetic Combinator]] performs arithmetic operations on input values and broadcasts the result to the specified output channel. The input and output channels can be any item channel or any of the virtual signal channels.
** Connecting: The Arithmetic Combinator connects to a red or green network on its '''input''' side (the terminals are set into the main body and look like spark plugs) and performs an arithmetic calculation which is broadcast into the specified channel on its '''output''' side (the output wires appear to stretch out a bit from the body of the device).
** Feedback: Note that the input network and the output network '''are not the same network'''. Connecting the output network back to the input network will result in a feedback loop. For example, adding 1 to the value for Copper Plates and broadcasting it as Copper Plates is an action that results in an infinite loop if output is connected back to input. The value for Copper Plates will rapidly (but not instantly) shoot upward. (Fun fact: The rate at which it climbs is the current tick rate) This technique can be combined with Decider Combinator logic to make electronic clocks, gates, and other systems; see [[Combinator Tutorial]] for advanced techniques.
** Each: This combinator can use the 'Each' signal for both input and output, in which case '''all''' non-zero input channels will have the combinator's operation performed and broadcast on the output side. Having Each signals for input and output and using a non-changing operation (like adding zero) is equivalent to having a 'one-way' wire; all the information from the input network is copied to the output network, but the reverse is not true.
**Multi-network: The Arithmetic Combinator can be joined to both red and green networks on the input side and will sum their inputs.

*The [[Decider Combinator]] functions much like an Arithmetic Combinator, but is designed to compare values. Essentially, it is a conditional. In terms of Connecting, Feedback, and the Each signal it functions as specified above. In addition, it can handle the Everything and Anything signals, and performs more complex functions than summing when attached to multiple networks. See the [[Decider Combinator]] page for more details on how to use this.

== Tutorials ==
'''[[Circuit-network Cookbook|Circuit Network Cookbook]]''' - ''Example heavy tutorials; for beginners who want to use the benefits of the Circuit Network.''

'''[[Combinator Tutorial]]''' - ''Mainly textual and detailed tutorials; for amateurs who can sometimes refer to this.''

''[http://www.reddit.com/r/factorio The official Factorio Reddit], if you'd like to ask any questions about circuitry in Factorio.''

== Logistic Network ==
The Logistic network used by [[Logistic robot|Logistic robots]] is essentially a third network (a wireless one), along with the green and red wired network. The Logistic Network is based on proximity to a central [[Roboport]].

Some devices can also be connected to the logistic network. If a device has conditions set for circuit and for logistic network, it will become activated if both conditions are true.

See [[Logistic network]] and [[Roboport]] for more information.

== History ==

{{history|0.15.0|
* Significantly improved circuit network performance. Up to 25 times less CPU usage and 10% less memory usage.
* Added the Programmable Speaker: it shows alerts and plays sounds based on circuit network signals. It can be used to make simple songs.
* Train Stop can output the contents of the stopped train's cargo.
* Train Stop can be disabled using the circuit network. Trains will skip disabled Train Stops, allowing simple train control.
* Mining Drills can be turned on and off using the circuit network. They can also output the remaining expected resources.
* Pumpjacks can be turned on and off using the circuit network. They can also output the current oil mining rate.
* Added Modulo, Power, Left Bit Shift, Right Bit Shift, Bitwise AND, Bitwise OR and Bitwise XOR to the Arithmetic Combinator.
* Added additional operators to the Decider Combinator and Circuit Conditions.}}

{{history|0.13.0|
* Many machines are now connectible to the circuit network.
* Wire disconnecting is incorporated into the latency hiding.
* Wires are now highlighted on entity mouseover.
* Reduced memory usage of circuit network.}}

{{history|0.12.33|
* Fluid values are rounded to the closest value instead of rounding down when transmitted to circuit network.}}

{{history|0.12.1|
* One can copy paste circuit network conditions between the [[Inserter]], [[Lamp]], [[Small pump]] and [[Offshore pump]]. }}

{{history|0.12.0|
* Improvements to circuit network connection, one can connect multiple wires of the same color to the same entity.
* The [[Lamp]], [[Storage tank]], [[Small pump]] and [[Offshore pump]] can be connected to the circuit network.
}}

{{history|0.10.0|
* [[Blueprint]]s copy circuit network connections.}}

{{history|0.8.3|
* Circuit network contents info has colored slots to specify the network it represents.}}

{{history|0.1.0|
* Introduced}}

== See also ==
* [[Circuit network (research)]]
* [[Transport network]]
* [[Combinators]]
* [[Virtual signals]]
* [http://www.factorioforums.com/forum/viewtopic.php?f=6&t=4728&p=37251#p37157 Logic gates revisited]

[[Category: Networks]] [[Category: Circuit network]]

Chemical plant

2017-06-03T01:12:20Z

Ignatio:

{{languages}}
{{:Chemical plant/infobox}}
[[File:Chemical-plant-example.png|thumb|256px|A chemical plant converting heavy oil to lubricant.]]
Most recipes that either require or provide a fluid other than crude oil is produced here. The chemical plant has 2 inputs and 2 outputs in fixed positions. Solid items are both inserted and removed by [[Inserters]] from any point (no need to target fluid input/output connections).

Processes [[Heavy oil]] into [[Lubricant]] (requirement for [[Electric engine unit]]), make [[Sulfur]], [[Sulfuric acid]], [[Plastic bar]] (requirement for [[Processing unit]]s), [[Battery]] and turn any Oil byproducts into [[Solid fuel]] (See [[Fuel]] to compare that with other types), and also crack oil byproducts into lighter oil byproducts.

== History ==

{{history|0.15.0|
* Module slots increased from 2 to 3.}}

{{history|0.11.6|
* Oil refinery and chemical plant are now disconnected from pipes when the recipe is reset.}}

{{history|0.10.0|
* Unused pipe connections don't connect to pipes.
* Fluid input amount is limited to 2x recipe cost.
* Fluid inputs for the chemical plant are now saved properly.
* Now accepts modules.
}}

{{history|0.9.0|
* Introduced}}

== See also ==
* [[Liquid network]]

{{ProductionNav}}

[[Category:Items]]
[[Category:Liquid network]]

Oil refinery

2017-06-03T01:11:59Z

Ignatio:

{{Languages}}
{{:Oil refinery/infobox}}

The '''Oil Refinery''' processes [[Crude Oil]] into 3 different fluids: [[Heavy Oil]], [[Light Oil]] and [[Petroleum Gas]].

Oil products have many uses. Although they can be turned into [[Solid fuel]] to fuel [[Boiler|boilers]] and furnaces, it is usually used to create [[Plastic]], which is used in [[Advanced Circuit|Advanced Circuits]], and [[Sulfur]], which is used in more advanced items. They are also used as ammunition for [[Flamethrower|flamethrowers]] and [[Flamethrower turret|flamethrower turrets]].

== Recipes ==

The refinery has three available recipes, one of which must be set before it can begin processing.

{|class="wikitable"
|-
! Process !! Input !! Output
|-
| {{imagelink|basic-oil-processing|Basic oil processing}} || {{icon|crude-oil|100|Crude Oil}} {{icon|time icon|5|Time}} || {{icon|heavy-oil|30|Heavy oil}} {{icon|light-oil|30|Light oil}} {{icon|petroleum-gas|40|Petroleum gas}}
|-
| {{imagelink|advanced-oil-processing|Advanced oil processing}}(requires [[Advanced oil processing (research)|Advanced Oil Processing research]])
| {{icon|crude-oil|100|Crude Oil}} {{icon|water|50|Water}} {{icon|time icon|5|Time}}
| {{icon|heavy-oil|10|Heavy oil}} {{icon|light-oil|45|Light oil}} {{icon|petroleum-gas|55|Petroleum gas}}
|-
| {{imagelink|coal_liquefaction|Coal liquefaction}}(requires [[Coal liquefaction (research)|Coal liquefaction (research)]])
| {{icon|coal|10|Coal}} {{icon|heavy-oil|25|Heavy Oil}} {{icon|steam|50|Steam}} {{icon|time icon|5|Time}}
| {{icon|heavy-oil|35|Heavy oil}} {{icon|light-oil|15|Light oil}} {{icon|petroleum-gas|20|Petroleum gas}}
|-
|}

== Notes ==
* When placing the refinery, it can be rotated, but otherwise neither input nor output tiles can be swapped in any way. (For advanced oil processing, the water input is to the right when the inputs are coming into the top.)

== Troubleshooting ==

When the refinery is working, a flame comes out of the chimney.

* You need to choose the recipe, otherwise it won't work.
* It will stop working if any of the products isn't properly drained from it (that is, 10.0 heavy oil at output will prevent production of the 2 other fluids).

== History ==

{{history|0.15.0|
* Module slots increased from 2 to 3.}}

{{history|0.11.6|
* Now disconnects from pipes when recipe is reset.}}

{{history|0.9.1|
* Now accepts modules
* Added cracking recipes}}

{{history|0.9.0|
* Introduced}}

== See also ==
* [[Oil processing]]
* [[Liquid network]]

{{ProductionNav}}

[[Category:Items]]
[[Category:Liquid network]]

Infobox:Oil refinery

2017-06-03T01:11:14Z

Ignatio: Module slots increased from 2 to 3.

{{Infobox
|expensive-total-raw = Time, 50 + Copper plate, 50 + Iron plate, 80 + Steel plate, 15 + Stone brick, 10
| category = Machinery
| category-name = Machine
|image =Oil-refinery-example
|health =300
|energy =420 kW electric
|drain =14 kW electric
|crafting-speed =1
|stack-size=10
|dimensions=5x5
|pollution =3.6
|modules =3
|recipe = Time, 10 + Electronic circuit, 10 + Iron gear wheel, 10 + Pipe, 10 + Steel plate, 15 + Stone brick, 10
|total-raw = Time, 32.5 + Copper plate, 15 + Iron plate, 40 + Steel plate, 15 + Stone brick, 10
|required-technologies =Oil processing
|producers =Manual + assembling machine 3
}}<noinclude>[[Category:Infobox page]]</noinclude>

Oil refinery

2017-06-03T01:10:22Z

Ignatio: Module slots increased from 2 to 3.

{{Languages}}
{{:Oil refinery/infobox}}

The '''Oil Refinery''' processes [[Crude Oil]] into 3 different fluids: [[Heavy Oil]], [[Light Oil]] and [[Petroleum Gas]].

Oil products have many uses. Although they can be turned into [[Solid fuel]] to fuel [[Boiler|boilers]] and furnaces, it is usually used to create [[Plastic]], which is used in [[Advanced Circuit|Advanced Circuits]], and [[Sulfur]], which is used in more advanced items. They are also used as ammunition for [[Flamethrower|flamethrowers]] and [[Flamethrower turret|flamethrower turrets]].

== Recipes ==

The refinery has three available recipes, one of which must be set before it can begin processing.

{|class="wikitable"
|-
! Process !! Input !! Output
|-
| {{imagelink|basic-oil-processing|Basic oil processing}} || {{icon|crude-oil|100|Crude Oil}} {{icon|time icon|5|Time}} || {{icon|heavy-oil|30|Heavy oil}} {{icon|light-oil|30|Light oil}} {{icon|petroleum-gas|40|Petroleum gas}}
|-
| {{imagelink|advanced-oil-processing|Advanced oil processing}}(requires [[Advanced oil processing (research)|Advanced Oil Processing research]])
| {{icon|crude-oil|100|Crude Oil}} {{icon|water|50|Water}} {{icon|time icon|5|Time}}
| {{icon|heavy-oil|10|Heavy oil}} {{icon|light-oil|45|Light oil}} {{icon|petroleum-gas|55|Petroleum gas}}
|-
| {{imagelink|coal_liquefaction|Coal liquefaction}}(requires [[Coal liquefaction (research)|Coal liquefaction (research)]])
| {{icon|coal|10|Coal}} {{icon|heavy-oil|25|Heavy Oil}} {{icon|steam|50|Steam}} {{icon|time icon|5|Time}}
| {{icon|heavy-oil|35|Heavy oil}} {{icon|light-oil|15|Light oil}} {{icon|petroleum-gas|20|Petroleum gas}}
|-
|}

== Notes ==
* When placing the refinery, it can be rotated, but otherwise neither input nor output tiles can be swapped in any way. (For advanced oil processing, the water input is to the right when the inputs are coming into the top.)

== Troubleshooting ==

When the refinery is working, a flame comes out of the chimney.

* You need to choose the recipe, otherwise it won't work.
* It will stop working if any of the products isn't properly drained from it (that is, 10.0 heavy oil at output will prevent production of the 2 other fluids).

== History ==

{{history|0.15|
* Module slots increased from 2 to 3.}}

{{history|0.11.6|
* Now disconnects from pipes when recipe is reset.}}

{{history|0.9.1|
* Now accepts modules
* Added cracking recipes}}

{{history|0.9.0|
* Introduced}}

== See also ==
* [[Oil processing]]
* [[Liquid network]]

{{ProductionNav}}

[[Category:Items]]
[[Category:Liquid network]]

Infobox:Chemical plant

2017-06-03T01:08:12Z

Ignatio:

{{Infobox
|expensive-total-raw = Time, 25 + Copper plate, 25 + Iron plate, 40 + Steel plate, 5
| category = Machinery
| category-name = Machine
|health =300
|stack-size =10
|dimensions =3x3
|energy =210 kW electric
|drain =7.0 kW electric
|crafting-speed =1.25
|pollution =1.8
|modules =3
|recipe = Time, 5 + Electronic circuit, 5 + Iron gear wheel, 5 + Pipe, 5 + Steel plate, 5
|total-raw = Time, 16.25 + Copper plate, 7.5 + Iron plate, 20 + Steel plate, 5
|required-technologies =Oil processing
|producers =Manual + Assembling machine 2 + Assembling machine 3
}}<noinclude>[[Category:Infobox page]]</noinclude>

Chemical plant

2017-06-03T00:57:20Z

Ignatio: Module slots increased from 2 to 3.

{{languages}}
{{:Chemical plant/infobox}}
[[File:Chemical-plant-example.png|thumb|256px|A chemical plant converting heavy oil to lubricant.]]
Most recipes that either require or provide a fluid other than crude oil is produced here. The chemical plant has 2 inputs and 2 outputs in fixed positions. Solid items are both inserted and removed by [[Inserters]] from any point (no need to target fluid input/output connections).

Processes [[Heavy oil]] into [[Lubricant]] (requirement for [[Electric engine unit]]), make [[Sulfur]], [[Sulfuric acid]], [[Plastic bar]] (requirement for [[Processing unit]]s), [[Battery]] and turn any Oil byproducts into [[Solid fuel]] (See [[Fuel]] to compare that with other types), and also crack oil byproducts into lighter oil byproducts.

== History ==

{{history|0.15|
* Module slots increased from 2 to 3.}}

{{history|0.11.6|
* Oil refinery and chemical plant are now disconnected from pipes when the recipe is reset.}}

{{history|0.10.0|
* Unused pipe connections don't connect to pipes.
* Fluid input amount is limited to 2x recipe cost.
* Fluid inputs for the chemical plant are now saved properly.
* Now accepts modules.
}}

{{history|0.9.0|
* Introduced}}

== See also ==
* [[Liquid network]]

{{ProductionNav}}

[[Category:Items]]
[[Category:Liquid network]]

Inserters

2017-05-27T18:47:13Z

Ignatio: Note when inserters stopped being slower south-to-north.

{{Languages}}

''For the common yellow electrical inserter, see [[Inserter]].''

'''Inserters''' are devices which are used to move items over short distances. When placed, they have a fixed direction. They can move items from behind and place them in front of them. By doing this, they can move items from one transport belt to another, but also extract items from, and insert items into machines or storage devices. There are seven types of inserters, all requiring electricity to run (except the Burner Inserter, which burns [[Fuel|fuel]]).

== Types Of Inserters ==

{| class="wikitable"
| {{imagelink|burner-inserter|Burner inserter}} || The only [[fuel]]-powered inserter.
|-
| {{imagelink|basic-inserter|Basic inserter}} || The standard electrical inserter.
|-
| {{imagelink|long-handed-inserter|Long handed inserter}} || Capable of inserting and removing items from a greater distance.
|-
| {{imagelink|fast-inserter|Fast inserter}} || Much faster than the Basic inserter.
|-
| {{imagelink|filter-inserter|Filter inserter}} || Variant of the Fast inserter that can filter items by type.
|-
| {{imagelink|stack-inserter|Stack inserter}} || As fast as the Fast inserter but can move many more items at the same time.
|-
| {{imagelink|stack_filter_inserter|Stack filter inserter}} || Variant of the Stack inserter that can filter items by type.
|-
|}

==Mechanics==
Inserters '''will''':
* '''Pick up''' [[Items]] off the ground, off of a [[Transport belts|Transport belt]], or from any object that has storage space, including [[Storages/Chests|chests]], [[furnace]]s and [[assembling machine]]s.
* '''Place''' the item onto the ground, onto a transport belt, or into any object that has storage space.
* Inserters can place items on all types of conveyor belts.
* Try to pick up items from all types of belts (as of v0.12 there is no limitation anymore).
* Inserters will run at slower speeds when starved for energy.

Inserters will '''not''':
* Pick up any items that can not be inserted into the connected entity.
* Pick up items into an entity with a full inventory.
* Place more than one item at a time onto the same ground tile.
* Place items into a stack limited inventory, beyond the stack limit (red slots).

Inserters act differently depending on what they are moving items to/into so as not to monopolize all of the items being picked up. This allows other machines and inserters on the same transport belt to pick up a share of the items. If two inserters are picking up from the same tile, the first placed inserter has priority.

==Insertion Limits==
Inserters will stop inserting items into certain buildings if they already have enough of that item. For example, if a boiler has 5 or more items of fuel in it, an inserter will not insert additional fuel. When the fuel drops below 5 items, the inserter will continue to insert more fuel, up to the limit of 5 items.

This is to allow for all machines to receive their share of items. The common limits on insertion are shown in the table below.

{| class="wikitable"
! Entity !! Item type !! Inserter limit !! Comment
|-
| [[Boiler]]s, [[Burner inserter]]s, [[Furnace]]s || [[Fuel]] || align="center" | 5 ||
|-
| [[Gun turret]]s || Bullet Magazines || align="center" | 10 || Since v0.8.4. Allows for 100 shots before depleting.
|-
| [[Assembling machine]]s || Items needed for the recipe || Double the number of items needed in the recipe ||
|-
| [[Furnace]]s || Items needed for the recipe || Double the number of items needed in the recipe ||
|-
| [[Lab]]s || [[Science pack]]s || Double the number of items needed for one research point ||
|}

An inserter that takes items from an object containing [[Storage/Stack|stacks]] of items (such as a chest) can overfill the target building due to the [[Inserter item stack size bonus]] research. Overfilling can also happen if multiple inserters are used to insert items into one building.

==Inserters And Transport Belt Interaction ==
[[Transport belts]] have two lanes on which items can travel. Inserters only place items onto one side of the belt. Which side they place it on depends on the orientation of the inserter and the belt, as described below.

: [[File:PlaceOnFarSide.gif|left]]
* Inserters will '''always''' place the item on the furthest lane.
{{clear}}
: [[File:TakeFromNearSide.gif|left]]
* Inserters '''prefer''' taking items from the nearest lane. If the nearest lane is empty, the inserter will take from the far lane.
{{clear}}
: [[File:PlaceOnRightSide.gif|left]]
* If a belt is in the same orientation as the inserter, the item will be placed on the right-hand lane, from the belt's perspective.
{{clear}}
: [[File:PlaceOnInsideOfCorner.gif|left]]
* If the item is placed on a corner piece, it will be put on the inside of the curve, regardless of orientation.
{{clear}}

== Potential Issues ==
Inserters may have problems picking up items:

* From very fast belts, because the items are moving too quickly.
* From the entry or exit of an underground belt (because the time they have to pick up is shorter)
* From turning belts if the item is on the inside of the corner

==Inserter Item Stack Size Bonus==

If an inserter moves items from inventory to inventory (for example from an assembler into a chest), or (as of v0.13) from an inventory to a belt, it is able to transport more items at once. The secret behind this is the [[Inserter item stack size bonus]] research.

==Power Usage==
* Electric inserters drain energy even when they are not moving, as idle power
* The amount of energy used is the same for every movement
* The [[Burner inserter]] does not drain energy when idle, but uses more energy when it is active. It is quite useful for situations where the inserter does not need to move very often.

==Inserter Speed==

{| class="wikitable"
! Type
! Rotation-speed (turns per [[Tick]]) Extension-speed ([[Tile]]s per Tick)
! Turns per [[Game-second]] Tiles per Game-second
! Game-second per full turn Game-seconds per Tile
! Ticks per full turn Ticks per Tile
|- align="center"
| align="left"| {{imagelink|burner-inserter|Burner Inserter}} || 0.01 0.0214 || 0.6 1.284 || 1.667 0.833 || 102 76
|- align="center"
| align="left"| {{imagelink|basic-inserter|Basic inserter}} || 0.014 0.03 || 0.84 1.8 || 1.191 0.56 || 72 54
|- align="center"
| align="left"| {{imagelink|long-handed-inserter|Long handed inserter}} || 0.02 0.0457 || 1.2 2.742 || 0.833 0.416 || 52 36
|- align="center"
| align="left"| {{imagelink|fast-inserter|Fast inserter}} {{imagelink|stack-inserter|Stack inserter}} {{imagelink|Stack_filter_inserter|Stack filter inserter}} || 0.04 0.07 || 2.4 4.2 || 0.417 0.238 || 26 24
|-
|}

===Rotation Speed===
Convention: 2π rad = 100% of a circle rotation = '''1 turn''' (or one full rotation).

Note: an Inserter doesn't always need to make full turns. When grabbing from a transport belt, it is slightly faster when grabbing items from the closest lane.

===Extension Speed===
The extension-speed is normally not visible (only when compared to other inserters), but there are measurable speed differences when taking - for example - from the near or the far side of a belt. Also Some mods can alter the pickup and drop locations of inserters, making this stat more relevant.

==Inserter Throughput==

The following is based on [https://docs.google.com/spreadsheets/d/1OzlP2v6P1OGxK1xCFr77aqVfNNEaEKHlA89aSVmqBGw/edit?usp=sharing experimental data] gathered in version 0.15.

Inserter throughput between chests and other [[stack|stacks]] is a simple function of stack size and arm speed:

<blockquote>
''n'' = Stack size

''t_arm'' = Time to move the arm back and forth

Time per item = ''t_arm'' / ''n''

Throughput (items/sec) = 1 / Time per item = ''n'' / ''t_arm''
</blockquote>

When moving items to or from belts, the time to pick up or put down items also becomes a factor:

<blockquote>
''t_item'' = Time to pick up or put down or an item

''t_cycle'' = Time to complete an arm cycle = ''t_arm'' + ''n''*''t_item''

Time per item = ''t_cycle'' / ''n'' = ''t_item'' + ''t_arm'' / ''n''

Throughput (items/sec) = 1 / (''t_item'' + ''t_arm'' / ''n'')
</blockquote>

'''Note:''' [https://forums.factorio.com/viewtopic.php?t=9141#p280529 Before 0.15.14], inserters were 1-4% less efficient when moving items from south to north.

===Chest to chest===

{| class="wikitable"
! rowspan=2 | Type
! rowspan=2 | Arm cycles per second
! colspan=6 | Items/second at [[inserter capacity bonus (research)|capacity bonus]] level (stack size)
|-
! colspan=2 | No capacity bonus
! colspan=2 | Capacity bonus 2
! colspan=2 | Capacity bonus 7
|- align="center"
| align="left"| {{imagelink|burner-inserter|Burner inserter}} || 0.59 || 0.59 || (1) || 1.18 || (2) || 1.76 || (3)
|- align="center"
| align="left"| {{imagelink|basic-inserter|Basic inserter}} || 0.83 || 0.83 || (1) || 1.67 || (2) || 2.50 || (3)
|- align="center"
| align="left"| {{imagelink|long-handed-inserter|Long handed inserter}} || 1.15 || 1.15 || (1) || 2.31 || (2) || 3.46 || (3)
|- align="center"
| align="left"| {{imagelink|fast-inserter|Fast inserter}} {{imagelink|filter-inserter|Filter inserter}} || 2.31 || 2.31 || (1) || 4.62 || (2) || 6.93 || (3)
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 2.31 || 4.62 || (2) || 9.23 || (4) || 27.70 || (12)
|-
|}

===Chest to belt===

Throughput going from chest to belt depends on how full the belt is and how the items are spaced, i.e. if spaces are large enough to fill with items. Underground entrances and exits also makes it easier for the inserter to put down an item.

In these measurements inserters move items onto an empty perpendicular belt. Values are given for the stack sizes at three different [[inserter capacity bonus (research)|capacity bonus]] levels.

{| class="wikitable"
! rowspan=3 | Type
! colspan=12 | Items/second at [[inserter capacity bonus (research)|capacity bonus]] level (stack size)
|-
! colspan=4 | No capacity bonus
! colspan=4 | Capacity bonus 2
! colspan=4 | Capacity bonus 7
|-
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]] ||
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]] ||
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]] ||
|- align="center"
| align="left"| {{imagelink|burner-inserter|Burner inserter}} || 0.59 || 0.59 || 0.59 || (1) || 1.10 || 1.13 || 1.14 || (2) || 1.53 || 1.62 || 1.67 || (3)
|- align="center"
| align="left"| {{imagelink|basic-inserter|Basic inserter}} || 0.83 || 0.83 || 0.83 || (1) || 1.52 || 1.58 || 1.60 || (2) || 2.05 || 2.22 || 2.31 || (3)
|- align="center"
| align="left"| {{imagelink|long-handed-inserter|Long handed inserter}} || 1.15 || 1.15 || 1.15 || (1) || 2.03 || 2.14 || 2.18 || (2) || 2.65 || 2.95 || 3.10 || (3)
|- align="center"
| align="left"| {{imagelink|fast-inserter|Fast inserter}} {{imagelink|filter-inserter|Filter inserter}} || 2.31 || 2.31 || 2.31 || (1) || 3.64 || 4.00 || 4.14 || (2) || 4.29 || 5.14 || 5.63 || (3)
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 3.64 || 4.00 || 4.14 || (2) || 4.71 || 6.15 || 6.86 || (4) || 5.90 || 9.60 || 12.20 || (12)
|-
|}

To calculate the throughput for [[Stack inserter]] and [[Stack filter inserter]] at any capacity level, you can use these linearly fitted factors with the belt/chest throughput formula above:

{| class="wikitable"
! rowspan=2 | Type
! colspan=2 | {{imagelink|basic-transport-belt|Transport belt}}
! colspan=2 | {{imagelink|fast-transport-belt|Fast transport belt}}
! colspan=2 | {{imagelink|express-transport-belt|Express transport belt}}
|-
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 0.142 || 0.292 || 0.073 || 0.360 || 0.049 || 0.384
|-
|}

See the [https://docs.google.com/spreadsheets/d/1OzlP2v6P1OGxK1xCFr77aqVfNNEaEKHlA89aSVmqBGw/edit?usp=sharing source spreadsheet] for the corresponding factors for the other inserter types. Their errors are generally well below 1%.

===Belt to chest===

When picking items from a belt, many more factors come into play besides belt fullness:

* How fast the items move (i.e. if they are queued up on the belt or move at belt speed).
* Whether the belt is perpendicular to the inserter or approaches it head on.
* Whether items are on the near or far lane of a perpendicular belt.
* Whether the belt turns or not, and whether the items are in the inner or outer side of the bend.
* If the belt is an underground entrance or exit. This shortens the time items are visible to the inserter for pickup.
* All sorts of intricate timing factors between the inserter and the items on the belt, since the game simulates the arm homing in on every item.

The test setup used below is with a south-to-north inserter taking items from a perpendicular belt with items on the far lane only. The belt is fully compressed and timings are both for items that move at full speed and queued up as much as possible. Values are given for the stack sizes at three different [[inserter capacity bonus (research)|capacity bonus]] levels.

{| class="wikitable"
! rowspan=4 | Type
! colspan=15 | Items/second at [[inserter capacity bonus (research)|capacity bonus]] level (stack size)
|-
! colspan=5 | No capacity bonus
! colspan=5 | Capacity bonus 2
! colspan=5 | Capacity bonus 7
|-
! colspan=3 | Items at belt speed
! rowspan=2 | Items queued up
! rowspan=2 |
! colspan=3 | Items at belt speed
! rowspan=2 | Items queued up
! rowspan=2 |
! colspan=3 | Items at belt speed
! rowspan=2 | Items queued up
! rowspan=2 |
|-
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]]
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]]
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]]
|- align="center"
| align="left"| {{imagelink|burner-inserter|Burner inserter}} || '''0.56''' || '''0.56''' || 0.51 || 0.65 || (1) || '''1.11''' || 1.07 || 0.98 || 1.18 || (2) || 1.43 || '''1.54''' || 1.43 || 1.75 || (3)
|- align="center"
| align="left"| {{imagelink|basic-inserter|Basic inserter}} || '''0.83''' || 0.74 || 0.77 || 0.90 || (1) || '''1.57''' || 1.48 || 1.45 || 1.62 || (2) || 2.00 || '''2.11''' || 2.07 || 2.40 || (3)
|- align="center"
| align="left"| {{imagelink|long-handed-inserter|Long handed inserter}} || '''1.16''' || 1.11 || 1.11 || 1.22 || (1) || 2.22 || '''2.22''' || 2.11 || 2.31 || (2) || 3.08 || 3.08 || '''3.16''' || 3.33 || (3)
|- align="center"
| align="left"| {{imagelink|fast-inserter|Fast inserter}} {{imagelink|filter-inserter|Filter inserter}} || '''2.22''' || '''2.22''' || 2.14 || 2.40 || (1) || '''4.17''' || 3.81 || 4.00 || 4.29 || (2) || '''5.71''' || 5.45 || 5.46 || 6.21 || (3)
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || '''4.17''' || 3.81 || 4.00 || 4.29 || (2) || '''6.67''' || '''6.67''' || 6.15 || 6.67 / 7.50 / 7.74 * || (4) || 6.67 || 10.00 || '''12.00''' || 6.67 / 11.61 / 13.58 * || (12)
|-
|}

<nowiki>*)</nowiki> Throughput for basic/fast/express belt.

Since there are many more factors involved, these measurements exhibit a more complex pattern than chest-to-belt.

* Boldface cells show for which belt each inserter has the best throughput on each bonus level when items move at belt speed. Higher speed belts mean that inserters have to work harder to catch the fast moving items. The effect is most noticeable for slower inserters and smaller stack sizes.
* When items are queued up the belt type hardly matters, so there is only a single column for that. The exceptions are the stack inserters - for basic transport belts it's the belt that sets the limit for stack sizes above 4, and there is also a notable difference between fast and express belts.

Here are linearly fitted factors to get the [[Stack inserter]] and [[Stack filter inserter]] throughput at any capacity level, by using the belt/chest throughput formula above:

{| class="wikitable"
! rowspan=2 | Type
! colspan=2 | {{imagelink|basic-transport-belt|Transport belt}}
! colspan=2 | {{imagelink|fast-transport-belt|Fast transport belt}}
! colspan=2 | {{imagelink|express-transport-belt|Express transport belt}}
|-
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 0.045* || 0.403* || 0.063 || 0.387 || 0.049 || 0.416
|-
|}

<nowiki>*)</nowiki> Since the belt is the limiting factor above stack size 4, these figures are only accurate up to that size. More than that and the throughput is fixed at 6.67 items per second.

==See Also==
* [[Electric network]]
* [[Transport network]]
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=5253 Inserter Power Efficiency]: Movements per energy and exact power usage numbers. See also [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=6258 this thread], where energy per movement is explained.
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=5400 Small Inserter Test]: Comparison if energy usage per item.
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=5524 Inserter heartbeats]: In some situations it is not possible to calculate the needed power usage.
===Special behavior===
* [[Inserters/Interaction with other Entities]]
* [[Inserter item stack size bonus]]: Inserter moves more than an item per turn.
* [[Inserter experiments]]
{{LogisticsNav}}

[[Category:Items]]
[[Category:Transport network]]
[[Category:Circuit network]]

Inserters

2017-05-27T18:41:06Z

Ignatio: Inserters are no longer worse in south-north direction. Also updated numbers from improved test rig.

{{Languages}}

''For the common yellow electrical inserter, see [[Inserter]].''

'''Inserters''' are devices which are used to move items over short distances. When placed, they have a fixed direction. They can move items from behind and place them in front of them. By doing this, they can move items from one transport belt to another, but also extract items from, and insert items into machines or storage devices. There are seven types of inserters, all requiring electricity to run (except the Burner Inserter, which burns [[Fuel|fuel]]).

== Types Of Inserters ==

{| class="wikitable"
| {{imagelink|burner-inserter|Burner inserter}} || The only [[fuel]]-powered inserter.
|-
| {{imagelink|basic-inserter|Basic inserter}} || The standard electrical inserter.
|-
| {{imagelink|long-handed-inserter|Long handed inserter}} || Capable of inserting and removing items from a greater distance.
|-
| {{imagelink|fast-inserter|Fast inserter}} || Much faster than the Basic inserter.
|-
| {{imagelink|filter-inserter|Filter inserter}} || Variant of the Fast inserter that can filter items by type.
|-
| {{imagelink|stack-inserter|Stack inserter}} || As fast as the Fast inserter but can move many more items at the same time.
|-
| {{imagelink|stack_filter_inserter|Stack filter inserter}} || Variant of the Stack inserter that can filter items by type.
|-
|}

==Mechanics==
Inserters '''will''':
* '''Pick up''' [[Items]] off the ground, off of a [[Transport belts|Transport belt]], or from any object that has storage space, including [[Storages/Chests|chests]], [[furnace]]s and [[assembling machine]]s.
* '''Place''' the item onto the ground, onto a transport belt, or into any object that has storage space.
* Inserters can place items on all types of conveyor belts.
* Try to pick up items from all types of belts (as of v0.12 there is no limitation anymore).
* Inserters will run at slower speeds when starved for energy.

Inserters will '''not''':
* Pick up any items that can not be inserted into the connected entity.
* Pick up items into an entity with a full inventory.
* Place more than one item at a time onto the same ground tile.
* Place items into a stack limited inventory, beyond the stack limit (red slots).

Inserters act differently depending on what they are moving items to/into so as not to monopolize all of the items being picked up. This allows other machines and inserters on the same transport belt to pick up a share of the items. If two inserters are picking up from the same tile, the first placed inserter has priority.

==Insertion Limits==
Inserters will stop inserting items into certain buildings if they already have enough of that item. For example, if a boiler has 5 or more items of fuel in it, an inserter will not insert additional fuel. When the fuel drops below 5 items, the inserter will continue to insert more fuel, up to the limit of 5 items.

This is to allow for all machines to receive their share of items. The common limits on insertion are shown in the table below.

{| class="wikitable"
! Entity !! Item type !! Inserter limit !! Comment
|-
| [[Boiler]]s, [[Burner inserter]]s, [[Furnace]]s || [[Fuel]] || align="center" | 5 ||
|-
| [[Gun turret]]s || Bullet Magazines || align="center" | 10 || Since v0.8.4. Allows for 100 shots before depleting.
|-
| [[Assembling machine]]s || Items needed for the recipe || Double the number of items needed in the recipe ||
|-
| [[Furnace]]s || Items needed for the recipe || Double the number of items needed in the recipe ||
|-
| [[Lab]]s || [[Science pack]]s || Double the number of items needed for one research point ||
|}

An inserter that takes items from an object containing [[Storage/Stack|stacks]] of items (such as a chest) can overfill the target building due to the [[Inserter item stack size bonus]] research. Overfilling can also happen if multiple inserters are used to insert items into one building.

==Inserters And Transport Belt Interaction ==
[[Transport belts]] have two lanes on which items can travel. Inserters only place items onto one side of the belt. Which side they place it on depends on the orientation of the inserter and the belt, as described below.

: [[File:PlaceOnFarSide.gif|left]]
* Inserters will '''always''' place the item on the furthest lane.
{{clear}}
: [[File:TakeFromNearSide.gif|left]]
* Inserters '''prefer''' taking items from the nearest lane. If the nearest lane is empty, the inserter will take from the far lane.
{{clear}}
: [[File:PlaceOnRightSide.gif|left]]
* If a belt is in the same orientation as the inserter, the item will be placed on the right-hand lane, from the belt's perspective.
{{clear}}
: [[File:PlaceOnInsideOfCorner.gif|left]]
* If the item is placed on a corner piece, it will be put on the inside of the curve, regardless of orientation.
{{clear}}

== Potential Issues ==
Inserters may have problems picking up items:

* From very fast belts, because the items are moving too quickly.
* From the entry or exit of an underground belt (because the time they have to pick up is shorter)
* From turning belts if the item is on the inside of the corner

==Inserter Item Stack Size Bonus==

If an inserter moves items from inventory to inventory (for example from an assembler into a chest), or (as of v0.13) from an inventory to a belt, it is able to transport more items at once. The secret behind this is the [[Inserter item stack size bonus]] research.

==Power Usage==
* Electric inserters drain energy even when they are not moving, as idle power
* The amount of energy used is the same for every movement
* The [[Burner inserter]] does not drain energy when idle, but uses more energy when it is active. It is quite useful for situations where the inserter does not need to move very often.

==Inserter Speed==

{| class="wikitable"
! Type
! Rotation-speed (turns per [[Tick]]) Extension-speed ([[Tile]]s per Tick)
! Turns per [[Game-second]] Tiles per Game-second
! Game-second per full turn Game-seconds per Tile
! Ticks per full turn Ticks per Tile
|- align="center"
| align="left"| {{imagelink|burner-inserter|Burner Inserter}} || 0.01 0.0214 || 0.6 1.284 || 1.667 0.833 || 102 76
|- align="center"
| align="left"| {{imagelink|basic-inserter|Basic inserter}} || 0.014 0.03 || 0.84 1.8 || 1.191 0.56 || 72 54
|- align="center"
| align="left"| {{imagelink|long-handed-inserter|Long handed inserter}} || 0.02 0.0457 || 1.2 2.742 || 0.833 0.416 || 52 36
|- align="center"
| align="left"| {{imagelink|fast-inserter|Fast inserter}} {{imagelink|stack-inserter|Stack inserter}} {{imagelink|Stack_filter_inserter|Stack filter inserter}} || 0.04 0.07 || 2.4 4.2 || 0.417 0.238 || 26 24
|-
|}

===Rotation Speed===
Convention: 2π rad = 100% of a circle rotation = '''1 turn''' (or one full rotation).

Note: an Inserter doesn't always need to make full turns. When grabbing from a transport belt, it is slightly faster when grabbing items from the closest lane.

===Extension Speed===
The extension-speed is normally not visible (only when compared to other inserters), but there are measurable speed differences when taking - for example - from the near or the far side of a belt. Also Some mods can alter the pickup and drop locations of inserters, making this stat more relevant.

==Inserter Throughput==

The following is based on [https://docs.google.com/spreadsheets/d/1OzlP2v6P1OGxK1xCFr77aqVfNNEaEKHlA89aSVmqBGw/edit?usp=sharing experimental data] gathered in version 0.15.

Inserter throughput between chests and other [[stack|stacks]] is a simple function of stack size and arm speed:

<blockquote>
''n'' = Stack size

''t_arm'' = Time to move the arm back and forth

Time per item = ''t_arm'' / ''n''

Throughput (items/sec) = 1 / Time per item = ''n'' / ''t_arm''
</blockquote>

When moving items to or from belts, the time to pick up or put down items also becomes a factor:

<blockquote>
''t_item'' = Time to pick up or put down or an item

''t_cycle'' = Time to complete an arm cycle = ''t_arm'' + ''n''*''t_item''

Time per item = ''t_cycle'' / ''n'' = ''t_item'' + ''t_arm'' / ''n''

Throughput (items/sec) = 1 / (''t_item'' + ''t_arm'' / ''n'')
</blockquote>

===Chest to chest===

{| class="wikitable"
! rowspan=2 | Type
! rowspan=2 | Arm cycles per second
! colspan=6 | Items/second at [[inserter capacity bonus (research)|capacity bonus]] level (stack size)
|-
! colspan=2 | No capacity bonus
! colspan=2 | Capacity bonus 2
! colspan=2 | Capacity bonus 7
|- align="center"
| align="left"| {{imagelink|burner-inserter|Burner inserter}} || 0.59 || 0.59 || (1) || 1.18 || (2) || 1.76 || (3)
|- align="center"
| align="left"| {{imagelink|basic-inserter|Basic inserter}} || 0.83 || 0.83 || (1) || 1.67 || (2) || 2.50 || (3)
|- align="center"
| align="left"| {{imagelink|long-handed-inserter|Long handed inserter}} || 1.15 || 1.15 || (1) || 2.31 || (2) || 3.46 || (3)
|- align="center"
| align="left"| {{imagelink|fast-inserter|Fast inserter}} {{imagelink|filter-inserter|Filter inserter}} || 2.31 || 2.31 || (1) || 4.62 || (2) || 6.93 || (3)
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 2.31 || 4.62 || (2) || 9.23 || (4) || 27.70 || (12)
|-
|}

===Chest to belt===

Throughput going from chest to belt depends on how full the belt is and how the items are spaced, i.e. if spaces are large enough to fill with items. Underground entrances and exits also makes it easier for the inserter to put down an item.

In these measurements inserters move items onto an empty perpendicular belt. Values are given for the stack sizes at three different [[inserter capacity bonus (research)|capacity bonus]] levels.

{| class="wikitable"
! rowspan=3 | Type
! colspan=12 | Items/second at [[inserter capacity bonus (research)|capacity bonus]] level (stack size)
|-
! colspan=4 | No capacity bonus
! colspan=4 | Capacity bonus 2
! colspan=4 | Capacity bonus 7
|-
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]] ||
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]] ||
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]] ||
|- align="center"
| align="left"| {{imagelink|burner-inserter|Burner inserter}} || 0.59 || 0.59 || 0.59 || (1) || 1.10 || 1.13 || 1.14 || (2) || 1.53 || 1.62 || 1.67 || (3)
|- align="center"
| align="left"| {{imagelink|basic-inserter|Basic inserter}} || 0.83 || 0.83 || 0.83 || (1) || 1.52 || 1.58 || 1.60 || (2) || 2.05 || 2.22 || 2.31 || (3)
|- align="center"
| align="left"| {{imagelink|long-handed-inserter|Long handed inserter}} || 1.15 || 1.15 || 1.15 || (1) || 2.03 || 2.14 || 2.18 || (2) || 2.65 || 2.95 || 3.10 || (3)
|- align="center"
| align="left"| {{imagelink|fast-inserter|Fast inserter}} {{imagelink|filter-inserter|Filter inserter}} || 2.31 || 2.31 || 2.31 || (1) || 3.64 || 4.00 || 4.14 || (2) || 4.29 || 5.14 || 5.63 || (3)
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 3.64 || 4.00 || 4.14 || (2) || 4.71 || 6.15 || 6.86 || (4) || 5.90 || 9.60 || 12.20 || (12)
|-
|}

To calculate the throughput for [[Stack inserter]] and [[Stack filter inserter]] at any capacity level, you can use these linearly fitted factors with the belt/chest throughput formula above:

{| class="wikitable"
! rowspan=2 | Type
! colspan=2 | {{imagelink|basic-transport-belt|Transport belt}}
! colspan=2 | {{imagelink|fast-transport-belt|Fast transport belt}}
! colspan=2 | {{imagelink|express-transport-belt|Express transport belt}}
|-
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 0.142 || 0.292 || 0.073 || 0.360 || 0.049 || 0.384
|-
|}

See the [https://docs.google.com/spreadsheets/d/1OzlP2v6P1OGxK1xCFr77aqVfNNEaEKHlA89aSVmqBGw/edit?usp=sharing source spreadsheet] for the corresponding factors for the other inserter types. Their errors are generally well below 1%.

===Belt to chest===

When picking items from a belt, many more factors come into play besides belt fullness:

* How fast the items move (i.e. if they are queued up on the belt or move at belt speed).
* Whether the belt is perpendicular to the inserter or approaches it head on.
* Whether items are on the near or far lane of a perpendicular belt.
* Whether the belt turns or not, and whether the items are in the inner or outer side of the bend.
* If the belt is an underground entrance or exit. This shortens the time items are visible to the inserter for pickup.
* All sorts of intricate timing factors between the inserter and the items on the belt, since the game simulates the arm homing in on every item.

The test setup used below is with a south-to-north inserter taking items from a perpendicular belt with items on the far lane only. The belt is fully compressed and timings are both for items that move at full speed and queued up as much as possible. Values are given for the stack sizes at three different [[inserter capacity bonus (research)|capacity bonus]] levels.

{| class="wikitable"
! rowspan=4 | Type
! colspan=15 | Items/second at [[inserter capacity bonus (research)|capacity bonus]] level (stack size)
|-
! colspan=5 | No capacity bonus
! colspan=5 | Capacity bonus 2
! colspan=5 | Capacity bonus 7
|-
! colspan=3 | Items at belt speed
! rowspan=2 | Items queued up
! rowspan=2 |
! colspan=3 | Items at belt speed
! rowspan=2 | Items queued up
! rowspan=2 |
! colspan=3 | Items at belt speed
! rowspan=2 | Items queued up
! rowspan=2 |
|-
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]]
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]]
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]]
|- align="center"
| align="left"| {{imagelink|burner-inserter|Burner inserter}} || '''0.56''' || '''0.56''' || 0.51 || 0.65 || (1) || '''1.11''' || 1.07 || 0.98 || 1.18 || (2) || 1.43 || '''1.54''' || 1.43 || 1.75 || (3)
|- align="center"
| align="left"| {{imagelink|basic-inserter|Basic inserter}} || '''0.83''' || 0.74 || 0.77 || 0.90 || (1) || '''1.57''' || 1.48 || 1.45 || 1.62 || (2) || 2.00 || '''2.11''' || 2.07 || 2.40 || (3)
|- align="center"
| align="left"| {{imagelink|long-handed-inserter|Long handed inserter}} || '''1.16''' || 1.11 || 1.11 || 1.22 || (1) || 2.22 || '''2.22''' || 2.11 || 2.31 || (2) || 3.08 || 3.08 || '''3.16''' || 3.33 || (3)
|- align="center"
| align="left"| {{imagelink|fast-inserter|Fast inserter}} {{imagelink|filter-inserter|Filter inserter}} || '''2.22''' || '''2.22''' || 2.14 || 2.40 || (1) || '''4.17''' || 3.81 || 4.00 || 4.29 || (2) || '''5.71''' || 5.45 || 5.46 || 6.21 || (3)
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || '''4.17''' || 3.81 || 4.00 || 4.29 || (2) || '''6.67''' || '''6.67''' || 6.15 || 6.67 / 7.50 / 7.74 * || (4) || 6.67 || 10.00 || '''12.00''' || 6.67 / 11.61 / 13.58 * || (12)
|-
|}

<nowiki>*)</nowiki> Throughput for basic/fast/express belt.

Since there are many more factors involved, these measurements exhibit a more complex pattern than chest-to-belt.

* Boldface cells show for which belt each inserter has the best throughput on each bonus level when items move at belt speed. Higher speed belts mean that inserters have to work harder to catch the fast moving items. The effect is most noticeable for slower inserters and smaller stack sizes.
* When items are queued up the belt type hardly matters, so there is only a single column for that. The exceptions are the stack inserters - for basic transport belts it's the belt that sets the limit for stack sizes above 4, and there is also a notable difference between fast and express belts.

Here are linearly fitted factors to get the [[Stack inserter]] and [[Stack filter inserter]] throughput at any capacity level, by using the belt/chest throughput formula above:

{| class="wikitable"
! rowspan=2 | Type
! colspan=2 | {{imagelink|basic-transport-belt|Transport belt}}
! colspan=2 | {{imagelink|fast-transport-belt|Fast transport belt}}
! colspan=2 | {{imagelink|express-transport-belt|Express transport belt}}
|-
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 0.045* || 0.403* || 0.063 || 0.387 || 0.049 || 0.416
|-
|}

<nowiki>*)</nowiki> Since the belt is the limiting factor above stack size 4, these figures are only accurate up to that size. More than that and the throughput is fixed at 6.67 items per second.

==See Also==
* [[Electric network]]
* [[Transport network]]
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=5253 Inserter Power Efficiency]: Movements per energy and exact power usage numbers. See also [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=6258 this thread], where energy per movement is explained.
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=5400 Small Inserter Test]: Comparison if energy usage per item.
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=5524 Inserter heartbeats]: In some situations it is not possible to calculate the needed power usage.
===Special behavior===
* [[Inserters/Interaction with other Entities]]
* [[Inserter item stack size bonus]]: Inserter moves more than an item per turn.
* [[Inserter experiments]]
{{LogisticsNav}}

[[Category:Items]]
[[Category:Transport network]]
[[Category:Circuit network]]

Circuit network

2017-05-27T01:25:43Z

Ignatio: Some clarifications and details on the number range.

{{Languages}}
'''Circuit networks''' are built using red or green wire, and enable the control of receivers, based upon information broadcast onto the network by connected senders. Most senders are storage devices, and broadcast their information onto a specific channel, based on the item or liquid the storage device contains. Each circuit network contains a channel for every kind of item, as well as 45 extra [[Virtual signals]] which act as user-definable channels. 'Everything', 'Anything' and 'Each' are also available wildcards.

[[File:InnerOfGreenCable.jpg|right|thumb|400px|A player drawn visualization of the interior of a circuit cable.]]

== Usage ==
=== Send Information ===
Senders broadcast the amount of [[Items]] or [[Liquids system|Fluids]] they contain or other data definable by the player. Each amount is broadcast as a numeric value on a 'channel' corresponding to the item. For example, a Storage Tank containing 1000 Crude Oil will broadcast 1000 on the Crude Oil channel.

The channels are separated from each other, so each network can simultaneously carry a number for each item and fluid in the game, and for each of the extra user-defined channels (digits 0-9, letters A-Z, and 9 different colors). All unused channels have the value zero.

Multiple broadcasts of the same item or fluid are additive: If there are two connected Storage Tanks with 1000 Crude Oil each, the value of the Crude Oil channel within the network will be 2000.

All wires of the same color which are connected together by junctions form a network, i.e. they will pass their signals to each other. For example, if two red wires are connected to the same combinator input, each wire receives the content from the other. This can result in feedback if care is not taken; see Feedback (under Arithmetic Combinator, below) for discussion.

Numbers are in the signed 32 bit integer range, i.e. from -2147483648 to 2147483647 inclusive. The numbers wrap around on overflow, so e.g. 2147483647 + 10 becomes -2147483639.

=== Control Devices ===
[[File:smart_inserter.png|thumb|250px|Example condition: "Work only if the count of Iron plates is lower than the count of Steel plates." Remember to set the filter as well.]]
Receivers can use broadcast information, in most cases to enable/disable the device.

They can either compare results between different channels, or compare a channel to a specific value. The pictured inserter works if the count of [[Iron plate|Iron plates]] is lower than the count of [[Steel plate|Steel plates]].

Receiving devices sum all signals from each wire connected to them, even red and green wires. For example, if an inserter is connected to a red wire carrying a signal for 20 iron plates, a green wire with 10 copper plates and another green wire with 5 iron plates, the input signal set for that receiver will be 25 iron plates and 10 copper plates.

== Devices ==

Since version 0.13 each entity connectable to one of the networks has icons in its top right corner. By clicking the left icon, you have access to the circuit network settings (if one is connected), by clicking the right icon, you have access to the logistic network settings, if one is reachable. There can be set conditions for both circuit (signals of red and green wires are summed) and logistic network, which will together act as a logical AND.

=== Senders ===
These devices can send signals to the circuit network.

{| class="wikitable"
| {{imagelink|basic-transport-belt|Transport belts}} || Transport belts can send their content to the Circuit network.
''Pulse mode'': The signal is sent for only 1 tick when the item enters the belt.

''Hold mode'': The signal is sent continuously as long as the items are on the belt.
|-
| {{imagelink|basic-inserter|Inserters}} || All inserters can send their held items to the Circuit network.
''Pulse mode'': The signal is sent for only 1 tick when the item is picked up.

''Hold mode'': The signal is sent continuously as long as the inserter is holding the item.
|-
| {{imagelink|wooden-chest|Chests}} || All chests can send their contents to the Circuit network. Logistic chests additionally send their contents to the [[Logistic network]].
|-
| {{imagelink|storage-tank|Storage tank}} || The storage tank can send its fluid content to the Circuit network.
|-
| {{imagelink|gate|Gate}} || Gates can send a signal to the Circuit network.
|-
| {{imagelink|rail-signal|Rail signal}} || Rail signals can send their state to the Circuit network.
|-
| {{imagelink|basic-accumulator|Accumulator}} || It can send its charge level in percent to the Circuit network.
|-
| {{imagelink|roboport|Roboport}} || It can send its logistic network contents or its robot statistics to the Circuit network.
|-
| {{imagelink|electric-mining-drill|Electric mining drill}} || It can send output the remaining expected resources.
|-
| {{imagelink|pumpjack|Pumpjack}} || It can output the current oil mining rate.
|}

=== Receivers ===

{| class="wikitable"
| {{imagelink|basic-transport-belt|Transport belts}} || Transport belts can be enabled on a condition.
|-
| {{imagelink|basic-inserter|Inserters}} || All inserters can be enabled on a condition.
|-
| {{imagelink|filter-inserter|Filter inserter}} || The filter inserter can additionally set its filters from the Circuit network.
|-
| {{imagelink|requester-chest|Requester chest}} || Its requested items can be set by the Circuit network.
|-
| {{imagelink|gate|Gate}} || Gates can be opened on a condition.
|-
| {{imagelink|rail-signal|Rail signal}} || Rail signals can prevent trains by passing on a condition (set signal to red).
|-
| {{imagelink|small-lamp|Lamp}} || The lamp can be enabled on a condition. If it receives color signals, it can set the given color.
|-
| {{imagelink|offshore-pump|Offshore pump}} || The offshore pump can be enabled on a condition.
|-
| {{imagelink|small-pump|Small pump}} || The small pump can be enabled on a condition.
|-
| {{imagelink|train-stop|Train stop}} || Train stations can send the contents of the Circuit network to the train to use it for wait conditions, as well as enable/disable the stop itself.
|-
| {{imagelink|power-switch|Power switch}} || Power switches can connect to power networks on a condition.
|-
| {{imagelink|electric-mining-drill|Electric mining drill}} || It can be enabled on a condition.
|-
| {{imagelink|pumpjack|Pumpjack}} || It can be enabled on a condition.
|-
| {{imagelink|Programmable_speaker|Programmable speaker}} || shows alerts and plays sounds based on circuit network signals. It can be used to make simple songs.
|}

== Physical network structure ==
A circuit network consists only of those devices connected together with the same color wire. Wire can be strung directly from device to device, or across any intervening power poles. Wire length is limited by its previous connection.

Note that each connected set of wires forms a separate network. For example, it's entirely possible to have four red-wire networks and three green-wire networks. If red and green wires happen to touch the same power pole or device, the red and green networks will remain separate and will not link up . However, two red cables or two green cables will link if they touch. Use different colored cables to separate networks in close proximity.

* To connect wires or cables to a power pole, simply click on one entity, then on the base of the power pole.
* To erase a wire or cable connection, place the same color wire over an existing connection. You don't get the wire/cable back.
* To remove '''all''' connections from a power pole, shift-click on the pole. The first shift-click will remove all electrical connections, and the second will remove all red and green wires. You don't get the wires back.
* When connecting to a [[Arithmetic Combinator]] or [[Decider Combinator]], take care to connect the wire to the correct input or output side. Use ALT-Key-Mode to see direction of combinator.
* Hovering the mouse cursor over an item will highlight all wires which form the network of the item.
* Hovering the mouse cursor over a power pole which is part of a network will display the signals on its network. Some items like combinators will also display their input and output signals when hovered over.

== Combinators ==
Combinators can function as both receiving and sending devices and allow more advanced functions to be used on a circuit network.

*The [[Constant Combinator]] broadcasts up to 15 values on any of the channels for whatever networks it is connected to. (You cannot currently specify whether a value should be on the red or green channel; if you need different values, use two combinators, one for each color wire.) You can use any item channel or any of the [[Automatic control/Virtual signals|virtual signal]] channels.
**Note that using two of the 15 slots to broadcast values on the '''same''' channel is the same as broadcasting the sum of the two values from one slot.

*The [[Arithmetic Combinator]] performs arithmetic operations on input values and broadcasts the result to the specified output channel. The input and output channels can be any item channel or any of the virtual signal channels.
** Connecting: The Arithmetic Combinator connects to a red or green network on its '''input''' side (the terminals are set into the main body and look like spark plugs) and performs an arithmetic calculation which is broadcast into the specified channel on its '''output''' side (the output wires appear to stretch out a bit from the body of the device).
** Feedback: Note that the input network and the output network '''are not the same network'''. Connecting the output network back to the input network will result in a feedback loop. For example, adding 1 to the value for Copper Plates and broadcasting it as Copper Plates is an action that results in an infinite loop if output is connected back to input. The value for Copper Plates will rapidly (but not instantly) shoot upward. (Fun fact: The rate at which it climbs is the current tick rate) This technique can be combined with Decider Combinator logic to make electronic clocks, gates, and other systems; see [[Combinator Tutorial]] for advanced techniques.
** Each: This combinator can use the 'Each' signal for both input and output, in which case '''all''' non-zero input channels will have the combinator's operation performed and broadcast on the output side. Having Each signals for input and output and using a non-changing operation (like adding zero) is equivalent to having a 'one-way' wire; all the information from the input network is copied to the output network, but the reverse is not true.
**Multi-network: The Arithmetic Combinator can be joined to both red and green networks on the input side and will sum their inputs.

*The [[Decider Combinator]] functions much like an Arithmetic Combinator, but is designed to compare values. Essentially, it is a conditional. In terms of Connecting, Feedback, and the Each signal it functions as specified above. In addition, it can handle the Everything and Anything signals, and performs more complex functions than summing when attached to multiple networks. See the [[Decider Combinator]] page for more details on how to use this.

== Tutorials ==
'''[[Circuit-network Cookbook|Circuit Network Cookbook]]''' - ''Example heavy tutorials; for beginners who want to use the benefits of the Circuit Network.''

'''[[Combinator Tutorial]]''' - ''Mainly textual and detailed tutorials; for amateurs who can sometimes refer to this.''

''[http://www.reddit.com/r/factorio The official Factorio Reddit], if you'd like to ask any questions about circuitry in Factorio.''

== Logistic Network ==
The Logistic network used by [[Logistic robot|Logistic robots]] is essentially a third network (a wireless one), along with the green and red wired network. The Logistic Network is based on proximity to a central [[Roboport]].

Some devices can also be connected to the logistic network. If a device has conditions set for circuit and for logistic network, it will become activated if both conditions are true.

See [[Logistic network]] and [[Roboport]] for more information.

== History ==

{{history|0.15.0|
* Significantly improved circuit network performance. Up to 25 times less CPU usage and 10% less memory usage.
* Added the Programmable Speaker: it shows alerts and plays sounds based on circuit network signals. It can be used to make simple songs.
* Train Stop can output the contents of the stopped train's cargo.
* Train Stop can be disabled using the circuit network. Trains will skip disabled Train Stops, allowing simple train control.
* Mining Drills can be turned on and off using the circuit network. They can also output the remaining expected resources.
* Pumpjacks can be turned on and off using the circuit network. They can also output the current oil mining rate.
* Added Modulo, Power, Left Bit Shift, Right Bit Shift, Bitwise AND, Bitwise OR and Bitwise XOR to the Arithmetic Combinator.
* Added additional operators to the Decider Combinator and Circuit Conditions.}}

{{history|0.13.0|
* Many machines are now connectible to the circuit network.
* Wire disconnecting is incorporated into the latency hiding.
* Wires are now highlighted on entity mouseover.
* Reduced memory usage of circuit network.}}

{{history|0.12.33|
* Fluid values are rounded to the closest value instead of rounding down when transmitted to circuit network.}}

{{history|0.12.1|
* One can copy paste circuit network conditions between the [[Inserter]], [[Lamp]], [[Small pump]] and [[Offshore pump]]. }}

{{history|0.12.0|
* Improvements to circuit network connection, one can connect multiple wires of the same color to the same entity.
* The [[Lamp]], [[Storage tank]], [[Small pump]] and [[Offshore pump]] can be connected to the circuit network.
}}

{{history|0.10.0|
* [[Blueprint]]s copy circuit network connections.}}

{{history|0.8.3|
* Circuit network contents info has colored slots to specify the network it represents.}}

{{history|0.1.0|
* Introduced}}

== See also ==
* [[Circuit network (research)]]
* [[Transport network]]
* [[Combinators]]
* [[Virtual signals]]
* [http://www.factorioforums.com/forum/viewtopic.php?f=6&t=4728&p=37251#p37157 Logic gates revisited]

[[Category: Networks]] [[Category: Circuit network]]

Inserters

2017-05-22T01:18:47Z

Ignatio: Made some tables a bit prettier.

{{Languages}}

''For the common yellow electrical inserter, see [[Inserter]].''

'''Inserters''' are devices which are used to move items over short distances. When placed, they have a fixed direction. They can move items from behind and place them in front of them. By doing this, they can move items from one transport belt to another, but also extract items from, and insert items into machines or storage devices. There are seven types of inserters, all requiring electricity to run (except the Burner Inserter, which burns [[Fuel|fuel]]).

== Types Of Inserters ==

{| class="wikitable"
| {{imagelink|burner-inserter|Burner inserter}} || The only [[fuel]]-powered inserter.
|-
| {{imagelink|basic-inserter|Basic inserter}} || The standard electrical inserter.
|-
| {{imagelink|long-handed-inserter|Long handed inserter}} || Capable of inserting and removing items from a greater distance.
|-
| {{imagelink|fast-inserter|Fast inserter}} || Much faster than the Basic inserter.
|-
| {{imagelink|filter-inserter|Filter inserter}} || Variant of the Fast inserter that can filter items by type.
|-
| {{imagelink|stack-inserter|Stack inserter}} || As fast as the Fast inserter but can move many more items at the same time.
|-
| {{imagelink|stack_filter_inserter|Stack filter inserter}} || Variant of the Stack inserter that can filter items by type.
|-
|}

==Mechanics==
Inserters '''will''':
* '''Pick up''' [[Items]] off the ground, off of a [[Transport belts|Transport belt]], or from any object that has storage space, including [[Storages/Chests|chests]], [[furnace]]s and [[assembling machine]]s.
* '''Place''' the item onto the ground, onto a transport belt, or into any object that has storage space.
* Inserters can place items on all types of conveyor belts.
* Try to pick up items from all types of belts (as of v0.12 there is no limitation anymore).
* Inserters will run at slower speeds when starved for energy.

Inserters will '''not''':
* Pick up any items that can not be inserted into the connected entity.
* Pick up items into an entity with a full inventory.
* Place more than one item at a time onto the same ground tile.
* Place items into a stack limited inventory, beyond the stack limit (red slots).

Inserters act differently depending on what they are moving items to/into so as not to monopolize all of the items being picked up. This allows other machines and inserters on the same transport belt to pick up a share of the items. If two inserters are picking up from the same tile, the first placed inserter has priority.

==Insertion Limits==
Inserters will stop inserting items into certain buildings if they already have enough of that item. For example, if a boiler has 5 or more items of fuel in it, an inserter will not insert additional fuel. When the fuel drops below 5 items, the inserter will continue to insert more fuel, up to the limit of 5 items.

This is to allow for all machines to receive their share of items. The common limits on insertion are shown in the table below.

{| class="wikitable"
! Entity !! Item type !! Inserter limit !! Comment
|-
| [[Boiler]]s, [[Burner inserter]]s, [[Furnace]]s || [[Fuel]] || align="center" | 5 ||
|-
| [[Gun turret]]s || Bullet Magazines || align="center" | 10 || Since v0.8.4. Allows for 100 shots before depleting.
|-
| [[Assembling machine]]s || Items needed for the recipe || Double the number of items needed in the recipe ||
|-
| [[Furnace]]s || Items needed for the recipe || Double the number of items needed in the recipe ||
|-
| [[Lab]]s || [[Science pack]]s || Double the number of items needed for one research point ||
|}

An inserter that takes items from an object containing [[Storage/Stack|stacks]] of items (such as a chest) can overfill the target building due to the [[Inserter item stack size bonus]] research. Overfilling can also happen if multiple inserters are used to insert items into one building.

==Inserters And Transport Belt Interaction ==
[[Transport belts]] have two lanes on which items can travel. Inserters only place items onto one side of the belt. Which side they place it on depends on the orientation of the inserter and the belt, as described below.

: [[File:PlaceOnFarSide.gif|left]]
* Inserters will '''always''' place the item on the furthest lane.
{{clear}}
: [[File:TakeFromNearSide.gif|left]]
* Inserters '''prefer''' taking items from the nearest lane. If the nearest lane is empty, the inserter will take from the far lane.
{{clear}}
: [[File:PlaceOnRightSide.gif|left]]
* If a belt is in the same orientation as the inserter, the item will be placed on the right-hand lane, from the belt's perspective.
{{clear}}
: [[File:PlaceOnInsideOfCorner.gif|left]]
* If the item is placed on a corner piece, it will be put on the inside of the curve, regardless of orientation.
{{clear}}

== Potential Issues ==
Inserters may have problems picking up items:

* From very fast belts, because the items are moving too quickly.
* From the entry or exit of an underground belt (because the time they have to pick up is shorter)
* From turning belts if the item is on the inside of the corner

==Inserter Item Stack Size Bonus==

If an inserter moves items from inventory to inventory (for example from an assembler into a chest), or (as of v0.13) from an inventory to a belt, it is able to transport more items at once. The secret behind this is the [[Inserter item stack size bonus]] research.

==Power Usage==
* Electric inserters drain energy even when they are not moving, as idle power
* The amount of energy used is the same for every movement
* The [[Burner inserter]] does not drain energy when idle, but uses more energy when it is active. It is quite useful for situations where the inserter does not need to move very often.

==Inserter Speed==

{| class="wikitable"
! Type
! Rotation-speed (turns per [[Tick]]) Extension-speed ([[Tile]]s per Tick)
! Turns per [[Game-second]] Tiles per Game-second
! Game-second per full turn Game-seconds per Tile
! Ticks per full turn Ticks per Tile
|- align="center"
| align="left"| {{imagelink|burner-inserter|Burner Inserter}} || 0.01 0.0214 || 0.6 1.284 || 1.667 0.833 || 102 76
|- align="center"
| align="left"| {{imagelink|basic-inserter|Basic inserter}} || 0.014 0.03 || 0.84 1.8 || 1.191 0.56 || 72 54
|- align="center"
| align="left"| {{imagelink|long-handed-inserter|Long handed inserter}} || 0.02 0.0457 || 1.2 2.742 || 0.833 0.416 || 52 36
|- align="center"
| align="left"| {{imagelink|fast-inserter|Fast inserter}} {{imagelink|stack-inserter|Stack inserter}} {{imagelink|Stack_filter_inserter|Stack filter inserter}} || 0.04 0.07 || 2.4 4.2 || 0.417 0.238 || 26 24
|-
|}

===Rotation Speed===
Convention: 2π rad = 100% of a circle rotation = '''1 turn''' (or one full rotation).

Note: an Inserter doesn't always need to make full turns. When grabbing from a transport belt, it is slightly faster when grabbing items from the closest lane.

===Extension Speed===
The extension-speed is normally not visible (only when compared to other inserters), but there are measurable speed differences when taking - for example - from the near or the far side of a belt. Also Some mods can alter the pickup and drop locations of inserters, making this stat more relevant.

==Inserter Throughput==

The following is based on [https://docs.google.com/spreadsheets/d/1OzlP2v6P1OGxK1xCFr77aqVfNNEaEKHlA89aSVmqBGw/edit?usp=sharing experimental data] gathered in version 0.15.

Inserter throughput between chests and other [[stack|stacks]] is a simple function of stack size and arm speed:

<blockquote>
''n'' = Stack size

''t_arm'' = Time to move the arm back and forth

Time per item = ''t_arm'' / ''n''

Throughput (items/sec) = 1 / Time per item = ''n'' / ''t_arm''
</blockquote>

When moving items to or from belts, the time to pick up or put down items also becomes a factor:

<blockquote>
''t_item'' = Time to pick up or put down or an item

''t_c'' = Time to complete an arm cycle = ''t_arm'' + ''n''*''t_item''

Time per item = ''t_c'' / ''n'' = ''t_item'' + ''t_arm'' / ''n''

Throughput (items/sec) = 1 / (''t_item'' + ''t_arm'' / ''n'')
</blockquote>

Due to some simulation quirk, inserters are noticeably slower when moving items from south to north. The effect is between 1% and 4% and it tends to be bigger for larger stack sizes. All the measurements below are based on south-to-north movement, to avoid overestimating throughput.

===Chest to chest===

These are measurements chest-to-chest in south-to-north direction.

{| class="wikitable"
! rowspan=2 | Type
! rowspan=2 | Arm cycles per second
! rowspan=2 | Percent faster not south-to-north
! colspan=6 | Items/second at [[inserter capacity bonus (research)|capacity bonus]] level (stack size)
|-
! colspan=2 | No capacity bonus
! colspan=2 | Capacity bonus 2
! colspan=2 | Capacity bonus 7
|- align="center"
| align="left"| {{imagelink|burner-inserter|Burner inserter}} || 0.59 || 1.0% || 0.59 || (1) || 1.18 || (2) || 1.77 || (3)
|- align="center"
| align="left"| {{imagelink|basic-inserter|Basic inserter}} || 0.83 || 1.4% || 0.83 || (1) || 1.66 || (2) || 2.49 || (3)
|- align="center"
| align="left"| {{imagelink|long-handed-inserter|Long handed inserter}} || 1.14 || 1.9% || 1.14 || (1) || 2.29 || (2) || 3.43 || (3)
|- align="center"
| align="left"| {{imagelink|fast-inserter|Fast inserter}} {{imagelink|filter-inserter|Filter inserter}} || 2.24 || 3.7% || 2.24 || (1) || 4.49 || (2) || 6.73 || (3)
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 2.24 || 3.7% || 4.49 || (2) || 8.98 || (4) || 26.93 || (12)
|-
|}

===Chest to belt===

Besides the inserter direction as noted above, the throughput going from chest to belt depends on how full the belt is and how the items are spaced, i.e. if spaces are large enough to fill with items. Underground entrances and exits also makes it easier for the inserter to put down an item.

In these measurements inserters move items south-to-north onto an empty perpendicular belt. Values are given for the stack sizes at three different [[inserter capacity bonus (research)|capacity bonus]] levels.

{| class="wikitable"
! rowspan=3 | Type
! rowspan=3 | Percent faster not south-to-north
! colspan=12 | Items/second at [[inserter capacity bonus (research)|capacity bonus]] level (stack size)
|-
! colspan=4 | No capacity bonus
! colspan=4 | Capacity bonus 2
! colspan=4 | Capacity bonus 7
|-
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]] ||
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]] ||
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]] ||
|- align="center"
| align="left"| {{imagelink|burner-inserter|Burner inserter}} || 0.9% || 0.58 || 0.58 || 0.58 || (1) || 1.10 || 1.13 || 1.14 || (2) || 1.53 || 1.62 || 1.67 || (3)
|- align="center"
| align="left"| {{imagelink|basic-inserter|Basic inserter}} || 1.3% || 0.82 || 0.82 || 0.82 || (1) || 1.51 || 1.57 || 1.59 || (2) || 2.04 || 2.22 || 2.30 || (3)
|- align="center"
| align="left"| {{imagelink|long-handed-inserter|Long handed inserter}} || 1.7% || 1.14 || 1.14 || 1.14 || (1) || 2.01 || 2.12 || 2.16 || (2) || 2.63 || 2.93 || 3.08 || (3)
|- align="center"
| align="left"| {{imagelink|fast-inserter|Fast inserter}} {{imagelink|filter-inserter|Filter inserter}} || 3.0% || 2.23 || 2.23 || 2.23 || (1) || 3.55 || 3.90 || 4.03 || (2) || 4.23 || 5.05 || 5.51 || (3)
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 1.7% || 3.55 || 3.90 || 4.03 || (2) || 4.68 || 6.08 || 6.75 || (4) || 6.09 || 9.86 || 12.49 || (12)
|-
|}

To calculate the throughput for [[Stack inserter]] and [[Stack filter inserter]] at any capacity level, you can use these linearly fitted factors with the belt/chest throughput formula above:

{| class="wikitable"
! rowspan=2 | Type
! colspan=2 | {{imagelink|basic-transport-belt|Transport belt}}
! colspan=2 | {{imagelink|fast-transport-belt|Fast transport belt}}
! colspan=2 | {{imagelink|express-transport-belt|Express transport belt}}
|-
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 0.137 || 0.312 || 0.070 || 0.378 || 0.047 || 0.402
|-
|}

See the [https://docs.google.com/spreadsheets/d/1OzlP2v6P1OGxK1xCFr77aqVfNNEaEKHlA89aSVmqBGw/edit?usp=sharing source spreadsheet] for the corresponding factors for the other inserter types. Their errors are generally well below 1%.

===Belt to chest===

When picking items from a belt, many more factors come into play besides those mentioned above (inserter direction and belt fullness):

* How fast the items move (i.e. if they are queued up on the belt or move at belt speed).
* Whether the belt is perpendicular to the inserter or approaches it head on.
* Whether items are on the near or far lane of a perpendicular belt.
* Whether the belt turns or not, and whether the items are in the inner or outer side of the bend.
* If the belt is an underground entrance or exit. This shortens the time items are visible to the inserter for pickup.
* All sorts of intricate timing factors between the inserter and the items on the belt, since the game simulates the arm homing in on every item.

The test setup used below is with a south-to-north inserter taking items from a perpendicular belt with items on the far lane only. The belt is fully compressed and timings are both for items that move at full speed and queued up as much as possible. Values are given for the stack sizes at three different [[inserter capacity bonus (research)|capacity bonus]] levels.

{| class="wikitable"
! rowspan=4 | Type
! rowspan=4 | Percent faster not south-to-north
! colspan=15 | Items/second at [[inserter capacity bonus (research)|capacity bonus]] level (stack size)
|-
! colspan=5 | No capacity bonus
! colspan=5 | Capacity bonus 2
! colspan=5 | Capacity bonus 7
|-
! colspan=3 | Items at belt speed
! rowspan=2 | Items queued up
! rowspan=2 |
! colspan=3 | Items at belt speed
! rowspan=2 | Items queued up
! rowspan=2 |
! colspan=3 | Items at belt speed
! rowspan=2 | Items queued up
! rowspan=2 |
|-
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]]
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]]
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]]
|- align="center"
| align="left"| {{imagelink|burner-inserter|Burner inserter}} || 0.9% || '''0.56''' || 0.53 || 0.50 || 0.64 || (1) || '''1.03''' || 1.03 || 0.98 || 1.17 || (2) || 1.44 || '''1.54''' || 1.43 || 1.70 || (3)
|- align="center"
| align="left"| {{imagelink|basic-inserter|Basic inserter}} || 1.3% || '''0.82''' || 0.74 || 0.77 || 0.88 || (1) || '''1.57''' || 1.49 || 1.48 || 1.60 || (2) || 2.01 || '''2.11''' || 2.01 || 2.38 || (3)
|- align="center"
| align="left"| {{imagelink|long-handed-inserter|Long handed inserter}} || 1.8% || '''1.11''' || 1.11 || 1.05 || 1.20 || (1) || '''2.11''' || 2.06 || 2.01 || 2.27 || (2) || '''3.01''' || 2.97 || 3.01 || 3.28 || (3)
|- align="center"
| align="left"| {{imagelink|fast-inserter|Fast inserter}} {{imagelink|filter-inserter|Filter inserter}} || 3.3% || 2.15 || '''2.22''' || 2.07 || 2.31 || (1) || 4.01 || '''3.82''' || '''3.82''' || 4.14 || (2) || 5.47 || 5.02 || '''5.47''' || 6.01 || (3)
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 1.9% || 4.01 || '''3.82''' || 3.82 || 4.14 || (2) || 6.17 || 6.18 || '''6.43''' || 6.69 || (4) || 6.67 || 10.03 || '''12.09''' || 13.40 || (12)
|-
|}

Since there are many more factors involved, these measurements exhibit a more complex pattern than chest-to-belt.

* Boldface cells show for which belt each inserter has the best throughput on each bonus level when items move at belt speed. Higher speed belts mean that inserters have to work harder to catch the fast moving items. The effect is most noticeable for slower inserters and smaller stack sizes.
* When items are queued up the belt type hardly matters, so there is only a single column for that. There is however one exception - see (*) below.

Here are linearly fitted factors to get the [[Stack inserter]] and [[Stack filter inserter]] throughput at any capacity level, by using the belt/chest throughput formula above:

{| class="wikitable"
! rowspan=2 | Type
! colspan=2 | {{imagelink|basic-transport-belt|Transport belt}}
! colspan=2 | {{imagelink|fast-transport-belt|Fast transport belt}}
! colspan=2 | {{imagelink|express-transport-belt|Express transport belt}}
|-
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 0.054 (*) || 0.410 (*) || 0.065 || 0.386 || 0.045 || 0.437
|-
|}

<nowiki>*)</nowiki> A stack inserter combined with a basic transport belt gets capped by the belt speed at stack sizes above 4, so these figures are only accurate up to size 4. More than that and the throughput is fixed at 6.67 items per second.

==See Also==
* [[Electric network]]
* [[Transport network]]
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=5253 Inserter Power Efficiency]: Movements per energy and exact power usage numbers. See also [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=6258 this thread], where energy per movement is explained.
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=5400 Small Inserter Test]: Comparison if energy usage per item.
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=5524 Inserter heartbeats]: In some situations it is not possible to calculate the needed power usage.
===Special behavior===
* [[Inserters/Interaction with other Entities]]
* [[Inserter item stack size bonus]]: Inserter moves more than an item per turn.
* [[Inserter experiments]]
{{LogisticsNav}}

[[Category:Items]]
[[Category:Transport network]]
[[Category:Circuit network]]

Long-handed inserter

2017-05-22T00:58:46Z

Ignatio: All inserters can pick up from all belts, at least if they are fully compressed.

{{Languages}}
{{:Long handed inserter/infobox}}

The '''Long handed inserter''' is an electric [[inserter]] that picks up and places items two tiles from its location instead of the usual one. They are commonly used for placing items on a [[Transport belts|belt]] that is three tiles away from either an [[Assembling machine]] or a [[Furnace]].

''Long handed inserters'' have trouble grabbing moving items from [[Express transport belt|express belts]], but can do it if the belt is compressed enough. They can't grab moving items from red/blue turning belts if the item is on the far side.

For more information on mechanics and uses see [[Inserters]].

== History ==

{{history|0.13.2|
* Inserters connected to the circuit network now have the option to only read hand contents.}}

{{history|0.13.0|
* Inserters can now send the item held in hand to the circuit network.
* Inserters are able to squeeze things ''slightly'' better to belts. more resources.
* All types of inserters can be controlled by the circuit and logistic network, once the respective network is researched.
}}

{{history|0.12.2|
* Inserters will never take more than the max stack size of an item.
* Inserters and logistic robots no longer extract from enemy chests
* Inserters now correctly pick up items from splitters
}}

{{history|0.12.0|
* Inserters can now extract from Roboports and Beacons.
* Inserters now take items from right behind them, not from the center of the pickup target entity.}}

{{history|0.10.0|
* New icon
* New sounds}}

{{history|0.9.2|
* Inserters can have arbitrary pickup and insert positions.}}

{{history|0.9.0|
* Inserter code optimisation, inserters that have nothing to do will sleep.}}

{{history|0.8.0|
* Improved inserter's ability to pull from train wagons.}}

{{history|0.5.0|
* Inserter can now pick up up to 5 items when researched.}}

{{history|0.4.0|
* Smaller inserter bounding box}}

{{history|0.3.0|
* New Inserter graphics}}

{{history|0.2.1|
* The item in the hand of the inserter is returned to the player when mined.}}

{{history|0.2.0|
* Show direction of inserter}}

{{history|0.1.0|
* Introduced}}

== See also ==
* [[Transport network]]
* [[Electric network]]
* [[Inserters]]
* [[Inserter experiments]]: Info about throughput

{{LogisticsNav}}

[[Category:Items]]
[[Category:Transport network]]
[[Category:Electric network]]
[[Category:Inserters]]

Inserter

2017-05-22T00:56:03Z

Ignatio: All inserters can pick up from all belts, at least if they are fully compressed.

{{Languages}}
{{:Inserter/infobox}}

The '''inserter''' (also known as '''yellow inserter''', or '''basic inserter''') can be used to transfer items between entities such as [[transport belt|transport belts]] and [[stone furnace|stone furnaces]]. It is the most basic electric inserter.

Unlike the [[fast inserter]], the inserter is not fast enough to pick up items moving on a [[express transport belt|express transport belts]], unless it is highly compressed or items have stopped due to a blockage. Additionally, the basic inserter is unable to access items on the far side of a curving transport belt.

The inserter is notable in that it is used in the creation of [[Science Pack 2|Science Pack 2]], so players must create an automated inserter assembly line. The basic inserter is also used in the creation of both the fast inserter and the long inserter, and serves as the base item for all electric inserters.

For more information on mechanics and uses see [[Inserters]].

== History ==

{{history|0.13.2|
* Inserters connected to the circuit network now have the option to only read hand contents.}}

{{history|0.13.0|
* Inserters can now send the item held in hand to the circuit network.
* Inserters are able to squeeze things ''slightly'' better to belts. more resources.
* All types of inserters can be controlled by the circuit and logistic network, once the respective network is researched.
* Inserter stack size bonus research is now only used for [[stack inserter]]s.
}}

{{history|0.12.2|
* Inserters will never take more than the max stack size of an item.
* Inserters and logistic robots no longer extract from enemy chests
* Inserters now correctly pick up items from [[splitter]]s.
}}

{{history|0.12.0|
* Inserters can now extract from [[Roboport]]s and [[Beacon]]s.
* Inserters now take items from right behind them, not from the center of the pickup target entity.
}}

{{history|0.10.0|
* New icon
* New sounds
}}

{{history|0.9.2|
* Inserters can have arbitrary pickup and insert positions.}}

{{history|0.9.0|
* Inserter code optimization, inserters that have nothing to do will sleep.}}

{{history|0.8.0|
* Improved inserter's ability to pull from train wagons.}}

{{history|0.7.1|
* Fast inserter now has the same speed as the smart inserter.}}

{{history|0.5.0|
* Inserter can now pick up up to 5 items when researched.}}

{{history|0.4.0|
* Smaller inserter bounding box}}

{{history|0.3.0|
* New Inserter graphics}}

{{history|0.2.1|
* The item in the hand of the inserter is returned to the player when mined.}}

{{history|0.2.0|
* Show direction of inserter}}

{{history|0.1.0|
* Introduced}}

== See also ==
* [[Transport network]]
* [[Electric network]]
* [[Inserters]]
* [[Inserter experiments]] for their throughput.

{{LogisticsNav}}

[[Category:Transport network]]
[[Category:Electric network]]

Burner inserter

2017-05-22T00:52:42Z

Ignatio: All inserters can pick up from all belts, at least if they are fully compressed.

{{Languages}}
{{:Burner inserter/infobox}}

The '''Burner inserter''' is the most basic and slowest type of [[Inserter]]. They are powered by burning [[Fuel]], compared to the more advanced inserters which are powered by [[Electric network|electricity]]. When moving [[fuel]], they will fuel themselves as well, which makes it useful for filling [[Boiler|Boilers]] with [[coal]]. This has the advantage that they will continue working even if the power fails. This is not the case for electrically powered [[inserters]]. While having no drain, they consume vastly more energy than comparable [[Inserters]] when active.

Burner inserters sometimes cannot grab moving items from either red belts or blue belts. They also cannot grab moving items from turning belts if the item is on the far side. They however will try to grab things, and consume fuel in their attempts. Eventually, the Burner Inserter will run out of fuel, be unable to refuel itself, and stop working.

Even though they don't use electricity, Burner inserters can be linked to and manipulated by the [[logistic network|logistic]] and the [[circuit network]].

For more information on mechanics and uses, see [[Inserters]].

== Power Comparison ==

A burner inserter consumes (at a rate of 188kW) exactly 1 coal (8.0MJ burner energy) every 42.55 seconds (0.0235 coal/second) when running continuously. In practice, the burner inserter may not run continuously, however burner inserters consume no idle power, therefore 1 coal will last 42.55 seconds of '''run time'''. In this time, a burner inserter will transfer items approximately 25 times. In contrast, a regular [[inserter]] will transfer approximately 256 times using the same amount of coal (through steam power). However, due to the electric energy drain of other inserters, a burner inserter is more coal efficient than a regular inserter if the inserter only operates less than once every 1560 seconds (26 minutes). This makes these burners useful in situations where a boiler-fueled electrical plant is switched off for large amounts of time, acting as a backup power plant. These burners are also useful for automatic recovery from a blackout after fuel starvation of a power plant, since they don't require power to resupply the boilers to get power production going again.

== History ==

{{history|0.13.2|
* Inserters connected to the circuit network now have the option to only read hand contents.}}

{{history|0.13.0|
* Inserters can now send the item held in hand to the circuit network.
* Inserters are able to squeeze things ''slightly'' better to belts. more resources.
* All types of inserters can be controlled by the circuit and logistic network, once the respective network is researched.
}}

{{history|0.12.16|
* Improved burner inserter's fuel searching logic; it will now search both transport belt lines for fuel}}

{{history|0.12.11|
* Burner inserter now grabs fuel for itself even if the target doesn't need it}}

{{history|0.12.2|
* Inserters will never take more than the max stack size of an item.
* Inserters and logistic robots no longer extract from enemy chests
* Inserters now correctly pick up items from splitters
}}

{{history|0.12.1|
* Burner inserters start with enough energy to pick up 1 item and fuel themselves.}}

{{history|0.12.0|
* Inserters can now extract from Roboports and Beacons.
* Inserters now take items from right behind them, not from the center of the pickup target entity.}}

{{history|0.10.0|
* New icon
* New sounds}}

{{history|0.9.2|
* Inserters can have arbitrary pickup and insert positions.}}

{{history|0.9.0|
* Inserter code optimisation, inserters that have nothing to do will sleep.}}

{{history|0.8.0|
* Improved inserter's ability to pull from train wagons.}}

{{history|0.7.1|
* Fast inserter now has the same speed as the smart inserter.}}

{{history|0.5.0|
* Inserter can now pick up up to 5 items when researched.}}

{{history|0.4.0|
* Smaller inserter bounding box}}

{{history|0.3.0|
* New Inserter graphics}}

{{history|0.2.1|
* The item in the hand of the inserter is returned to the player when mined.}}

{{history|0.2.0|
* Show direction of inserter}}

{{history|0.1.0|
* Introduced}}

== See also ==
* [[Transport network]]
* [[Inserters]]
* [[Inserter experiments]] : Info on throughput
* http://www.factorioforums.com/forum/viewtopic.php?f=5&t=5387&p=41576#p41456
* [http://www.factorioforums.com/forum/viewtopic.php?f=18&t=6850 Burner Inserters: Less polluting than non-burning!?]

{{BurnerNav}}
{{LogisticsNav}}

Inserters

2017-05-22T00:50:16Z

Ignatio: All inserters can pick up from all belts, at least in 0.15.

{{Languages}}

''For the common yellow electrical inserter, see [[Inserter]].''

'''Inserters''' are devices which are used to move items over short distances. When placed, they have a fixed direction. They can move items from behind and place them in front of them. By doing this, they can move items from one transport belt to another, but also extract items from, and insert items into machines or storage devices. There are seven types of inserters, all requiring electricity to run (except the Burner Inserter, which burns [[Fuel|fuel]]).

== Types Of Inserters ==

* [[Burner inserter]] - The only [[fuel]]-powered inserter.
* [[Inserter]] - The standard yellow electrical inserter.
* [[Fast inserter]] - The much faster blue inserter.
* [[Long handed inserter]] - Capable of inserting and removing from a greater range.
* [[Filter inserter]] - Purple inserter used for filtering.
* [[Stack inserter]] - New inserter available with V0.13, allows much greater throughput.
* [[Stack filter inserter]] - A filtered version of the Stack inserter.

==Mechanics==
Inserters '''will''':
* '''Pick up''' [[Items]] off the ground, off of a [[Transport belts|Transport belt]], or from any object that has storage space, including [[Storages/Chests|chests]], [[furnace]]s and [[assembling machine]]s.
* '''Place''' the item onto the ground, onto a transport belt, or into any object that has storage space.
* Inserters can place items on all types of conveyor belts.
* Try to pick up items from all types of belts (as of v0.12 there is no limitation anymore).
* Inserters will run at slower speeds when starved for energy.

Inserters will '''not''':
* Pick up any items that can not be inserted into the connected entity.
* Pick up items into an entity with a full inventory.
* Place more than one item at a time onto the same ground tile.
* Place items into a stack limited inventory, beyond the stack limit (red slots).

Inserters act differently depending on what they are moving items to/into so as not to monopolize all of the items being picked up. This allows other machines and inserters on the same transport belt to pick up a share of the items. If two inserters are picking up from the same tile, the first placed inserter has priority.

==Insertion Limits==
Inserters will stop inserting items into certain buildings if they already have enough of that item. For example, if a boiler has 5 or more items of fuel in it, an inserter will not insert additional fuel. When the fuel drops below 5 items, the inserter will continue to insert more fuel, up to the limit of 5 items.

This is to allow for all machines to receive their share of items. The common limits on insertion are shown in the table below.

{| class="wikitable"
! Entity !! Item type !! Inserter limit !! Comment
|-
| [[Boiler]]s, [[Burner inserter]]s, [[Furnace]]s || [[Fuel]] || align="center" | 5 ||
|-
| [[Gun turret]]s || Bullet Magazines || align="center" | 10 || Since v0.8.4. Allows for 100 shots before depleting.
|-
| [[Assembling machine]]s || Items needed for the recipe || Double the number of items needed in the recipe ||
|-
| [[Furnace]]s || Items needed for the recipe || Double the number of items needed in the recipe ||
|-
| [[Lab]]s || [[Science pack]]s || Double the number of items needed for one research point ||
|}

An inserter that takes items from an object containing [[Storage/Stack|stacks]] of items (such as a chest) can overfill the target building due to the [[Inserter item stack size bonus]] research. Overfilling can also happen if multiple inserters are used to insert items into one building.

==Inserters And Transport Belt Interaction ==
[[Transport belts]] have two lanes on which items can travel. Inserters only place items onto one side of the belt. Which side they place it on depends on the orientation of the inserter and the belt, as described below.

: [[File:PlaceOnFarSide.gif|left]]
* Inserters will '''always''' place the item on the furthest lane.
{{clear}}
: [[File:TakeFromNearSide.gif|left]]
* Inserters '''prefer''' taking items from the nearest lane. If the nearest lane is empty, the inserter will take from the far lane.
{{clear}}
: [[File:PlaceOnRightSide.gif|left]]
* If a belt is in the same orientation as the inserter, the item will be placed on the right-hand lane, from the belt's perspective.
{{clear}}
: [[File:PlaceOnInsideOfCorner.gif|left]]
* If the item is placed on a corner piece, it will be put on the inside of the curve, regardless of orientation.
{{clear}}

== Potential Issues ==
Inserters may have problems picking up items:

* From very fast belts, because the items are moving too quickly.
* From the entry or exit of an underground belt (because the time they have to pick up is shorter)
* From turning belts if the item is on the inside of the corner

==Inserter Item Stack Size Bonus==

If an inserter moves items from inventory to inventory (for example from an assembler into a chest), or (as of v0.13) from an inventory to a belt, it is able to transport more items at once. The secret behind this is the [[Inserter item stack size bonus]] research.

==Power Usage==
* Electric inserters drain energy even when they are not moving, as idle power
* The amount of energy used is the same for every movement
* The [[Burner inserter]] does not drain energy when idle, but uses more energy when it is active. It is quite useful for situations where the inserter does not need to move very often.

==Inserter Speed==
{| class="wikitable"
! Type
! Rotation-speed (turns per [[Tick]]) Extension-speed ([[Tile]]s per Tick)
! Turns per [[Game-second]] Tiles per Game-second
! Game-second per full turn Game-seconds per Tile
! Ticks per full turn Ticks per Tile
|- align="center"
| align="left"| {{imagelink|burner-inserter|Burner Inserter}} || 0.01 0.0214 || 0.6 1.284 || 1.667 0.833 || 102 76
|- align="center"
| align="left"| {{imagelink|basic-inserter|Basic inserter}} || 0.014 0.03 || 0.84 1.8 || 1.191 0.56 || 72 54
|- align="center"
| align="left"| {{imagelink|long-handed-inserter|Long handed inserter}} || 0.02 0.0457 || 1.2 2.742 || 0.833 0.416 || 52 36
|- align="center"
| align="left"| {{imagelink|fast-inserter|Fast inserter}} || 0.04 0.07 || 2.4 4.2 || 0.417 0.238 || 26 24
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} || 0.04 0.07 || 2.4 4.2 || 0.417 0.238 || 26 24
|-align="center"
| align="left"| {{imagelink|Stack_filter_inserter|Stack filter inserter}} || 0.04 0.07 || 2.4 4.2 || 0.417 0.238 || 26 24
|-
|}

===Rotation Speed===
Convention: 2π rad = 100% of a circle rotation = '''1 turn''' (or one full rotation).

Note: an Inserter doesn't always need to make full turns. When grabbing from a transport belt, it is slightly faster when grabbing items from the closest lane.

===Extension Speed===
The extension-speed is normally not visible (only when compared to other inserters), but there are measurable speed differences when taking - for example - from the near or the far side of a belt. Also Some mods can alter the pickup and drop locations of inserters, making this stat more relevant.

==Inserter Throughput==

The following is based on [https://docs.google.com/spreadsheets/d/1OzlP2v6P1OGxK1xCFr77aqVfNNEaEKHlA89aSVmqBGw/edit?usp=sharing experimental data] gathered in version 0.15.

Inserter throughput between chests and other [[stack|stacks]] is a simple function of stack size and arm speed:

<blockquote>
''n'' = Stack size

''t_arm'' = Time to move the arm back and forth

Time per item = ''t_arm'' / ''n''

Throughput (items/sec) = 1 / Time per item = ''n'' / ''t_arm''
</blockquote>

When moving items to or from belts, the time to pick up or put down items also becomes a factor:

<blockquote>
''t_item'' = Time to pick up or put down or an item

''t_c'' = Time to complete an arm cycle = ''t_arm'' + ''n''*''t_item''

Time per item = ''t_c'' / ''n'' = ''t_item'' + ''t_arm'' / ''n''

Throughput (items/sec) = 1 / (''t_item'' + ''t_arm'' / ''n'')
</blockquote>

Due to some simulation quirk, inserters are noticeably slower when moving items from south to north. The effect is between 1% and 4% and it tends to be bigger for larger stack sizes. All the measurements below are based on south-to-north movement, to avoid overestimating throughput.

===Chest to chest===

These are measurements chest-to-chest in south-to-north direction.

{| class="wikitable"
! rowspan=2 | Type
! rowspan=2 | Arm cycles per second
! rowspan=2 | Percent faster not south-to-north
! colspan=6 | Items/second at [[inserter capacity bonus (research)|capacity bonus]] level (stack size)
|-
! colspan=2 | No capacity bonus
! colspan=2 | Capacity bonus 2
! colspan=2 | Capacity bonus 7
|- align="center"
| align="left"| {{imagelink|burner-inserter|Burner inserter}} || 0.59 || 1.0% || 0.59 || (1) || 1.18 || (2) || 1.77 || (3)
|- align="center"
| align="left"| {{imagelink|basic-inserter|Basic inserter}} || 0.83 || 1.4% || 0.83 || (1) || 1.66 || (2) || 2.49 || (3)
|- align="center"
| align="left"| {{imagelink|long-handed-inserter|Long handed inserter}} || 1.14 || 1.9% || 1.14 || (1) || 2.29 || (2) || 3.43 || (3)
|- align="center"
| align="left"| {{imagelink|fast-inserter|Fast inserter}} {{imagelink|filter-inserter|Filter inserter}} || 2.24 || 3.7% || 2.24 || (1) || 4.49 || (2) || 6.73 || (3)
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 2.24 || 3.7% || 4.49 || (2) || 8.98 || (4) || 26.93 || (12)
|-
|}

===Chest to belt===

Besides the inserter direction as noted above, the throughput going from chest to belt depends on how full the belt is and how the items are spaced, i.e. if spaces are large enough to fill with items. Underground entrances and exits also makes it easier for the inserter to put down an item.

In these measurements inserters move items south-to-north onto an empty perpendicular belt. Values are given for the stack sizes at three different [[inserter capacity bonus (research)|capacity bonus]] levels.

{| class="wikitable"
! rowspan=3 | Type
! rowspan=3 | Percent faster not south-to-north
! colspan=12 | Items/second at [[inserter capacity bonus (research)|capacity bonus]] level (stack size)
|-
! colspan=4 | No capacity bonus
! colspan=4 | Capacity bonus 2
! colspan=4 | Capacity bonus 7
|-
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]] ||
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]] ||
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]] ||
|- align="center"
| align="left"| {{imagelink|burner-inserter|Burner inserter}} || 0.9% || 0.58 || 0.58 || 0.58 || (1) || 1.10 || 1.13 || 1.14 || (2) || 1.53 || 1.62 || 1.67 || (3)
|- align="center"
| align="left"| {{imagelink|basic-inserter|Basic inserter}} || 1.3% || 0.82 || 0.82 || 0.82 || (1) || 1.51 || 1.57 || 1.59 || (2) || 2.04 || 2.22 || 2.30 || (3)
|- align="center"
| align="left"| {{imagelink|long-handed-inserter|Long handed inserter}} || 1.7% || 1.14 || 1.14 || 1.14 || (1) || 2.01 || 2.12 || 2.16 || (2) || 2.63 || 2.93 || 3.08 || (3)
|- align="center"
| align="left"| {{imagelink|fast-inserter|Fast inserter}} {{imagelink|filter-inserter|Filter inserter}} || 3.0% || 2.23 || 2.23 || 2.23 || (1) || 3.55 || 3.90 || 4.03 || (2) || 4.23 || 5.05 || 5.51 || (3)
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 1.7% || 3.55 || 3.90 || 4.03 || (2) || 4.68 || 6.08 || 6.75 || (4) || 6.09 || 9.86 || 12.49 || (12)
|-
|}

To calculate the throughput for [[Stack inserter]] and [[Stack filter inserter]] at any capacity level, you can use these linearly fitted factors with the belt/chest throughput formula above:

{| class="wikitable"
! rowspan=2 | Type
! colspan=2 | {{imagelink|basic-transport-belt|Transport belt}}
! colspan=2 | {{imagelink|fast-transport-belt|Fast transport belt}}
! colspan=2 | {{imagelink|express-transport-belt|Express transport belt}}
|-
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 0.137 || 0.312 || 0.070 || 0.378 || 0.047 || 0.402
|-
|}

See the [https://docs.google.com/spreadsheets/d/1OzlP2v6P1OGxK1xCFr77aqVfNNEaEKHlA89aSVmqBGw/edit?usp=sharing source spreadsheet] for the corresponding factors for the other inserter types. Their errors are generally well below 1%.

===Belt to chest===

When picking items from a belt, many more factors come into play besides those mentioned above (inserter direction and belt fullness):

* How fast the items move (i.e. if they are queued up on the belt or move at belt speed).
* Whether the belt is perpendicular to the inserter or approaches it head on.
* Whether items are on the near or far lane of a perpendicular belt.
* Whether the belt turns or not, and whether the items are in the inner or outer side of the bend.
* If the belt is an underground entrance or exit. This shortens the time items are visible to the inserter for pickup.
* All sorts of intricate timing factors between the inserter and the items on the belt, since the game simulates the arm homing in on every item.

The test setup used below is with a south-to-north inserter taking items from a perpendicular belt with items on the far lane only. The belt is fully compressed and timings are both for items that move at full speed and queued up as much as possible. Values are given for the stack sizes at three different [[inserter capacity bonus (research)|capacity bonus]] levels.

{| class="wikitable"
! rowspan=4 | Type
! rowspan=4 | Percent faster not south-to-north
! colspan=15 | Items/second at [[inserter capacity bonus (research)|capacity bonus]] level (stack size)
|-
! colspan=5 | No capacity bonus
! colspan=5 | Capacity bonus 2
! colspan=5 | Capacity bonus 7
|-
! colspan=3 | Items at belt speed
! rowspan=2 | Items queued up
! rowspan=2 |
! colspan=3 | Items at belt speed
! rowspan=2 | Items queued up
! rowspan=2 |
! colspan=3 | Items at belt speed
! rowspan=2 | Items queued up
! rowspan=2 |
|-
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]]
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]]
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]]
|- align="center"
| align="left"| {{imagelink|burner-inserter|Burner inserter}} || 0.9% || '''0.56''' || 0.53 || 0.50 || 0.64 || (1) || '''1.03''' || 1.03 || 0.98 || 1.17 || (2) || 1.44 || '''1.54''' || 1.43 || 1.70 || (3)
|- align="center"
| align="left"| {{imagelink|basic-inserter|Basic inserter}} || 1.3% || '''0.82''' || 0.74 || 0.77 || 0.88 || (1) || '''1.57''' || 1.49 || 1.48 || 1.60 || (2) || 2.01 || '''2.11''' || 2.01 || 2.38 || (3)
|- align="center"
| align="left"| {{imagelink|long-handed-inserter|Long handed inserter}} || 1.8% || '''1.11''' || 1.11 || 1.05 || 1.20 || (1) || '''2.11''' || 2.06 || 2.01 || 2.27 || (2) || '''3.01''' || 2.97 || 3.01 || 3.28 || (3)
|- align="center"
| align="left"| {{imagelink|fast-inserter|Fast inserter}} {{imagelink|filter-inserter|Filter inserter}} || 3.3% || 2.15 || '''2.22''' || 2.07 || 2.31 || (1) || 4.01 || '''3.82''' || '''3.82''' || 4.14 || (2) || 5.47 || 5.02 || '''5.47''' || 6.01 || (3)
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 1.9% || 4.01 || '''3.82''' || 3.82 || 4.14 || (2) || 6.17 || 6.18 || '''6.43''' || 6.69 || (4) || 6.67 || 10.03 || '''12.09''' || 13.40 || (12)
|-
|}

Since there are many more factors involved, these measurements exhibit a more complex pattern than chest-to-belt.

* Boldface cells show for which belt each inserter has the best throughput on each bonus level when items move at belt speed. Higher speed belts mean that inserters have to work harder to catch the fast moving items. The effect is most noticeable for slower inserters and smaller stack sizes.
* When items are queued up the belt type hardly matters, so there is only a single column for that. There is however one exception - see (*) below.

Here are linearly fitted factors to get the [[Stack inserter]] and [[Stack filter inserter]] throughput at any capacity level, by using the belt/chest throughput formula above:

{| class="wikitable"
! rowspan=2 | Type
! colspan=2 | {{imagelink|basic-transport-belt|Transport belt}}
! colspan=2 | {{imagelink|fast-transport-belt|Fast transport belt}}
! colspan=2 | {{imagelink|express-transport-belt|Express transport belt}}
|-
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 0.054 (*) || 0.410 (*) || 0.065 || 0.386 || 0.045 || 0.437
|-
|}

<nowiki>*)</nowiki> A stack inserter combined with a basic transport belt gets capped by the belt speed at stack sizes above 4, so these figures are only accurate up to size 4. More than that and the throughput is fixed at 6.67 items per second.

==See Also==
* [[Electric network]]
* [[Transport network]]
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=5253 Inserter Power Efficiency]: Movements per energy and exact power usage numbers. See also [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=6258 this thread], where energy per movement is explained.
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=5400 Small Inserter Test]: Comparison if energy usage per item.
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=5524 Inserter heartbeats]: In some situations it is not possible to calculate the needed power usage.
===Special behavior===
* [[Inserters/Interaction with other Entities]]
* [[Inserter item stack size bonus]]: Inserter moves more than an item per turn.
* [[Inserter experiments]]
{{LogisticsNav}}

[[Category:Items]]
[[Category:Transport network]]
[[Category:Circuit network]]

Talk:Inserter experiments

2017-05-22T00:47:54Z

Ignatio: Created page with "The data on this page is no longer very relevant since it doesn't cover stack sizes. With that now being covered in the Inserter Throughput section, I suggest removing this pa..."

The data on this page is no longer very relevant since it doesn't cover stack sizes. With that now being covered in the Inserter Throughput section, I suggest removing this page. I've put a notice at the top of the page for now.

Inserter capacity bonus (research)

2017-05-22T00:43:45Z

Ignatio: Added pointer to updater inserter throughput section.

{{Languages}}

{{:Inserter capacity bonus (research)/infobox}}

''Inserter capacity bonus'' research increases the ''stack size'' for [[inserters]], i.e. the number of items they can hold in the arm at once.

* When moving items from one [[stack]] to another, the inserter takes as many items as it can (i.e. up to the stack size) at once, without any additional delay.

* When moving items to a [[transport belt|belt]], the inserter picks up several items and then drops those items on the belt one by one. While this takes longer than dropping a single item, the overall throughput is still higher because the arm doesn't have to move back and forth.

* When moving items from a belt, the inserter tries to fill its stack to capacity before moving the arm to drop them off. To do this, it waits for a short time for a new item to become in range. The wait time is long enough to make the inserter fill up completely on a fully compressed belt. It is shorter than the time to move the arm away and back, so even though it waits it is a net benefit for throughput.

: However, the extra time to fill the stack and wait for more items mean longer delays, e.g. for a machine to get enough items to start working. Beginning with 0.15 it is possible to override the max stack size.

This means the bonus is more effective when moving from stack to stack than when moving from stack to belt or belt to stack. The increased throughput is significant in any case though, especially for the [[Stack inserter]] that has a max size of 12. See the [[Inserters#Inserter_Throughput|inserter throughput]] section for more details.

A slow [[Inserter]] with stack size bonus of 4, which moves from chest to chest, can easily keep up with a [[Fast inserter]], moving from chest to a belt. This is why it is recommended to move items that are required in high quantities at high speeds directly between machines.

A high inserter capacity bonus can break some constructions that use the [[circuit network]]; since an inserter can move more items at once an equal ("=") condition might not be met because the number of items "jumps" over the specified number.

In 0.15 it is possible to override the max stack size to overcome problems like that. It can also be controlled by a circuit network signal.

This bonus is is also often called "inserter bonus", "stacksize bonus" , or "stack bonus".

{| class="wikitable"
! rowspan=2 | Technology !! rowspan=2 | Cost !! colspan=2 | Pickup bonus (total stack size)
|-
! style="width: 100px;" | Non-Stack Inserter !! style="width: 100px;" | Stack Inserter
|-
| none || - || (1) || (2)
|-
| {{icontech|inserter-capacity-research|1|Inserter capacity bonus (research)}} Inserter capacity bonus 1 || {{icon|time|30}} {{icon|science pack 1|1}} {{icon|science pack 2|1}} <big>X 200</big> || || +1 (3)
|-
| {{icontech|inserter-capacity-research|2|Inserter capacity bonus (research)}} Inserter capacity bonus 2 || {{icon|time|30}} {{icon|science pack 1|1}} {{icon|science pack 2|1}} <big>X 250</big> || +1 (2) || +1 (4)
|-
| {{icontech|inserter-capacity-research|3|Inserter capacity bonus (research)}} Inserter capacity bonus 3 || {{icon|time|30}} {{icon|science pack 1|1}} {{icon|science pack 2|1}} {{icon|science pack 3|1}} <big>X 250</big> || || +1 (5)
|-
| {{icontech|inserter-capacity-research|4|Inserter capacity bonus (research)}} Inserter capacity bonus 4 || {{icon|time|30}} {{icon|science pack 1|2}} {{icon|science pack 2|2}} {{icon|science pack 3|1}} <big>X 250</big> || || +1 (6)
|-
| {{icontech|inserter-capacity-research|5|Inserter capacity bonus (research)}} Inserter capacity bonus 5 || {{icon|time|30}} {{icon|science pack 1|2}} {{icon|science pack 2|2}} {{icon|science pack 3|2}} {{icon|alien science pack|1}} <big>X 300</big> || || +2 (8)
|-
| {{icontech|inserter-capacity-research|6|Inserter capacity bonus (research)}} Inserter capacity bonus 6 || {{icon|time|30}} {{icon|science pack 1|2}} {{icon|science pack 2|2}} {{icon|science pack 3|2}} {{icon|alien science pack|2}} <big>X 400</big> || || +2 (10)
|-
| {{icontech|inserter-capacity-research|7|Inserter capacity bonus (research)}} Inserter capacity bonus 7 || {{icon|time|30}} {{icon|science pack 1|4}} {{icon|science pack 2|4}} {{icon|science pack 3|3}} {{icon|alien science pack|2}} <big>X 600</big> || +1 (3) || +2 (12)
|-
|}

== See also ==
* [[Research]]
* [[Technologies]]

{{TechNav}}

Inserters

2017-05-22T00:10:46Z

Ignatio: Extensive discussion on inserter throughput, based on experiments in 0.15.

{{Languages}}

''For the common yellow electrical inserter, see [[Inserter]].''

'''Inserters''' are devices which are used to move items over short distances. When placed, they have a fixed direction. They can move items from behind and place them in front of them. By doing this, they can move items from one transport belt to another, but also extract items from, and insert items into machines or storage devices. There are seven types of inserters, all requiring electricity to run (except the Burner Inserter, which burns [[Fuel|fuel]]).

== Types Of Inserters ==

* [[Burner inserter]] - The only [[fuel]]-powered inserter.
* [[Inserter]] - The standard yellow electrical inserter.
* [[Fast inserter]] - The much faster blue inserter.
* [[Long handed inserter]] - Capable of inserting and removing from a greater range.
* [[Filter inserter]] - Purple inserter used for filtering.
* [[Stack inserter]] - New inserter available with V0.13, allows much greater throughput.
* [[Stack filter inserter]] - A filtered version of the Stack inserter.

==Mechanics==
Inserters '''will''':
* '''Pick up''' [[Items]] off the ground, off of a [[Transport belts|Transport belt]], or from any object that has storage space, including [[Storages/Chests|chests]], [[furnace]]s and [[assembling machine]]s.
* '''Place''' the item onto the ground, onto a transport belt, or into any object that has storage space.
* Inserters can place items on all types of conveyor belts.
* Try to pick up items from all types of belts (as of v0.12 there is no limitation anymore).
* Inserters will run at slower speeds when starved for energy.

Inserters will '''not''':
* Pick up any items that can not be inserted into the connected entity.
* Pick up items into an entity with a full inventory.
* Place more than one item at a time onto the same ground tile.
* Place items into a stack limited inventory, beyond the stack limit (red slots).

Inserters act differently depending on what they are moving items to/into so as not to monopolize all of the items being picked up. This allows other machines and inserters on the same transport belt to pick up a share of the items. If two inserters are picking up from the same tile, the first placed inserter has priority.

==Insertion Limits==
Inserters will stop inserting items into certain buildings if they already have enough of that item. For example, if a boiler has 5 or more items of fuel in it, an inserter will not insert additional fuel. When the fuel drops below 5 items, the inserter will continue to insert more fuel, up to the limit of 5 items.

This is to allow for all machines to receive their share of items. The common limits on insertion are shown in the table below.

{| class="wikitable"
! Entity !! Item type !! Inserter limit !! Comment
|-
| [[Boiler]]s, [[Burner inserter]]s, [[Furnace]]s || [[Fuel]] || align="center" | 5 ||
|-
| [[Gun turret]]s || Bullet Magazines || align="center" | 10 || Since v0.8.4. Allows for 100 shots before depleting.
|-
| [[Assembling machine]]s || Items needed for the recipe || Double the number of items needed in the recipe ||
|-
| [[Furnace]]s || Items needed for the recipe || Double the number of items needed in the recipe ||
|-
| [[Lab]]s || [[Science pack]]s || Double the number of items needed for one research point ||
|}

An inserter that takes items from an object containing [[Storage/Stack|stacks]] of items (such as a chest) can overfill the target building due to the [[Inserter item stack size bonus]] research. Overfilling can also happen if multiple inserters are used to insert items into one building.

==Inserters And Transport Belt Interaction ==
[[Transport belts]] have two lanes on which items can travel. Inserters only place items onto one side of the belt. Which side they place it on depends on the orientation of the inserter and the belt, as described below.

: [[File:PlaceOnFarSide.gif|left]]
* Inserters will '''always''' place the item on the furthest lane.
{{clear}}
: [[File:TakeFromNearSide.gif|left]]
* Inserters '''prefer''' taking items from the nearest lane. If the nearest lane is empty, the inserter will take from the far lane.
{{clear}}
: [[File:PlaceOnRightSide.gif|left]]
* If a belt is in the same orientation as the inserter, the item will be placed on the right-hand lane, from the belt's perspective.
{{clear}}
: [[File:PlaceOnInsideOfCorner.gif|left]]
* If the item is placed on a corner piece, it will be put on the inside of the curve, regardless of orientation.
{{clear}}

== Potential Issues ==
Inserters may have problems picking up items:

* From very fast belts, because the items are moving too quickly. ([[Inserter|basic inserters]] cannot pick up from [[express transport belt]] for example)
* From the entry or exit of an underground belt (because the time they have to pick up is shorter)
* From turning belts if the item is on the inside of the corner

==Inserter Item Stack Size Bonus==

If an inserter moves items from inventory to inventory (for example from an assembler into a chest), or (as of v0.13) from an inventory to a belt, it is able to transport more items at once. The secret behind this is the [[Inserter item stack size bonus]] research.

==Power Usage==
* Electric inserters drain energy even when they are not moving, as idle power
* The amount of energy used is the same for every movement
* The [[Burner inserter]] does not drain energy when idle, but uses more energy when it is active. It is quite useful for situations where the inserter does not need to move very often.

==Inserter Speed==
{| class="wikitable"
! Type
! Rotation-speed (turns per [[Tick]]) Extension-speed ([[Tile]]s per Tick)
! Turns per [[Game-second]] Tiles per Game-second
! Game-second per full turn Game-seconds per Tile
! Ticks per full turn Ticks per Tile
|- align="center"
| align="left"| {{imagelink|burner-inserter|Burner Inserter}} || 0.01 0.0214 || 0.6 1.284 || 1.667 0.833 || 102 76
|- align="center"
| align="left"| {{imagelink|basic-inserter|Basic inserter}} || 0.014 0.03 || 0.84 1.8 || 1.191 0.56 || 72 54
|- align="center"
| align="left"| {{imagelink|long-handed-inserter|Long handed inserter}} || 0.02 0.0457 || 1.2 2.742 || 0.833 0.416 || 52 36
|- align="center"
| align="left"| {{imagelink|fast-inserter|Fast inserter}} || 0.04 0.07 || 2.4 4.2 || 0.417 0.238 || 26 24
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} || 0.04 0.07 || 2.4 4.2 || 0.417 0.238 || 26 24
|-align="center"
| align="left"| {{imagelink|Stack_filter_inserter|Stack filter inserter}} || 0.04 0.07 || 2.4 4.2 || 0.417 0.238 || 26 24
|-
|}

===Rotation Speed===
Convention: 2π rad = 100% of a circle rotation = '''1 turn''' (or one full rotation).

Note: an Inserter doesn't always need to make full turns. When grabbing from a transport belt, it is slightly faster when grabbing items from the closest lane.

===Extension Speed===
The extension-speed is normally not visible (only when compared to other inserters), but there are measurable speed differences when taking - for example - from the near or the far side of a belt. Also Some mods can alter the pickup and drop locations of inserters, making this stat more relevant.

==Inserter Throughput==

The following is based on [https://docs.google.com/spreadsheets/d/1OzlP2v6P1OGxK1xCFr77aqVfNNEaEKHlA89aSVmqBGw/edit?usp=sharing experimental data] gathered in version 0.15.

Inserter throughput between chests and other [[stack|stacks]] is a simple function of stack size and arm speed:

<blockquote>
''n'' = Stack size

''t_arm'' = Time to move the arm back and forth

Time per item = ''t_arm'' / ''n''

Throughput (items/sec) = 1 / Time per item = ''n'' / ''t_arm''
</blockquote>

When moving items to or from belts, the time to pick up or put down items also becomes a factor:

<blockquote>
''t_item'' = Time to pick up or put down or an item

''t_c'' = Time to complete an arm cycle = ''t_arm'' + ''n''*''t_item''

Time per item = ''t_c'' / ''n'' = ''t_item'' + ''t_arm'' / ''n''

Throughput (items/sec) = 1 / (''t_item'' + ''t_arm'' / ''n'')
</blockquote>

Due to some simulation quirk, inserters are noticeably slower when moving items from south to north. The effect is between 1% and 4% and it tends to be bigger for larger stack sizes. All the measurements below are based on south-to-north movement, to avoid overestimating throughput.

===Chest to chest===

These are measurements chest-to-chest in south-to-north direction.

{| class="wikitable"
! rowspan=2 | Type
! rowspan=2 | Arm cycles per second
! rowspan=2 | Percent faster not south-to-north
! colspan=6 | Items/second at [[inserter capacity bonus (research)|capacity bonus]] level (stack size)
|-
! colspan=2 | No capacity bonus
! colspan=2 | Capacity bonus 2
! colspan=2 | Capacity bonus 7
|- align="center"
| align="left"| {{imagelink|burner-inserter|Burner inserter}} || 0.59 || 1.0% || 0.59 || (1) || 1.18 || (2) || 1.77 || (3)
|- align="center"
| align="left"| {{imagelink|basic-inserter|Basic inserter}} || 0.83 || 1.4% || 0.83 || (1) || 1.66 || (2) || 2.49 || (3)
|- align="center"
| align="left"| {{imagelink|long-handed-inserter|Long handed inserter}} || 1.14 || 1.9% || 1.14 || (1) || 2.29 || (2) || 3.43 || (3)
|- align="center"
| align="left"| {{imagelink|fast-inserter|Fast inserter}} {{imagelink|filter-inserter|Filter inserter}} || 2.24 || 3.7% || 2.24 || (1) || 4.49 || (2) || 6.73 || (3)
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 2.24 || 3.7% || 4.49 || (2) || 8.98 || (4) || 26.93 || (12)
|-
|}

===Chest to belt===

Besides the inserter direction as noted above, the throughput going from chest to belt depends on how full the belt is and how the items are spaced, i.e. if spaces are large enough to fill with items. Underground entrances and exits also makes it easier for the inserter to put down an item.

In these measurements inserters move items south-to-north onto an empty perpendicular belt. Values are given for the stack sizes at three different [[inserter capacity bonus (research)|capacity bonus]] levels.

{| class="wikitable"
! rowspan=3 | Type
! rowspan=3 | Percent faster not south-to-north
! colspan=12 | Items/second at [[inserter capacity bonus (research)|capacity bonus]] level (stack size)
|-
! colspan=4 | No capacity bonus
! colspan=4 | Capacity bonus 2
! colspan=4 | Capacity bonus 7
|-
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]] ||
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]] ||
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]] ||
|- align="center"
| align="left"| {{imagelink|burner-inserter|Burner inserter}} || 0.9% || 0.58 || 0.58 || 0.58 || (1) || 1.10 || 1.13 || 1.14 || (2) || 1.53 || 1.62 || 1.67 || (3)
|- align="center"
| align="left"| {{imagelink|basic-inserter|Basic inserter}} || 1.3% || 0.82 || 0.82 || 0.82 || (1) || 1.51 || 1.57 || 1.59 || (2) || 2.04 || 2.22 || 2.30 || (3)
|- align="center"
| align="left"| {{imagelink|long-handed-inserter|Long handed inserter}} || 1.7% || 1.14 || 1.14 || 1.14 || (1) || 2.01 || 2.12 || 2.16 || (2) || 2.63 || 2.93 || 3.08 || (3)
|- align="center"
| align="left"| {{imagelink|fast-inserter|Fast inserter}} {{imagelink|filter-inserter|Filter inserter}} || 3.0% || 2.23 || 2.23 || 2.23 || (1) || 3.55 || 3.90 || 4.03 || (2) || 4.23 || 5.05 || 5.51 || (3)
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 1.7% || 3.55 || 3.90 || 4.03 || (2) || 4.68 || 6.08 || 6.75 || (4) || 6.09 || 9.86 || 12.49 || (12)
|-
|}

To calculate the throughput for [[Stack inserter]] and [[Stack filter inserter]] at any capacity level, you can use these linearly fitted factors with the belt/chest throughput formula above:

{| class="wikitable"
! rowspan=2 | Type
! colspan=2 | {{imagelink|basic-transport-belt|Transport belt}}
! colspan=2 | {{imagelink|fast-transport-belt|Fast transport belt}}
! colspan=2 | {{imagelink|express-transport-belt|Express transport belt}}
|-
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 0.137 || 0.312 || 0.070 || 0.378 || 0.047 || 0.402
|-
|}

See the [https://docs.google.com/spreadsheets/d/1OzlP2v6P1OGxK1xCFr77aqVfNNEaEKHlA89aSVmqBGw/edit?usp=sharing source spreadsheet] for the corresponding factors for the other inserter types. Their errors are generally well below 1%.

===Belt to chest===

When picking items from a belt, many more factors come into play besides those mentioned above (inserter direction and belt fullness):

* How fast the items move (i.e. if they are queued up on the belt or move at belt speed).
* Whether the belt is perpendicular to the inserter or approaches it head on.
* Whether items are on the near or far lane of a perpendicular belt.
* Whether the belt turns or not, and whether the items are in the inner or outer side of the bend.
* If the belt is an underground entrance or exit. This shortens the time items are visible to the inserter for pickup.
* All sorts of intricate timing factors between the inserter and the items on the belt, since the game simulates the arm homing in on every item.

The test setup used below is with a south-to-north inserter taking items from a perpendicular belt with items on the far lane only. The belt is fully compressed and timings are both for items that move at full speed and queued up as much as possible. Values are given for the stack sizes at three different [[inserter capacity bonus (research)|capacity bonus]] levels.

{| class="wikitable"
! rowspan=4 | Type
! rowspan=4 | Percent faster not south-to-north
! colspan=15 | Items/second at [[inserter capacity bonus (research)|capacity bonus]] level (stack size)
|-
! colspan=5 | No capacity bonus
! colspan=5 | Capacity bonus 2
! colspan=5 | Capacity bonus 7
|-
! colspan=3 | Items at belt speed
! rowspan=2 | Items queued up
! rowspan=2 |
! colspan=3 | Items at belt speed
! rowspan=2 | Items queued up
! rowspan=2 |
! colspan=3 | Items at belt speed
! rowspan=2 | Items queued up
! rowspan=2 |
|-
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]]
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]]
! [[File:Basic-transport-belt.png|link=Transport belt]] || [[File:Fast-transport-belt.png|link=Fast transport belt]] || [[File:Express-transport-belt.png|link=Express transport belt]]
|- align="center"
| align="left"| {{imagelink|burner-inserter|Burner inserter}} || 0.9% || '''0.56''' || 0.53 || 0.50 || 0.64 || (1) || '''1.03''' || 1.03 || 0.98 || 1.17 || (2) || 1.44 || '''1.54''' || 1.43 || 1.70 || (3)
|- align="center"
| align="left"| {{imagelink|basic-inserter|Basic inserter}} || 1.3% || '''0.82''' || 0.74 || 0.77 || 0.88 || (1) || '''1.57''' || 1.49 || 1.48 || 1.60 || (2) || 2.01 || '''2.11''' || 2.01 || 2.38 || (3)
|- align="center"
| align="left"| {{imagelink|long-handed-inserter|Long handed inserter}} || 1.8% || '''1.11''' || 1.11 || 1.05 || 1.20 || (1) || '''2.11''' || 2.06 || 2.01 || 2.27 || (2) || '''3.01''' || 2.97 || 3.01 || 3.28 || (3)
|- align="center"
| align="left"| {{imagelink|fast-inserter|Fast inserter}} {{imagelink|filter-inserter|Filter inserter}} || 3.3% || 2.15 || '''2.22''' || 2.07 || 2.31 || (1) || 4.01 || '''3.82''' || '''3.82''' || 4.14 || (2) || 5.47 || 5.02 || '''5.47''' || 6.01 || (3)
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 1.9% || 4.01 || '''3.82''' || 3.82 || 4.14 || (2) || 6.17 || 6.18 || '''6.43''' || 6.69 || (4) || 6.67 || 10.03 || '''12.09''' || 13.40 || (12)
|-
|}

Since there are many more factors involved, these measurements exhibit a more complex pattern than chest-to-belt.

* Boldface cells show for which belt each inserter has the best throughput on each bonus level when items move at belt speed. Higher speed belts mean that inserters have to work harder to catch the fast moving items. The effect is most noticeable for slower inserters and smaller stack sizes.
* When items are queued up the belt type hardly matters, so there is only a single column for that. There is however one exception - see (*) below.

Here are linearly fitted factors to get the [[Stack inserter]] and [[Stack filter inserter]] throughput at any capacity level, by using the belt/chest throughput formula above:

{| class="wikitable"
! rowspan=2 | Type
! colspan=2 | {{imagelink|basic-transport-belt|Transport belt}}
! colspan=2 | {{imagelink|fast-transport-belt|Fast transport belt}}
! colspan=2 | {{imagelink|express-transport-belt|Express transport belt}}
|-
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
! ''t_item'' || ''t_arm''
|- align="center"
| align="left"| {{imagelink|stack-inserter|Stack inserter}} {{imagelink|stack_filter_inserter|Stack filter inserter}} || 0.054 (*) || 0.410 (*) || 0.065 || 0.386 || 0.045 || 0.437
|-
|}

<nowiki>*)</nowiki> A stack inserter combined with a basic transport belt gets capped by the belt speed at stack sizes above 4, so these figures are only accurate up to size 4. More than that and the throughput is fixed at 6.67 items per second.

==See Also==
* [[Electric network]]
* [[Transport network]]
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=5253 Inserter Power Efficiency]: Movements per energy and exact power usage numbers. See also [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=6258 this thread], where energy per movement is explained.
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=5400 Small Inserter Test]: Comparison if energy usage per item.
* [http://www.factorioforums.com/forum/viewtopic.php?f=5&t=5524 Inserter heartbeats]: In some situations it is not possible to calculate the needed power usage.
===Special behavior===
* [[Inserters/Interaction with other Entities]]
* [[Inserter item stack size bonus]]: Inserter moves more than an item per turn.
* [[Inserter experiments]]
{{LogisticsNav}}

[[Category:Items]]
[[Category:Transport network]]
[[Category:Circuit network]]

Inserter capacity bonus (research)

2017-05-20T19:01:53Z

Ignatio: Rewrote much of the intro section for clarity, giving more details on the wait time etc.

{{Languages}}

{{:Inserter capacity bonus (research)/infobox}}

''Inserter capacity bonus'' research increases the ''stack size'' for [[inserters]], i.e. the number of items they can hold in the arm at once.

* When moving items from one [[stack]] to another, the inserter takes as many items as it can (i.e. up to the stack size) at once, without any additional delay.

* When moving items to a [[transport belt|belt]], the inserter picks up several items and then drops those items on the belt one by one. While this takes longer than dropping a single item, the overall throughput is still higher because the arm doesn't have to move back and forth.

* When moving items from a belt, the inserter tries to fill its stack to capacity before moving the arm to drop them off. To do this, it waits for a short time for a new item to become in range. The wait time is long enough to make the inserter fill up completely on a fully compressed belt. It is shorter than the time to move the arm away and back, so even though it waits it is a net benefit for throughput.

: However, the extra time to fill the stack and wait for more items mean longer delays, e.g. for a machine to get enough items to start working. Beginning with 0.15 it is possible to override the max stack size.

This means the bonus is more effective when moving from stack to stack than when moving from stack to belt or belt to stack. The increased throughput is still significant in any case though, especially for the [[Stack inserter]] that has a max size of 12.

A slow [[Inserter]] with stack size bonus of 4, which moves from chest to chest, can easily keep up with a [[Fast inserter]], moving from chest to a belt. This is why it is recommended to move items that are required in high quantities at high speeds directly between machines.

A high inserter capacity bonus can break some constructions that use the [[circuit network]]; since an inserter can move more items at once an equal ("=") condition might not be met because the number of items "jumps" over the specified number.

In 0.15 it is possible to override the max stack size to overcome problems like that. It can also be controlled by a circuit network signal.

This bonus is is also often called "inserter bonus", "stacksize bonus" , or "stack bonus".

{| class="wikitable"
! rowspan=2 | Technology !! rowspan=2 | Cost !! colspan=2 | Pickup bonus (total stack size)
|-
! style="width: 100px;" | Non-Stack Inserter !! style="width: 100px;" | Stack Inserter
|-
| none || - || (1) || (2)
|-
| {{icontech|inserter-capacity-research|1|Inserter capacity bonus (research)}} Inserter capacity bonus 1 || {{icon|time|30}} {{icon|science pack 1|1}} {{icon|science pack 2|1}} <big>X 200</big> || || +1 (3)
|-
| {{icontech|inserter-capacity-research|2|Inserter capacity bonus (research)}} Inserter capacity bonus 2 || {{icon|time|30}} {{icon|science pack 1|1}} {{icon|science pack 2|1}} <big>X 250</big> || +1 (2) || +1 (4)
|-
| {{icontech|inserter-capacity-research|3|Inserter capacity bonus (research)}} Inserter capacity bonus 3 || {{icon|time|30}} {{icon|science pack 1|1}} {{icon|science pack 2|1}} {{icon|science pack 3|1}} <big>X 250</big> || || +1 (5)
|-
| {{icontech|inserter-capacity-research|4|Inserter capacity bonus (research)}} Inserter capacity bonus 4 || {{icon|time|30}} {{icon|science pack 1|2}} {{icon|science pack 2|2}} {{icon|science pack 3|1}} <big>X 250</big> || || +1 (6)
|-
| {{icontech|inserter-capacity-research|5|Inserter capacity bonus (research)}} Inserter capacity bonus 5 || {{icon|time|30}} {{icon|science pack 1|2}} {{icon|science pack 2|2}} {{icon|science pack 3|2}} {{icon|alien science pack|1}} <big>X 300</big> || || +2 (8)
|-
| {{icontech|inserter-capacity-research|6|Inserter capacity bonus (research)}} Inserter capacity bonus 6 || {{icon|time|30}} {{icon|science pack 1|2}} {{icon|science pack 2|2}} {{icon|science pack 3|2}} {{icon|alien science pack|2}} <big>X 400</big> || || +2 (10)
|-
| {{icontech|inserter-capacity-research|7|Inserter capacity bonus (research)}} Inserter capacity bonus 7 || {{icon|time|30}} {{icon|science pack 1|4}} {{icon|science pack 2|4}} {{icon|science pack 3|3}} {{icon|alien science pack|2}} <big>X 600</big> || +1 (3) || +2 (12)
|-
|}

== See also ==
* [[Research]]
* [[Technologies]]

{{TechNav}}

Express transport belt

2017-05-20T17:42:52Z

Ignatio: Skip the disambiguation page in a link

{{Languages}}

{{:Express transport belt/infobox}}
The [[Express transport belt]] is the most advanced variant of the [[Basic transport belt]]. Its available when [[Logistics 3]] has been [[Research|researched]]. Its behaviour is exactly the same as the [[Basic transport belt]] at triple speed. Making an express transport belt is costly and should be used mainly in places where high throughput is needed.

See '''[[belt transport system]]''' for more general information about transport belts.

[[File:Express_transport_belt_fulldensity.gif|right|300px|thumb| 9 [[Fast inserter]] per side will fill an express belt to max. density.]]

{| class="wikitable"
|-
! scope="col" | Type
! scope="col" | Max. throughput ([[Items]] per [[game-second]]*)
! scope="col" | Speed ([[Tile|Tiles]] per [[game-second]])*
! scope="col" | Max. density ([[Items]] per [[Tile|tile]])*
! scope="col" | Required [[Research|technologies]]
|-
| {{imagelink|express-transport-belt|Express transport belt}} || 40.0 || 5.625 || 7.111 || [[Logistics 3]]
|}
 *See '''[[Transport_belts/Physics|Physics of Transport Belts]]''' for more detailed information.

==Production Layouts==



{| class="wikitable"
|-
! scope="col" | Design
! scope="col" | Input: ([[Items]] per [[game-second]])
|- style="vertical-align:top;"
|rowspan="3" | [[File:Express_Transport_belt_layout1.jpg|top|400px]]
|{{icon|iron plate|21.5}} {{icon|Lubricant|2}}
|-
! scope="col"|Output: ([[Items]] per [[game-second]])
|- style="vertical-align:top;"
|{{icon|express transport belt|1}}
|}

== History ==

{{history|0.13.0|
* Transport belt is now connectible to the [[circuit network]].
* Transport belt connectible entities will now disconnect from incoming belts when marked for deconstruction.}}

{{history|0.12.0|
* Items on transport belts don't go off the belt at the end, so the transport belt has to go directly in front of the required inserter.
* Optimised the transport belt movement.}}

{{history|0.11.9|
* Items marked for deconstruction cannot be moved by belts anymore.
* Reduced the CPU load caused by big counts of [[inserters]] loading/unloading transport belts.}}

{{history|0.11.0|
* Fast/express belts are now made from the slower variants.}}

{{history|0.9.7|
* Belts to be deconstructed no longer accept items. }}

{{history|0.9.6|
* New transport belt graphics. }}

{{history|0.9.0|
* Small optimisation. }}

{{history|0.7.1|
* [[Express transport belt]] now takes 15 [[Iron gear wheel]]s to craft. }}

{{history|0.6.0|
* Transport belt doesn't pull player out of the edge of it (like items), so player won't be almost trapped on faster transport belts. }}

{{history|0.5.0|
* Better movement on transport belts in turns and crossings. }}

{{history|0.2.8|
* Cross connections of transport belt of the same type are disabled. }}

{{history|0.2.2|
* When transport belts are rotated (or replaced with different than opposite direction), items on transport belt are collected.}}

{{history|0.2.1|
* Small optimisation. }}

{{history|0.1.0|
* Introduced}}

== See also ==
* [[Belt transport system]]
** [[Splitters]]
** [[Inserters]]
* [[Crafting network]]

{{LogisticsNav}}

[[Category:Items]]

Console

2017-05-14T21:30:56Z

Ignatio: Clarified docs for the take_screenshot command.

{{Languages}}

== Overview ==
The in-game console is used for:

* Chatting with other players
* Running commands / scripts / cheats
* Occasional status updates

There are three types of command:

* '''Multiplayer''' - message filtering, banning users, etc.
* '''Information''' - display various information about the game
* '''Scripting/Cheating''' - run small Lua scripts (but they disable achievements for the save game)

=== Using the console ===
The console display can be toggled with the {{keybinding|/}} (slash) or {{keybinding|~}} (tilde) keys.

You can customize the keys via '''Options Menu -> Keyboard -> Toggle Lua console'''. When the console is open, you'll see a blinking cursor at the bottom of the screen; type your message or command and hit '''Return''' to send it (this will also close the console). Documentation about message and command prefixes can be found further down this page.

When console is closed, only the most recent messages/commands will be displayed, but they will gradually fade away (opening the console will immediately re-display all recent messages). Note that by default, all executed commands are made visible to all users. You can set the fade out time via '''Options Menu -> Other Settings -> Message Delay'''.

If you want to immediately hide the console, open the console and then press '''Escape''' key (or press '''Return''' without entering any message/command). This not only closes the console, but it also hides all the recent messages/commands. In [https://forums.factorio.com/viewtopic.php?f=3&t=32389 Factorio 0.14.5 and later], you can clear the console with the '''/clear''' command.

Note that the console can also accept raw Lua code as well as game commands.

=== Console history ===

The console has an inbuilt history; it's a bit like a text editor where only one line of text is displayed at a time.

Use the {{keybinding|↑}} and {{keybinding|↓}} keys to scroll through the console history.

Use the {{keybinding|←}} and {{keybinding|→}} keys to cursor through the currently displayed message or command, which you can edit (delete, insert, etc.) and resend (by pressing '''Return''').

In [https://forums.factorio.com/viewtopic.php?f=3&t=32389 Factorio 0.14.5 and later], the '''Tab''' key will auto-complete commands and player ids.

== Multiplayer Chat ==

Send private message to specific player with '''/whisper''' (or '''/w'''):

/whisper <playerId> <message>

Reply to the most recently received private message with '''/reply''' (or '''/r'''):

/reply <message>

In [https://forums.factorio.com/viewtopic.php?f=3&t=32248 Factorio 0.14.4 and later], group chat works like this:

hello my team!

/s hello all players!
/shout same as /s

In Factorio 0.14.3 and earlier, group chat worked like this:

hello all players!

/team hello my team!

These are just the main chat features - there are also options for banning, ignoring and muting players; see the console '''/help''' for a full list.

== Commands ==
To see a list of all available commands, enter '''/help''' (or '''/h''') in to the console. The available commands will depend on Factorio version and game setup.

/help

In [https://forums.factorio.com/viewtopic.php?f=3&t=32248 Factorio 0.14.4 and later], the '''/help''' command will just display a list of commands - to get full details for a command add the command name (without slash) after '''/help''' (or '''/h'''), for example if you want help on the '''/evolution''' command, you'd type:

/h evolution

=== Scripting and cheat commands ===
You can run Lua script commands via the console. It works similarly to any command line interface or the JavaScript console for your browser.

This is a very powerful feature, which also allows cheating, and as such achievements will be permanently disabled for the save as soon as you use a script command.

To run a script, prefix it with '''/command''' (or '''/c'''), for example:

/c game.player.print 'hello me!'

If you're in a multiplayer game, the command will be echoed to all other players (so they can see if you're cheating).

In [https://forums.factorio.com/viewtopic.php?p=203991#p203991 Factorio 0.14.5 and later], multiplayer server admins can use '''/silent-command''' (only via RCON/server console) instead of '''/c''' to avoid the command being echoed to all players.

/silent-command game.player.print 'only admins can use (and see) silent commands'

Mod developers can also take advantage of the special '''/measured-command''' which is like '''/c''' but will time how long the command takes to run. This is very useful for performance tuning your scripts.

/measured-command game.player.print 'how much time does this take to run?'

The game ignores newlines when pasting "scriptlets" in the console. This means they can be written in a human readable form in an editor and copy/pasted into the console, making understanding and editing a bit easier.

You can essentially fire any Lua command here, just as you would from a Lua program - Factorio [[Mods]] are merely Lua commands. Therefore you don't necessarily need "cheats" active per-se, as the console allows you full access to the game's internals. You only need a familiarity with the commands and types, as shown in the below examples and the [[Modding]] section.

==Basic Command Examples==

=== Large Screenshots ===

This is how you would take a large HD screenshot. As usual, replace the X and Y with the values you wish.

The file is put into a folder called "script-output", which is located in the same location as the mods folder. These pictures can be quite large.

/c game.take_screenshot{''<parameter>''=''<value>'',...}

The command takes the following parameters:

* showgui - Boolean value, true or false. True if GUIs should be included in the screenshot.
* resolution - Takes an x and y, in the form {x = ''<x-size>'', y = ''<y-size>''}.
* show_entity_info - Boolean value, true if alt info should be shown in the screenshot.
* zoom - The zoom level. 1 is normal, 2 is zoomed in to half the area, 0.5 is zoomed out to twice the area, etc.

=== Use it as calculator ===

/c game.player.print(1234 * 5678)

=== Mine faster ===

/c game.player.force.manual_mining_speed_modifier=1000

=== Craft faster ===

/c game.player.force.manual_crafting_speed_modifier=1000

=== Unlock and Research all Technology ===

/c game.player.force.research_all_technologies()

Undo this with:

/c for _, tech in pairs(game.player.force.technologies) do tech.researched=false end

=== Reset any modifiers to default ===
This includes Tech and speed alterations.

/c game.player.force.reset()

=== Zoom beyond normal bounds ===
Note that zooming too far out can cause performance hits. Be careful.

/c game.player.zoom = 0.1

== Inventory Manipulation ==

=== Refill resources (refill oil, iron etc.) ===
While holding the cursor over a resource tile in-game
/c game.player.selected.amount=7500

=== Add items to the player's inventory ===
Replace iron-plate with the internal name of the item desired.

/c game.player.insert{name="iron-plate", count=100}

For instance, here's a god-mode energy system interface:

/c game.player.insert{name="electric-energy-interface"}

=== Cheat mode ===
Allows for infinite free crafting. Disable by replacing true with false.

/c game.player.cheat_mode=true

== World Manipulation ==

=== Reveal the map around the player ===

Reveals the map around the player, similar to a [[radar]].

/c local radius = 150; game.player.force.chart(game.player.surface, {{game.player.position.x - radius, game.player.position.y - radius}, {game.player.position.x + radius, game.player.position.y + radius}})

Change 150 to the desired radius, higher values take longer.

=== Turn off night ===
Enables eternal day.
/c game.surfaces[1].always_day=true

=== Change game speed ===
0.5 is half speed, 1 is default, 2 is double speed, etc. This can be used for a lot of things like when you know you will have to wait for long periods of time for something to complete. Increasing will decrease performance, be careful.

/c game.speed = X

=== Freeze Time Passage ===
Stops the advancement of the time if you replace "BOOL" with "true" or unfreezes it if you replace it with "false".

/c game.player.surface.freeze_daytime(BOOL)

=== Remove all pollution ===

/c local surface = game.player.surface;
for coord in surface.get_chunks() do
surface.pollute({coord.x * 32, coord.y * 32}, -10000000)
end

=== Add new resource patch ===
This creates a new 11x11 patch of resources, centered on the player character. The patch it creates is perfectly square but it randomizes the amount similar to natural generation, with fewer ore at the edges and more ore in the center. The default numbers result in a patch with 2500-3000 ore.

If you want a larger patch, change "local size = 5" to a larger number. A larger patch will have exponentially more ore. Entering a number above 30 is not recommended.

If you want a richer patch, change "local density = 10" to a larger number. Entering a very large number shouldn't hurt anything but you probably don't need to go above 100.

To choose which resource is spawned, change "stone" near the bottom to "iron-ore", "copper-ore", "coal", or "uranium-ore".

/c local surface = game.player.surface;
local ore = nil
local size = 5
local density = 10
for y=-size,size do
for x=-size,size do
a = (((size+1) - math.abs(x))*10)
b = (((size+1) - math.abs(y))*10)
if a < b then
ore = math.random(((a*density)-(a*(density-8))),((a*density)+(a*(density-8))))
end
if b < a then
ore = math.random(((b*density)-(b*(density-8))),((b*density)+(b*(density-8))))
end
surface.create_entity({name="stone", amount=ore, position={game.player.position.x+x, game.player.position.y+y}})
end
end

=== Add new oil patch ===
This creates 9 crude oil patches in a 3x3 square.

/c for y=0,2 do
for x=0,2 do
game.player.surface.create_entity({name="crude-oil", amount=5000, position={game.player.position.x+x*7-7, game.player.position.y+y*7-7}})
end
end

or randomly without any collision:

/c local position = nil
for i=1,9 do
position = game.player.surface.find_non_colliding_position("crude-oil", game.player.position, 0, i/2+1.5)
if position then
game.player.surface.create_entity({name="crude-oil", amount=5000, position=position})
end
end

=== Count entities ===
Counts all entities whose name includes the string in local entity.

/c
local entity = "belt"

local surface = game.player.surface
local count = 0
for c in surface.get_chunks() do
for key, ent in pairs(surface.find_entities_filtered({area={{c.x * 32, c.y * 32}, {c.x * 32 + 32, c.y * 32 + 32}}, force= game.player.force})) do
if string.find(ent.name,entity) then
count = count + 1
end
end
end
game.player.print(count)

== Enemy/Evolution ==
=== Check how far the biters have evolved ===
Note that commands that do not start with "/c" do not disable achievements.
/evolution

=== Set evolution factor ===
Ranges from 0 (new game) to 1.

/c game.evolution_factor=X

In 0.15, use the following command instead:

/c game.forces["enemy"].evolution_factor=X

=== Disable time-based evolution & increases pollution-based evolution ===
/c game.map_settings.enemy_evolution.time_factor = 0
/c game.map_settings.enemy_evolution.pollution_factor = game.map_settings.enemy_evolution.pollution_factor * 2

The "2" at the end of the last command will double the default pollution factor. You can substitute another number to increase (or decrease) the pollution factor further.

=== Kill all biters on the "enemy" force ===
Note that this will kill only mobile units and worms, spawners will not be killed.
/c game.forces["enemy"].kill_all_units()

=== Kill all enemies ===
This will kill all biters, bases and worms. Anything that is an enemy will be completely destroyed. This only affects enemies in the explored world, so any unexplored parts of the map which still need to be generated will still have enemies.

/c local surface = game.player.surface
for c in surface.get_chunks() do
for key, entity in pairs(surface.find_entities_filtered({area={{c.x * 32, c.y * 32}, {c.x * 32 + 32, c.y * 32 + 32}}, force= "enemy"})) do
entity.destroy()
end
end

=== Enable peaceful mode ===
Peaceful mode prevents biter attacks until provoked. Substitute false for true to disable.
/c game.player.surface.peaceful_mode = true

=== Disable biter expansion ===
This prevents biters from creating new spawners.
/c game.map_settings.enemy_expansion.enabled = false

== Player Character ==
Commands concerning the player directly.
=== Get Player Position ===
Prints coordinates of your current position.

/c game.player.print({"", "(", game.player.position.x, ", ", game.player.position.y, ")"})

=== Teleport player ===
Moves the player to the specified location. You should be able to teleport to a specific player if you obtain their coordinates via them executing the previous command and giving them to you.

/c game.player.teleport({X, Y})

To teleport to the world's origin, use 0,0.

=== Spawn a player character ===
This is useful for escaping god mode. (see [[Console#Enable_god_mode]].) This will spawn a new player at the spawn point of the world, and connect your controls to it.

/c game.player.character = game.player.surface.create_entity{name="player", position = {0,0}, force = game.forces.player}

=== Change Player color ===
Note that commands that do not start with "/c" do not disable achievements. Replace COLOR with the name of a color. Available names are: Black, blue, brown, cyan, gray, green, orange, pink, purple, red, white, and yellow
/color COLOR

=== Enable god mode ===
God mode removes your player character allowing you to fly over obstacles and take no damage.

Disassociate your controls from the player:

/c game.player.character = nil

Then, hover the mouse over the useless player and destroy it by typing:

/c game.player.selected.destroy()

To undo

/c game.player.create_character()

== Research ==
=== Enable faster research ===
/c game.player.force.laboratory_speed_modifier = 1
1 is normal speed, 2 is double speed 3 is triple etc. I think it goes up to 100.

=== Enabling specific technologies ===
[http://www.factorioforums.com/forum/viewtopic.php?f=18&t=6633 Enabling technologies] (forums)
/c game.player.force.technologies['electric-energy-distribution-1'].researched=true
/c game.player.force.technologies['steel-processing'].researched=true

=== Enabling specific recipes ===
/c game.player.force.recipes["electric-energy-interface"].enabled = true
/c game.player.force.recipes["rocket-silo"].enabled = true

=== Finish research immediately ===
/c for name,technology in pairs(game.player.force.technologies) do technology.researched=technology.enabled end

== Command Line Parameters ==
'''As of Game Version 0.14.21'''

Command line parameters can be used to set settings in the command line before the game launches, this is useful mainly for advanced users or server hosts.

General options:
-h [ --help ] display help
--version show version information
-v [ --verbose ] enable verbose logging
-c [ --config ] PATH config file to use
--no-log-rotation don't rotate log file
--mod-directory PATH Mod directory to use

Running options:
-s [ --map2scenario ] arg map to scenario conversion
-m [ --scenario2map ] arg scenario to map conversion
--apply-update arg immediately apply update package
--create FILE create a new map
--map-gen-settings FILE Map generation settings for use with
--create. See data/map-gen-settings.exampl
e.json
--start-server FILE start a multiplayer server
--start-server-load-scenario FILE start a multiplayer server and load the
specified scenario
--start-server-load-latest start a multiplayer server and load the
latest available save
--until-tick TICK run a save until given map tick
--mp-connect ADDRESS start factorio and connect to address
--load-game FILE start Factorio and load a game in
singleplayer
--benchmark FILE load save and run benchmark
--benchmark-ticks N (=1,000) number of ticks for benchmarking. Default
is 1000
--force-opengl use OpenGL for rendering
--force-d3d use Direct3D for rendering

Server options:
--port N network port to use
--bind ADDRESS[:PORT] IP address (and optionally port) to bind
to
--rcon-port N Port to use for RCON
--rcon-password PASSWORD Password for RCON
--server-settings FILE Path to file with server settings. See
data/server-settings.example.json

'''As of Game Version 0.15.9''' 
0.15.x Adds in a couple of new command line options.

General options:
-h [ --help ] display help
--version show version information
-v [ --verbose ] enable verbose logging
-c [ --config ] PATH config file to use
--no-log-rotation don't rotate log file
--mod-directory PATH Mod directory to use
--check-unused-prototype-data Print a warning for all prototype values
that were not accessed

Running options:
-s [ --map2scenario ] arg map to scenario conversion
-m [ --scenario2map ] arg scenario to map conversion
--apply-update arg immediately apply update package
--create FILE create a new map
--map-gen-settings FILE Map generation settings for use with
--create. See data/map-gen-settings.exampl
e.json
--map-settings FILE Map settings for use with --create. See
data/base/prototypes/map-settings.lua
--preset arg Name of the map generation preset to be
used.
--start-server FILE start a multiplayer server
--start-server-load-scenario FILE start a multiplayer server and load the
specified scenario
--start-server-load-latest start a multiplayer server and load the
latest available save
--until-tick TICK run a save until given map tick
--mp-connect ADDRESS start factorio and connect to address
--load-game FILE start Factorio and load a game in
singleplayer
--benchmark FILE load save and run benchmark
--benchmark-ticks N (=1.000) number of ticks for benchmarking. Default
is 1000
--force-opengl use OpenGL for rendering
--force-d3d use Direct3D for rendering
--fullscreen BOOL start game in windowed mode (saved to
configuration)
--max-texture-size N maximal size of texture that the game can
use (saved to configuration). Should be
power of two greater than 2048
--graphics-quality arg accepted values: normal, low, very-low
--video-memory-usage arg accepted values: all, high, medium, low
--gfx-safe-mode resets some graphics settings to values
that should work on most configurations
--shader arg enable/disable shader postprocessing
(saved to configuration)
--disable-audio Disable audio. Mainly for faster startup
during development.

Server options:
--port N network port to use
--bind ADDRESS[:PORT] IP address (and optionally port) to bind
to
--rcon-port N Port to use for RCON
--rcon-password PASSWORD Password for RCON
--server-settings FILE Path to file with server settings. See
data/server-settings.example.json
--server-whitelist FILE Path to file with server whitelist.
--server-banlist FILE Path to file with server banlist.
--console-log FILE Path to file where a copy of the server's
log will be stored

=== Multiplayer ===

--start-server SAVE

Will start a Headless (Dedicated) server, with no GUI.

--mp-connect ADDRESS
ADDRESS is the IP:port of the remote host. Port is optional.
Examples:

./factorio --mp-connect 192.168.1.101
./factorio --mp-connect 192.168.1.101:2345

As above, port can be specified by placing the port number after a colon in the address.

--map2scenario SAVE
Converts a save game to a User Scenario, allows saved game state to be loaded into map editor. Assuming that save game name is "foo.zip", executing './factorio --map2scenario s1' will result in Factorio loading, opening the save file, and saving the scenario into the scenario folder.

== See also ==

* http://lua-api.factorio.com/latest/ - Factorio API reference for latest version
* http://lua-api.factorio.com/ - links to specific versions of API reference
[[Category:Console]]

Fuel

2017-05-13T14:26:00Z

Ignatio:

{{Languages}}
'''Fuel''' can be inserted into [[burner devices]] and burned to power them. Different types of Fuel provide different amounts of energy, measured in megajoules (MJ). A megajoule (MJ) is equivalent to one megawatt second (MWs), so dividing the megajoule (MJ) value by the power consumption in megawatts (MW) gives the time the fuel will last.

== Types ==
This is a list of all [[Items]] usable as fuel in burner devices, ordered by fuel value:
{| class="wikitable"
! Item !! Fuel value !! Fuel value per raw total !! Vehicle acceleration
|-
| {{imagelink|wood|Wood}} || 2 MJ || 4 MJ per raw wood || 100%
|-
| {{imagelink|raw-wood|Raw wood}} || 4 MJ || 4 MJ per raw wood || 100%
|-
| {{imagelink|small-electric-pole|Small electric pole}} || 4 MJ || 4 MJ per raw wood || 100%
|-
| {{imagelink|wooden-chest|Wooden chest}} || 6 MJ || 3 MJ per raw wood || 100%
|-
| {{imagelink|coal|Coal}} || 8 MJ || 8 MJ per coal || 100%
|-
| {{imagelink|solid-fuel|Solid fuel}} || 25 MJ || 20 MJ per unit of [[Crude oil]]¹ || 120%
|-
| {{imagelink|rocket-fuel|Rocket fuel}} || 225 MJ || || 180%
|-
| {{imagelink|uranium_fuel_cell|Uranium_fuel_cell}} || 8 GJ² || 507 MJ per [[Uranium ore]]³ || Unusable
|}

(¹) This assumes the Crude oil is processed completely into Solid fuel, using [[Advanced oil processing]] and [[Heavy oil cracking]] as intermediate steps, but not [[Light oil cracking]]. Less efficient methods are possible. In practice, the [[Petroleum Gas]] part of processed crude oil is more likely to be used for something other than Solid fuel.

(²) This fuel type can only be used in a [[nuclear reactor]]. Unlike other fuel types, it can't be placed into standard burners.

(³) Assuming that all U-238 is enriched, all used up cells are reprocessed, and there is no reactor neighbor bonus.

== History ==

{{history|0.15.0|
* Fuel type affects vehicle acceleration and top speed.}}

== See also ==
* [[Burner devices]]
* [[Electric network]]
* [[Belt transport system]]

[[Category: Items]]

{{BurnerNav}}

Fuel

2017-05-13T14:24:58Z

Ignatio:

{{Languages}}
'''Fuel''' can be inserted into [[burner devices]] and burned to power them. Different types of Fuel provide different amounts of energy, measured in megajoules (MJ). A megajoule (MJ) is equivalent to one megawatt second (MWs), so dividing the megajoule (MJ) value by the power consumption in megawatts (MW) gives the time the fuel will last.

== Types ==
This is a list of all [[Items]] usable as fuel in burner devices, ordered by fuel value:
{| class="wikitable"
! Item !! Fuel value !! Fuel value per raw total !! Vehicle acceleration
|-
| {{imagelink|wood|Wood}} || 2 MJ || 4 MJ per raw wood || 100%
|-
| {{imagelink|raw-wood|Raw wood}} || 4 MJ || 4 MJ per raw wood || 100%
|-
| {{imagelink|small-electric-pole|Small electric pole}} || 4 MJ || 4 MJ per raw wood || 100%
|-
| {{imagelink|wooden-chest|Wooden chest}} || 6 MJ || 3 MJ per raw wood || 100%
|-
| {{imagelink|coal|Coal}} || 8 MJ || 8 MJ per coal || 100%
|-
| {{imagelink|solid-fuel|Solid fuel}} || 25 MJ || 20 MJ per unit of [[Crude oil]]¹ || 120%
|-
| {{imagelink|rocket-fuel|Rocket fuel}} || 225 MJ || || 180%
|-
| {{imagelink|uranium_fuel_cell|Uranium_fuel_cell}} || 8 GJ² || 507 MJ per [[Uranium ore]]³ || Unusable
|}

(¹) This assumes the Crude oil is processed completely into Solid fuel, using [[Advanced oil processing]] and [[Heavy oil cracking]] as intermediate steps, but not [[Light oil cracking]]. Less efficient methods are possible. In practice, the [[Petroleum Gas]] part of processed crude oil is more likely to be used for something other than Solid fuel.

(²) This fuel type can only be used in a [[nuclear reactor]]. Unlike other fuel types, it can't be placed into standard burners.

(³) Assuming that all U-238 is enriched, all used up cells are reprocessed, and there is no reactor neighbor bonus.

== History ==

{{history|0.15|
* Fuel type affects vehicle acceleration and top speed.}}

== See also ==
* [[Burner devices]]
* [[Electric network]]
* [[Belt transport system]]

[[Category: Items]]

{{BurnerNav}}