Official Factorio Wiki - User contributions [en]

Talk:Achievements

2020-12-13T19:37:33Z

Evg-zhabotinsky: Created page with "== "Solaris" achievement notes == The description for the Solaris achievement says "The electric network may not have any electricity producers besides solar panels connected..."

== "Solaris" achievement notes ==
The description for the Solaris achievement says "The electric network may not have any electricity producers besides solar panels connected to it." I'm not sure if it is entirely correct: I had backup coal power when I got that achievement, though it probably was automatically disconnected by [[power switch]]es because my batteries stopped discharging below 40%. --[[User:Evg-zhabotinsky|Evg-zhabotinsky]] ([[User talk:Evg-zhabotinsky|talk]]) 19:37, 13 December 2020 (UTC)

Blueprint library

2020-12-13T19:09:08Z

Evg-zhabotinsky: Who knew that pressing <enter> in the "summary" field would save the changes? Finished creating the page for the blueprint library.

{{Languages}}
[[File:Blueprint_library.png|thumb|right|The blueprint library GUI.]]

The '''blueprint library''' is a special virtual inventory that can be used to store and share any blueprint-like items, including [[blueprint book]]s, [[blueprint]]s, [[deconstruction planner]]s and [[upgrade planner]]s. It can be opened by clicking the ( [[File:blueprint_library_button.png|20px]] ) button above the minimap or using a keyboard shortcut, {{Keybinding|B}} by default.

Two libraries are available at any given moment, each occupies its own tab in the blueprint library GUI:
* "My blueprints" is your personal blueprint library. It is shared across all the games you play.
* "Game blueprints" is the library bound to the current game. In multiplayer, it is shared across all the players of a fraction.

Besides being a convenient place to share and organize blueprints, the library provides free (unlimited?) inventory space just for them. That space is also safe from accidents: Blueprints and books are normal items, so they can be destroyed e.g. by destroying a chest they are in (by biter attack or careless tank driving), or can be hard to reclaim if you die with them in your inventory, while the library isn't affected by any of that.

Any blueprint or book in the library can be placed in the [[quickbar]], including the ones nested in blueprint books. This allows conveniently using individual blueprints and books without taking them out of any "organizer" books you might have in your library. All blueprints in the libraries are always accessible, like ones in your inventory and unlike any you put in chests or other containers. (Quickbar shortcuts are disabled when you put the blueprints in a chest or other container, but remain available when you put them in your library.)

== History ==
{{history|0.15.0|
* Introduced}}

== See also ==

* [[Blueprint]]
* [[Blueprint book]]
* [[Deconstruction planner]]
* [[Upgrade planner]]

{{C|Tools}}
{{C|GUI}}

File:Blueprint library button.png

2020-12-13T18:42:19Z

Evg-zhabotinsky:

File:Blueprint library.png

2020-12-13T18:32:31Z

Evg-zhabotinsky: The blueprint library GUI screenshot

== Summary ==
The blueprint library GUI screenshot

Blueprint library

2020-12-13T18:20:23Z

Evg-zhabotinsky: This is my first ever Wiki page! Please fix if I messed something up.

{{Languages}}
{{:Infobox:Blueprint library}}

The '''blueprint library''' is a special inventory that can be used to store and share any blueprint-like items, including [[blueprint book]]s, [[blueprint]]s, [[deconstruction planner]]s and [[upgrade planner]]s.

== History ==
{{history|0.15.0|
* Introduced}}

== See also ==

* [[Blueprint]]
* [[Blueprint book]]
* [[Deconstruction planner]]
* [[Upgrade planner]]

{{ProductionNav}}
{{C|Tools}}

Blueprint

2020-12-13T18:15:13Z

Evg-zhabotinsky: /* History */

{{Languages}}
{{:Infobox:Blueprint}}

'''Blueprints''' are items that contain building layouts. Blueprints are used to 'copy & paste' parts of a factory. Built areas can be selected for inclusion in a blueprint. When a blueprint is placed, a [[ghost]] of the layout appears on the ground. This can be used as a guide for manually placing factory pieces, or, more commonly, handed over to [[construction robot]]s for automated completion.

Blueprints can be stored in a [[blueprint book]] or [[blueprint library]] to prevent them occupying inventory space or for organization or sharing purposes.

== Achievements ==
{{Achievement|automated-construction}}
{{Achievement|you-are-doing-it-right}}

== Usage ==

Blank blueprints can be crafted by clicking the ( [[File:Blueprint_button.png|20px]] ) button in the [[shortcut bar]].

The blank blueprint can now be used to 'copy' a set of buildings.

For example, copying this small laser defense setup:

[[File:Blueprint-example-01.png]]

=== Create a blueprint ===

To create a blueprint select the blueprint item out of the toolbar or the inventory.
With the blueprint icon shown next to the mouse cursor, click and hold the left mouse button and drag a box as large as needed (which can be cancelled by pressing {{key|Q}}).
All buildings which will be included in the blueprint will be highlighted with a green square.
Once everything to 'copy' is inside the drag box, release the mouse button, and the 'Blueprint icon setup' menu will open.

[[File:Blueprint-example-02.png‎]]

=== Blueprint icon setup ===

On the top left of the "Setup new blueprint" menu there are four icon slots.
The game chooses automatically the number of icons and which are pre-selected depending on the number of buildings that are included.
This can be changed by simply clicking on the icons to choose the desired ones.
On the left the 'Total' number of components included in the blueprint is shown.

The green "Create blueprint" button creates the blueprint. Additionally, blueprint creation can be cancelled by clicking the X in the top right corner.
Canceling the blueprint does not consume the blueprint item. The created blueprint will replace the empty blueprint in the player's cursor.

[[File:Blueprint-example-03.png‎]]

=== Placing the blueprint ===

To use/place the created blueprint select it from the tool belt or inventory.
The whole building setup of the blueprint will be shown at your mouse cursor.
In this case the Blueprint was renamed to "Example blueprint".
It is possible to place it rotated, press the default key {{keybinding|r}} to rotate.
The blueprint can be placed anywhere inside the green (or orange) 110×110 tiles area of a [[roboport]], or within range of a [[personal roboport]] installed in [[modular armor]] or [[spidertron]].

[[File:Blueprint-example-04.png‎]]

After the blueprint gets placed somewhere, the buildings are placed as ghost buildings.
[[Construction robot]]s will now start to pick up the needed items from the construction network/the player inventory (if using a personal roboport) and place them at the ghost buildings.
The required items need to be in the network in an [[active provider chest]], a [[passive provider chest]], a [[buffer chest]] or a [[storage chest]].

[[File:Blueprint-example-05.png‎]]

Blueprints can be placed from map view where the player has vision. Vision can be achieved by player presence, [[radar]] or a [[spidertron]]. Blueprints that are placed on map view outside the field of vision are truncated.

[[File:Factorio_Blueprint_MapView.jpg|450px]]

=== Viewing and clearing a blueprint ===

Right clicking on a blueprint allows you to view, edit and clear it.
By clearing it, it will become blank so it can be set again.

== Importing/Exporting blueprints ==

It is possible to export blueprints as a text string and import said text string to create a new blueprint. This makes sharing blueprints between players very easy.<br>
Clicking the '''Export to string''' button ( [[File:ExportToString.png|25px]] ) in the top right of the blueprint edit window will pop up a window containing the '''Blueprint string'''. This string can be copied to the operating system clipboard, from where it could be saved to a text file or uploaded to a website.

To import a blueprint, the player can click the '''Import string''' icon on the [[shortcut bar]] ( [[File:ImportString.png|25px]] ). A dialogue box will appear into which the string can be pasted. This will result in a blueprint appearing on the hand with the same setup as the one that was exported.

The text string itself is a base64 encoded, compressed JSON string which contains all the information of the blueprint. It is therefore possible to decode/decompress the text string, change attributes of the blueprint in the JSON text and finally re-encode/compress it back to the known text string format. This basically allows blueprint editing outside of the game itself.

A complete explanation of the blueprint JSON can be found on the [[blueprint string format]] page.

== Additional information ==

* Once a blueprint is created, it can be used an unlimited amount of times.
* To place a blueprint that is blocked by existing buildings, you can hold {{key|Shift}} to place the objects that aren't blocked.
* The above trick will also mark [[rock]]s and [[tree]]s for deconstruction.
* Buildings marked for [[Deconstruction planner|destruction]] will not block placing a blueprint. The blueprinted building cannot be placed if there are any buildings in the way. This can cause an item outside the construction zone to block construction of a 2×2 building on the edge of the zone.
* The maximum of size a blueprint is 10k by 10k [[Map_structure#Tile|tiles]].

== History ==
{{history|0.17.10|
* "Make blueprint" function is now accessible via keyboard shortcut.}}

{{history|0.17.0|
* Trains can be blueprinted.}}

{{history|0.15.24|
* In multiplayer, admins are allowed to modify other players' blueprints in the library, including deleting them.}}

{{history|0.15.3|
* Blueprints can be destroyed by clicking the trash can icon in the GUI.}}

{{history|0.15.0|
* [[Blueprint library]] introduced: Allows for keeping player's blueprints between individual game saves and allows sharing blueprints in multiplayer games. Also serves as unlimited inventory space for blueprints.
* The build rotation of each blueprint is remembered independently of the general item build rotation.
* Alternative select with blueprints (shift + select) skips the blueprint setup GUI.
* Added ability to export and import blueprints, blueprint books, and deconstruction planners as strings.
* Blueprints, blueprint books and deconstruction planners are obtainable from the library GUI with no crafting cost.}}

{{history|0.14.15|
* Changed the clear blueprint icon to the trashcan icon and moved it to the left of the cancel button, to make it less confusing for users.}}

{{history|0.13.13|
* Added [http://lua-api.factorio.com/latest/LuaEntityPrototype.html entity prototype flags] not-blueprintable and not-deconstructable, so these can be controlled by mod makers.}}

{{history|0.13.9|
* Added tips and tricks for pasting wagon slots and cycling in [[blueprint book]].}}

{{history|0.13.7|
* Rocks can be mined while holding blueprints.}}

{{history|0.13.5|
* Blueprints with labels will now show the label when holding them in the active hand.}}

{{history|0.13.0|
* Blueprints can now be edited.
* Added the [[blueprint book]] item, can hold multiple blueprints in one item.
* Modules are now supported by blueprints.
* Optimized drawing of connections between [[roboport]]s in blueprints.
* [[Circuit network#Virtual_signals|Virtual signals]] can be used in blueprint icons.
}}

{{history|0.12.2|
* Enabled swapping held blueprints with other blueprints directly.
* Force building blueprints will mark colliding trees for deconstruction.}}

{{history|0.12.0|
* Enabled mining trees/ghosts while holding blueprints to be built.
* Building blueprints over existing ghosts restores the ghost's life time.
* Proper blueprint centering.
}}

{{history|0.11.18|
* Blueprints can be built over things marked for deconstruction.
* Blueprints can be force built by shift clicking.
}}

{{history|0.11.10|
* Added [http://lua-api.factorio.com/latest/LuaItemStack.html Lua API] for reading/writing information from blueprints.}}

{{history|0.10.2|
* The rotation of turrets in blueprints no longer matters when testing for entity collision.}}

{{history|0.10.0|
* Blueprints can copy [[circuit network]] connections.
* Miners in blueprints are now ignored if they are non-functional.
* An [[inserter]]'s logistic conditions are copied when blueprinting.
}}

{{history|0.9.4|
* Limit the size of the blueprint preview, so it is usable for very large blueprints.}}

{{history|0.9.2|
* The [[train stop]] and [[lab]] built from blueprints are now given dedicated names.}}

{{history|0.9.0|
*Introduced}}

== See also ==
* [[Deconstruction planner]]
* [[Upgrade planner]]
* [[Blueprint book]]
* [[Logistic network]]
* [[Roboport]]
* [[Personal roboport]]
* [[Construction robot]]
* [[Blueprint string format]]

{{ProductionNav}}
{{C|Tools}}

Blueprint book

2020-12-13T18:06:41Z

Evg-zhabotinsky: Fixed the typo I missed in the previous edit

{{Languages}}
{{:Infobox:Blueprint book}}

The '''blueprint book''' is an item that can be used to store, organize and share [[blueprint]]s, [[deconstruction planner]]s, [[upgrade planner]]s and other blueprint books. Just like blueprints and planners, it occupies a single inventory slot, but can contain an unlimited amount of any of them. Also just like them, it can be stored in the [[blueprint library]] to prevent inventory space usage or for sharing purposes.

Blueprints can be used directly from the book item, and the currently active blueprint can be changed with {{Keybinding|shift|mwu}} and {{Keybinding|shift|mwd}}. If books are nested, this works as if every nested book was replaced by its contents: Upon switching to a nested book, that book is switched to the first (last) item it contains, and scrolling further switches through that nested book's items until its end, at which point the item that goes after the nested book is selected.

A blueprint book can be created by clicking the ( [[File:blueprint_book_button.png|20px]] ) button in the [[shortcut bar]]. It can be stored in player's inventory, in another book, or in the blueprint library. Any book or blueprint, even nested one, can also be placed in the [[quickbar]], but it is just a "shortcut", the item itself stays wherever it was. A book can also be placed in any normal container, like a chest, but keeping it there disables the quickbar entry (if it was created) and increases the chances of destruction (by biter attack or careless tank driving). ''For the ultimate safety and convenience, store all your books, blueprints and planners in your [[blueprint library]], optionally nested in other books for organization.''

[[File:Blueprint_book_ui.png|thumb|none|400px|Blueprint book GUI.]]

Shown above is the full blueprint book GUI window (includes player inventory on the left), which can be opened by right clicking the book item in any inventory (includes other books and blueprint library) or quickbar.

* The name and the icon of the book can be set with the button next to the name.
* The two leftmost buttons in the row below chose between the list view (shown in this screenshot) and the more compact grid view (shown in the screenshot at the top of this page).
* The "plus" button creates a copy of the book. The result is a completely separate book, editing or deleting either one or their contents does not affect the other.
* The green button allows applying an upgrade planner to all entities in all blueprints in the book.
* The button between the green and the red exports the book as a string that can be imported with the "Import string" button on the shortcut bar.
* The red trashcan button allows to delete the blueprint book and its contents.
* The currently selected book entry is highlighted with green.

== History ==
{{history|0.17.10|
* "Make blueprint book" function is now accessible via keyboard shortcut.}}

{{history|0.15.3|
* Blueprint books can be destroyed by clicking the trash can icon in the GUI. }}

{{history|0.15.0|
* Increased blueprint book size to hold 1000 blueprints.
* Added ability to export and import blueprints, blueprint books, and deconstruction planners as strings.
* Blueprints, blueprint books and deconstruction planners are obtainable from the library GUI with no crafting cost.}}

{{history|0.13.0|
* Introduced}}

== See also ==

* [[Blueprint]]
* [[Construction robot]]
* [[Deconstruction planner]]

{{ProductionNav}}
{{C|Tools}}

Blueprint book

2020-12-13T18:01:24Z

Evg-zhabotinsky: New GUI screenshots, mention book nesting and blueprint library, more explanations and info

{{Languages}}
{{:Infobox:Blueprint book}}

The '''blueprint book''' is an item that can be used to store, organize and share [[blueprint]]s, [[deconstruction planner]]s, [[upgrade planner]s and other blueprint books. Just like blueprints and planners, it occupies a single inventory slot, but can contain an unlimited amount of any of them. Also just like them, it can be stored in the [[blueprint library]] to prevent inventory space usage or for sharing purposes.

Blueprints can be used directly from the book item, and the currently active blueprint can be changed with {{Keybinding|shift|mwu}} and {{Keybinding|shift|mwd}}. If books are nested, this works as if every nested book was replaced by its contents: Upon switching to a nested book, that book is switched to the first (last) item it contains, and scrolling further switches through that nested book's items until its end, at which point the item that goes after the nested book is selected.

A blueprint book can be created by clicking the ( [[File:blueprint_book_button.png|20px]] ) button in the [[shortcut bar]]. It can be stored in player's inventory, in another book, or in the blueprint library. Any book or blueprint, even nested one, can also be placed in the [[quickbar]], but it is just a "shortcut", the item itself stays wherever it was. They can also be placed in any normal container, like a chest, but keeping it there disables the quickbar entry (if it was created) and increases the chances of destruction (by biter attack or careless tank driving). ''For the ultimate safety and convenience, store all your books, blueprints and planners in your [[blueprint library]], optionally nested in other books for organization.''

[[File:Blueprint_book_ui.png|thumb|none|400px|Blueprint book GUI.]]

Shown above is the full blueprint book GUI window (includes player inventory on the left), which can be opened by right clicking the book item in any inventory (includes other books and blueprint library) or quickbar.

* The name and the icon of the book can be set with the button next to the name.
* The two leftmost buttons in the row below chose between the list view (shown in this screenshot) and the more compact grid view (shown in the screenshot at the top of this page).
* The "plus" button creates a copy of the book. The result is a completely separate book, editing or deleting either one or their contents does not affect the other.
* The green button allows applying an upgrade planner to all entities in all blueprints in the book.
* The button between the green and the red exports the book as a string that can be imported with the "Import string" button on the shortcut bar.
* The red trashcan button allows to delete the blueprint book and its contents.
* The currently selected book entry is highlighted with green.

== History ==
{{history|0.17.10|
* "Make blueprint book" function is now accessible via keyboard shortcut.}}

{{history|0.15.3|
* Blueprint books can be destroyed by clicking the trash can icon in the GUI. }}

{{history|0.15.0|
* Increased blueprint book size to hold 1000 blueprints.
* Added ability to export and import blueprints, blueprint books, and deconstruction planners as strings.
* Blueprints, blueprint books and deconstruction planners are obtainable from the library GUI with no crafting cost.}}

{{history|0.13.0|
* Introduced}}

== See also ==

* [[Blueprint]]
* [[Construction robot]]
* [[Deconstruction planner]]

{{ProductionNav}}
{{C|Tools}}

File:Blueprint book preview.png

2020-12-13T17:29:56Z

Evg-zhabotinsky: Evg-zhabotinsky uploaded a new version of File:Blueprint book preview.png

File:Blueprint book gui.png

2020-12-13T17:24:11Z

Evg-zhabotinsky: Evg-zhabotinsky uploaded a new version of File:Blueprint book gui.png

Upgrade planner

2020-12-13T16:31:24Z

Evg-zhabotinsky: Mention ability to store in blueprint book or blueprint library

{{Languages}}{{:Infobox:Upgrade planner}}
The '''upgrade planner''' is a tool for mass updating entities to alternative entities of the same size and type. It can be used on both placed structures and [[ghost]]s. It can also modify the contents of a [[blueprint]]. While most commonly used to upgrade entities to their higher tier equivalents - for example to replace [[transport belt]]s with [[fast transport belt]]s or [[fast inserter]]s with [[stack inserter]]s - the upgrade planner is able to change a wide range of entities including [[transport belts]], [[underground belts]], [[splitters]], [[inserters]], [[assembling machine]]s, [[chests]], [[electric system|power poles]], [[rail signal]]s, [[module]]s, [[furnace]]s and more.

Using an upgrade planner in the game world is similar to the operation of the [[deconstruction planner]] and blueprint, in that the player drags a rectangular area in which the upgrade planner will function and this results in orders being queued for [[construction robot]]s. Upgrade planners can be used blank (unfiltered) to automatically apply a limited set of common upgrades. Alternatively they can be configured (filtered) to make specific replacements. This can include downgrading higher tier, later-game entities to lower tier equivalents.

Upgrade planners, just like [[blueprint]]s, can be stored in a [[blueprint book]] or [[blueprint library]] to prevent them occupying inventory space or for organization or sharing purposes.

== Basic operation ==

=== Getting an upgrade planner ===

A blank planner can be obtained by clicking the green upgrade planner icon ( [[File:upgrade_planner_button.png|20px]] ) on the [[shortcut bar]] (available once [[Construction robotics (research)|construction robotics]] has been researched in at least one game.)

This will result in a blank upgrade planner appearing in the hand. It can be used immediately or placed in the inventory. It must be placed in the inventory before a filter can be applied and before it can be pinned to a [[quickbar]] slot.

=== Using a planner in the game world ===

With a planner held in the hand the player can click-drag it ({{Keybinding|lmb}} is held down while moving the mouse) over existing structures to mark them for upgrade. A tooltip appears indicating which entities will be changed and to what.

Once {{Keybinding|lmb}} is released yellow circles will appear over any existing structures that are now queued for update. These update operations will be performed by [[construction robot]]s.

Upgrade planners can also affect ghost entities. Any ghost eligible for update will immediately change to the new entity.

<gallery widths=280px heights=260px>
File:UpgradePlanner-DraggingAPlanner.png|thumb|none|250px|Dragging an upgrade planner.
File:UpgradePlanner-DraggingAPlannerTooltip.png|thumb|none|250px|The tooltip shows which upgrades will occur.
File:UpgradePlanner-PendingUpgradeOperationCircles.png|thumb|none|250px|Yellow circles indicate pending update operations.
File:UpgradePlanner-GhostsDemo.gif|Ghost entities update immediately.
</gallery>

=== Cancelling updates ===

Pending upgrade operations can be cancelled by holding {{Keybinding|Shift}} while click-dragging the upgrade planner over the affected area.

=== Updating blueprints ===

Upgrade planners can also be used to change the contents of a blueprint. This allows the player to keep using the same blueprints as they research progressively better entities. As upgrade planners can also downgrade entities this further provides a way for a player to adjust late-game blueprints to make them suitable for re-use in subsequent games.

* The blueprint to be updated must reside in an inventory. It is not currently possible to use an upgrade planner in the blueprint library.
* With a planner held in the hand, the edit window for a blueprint should be opened by clicking {{Keybinding|rmb}} on it.
* The upgrade planner can be applied by clicking {{Keybinding|lmb}} on the grey upgrade planner slot in the top right corner of the blueprint.
* The entities in the blueprint will immediately update according to the filters in the planner. If a blank planner is used an automatic set of common upgrades is applied, as described in the next section.
* The update is immediate and cannot be undone, except by applying another upgrade planner with filters set to change back the affected entities.
<br/>
: [[File:UpgradePlanner-BlueprintExample.gif|border]]

== Upgrade planner filters ==

A new upgrade planner is blank, meaning it lacks any configuration and will operate on a pre-defined set of upgrade rules. The planner can optionally be edited to provide a custom list of update rules that control which entities will be updated and what to.

=== Using a blank upgrade planner (unfiltered) ===

When a blank upgrade planner is used it operates on a specific list of entities considered automatically upgradable to the next highest tier. The list of entity types that can be affected by a blank planner are as follows:

* [[Transport belts|Belts]]
* [[Underground belts]]
* [[Splitters]]
* [[Inserters]]
* [[Assembling machine]]s
* [[Furnace]]s

Entities of the above types will be upgraded to the next highest tier where one exists. A complete list of the entities eligible for upgrade by a blank planner is found in [[#Valid entities|Valid entities]].

=== Filtering an upgrade planner ===

The planner must be in an inventory in order for it to be editable. The filter window can be accessed by clicking {{Keybinding|rmb}} on an upgrade planner, either in the inventory or on a [[quickbar]] link.

==== The filter window ====

The filter window consists of 24 entity slot pairs.

In each pair the entity to be updated goes in the left slot and the entity it will be changed to goes in the right slot.

<gallery widths=300px heights=200px>
File:UpgradePlanner-Blank.png|300px|A blank planner.
File:UpgradePlanner-Example1.png|300px|A simple configuration example.
</gallery>

==== Editing the filters ====

A filter is applied by first clicking {{Keybinding|lmb}} on the left-hand slot of any slot pair. This brings up the '''Select upgrade''' window. This is similar to the [[Items|item selection]] window but is limited to displaying the entities an upgrade planner is able to change.

The right-hand slot is then selected in the same way, choosing the target entity. The select upgrade window for the right slot will only show entities that are a valid update target for the entity in the left slot.

When there is only one possible update target the right slot will be filled in automatically.

Filters can be removed by clicking {{Keybinding|rmb}} on the slot.

== Valid entities ==
[[File:UpgradePlanner-DowngradeExampleCropped.png|thumb|right|200px|An example of downgrading. This could be helpful to make a blueprint usable from the beginning of a game.]]
The upgrade planner can operate on the entities listed below. It can swap any entity in a given category to any other entity in the same category. For example a [[transport belt]] can be changed to a [[fast transport belt|fast]] or [[express transport belt]] and also to any kind of [[underground belt]], but not to a [[splitters|splitter]] or a [[chests|chest]].

The '''Blank upgrade planner''' column indicates which entities will be automatically upgraded when a blank (unfiltered) upgrade planner is used. These entities will upgrade to the entity following them in the table.

{| class="wikitable"
!style="width: 220px;" |Category
!Entity
!Blank upgrade planner
|-
| Belts and undergrounds || [[Transport belt]] || Yes
|-
| Belts and undergrounds || [[Fast transport belt]] || Yes
|-
| Belts and undergrounds || [[Express transport belt]] || No
|-
| Belts and undergrounds || [[Underground belt]] || Yes
|-
| Belts and undergrounds || [[Fast underground belt]] || Yes
|-
| Belts and undergrounds || [[Express underground belt]] || No
|-
| Splitters || [[Splitter]] || Yes
|-
| Splitters || [[Fast splitter]] || Yes
|-
| Splitters || [[Express splitter]] || No
|-
| Inserters || [[Burner inserter]] || No
|-
| Inserters || [[Inserter]] || Yes
|-
| Inserters || [[Fast inserter]] || Yes
|-
| Inserters || [[Stack inserter]] || No
|-
| Inserters || [[Filter inserter]] || No
|-
| Inserters || [[Stack filter inserter]] || No
|-
| Chests || [[Wooden chest]] || No
|-
| Chests || [[Iron chest]] || No
|-
| Chests || [[Steel chest]] || No
|-
| Chests || [[Active provider chest]] || No
|-
| Chests || [[Passive provider chest]] || No
|-
| Chests || [[Storage chest]] || No
|-
| Chests || [[Buffer chest]] || No
|-
| Chests || [[Requester chest]] || No
|-
| Power poles || [[Small electric pole]] || No
|-
| Power poles || [[Medium electric pole]] || No
|-
| Rail signals || [[Rail signal]] || No
|-
| Rail signals || [[Rail chain signal]] || No
|-
| Steam Engine/Turbine || [[Steam engine]] || No
|-
| Steam Engine/Turbine || [[Steam turbine]] || No
|-
| Furnaces || [[Stone furnace]] || Yes
|-
| Furnaces || [[Steel furnace]] || No
|-
| Assembling machines || [[Assembling machine 1]] || Yes
|-
| Assembling machines || [[Assembling machine 2]] || Yes
|-
| Assembling machines || [[Assembling machine 3]] || No
|-
| Modules || [[Speed module]] || No
|-
| Modules || [[Speed module 2]] || No
|-
| Modules || [[Speed module 3]] || No
|-
| Modules || [[Productivity module]] || No
|-
| Modules || [[Productivity module 2]] || No
|-
| Modules || [[Productivity module 3]] || No
|-
| Modules || [[Efficiency module]] || No
|-
| Modules || [[Efficiency module 2]] || No
|-
| Modules || [[Efficiency module 3]] || No
|}

=== Modded entities ===

[[modding|Modded]] entities can also be valid entities for an upgrade planner. The filter selection window will expand to automatically include any modded entities compatible with the above categories.

This can also result in extra categories being available for update, beyond those listed above. For example if a mod is installed that adds new types of [[lamp]], it may become possible to update the vanilla lamp to one of the new modded lamps using an upgrade planner.

== History ==
{{history|0.17.10|
* "Make upgrade planner" function is now accessible via keyboard shortcut.}}

{{history|0.17.0|
* Introduced}}

== See also ==

* [[Construction robot]]

{{ProductionNav}}
{{C|Tools}}

Deconstruction planner

2020-12-13T16:29:37Z

Evg-zhabotinsky: Mention ability to store in blueprint books and blueprint library

{{Languages}}
{{:Infobox:Deconstruction planner}}
The '''deconstruction planner''' is an item which allows the player to mark [[tile]]s and entities, including [[tree]]s, [[rock]]s, [[cliff]]s, [[fish]] and items on the ground, for removal.

By default, tiles are only marked when no entities are found. Tiles or entities queued for deconstruction will be marked with a red 'X'. When within the range of [[construction robot]]s they will be removed by the robots and the resulting items stored in [[logistic network]] chests or, when a [[personal roboport]] is used, the player's inventory. [[Ghost]]s will be removed immediately. Anything marked for deconstruction will immediately stop functioning. Deconstruction orders can be cancelled prior to the removal of the target. The deconstruction planner can be used unfiltered (blank) to remove all entities or tiles within its selection area, or it can be filtered to specific targets.

Deconstruction planners, just like [[blueprint]]s, can be stored in a [[blueprint book]] or [[blueprint library]] to prevent them occupying inventory space or for organization or sharing purposes.

== Usage ==

=== Getting a deconstruction planner ===

A planner can be obtained by:
* Clicking the red deconstruction planner icon ( [[File:DeconstructionPlanner-ShortcutIcon.png|25px]] ) in the [[shortcut bar]]. (Available once [[Construction robotics (research)|construction robotics]] is researched in at least one game.)
* Pressing the keyboard shortcut assigned to '''Make new deconstruction planner'''; default: {{Keybinding|ALT + D}}.
* [[#Exporting_and_importing_with_strings|Importing a deconstruction planner string]].

Once a new planner is in the hand it can be used immediately and then deleted by pressing {{Keybinding|Q}} to clear the hand. Alternatively, it can be dropped into the player's inventory for later use. Once in the inventory it can be pinned to a [[quickbar]] slot.

=== Accessing settings ===

The planner must be in an inventory in order for its configuration to be changed. Settings can be accessed by clicking {{Keybinding|rmb}} on a planner's icon, either in the inventory or on a quickbar link.

A full description of available settings and filters can be found under [[#Configuration and filtering|configuration and filtering]].

=== Deleting a planner ===

A planner that has been stored in an inventory can be deleted by clicking the red trash-can icon labelled '''Destroy deconstruction planner''' ( [[File:TrashCan.png|25px]] ) in the top right of its settings window.

Care should be taken when the planner has been configured as this operation is performed immediately without confirmation and cannot be undone.

=== Using the deconstruction planner ===

With a planner held in the hand the player can click-drag it ({{Keybinding|lmb}} is held down while moving the mouse) over existing structures and ghosts to mark them for deconstruction. A tooltip appears indicating what will be removed.

The planner can be used anywhere on the map where the player has [[radar]] coverage (map view).

Once {{Keybinding|lmb}} is released the deconstruction planner will take effect according to the rules listed below.

<gallery widths=400px heights=300px>
File:DeconstructionPlanner-DraggingAPlanner.png|Dragging a deconstruction planner.
File:DeconstructionPlanner-DraggingAPlannerTooltip.png|The tooltip shows what will be removed.
File:DeconstructionPlanner-DraggingAPlannerMarkers.png|Red Xs indicate queued deconstruction orders. Ghosts were immediately removed.
</gallery>

=== Effects of deconstruction ===

The following describes the possible results of using a deconstruction planner in the game world:
* Any selected entity ghosts and tile ghosts will be immediately removed.
* Any selected entities and tiles will be queued for deconstruction, indicated with a red X.
* Anything queued for deconstruction will stop functioning; for example [[transport belts]] will stop moving, [[assembling machine]]s will cease producing items, [[wall]]s stop connecting to each other, and so on. Laser and gun turrets will continue functioning even when marked for deconstruction.
* If the deconstruction orders are within the construction area of construction robots the orders will be added to the bots' queue and will be removed in due course:
** Bots will fly in and remove all entities and tiles and place the resulting items in logistic network chests, or the player's inventory when the bots flew from a personal roboport.
** Where there are items to be removed - for example being carried by transport belts or stored inside a chest or assembling machine - these will also be picked up by bots and placed in the appropriate storage.
*** Items must be removed before the entities that carry or hold them. For example if a [[wooden chest]] holding 500 [[iron plate]]s is marked for removal, the plates will be picked up first and only when all have been removed will the bots deconstruct the chest itself.
** Environmental entities such as trees, rocks and fish are handled in the same way, except bots mine them and collect and store the resource items they leave behind.
*** Cliffs are a special case: they are destroyed by bots carrying [[cliff explosives]] and do not yield any item to be stored.

=== Cancelling deconstruction orders ===

Queued deconstruction orders can be cancelled by holding {{Keybinding|Shift}} while click-dragging a deconstruction planner over the affected area.

When {{Keybinding|Shift}} is held down the area selection border will change from red to blue to indicate cancellation mode is in effect.

=== Undo ===

The undo tool can be used to revert the actions of a deconstruction planner. This applies both to pending deconstruction orders and completed removals.

Undo is triggered by pressing {{Keybinding|Control + Z}} (on macOS: {{Keybinding|Command + Z}})

Performing an undo will cancel any queued removal orders (red Xs) that have not yet been actioned. Any ghosts that were removed will be immediately replaced. Where built entities and tiles have already been removed the undo will reinstate them in the form of new ghosts that can then be re-built by any construction robots in range.

Items that were removed as part of the deconstruction - for example the inventory of chests or items carried by a transport belt - will not be restored by an undo. This means that a deconstruction that consisted exclusively of items, for example picking up [[stone]] from the ground, cannot be undone.

It is also not possible to undo the removal of trees, rocks, cliffs and fish.

<gallery widths=400px heights=230px>
File:DeconstructionPlanner-CancelDemo.gif|Cancelling deconstruction orders by dragging with {{keybinding|Shift}} held down. The entities start working when the deconstruction is cancelled.
File:DeconstructionPlanner-UndoDemo.gif|Using then undoing a deconstruction planner. Deconstruction markers are cancelled, ghosts re-appear, and removed entities are reinstated as new ghosts for bot rebuilding.
</gallery>

== Valid targets ==
[[File:DeconstructionPlanner-Fish.png|thumb|right|300px|Harvesting fish with a deconstruction planner.]]
The deconstruction planner can remove player-built entities, [[Ghost#Entities|entity ghosts]], tiles, [[Ghost#Tiles|tile ghosts]] and loose items. In addition, it can remove [[tree]]s, [[rock]]s, [[cliff]]s and [[fish]].

=== Tiles ===

[[Tile]]s are treated differently to entities, entity ghosts and tile ghosts. By default a deconstruction planner will not select any tiles unless the area selected contains ''only'' tiles; whenever one or more entities, entity ghosts or tile ghosts is included, tile selection is disabled. This is done to allow the player to use a deconstruction planner to remove entities that are placed on top of path tiles (such as [[concrete]]) without the floor always being removed as well.

When the user wishes to select tiles in areas where other objects also exist the deconstruction planner configuration must be changed as described in the next section.

=== Environmental entities ===

These are handled in the same way as entities and tiles placed by the player: they are marked with a red X and construction robots will remove them. A difference with environmental entities is that bots will collect resources rather than the entity itself, such as [[wood]] from trees and stone from rocks.

The removal of cliffs requires that the bots have access to cliff explosives. Cliffs do not leave behind any resource.

The ability to use a deconstruction planner to remove and collect fish provides a convenient way for a player equipped with a [[personal roboport]] to replenish their stocks of healing items even in the middle of combat. Fish marked with a deconstruction planner will stop moving.

== Configuration and filtering ==
[[File:DeconstructionPlanner-IconFiltered.png|thumb|right|An example of a filtered planner icon.]]
A new deconstruction planner is blank, meaning it removes according to a pre-defined set of rules. The planner can optionally be edited to provide a custom list of removal rules which control which types of entities and tiles will - or won't - be removed. These rules are called filters.

A filtered planner will show its filtered items on its icon. Up to the first four filters will be shown.

=== Blank planner rules ===

A blank planner will select:
* Any entities and entity ghosts, including trees, rocks, cliffs and fish;
* Tile ghosts;
* '''''Or''''', if and only if no entities, entity ghosts and tile ghosts are found, it will instead select tiles.

These rules are the base point from which a filtered planner can then be customized.

=== Filter settings window ===

The deconstruction planner interface is divided into two sections: '''entities''' and '''tiles'''.

<gallery widths=280px heights=150px>
File:DeconstructionPlanner-BlankEntities.png|The entities tab.
File:DeconstructionPlanner-BlankTiles.png|The tiles tab.
</gallery>

[[File:DeconstructionPlanner-ExampleWhitelistDefences.png|thumb|right|200px|A whitelist filter that removes only defensive structures.]]
[[File:DeconstructionPlanner-ExampleBlacklistPowerandRoboports.png|thumb|right|200px|A blacklist filter that removes everything except [[roboport]]s and [[Electric_system#Distribution|power poles]].]]

=== Principles of filtering ===

Each tab consists of 30 slots in which an entity or tile can be chosen. When one or more slots is filled the planner becomes filtered and will now act according to those filters.

A set of filters is either a whitelist or blacklist, and this is set with a toggle at the top of each tab. The default is whitelist. In whitelist mode the planner will act only upon those items added to the filter slots - any entities and tiles not added as filters will be ignored by the planner.

In blacklist mode the opposite applies: the planner will mark everything ''except'' the entities or tiles filtered on.

=== Setting and removing filters ===

Clicking any slot with {{keybinding|lmb}} will open the '''Set the filter''' window in which the desired item can be chosen. Alternatively, an item in the hand can be clicked into a slot to filter on that item.

A filter is removed by clicking on a filled slot with {{keybinding|rmb}}.

=== Entities tab ===

In the entities tab the user can select items to filter from the follow categories:
* Environment
* Logistics
* Production
* Combat
* Unsorted
[[File:DeconstructionPlanner-SetFilterEnvironment.png|thumb|right|200px|The Environment tab lists all types of trees and rocks, plus cliffs and fish.]]
Logistics, production and combat will be familiar to the player from the [[items|item selection]] window. Environment and unsorted are unique to the deconstruction planner.

The environment tab lists cliffs, fish, and every individual kind of tree and rock. This facilitates filtering on specific environmental entities if desired.

==== Trees/rocks only toggle ====

At the top of the entities tab is the '''Trees/rocks only''' tick-box. With this enabled the deconstruction planner will filter on all kinds of trees and rocks from the Environment section, and the filter slots will be disabled. The Whitelist/Blacklist toggle is still in effect and controls whether the planner selects only trees and rocks, or selects everything but them.

Fish and cliffs are ''not'' included in this filter, and enabling it blocks manual addition of any items. Therefore, if you want a planner that, for example, removes everything player-placed and does not touch the environment, you have to add each item in the Environment tab (every single tree and rock, cliffs and fish) individually. (This is as of 1.0.0. See suggestion threads to change that: [https://forums.factorio.com/viewtopic.php?f=6&t=91389 1] [https://forums.factorio.com/viewtopic.php?f=6&t=68629 2])

==== Special items in the Unsorted section ====

The unsorted section provides four special items, each using a red X icon.
* Entity ghost: To filter on any type of entity ghost, separate from constructed entities.
* Item on ground: Loose items on the ground, such as dropped by the player, spilled from removing [[armor]], and stones dropped from destroyed [[rock]]s. Does not include items on [[transport belts]].
* Item request slot: Filters on the pending addition of items such as [[module]]s to [[assembling machine 2]] or [[electric furnace]]. This would also target [[fuel]] queued for addition to a [[locomotive]]. Does not target items already installed, only those waiting to be added following the placement of a blueprint or as a result of an undo operation.
* Tile ghost: As with entity ghost, this will target [[tile]] ghosts separately from constructed tiles. If the user wants a deconstruction planner that only removes tile ghosts, they can place this item as an entity filter. If they want a filter that removes all types of tiles and tile ghosts, they should add '''Tile ghost''' under Entities and then set the Tiles tab drop-down to 'Always'.

=== Tiles tab ===

Clicking a filter slot will bring up the '''Set the Filter''' window showing the available tiles. [[Landfill]] is included in the list but has no function as landfill cannot be removed once placed.

At the top of the Tiles tab is a drop-down that controls constructed tile removal behavior. It has four options:
* Normal: The default. Constructed tiles are removed only when no entities, entity ghosts or tiles ghosts are found in the deconstruction area.
* Always: Constructed tiles are always removed, even if the deconstruction planner also selects entities or entity ghosts. Tile ghosts are not selected unless '''Tile ghost''' is added under the Entities tab.
* Never: Constructed tiles are never removed, even if they are the only object selected. Tile ghosts are not selected unless '''Tile ghost''' is added in the Entities tab.
* Only: Constructed tiles are always removed, and nothing else will be. Entities, entity ghosts and tile ghosts will be ignored. The Entities tab is effectively disabled when this mode is selected.

The deconstruction planner always follows the settings of this drop-down, regardless of any filters set in the Tiles tab. For example if a user wishes to configure a planner that removes both walls and [[concrete]], they must first set those filters in the Entities and Tiles tabs, and then also set the Tiles drop-down to '''Always'''. Without changing the drop-down the planner would only select concrete in places where no entities, entity ghosts or tile ghosts were found, as per the rules described under Normal in the above list.

=== Exporting and importing with strings ===

The settings for a deconstruction planner can be exported in string form.

Clicking the '''Export to string''' button ( [[File:ExportToString.png|25px]] ) in the top right of the planner edit window will pop up a window containing the '''Deconstruction item string'''. This string can be copied to the operating system clipboard, from where it could be saved to a text file or uploaded to a website.

To import a deconstruction planner the player can click the '''Import String''' icon on the [[shortcut bar]] ( [[File:ImportString.png|25px]] ). A dialogue box will appear into which the string can be pasted. This will result in a deconstruction planner appearing on the hand with the same configuration as the one that was exported.

The export/import process can be used to copy deconstruction planners between games and to other players.

== Achievements ==
{{Achievement|automated-cleanup}}

== History ==
{{history|0.18.37|
* Deconstruction planners can be inserted into blueprint books and the blueprint library.
* Deconstruction planners can now have custom icons specified.
* Icons and filters in the deconstruction planners are preserving the original values so whenever the mods would be re-added, the original values can be restored, unless the player clears the related icons manually.
* Deconstruction planners can no longer be cleared by shift-right mouse button.}}

{{history|0.18.13|
* Allowed to delete deconstruction planners also when opened in other inventory.}}

{{history|0.17.10|
* "Make deconstruction planner" function is now accessible via keyboard shortcut.}}

{{history|0.17.0|
* Added cliffs as a valid deconstruction target.
* Trains can be deconstructed.}}

{{history|0.15.3|
* Deconstruction planners can be destroyed by clicking the trash can icon in the GUI.}}

{{history|0.15.0|
* Blueprint library: Allows for keeping players blueprints between individual game saves and allows sharing blueprints in multiplayer games.
* Added ability to export and import blueprints, blueprint books, and deconstruction planners as strings.
* Blueprints, blueprint books and deconstruction planners are obtainable from the library GUI with no crafting cost.}}

{{history|0.13.0|
* Several non-stackable items can be swapped directly with counterparts, this includes the deconstruction planner.}}

{{history|0.11.15|
* When using the deconstruction planner, the [[logistic network]] is not drawn if the mouse is over a GUI element.}}

{{history|0.11.0|
* Added a cancel deconstruction option to the deconstruction planner.}}

{{history|0.9.0|
* Introduced}}

== See also ==
* [[Blueprint]]
* [[Upgrade planner]]
* [[Roboport]]
* [[Construction robot]]

{{ProductionNav}}
{{C|Tools}}

Blueprint

2020-12-13T16:26:04Z

Evg-zhabotinsky: Mention blueprint library, change wording

{{Languages}}
{{:Infobox:Blueprint}}

'''Blueprints''' are items that contain building layouts. Blueprints are used to 'copy & paste' parts of a factory. Built areas can be selected for inclusion in a blueprint. When a blueprint is placed, a [[ghost]] of the layout appears on the ground. This can be used as a guide for manually placing factory pieces, or, more commonly, handed over to [[construction robot]]s for automated completion.

Blueprints can be stored in a [[blueprint book]] or [[blueprint library]] to prevent them occupying inventory space or for organization or sharing purposes.

== Achievements ==
{{Achievement|automated-construction}}
{{Achievement|you-are-doing-it-right}}

== Usage ==

Blank blueprints can be crafted by clicking the ( [[File:Blueprint_button.png|20px]] ) button in the [[shortcut bar]].

The blank blueprint can now be used to 'copy' a set of buildings.

For example, copying this small laser defense setup:

[[File:Blueprint-example-01.png]]

=== Create a blueprint ===

To create a blueprint select the blueprint item out of the toolbar or the inventory.
With the blueprint icon shown next to the mouse cursor, click and hold the left mouse button and drag a box as large as needed (which can be cancelled by pressing {{key|Q}}).
All buildings which will be included in the blueprint will be highlighted with a green square.
Once everything to 'copy' is inside the drag box, release the mouse button, and the 'Blueprint icon setup' menu will open.

[[File:Blueprint-example-02.png‎]]

=== Blueprint icon setup ===

On the top left of the "Setup new blueprint" menu there are four icon slots.
The game chooses automatically the number of icons and which are pre-selected depending on the number of buildings that are included.
This can be changed by simply clicking on the icons to choose the desired ones.
On the left the 'Total' number of components included in the blueprint is shown.

The green "Create blueprint" button creates the blueprint. Additionally, blueprint creation can be cancelled by clicking the X in the top right corner.
Canceling the blueprint does not consume the blueprint item. The created blueprint will replace the empty blueprint in the player's cursor.

[[File:Blueprint-example-03.png‎]]

=== Placing the blueprint ===

To use/place the created blueprint select it from the tool belt or inventory.
The whole building setup of the blueprint will be shown at your mouse cursor.
In this case the Blueprint was renamed to "Example blueprint".
It is possible to place it rotated, press the default key {{keybinding|r}} to rotate.
The blueprint can be placed anywhere inside the green (or orange) 110×110 tiles area of a [[roboport]], or within range of a [[personal roboport]] installed in [[modular armor]] or [[spidertron]].

[[File:Blueprint-example-04.png‎]]

After the blueprint gets placed somewhere, the buildings are placed as ghost buildings.
[[Construction robot]]s will now start to pick up the needed items from the construction network/the player inventory (if using a personal roboport) and place them at the ghost buildings.
The required items need to be in the network in an [[active provider chest]], a [[passive provider chest]], a [[buffer chest]] or a [[storage chest]].

[[File:Blueprint-example-05.png‎]]

Blueprints can be placed from map view where the player has vision. Vision can be achieved by player presence, [[radar]] or a [[spidertron]]. Blueprints that are placed on map view outside the field of vision are truncated.

[[File:Factorio_Blueprint_MapView.jpg|450px]]

=== Viewing and clearing a blueprint ===

Right clicking on a blueprint allows you to view, edit and clear it.
By clearing it, it will become blank so it can be set again.

== Importing/Exporting blueprints ==

It is possible to export blueprints as a text string and import said text string to create a new blueprint. This makes sharing blueprints between players very easy.<br>
Clicking the '''Export to string''' button ( [[File:ExportToString.png|25px]] ) in the top right of the blueprint edit window will pop up a window containing the '''Blueprint string'''. This string can be copied to the operating system clipboard, from where it could be saved to a text file or uploaded to a website.

To import a blueprint, the player can click the '''Import string''' icon on the [[shortcut bar]] ( [[File:ImportString.png|25px]] ). A dialogue box will appear into which the string can be pasted. This will result in a blueprint appearing on the hand with the same setup as the one that was exported.

The text string itself is a base64 encoded, compressed JSON string which contains all the information of the blueprint. It is therefore possible to decode/decompress the text string, change attributes of the blueprint in the JSON text and finally re-encode/compress it back to the known text string format. This basically allows blueprint editing outside of the game itself.

A complete explanation of the blueprint JSON can be found on the [[blueprint string format]] page.

== Additional information ==

* Once a blueprint is created, it can be used an unlimited amount of times.
* To place a blueprint that is blocked by existing buildings, you can hold {{key|Shift}} to place the objects that aren't blocked.
* The above trick will also mark [[rock]]s and [[tree]]s for deconstruction.
* Buildings marked for [[Deconstruction planner|destruction]] will not block placing a blueprint. The blueprinted building cannot be placed if there are any buildings in the way. This can cause an item outside the construction zone to block construction of a 2×2 building on the edge of the zone.
* The maximum of size a blueprint is 10k by 10k [[Map_structure#Tile|tiles]].

== History ==
{{history|0.17.10|
* "Make blueprint" function is now accessible via keyboard shortcut.}}

{{history|0.17.0|
* Trains can be blueprinted.}}

{{history|0.15.24|
* In multiplayer, admins are allowed to modify other players' blueprints in the library, including deleting them.}}

{{history|0.15.3|
* Blueprints can be destroyed by clicking the trash can icon in the GUI.}}

{{history|0.15.0|
* Blueprint library: Allows for keeping players blueprints between individual game saves and allows sharing blueprints in multiplayer games.
* The build rotation of each blueprint is remembered independently of the general item build rotation.
* Alternative select with blueprints (shift + select) skips the blueprint setup GUI.
* Added ability to export and import blueprints, blueprint books, and deconstruction planners as strings.
* Blueprints, blueprint books and deconstruction planners are obtainable from the library GUI with no crafting cost.}}

{{history|0.14.15|
* Changed the clear blueprint icon to the trashcan icon and moved it to the left of the cancel button, to make it less confusing for users.}}

{{history|0.13.13|
* Added [http://lua-api.factorio.com/latest/LuaEntityPrototype.html entity prototype flags] not-blueprintable and not-deconstructable, so these can be controlled by mod makers.}}

{{history|0.13.9|
* Added tips and tricks for pasting wagon slots and cycling in [[blueprint book]].}}

{{history|0.13.7|
* Rocks can be mined while holding blueprints.}}

{{history|0.13.5|
* Blueprints with labels will now show the label when holding them in the active hand.}}

{{history|0.13.0|
* Blueprints can now be edited.
* Added the [[blueprint book]] item, can hold multiple blueprints in one item.
* Modules are now supported by blueprints.
* Optimized drawing of connections between [[roboport]]s in blueprints.
* [[Circuit network#Virtual_signals|Virtual signals]] can be used in blueprint icons.
}}

{{history|0.12.2|
* Enabled swapping held blueprints with other blueprints directly.
* Force building blueprints will mark colliding trees for deconstruction.}}

{{history|0.12.0|
* Enabled mining trees/ghosts while holding blueprints to be built.
* Building blueprints over existing ghosts restores the ghost's life time.
* Proper blueprint centering.
}}

{{history|0.11.18|
* Blueprints can be built over things marked for deconstruction.
* Blueprints can be force built by shift clicking.
}}

{{history|0.11.10|
* Added [http://lua-api.factorio.com/latest/LuaItemStack.html Lua API] for reading/writing information from blueprints.}}

{{history|0.10.2|
* The rotation of turrets in blueprints no longer matters when testing for entity collision.}}

{{history|0.10.0|
* Blueprints can copy [[circuit network]] connections.
* Miners in blueprints are now ignored if they are non-functional.
* An [[inserter]]'s logistic conditions are copied when blueprinting.
}}

{{history|0.9.4|
* Limit the size of the blueprint preview, so it is usable for very large blueprints.}}

{{history|0.9.2|
* The [[train stop]] and [[lab]] built from blueprints are now given dedicated names.}}

{{history|0.9.0|
*Introduced}}

== See also ==
* [[Deconstruction planner]]
* [[Upgrade planner]]
* [[Blueprint book]]
* [[Logistic network]]
* [[Roboport]]
* [[Personal roboport]]
* [[Construction robot]]
* [[Blueprint string format]]

{{ProductionNav}}
{{C|Tools}}

Deconstruction planner

2020-12-13T16:01:14Z

Evg-zhabotinsky: /* Trees/rocks only toggle */ It does not include cliffs and fish!

{{Languages}}
{{:Infobox:Deconstruction planner}}
The '''deconstruction planner''' is an item which allows the player to mark [[tile]]s and entities, including [[tree]]s, [[rock]]s, [[cliff]]s, [[fish]] and items on the ground, for removal.

By default, tiles are only marked when no entities are found. Tiles or entities queued for deconstruction will be marked with a red 'X'. When within the range of [[construction robot]]s they will be removed by the robots and the resulting items stored in [[logistic network]] chests or, when a [[personal roboport]] is used, the player's inventory. [[Ghost]]s will be removed immediately. Anything marked for deconstruction will immediately stop functioning. Deconstruction orders can be cancelled prior to the removal of the target. The deconstruction planner can be used unfiltered (blank) to remove all entities or tiles within its selection area, or it can be filtered to specific targets.

== Usage ==

=== Getting a deconstruction planner ===

A planner can be obtained by:
* Clicking the red deconstruction planner icon ( [[File:DeconstructionPlanner-ShortcutIcon.png|25px]] ) in the [[shortcut bar]]. (Available once [[Construction robotics (research)|construction robotics]] is researched in at least one game.)
* Pressing the keyboard shortcut assigned to '''Make new deconstruction planner'''; default: {{Keybinding|ALT + D}}.
* [[#Exporting_and_importing_with_strings|Importing a deconstruction planner string]].

Once a new planner is in the hand it can be used immediately and then deleted by pressing {{Keybinding|Q}} to clear the hand. Alternatively, it can be dropped into the player's inventory for later use. Once in the inventory it can be pinned to a [[quickbar]] slot.

=== Accessing settings ===

The planner must be in an inventory in order for its configuration to be changed. Settings can be accessed by clicking {{Keybinding|rmb}} on a planner's icon, either in the inventory or on a quickbar link.

A full description of available settings and filters can be found under [[#Configuration and filtering|configuration and filtering]].

=== Deleting a planner ===

A planner that has been stored in an inventory can be deleted by clicking the red trash-can icon labelled '''Destroy deconstruction planner''' ( [[File:TrashCan.png|25px]] ) in the top right of its settings window.

Care should be taken when the planner has been configured as this operation is performed immediately without confirmation and cannot be undone.

=== Using the deconstruction planner ===

With a planner held in the hand the player can click-drag it ({{Keybinding|lmb}} is held down while moving the mouse) over existing structures and ghosts to mark them for deconstruction. A tooltip appears indicating what will be removed.

The planner can be used anywhere on the map where the player has [[radar]] coverage (map view).

Once {{Keybinding|lmb}} is released the deconstruction planner will take effect according to the rules listed below.

<gallery widths=400px heights=300px>
File:DeconstructionPlanner-DraggingAPlanner.png|Dragging a deconstruction planner.
File:DeconstructionPlanner-DraggingAPlannerTooltip.png|The tooltip shows what will be removed.
File:DeconstructionPlanner-DraggingAPlannerMarkers.png|Red Xs indicate queued deconstruction orders. Ghosts were immediately removed.
</gallery>

=== Effects of deconstruction ===

The following describes the possible results of using a deconstruction planner in the game world:
* Any selected entity ghosts and tile ghosts will be immediately removed.
* Any selected entities and tiles will be queued for deconstruction, indicated with a red X.
* Anything queued for deconstruction will stop functioning; for example [[transport belts]] will stop moving, [[assembling machine]]s will cease producing items, [[wall]]s stop connecting to each other, and so on. Laser and gun turrets will continue functioning even when marked for deconstruction.
* If the deconstruction orders are within the construction area of construction robots the orders will be added to the bots' queue and will be removed in due course:
** Bots will fly in and remove all entities and tiles and place the resulting items in logistic network chests, or the player's inventory when the bots flew from a personal roboport.
** Where there are items to be removed - for example being carried by transport belts or stored inside a chest or assembling machine - these will also be picked up by bots and placed in the appropriate storage.
*** Items must be removed before the entities that carry or hold them. For example if a [[wooden chest]] holding 500 [[iron plate]]s is marked for removal, the plates will be picked up first and only when all have been removed will the bots deconstruct the chest itself.
** Environmental entities such as trees, rocks and fish are handled in the same way, except bots mine them and collect and store the resource items they leave behind.
*** Cliffs are a special case: they are destroyed by bots carrying [[cliff explosives]] and do not yield any item to be stored.

=== Cancelling deconstruction orders ===

Queued deconstruction orders can be cancelled by holding {{Keybinding|Shift}} while click-dragging a deconstruction planner over the affected area.

When {{Keybinding|Shift}} is held down the area selection border will change from red to blue to indicate cancellation mode is in effect.

=== Undo ===

The undo tool can be used to revert the actions of a deconstruction planner. This applies both to pending deconstruction orders and completed removals.

Undo is triggered by pressing {{Keybinding|Control + Z}} (on macOS: {{Keybinding|Command + Z}})

Performing an undo will cancel any queued removal orders (red Xs) that have not yet been actioned. Any ghosts that were removed will be immediately replaced. Where built entities and tiles have already been removed the undo will reinstate them in the form of new ghosts that can then be re-built by any construction robots in range.

Items that were removed as part of the deconstruction - for example the inventory of chests or items carried by a transport belt - will not be restored by an undo. This means that a deconstruction that consisted exclusively of items, for example picking up [[stone]] from the ground, cannot be undone.

It is also not possible to undo the removal of trees, rocks, cliffs and fish.

<gallery widths=400px heights=230px>
File:DeconstructionPlanner-CancelDemo.gif|Cancelling deconstruction orders by dragging with {{keybinding|Shift}} held down. The entities start working when the deconstruction is cancelled.
File:DeconstructionPlanner-UndoDemo.gif|Using then undoing a deconstruction planner. Deconstruction markers are cancelled, ghosts re-appear, and removed entities are reinstated as new ghosts for bot rebuilding.
</gallery>

== Valid targets ==
[[File:DeconstructionPlanner-Fish.png|thumb|right|300px|Harvesting fish with a deconstruction planner.]]
The deconstruction planner can remove player-built entities, [[Ghost#Entities|entity ghosts]], tiles, [[Ghost#Tiles|tile ghosts]] and loose items. In addition, it can remove [[tree]]s, [[rock]]s, [[cliff]]s and [[fish]].

=== Tiles ===

[[Tile]]s are treated differently to entities, entity ghosts and tile ghosts. By default a deconstruction planner will not select any tiles unless the area selected contains ''only'' tiles; whenever one or more entities, entity ghosts or tile ghosts is included, tile selection is disabled. This is done to allow the player to use a deconstruction planner to remove entities that are placed on top of path tiles (such as [[concrete]]) without the floor always being removed as well.

When the user wishes to select tiles in areas where other objects also exist the deconstruction planner configuration must be changed as described in the next section.

=== Environmental entities ===

These are handled in the same way as entities and tiles placed by the player: they are marked with a red X and construction robots will remove them. A difference with environmental entities is that bots will collect resources rather than the entity itself, such as [[wood]] from trees and stone from rocks.

The removal of cliffs requires that the bots have access to cliff explosives. Cliffs do not leave behind any resource.

The ability to use a deconstruction planner to remove and collect fish provides a convenient way for a player equipped with a [[personal roboport]] to replenish their stocks of healing items even in the middle of combat. Fish marked with a deconstruction planner will stop moving.

== Configuration and filtering ==
[[File:DeconstructionPlanner-IconFiltered.png|thumb|right|An example of a filtered planner icon.]]
A new deconstruction planner is blank, meaning it removes according to a pre-defined set of rules. The planner can optionally be edited to provide a custom list of removal rules which control which types of entities and tiles will - or won't - be removed. These rules are called filters.

A filtered planner will show its filtered items on its icon. Up to the first four filters will be shown.

=== Blank planner rules ===

A blank planner will select:
* Any entities and entity ghosts, including trees, rocks, cliffs and fish;
* Tile ghosts;
* '''''Or''''', if and only if no entities, entity ghosts and tile ghosts are found, it will instead select tiles.

These rules are the base point from which a filtered planner can then be customized.

=== Filter settings window ===

The deconstruction planner interface is divided into two sections: '''entities''' and '''tiles'''.

<gallery widths=280px heights=150px>
File:DeconstructionPlanner-BlankEntities.png|The entities tab.
File:DeconstructionPlanner-BlankTiles.png|The tiles tab.
</gallery>

[[File:DeconstructionPlanner-ExampleWhitelistDefences.png|thumb|right|200px|A whitelist filter that removes only defensive structures.]]
[[File:DeconstructionPlanner-ExampleBlacklistPowerandRoboports.png|thumb|right|200px|A blacklist filter that removes everything except [[roboport]]s and [[Electric_system#Distribution|power poles]].]]

=== Principles of filtering ===

Each tab consists of 30 slots in which an entity or tile can be chosen. When one or more slots is filled the planner becomes filtered and will now act according to those filters.

A set of filters is either a whitelist or blacklist, and this is set with a toggle at the top of each tab. The default is whitelist. In whitelist mode the planner will act only upon those items added to the filter slots - any entities and tiles not added as filters will be ignored by the planner.

In blacklist mode the opposite applies: the planner will mark everything ''except'' the entities or tiles filtered on.

=== Setting and removing filters ===

Clicking any slot with {{keybinding|lmb}} will open the '''Set the filter''' window in which the desired item can be chosen. Alternatively, an item in the hand can be clicked into a slot to filter on that item.

A filter is removed by clicking on a filled slot with {{keybinding|rmb}}.

=== Entities tab ===

In the entities tab the user can select items to filter from the follow categories:
* Environment
* Logistics
* Production
* Combat
* Unsorted
[[File:DeconstructionPlanner-SetFilterEnvironment.png|thumb|right|200px|The Environment tab lists all types of trees and rocks, plus cliffs and fish.]]
Logistics, production and combat will be familiar to the player from the [[items|item selection]] window. Environment and unsorted are unique to the deconstruction planner.

The environment tab lists cliffs, fish, and every individual kind of tree and rock. This facilitates filtering on specific environmental entities if desired.

==== Trees/rocks only toggle ====

At the top of the entities tab is the '''Trees/rocks only''' tick-box. With this enabled the deconstruction planner will filter on all kinds of trees and rocks from the Environment section, and the filter slots will be disabled. The Whitelist/Blacklist toggle is still in effect and controls whether the planner selects only trees and rocks, or selects everything but them.

Fish and cliffs are ''not'' included in this filter, and enabling it blocks manual addition of any items. Therefore, if you want a planner that, for example, removes everything player-placed and does not touch the environment, you have to add each item in the Environment tab (every single tree and rock, cliffs and fish) individually. (This is as of 1.0.0. See suggestion threads to change that: [https://forums.factorio.com/viewtopic.php?f=6&t=91389 1] [https://forums.factorio.com/viewtopic.php?f=6&t=68629 2])

==== Special items in the Unsorted section ====

The unsorted section provides four special items, each using a red X icon.
* Entity ghost: To filter on any type of entity ghost, separate from constructed entities.
* Item on ground: Loose items on the ground, such as dropped by the player, spilled from removing [[armor]], and stones dropped from destroyed [[rock]]s. Does not include items on [[transport belts]].
* Item request slot: Filters on the pending addition of items such as [[module]]s to [[assembling machine 2]] or [[electric furnace]]. This would also target [[fuel]] queued for addition to a [[locomotive]]. Does not target items already installed, only those waiting to be added following the placement of a blueprint or as a result of an undo operation.
* Tile ghost: As with entity ghost, this will target [[tile]] ghosts separately from constructed tiles. If the user wants a deconstruction planner that only removes tile ghosts, they can place this item as an entity filter. If they want a filter that removes all types of tiles and tile ghosts, they should add '''Tile ghost''' under Entities and then set the Tiles tab drop-down to 'Always'.

=== Tiles tab ===

Clicking a filter slot will bring up the '''Set the Filter''' window showing the available tiles. [[Landfill]] is included in the list but has no function as landfill cannot be removed once placed.

At the top of the Tiles tab is a drop-down that controls constructed tile removal behavior. It has four options:
* Normal: The default. Constructed tiles are removed only when no entities, entity ghosts or tiles ghosts are found in the deconstruction area.
* Always: Constructed tiles are always removed, even if the deconstruction planner also selects entities or entity ghosts. Tile ghosts are not selected unless '''Tile ghost''' is added under the Entities tab.
* Never: Constructed tiles are never removed, even if they are the only object selected. Tile ghosts are not selected unless '''Tile ghost''' is added in the Entities tab.
* Only: Constructed tiles are always removed, and nothing else will be. Entities, entity ghosts and tile ghosts will be ignored. The Entities tab is effectively disabled when this mode is selected.

The deconstruction planner always follows the settings of this drop-down, regardless of any filters set in the Tiles tab. For example if a user wishes to configure a planner that removes both walls and [[concrete]], they must first set those filters in the Entities and Tiles tabs, and then also set the Tiles drop-down to '''Always'''. Without changing the drop-down the planner would only select concrete in places where no entities, entity ghosts or tile ghosts were found, as per the rules described under Normal in the above list.

=== Exporting and importing with strings ===

The settings for a deconstruction planner can be exported in string form.

Clicking the '''Export to string''' button ( [[File:ExportToString.png|25px]] ) in the top right of the planner edit window will pop up a window containing the '''Deconstruction item string'''. This string can be copied to the operating system clipboard, from where it could be saved to a text file or uploaded to a website.

To import a deconstruction planner the player can click the '''Import String''' icon on the [[shortcut bar]] ( [[File:ImportString.png|25px]] ). A dialogue box will appear into which the string can be pasted. This will result in a deconstruction planner appearing on the hand with the same configuration as the one that was exported.

The export/import process can be used to copy deconstruction planners between games and to other players.

== Achievements ==
{{Achievement|automated-cleanup}}

== History ==
{{history|0.18.37|
* Deconstruction planners can be inserted into blueprint books and the blueprint library.
* Deconstruction planners can now have custom icons specified.
* Icons and filters in the deconstruction planners are preserving the original values so whenever the mods would be re-added, the original values can be restored, unless the player clears the related icons manually.
* Deconstruction planners can no longer be cleared by shift-right mouse button.}}

{{history|0.18.13|
* Allowed to delete deconstruction planners also when opened in other inventory.}}

{{history|0.17.10|
* "Make deconstruction planner" function is now accessible via keyboard shortcut.}}

{{history|0.17.0|
* Added cliffs as a valid deconstruction target.
* Trains can be deconstructed.}}

{{history|0.15.3|
* Deconstruction planners can be destroyed by clicking the trash can icon in the GUI.}}

{{history|0.15.0|
* Blueprint library: Allows for keeping players blueprints between individual game saves and allows sharing blueprints in multiplayer games.
* Added ability to export and import blueprints, blueprint books, and deconstruction planners as strings.
* Blueprints, blueprint books and deconstruction planners are obtainable from the library GUI with no crafting cost.}}

{{history|0.13.0|
* Several non-stackable items can be swapped directly with counterparts, this includes the deconstruction planner.}}

{{history|0.11.15|
* When using the deconstruction planner, the [[logistic network]] is not drawn if the mouse is over a GUI element.}}

{{history|0.11.0|
* Added a cancel deconstruction option to the deconstruction planner.}}

{{history|0.9.0|
* Introduced}}

== See also ==
* [[Blueprint]]
* [[Upgrade planner]]
* [[Roboport]]
* [[Construction robot]]

{{ProductionNav}}
{{C|Tools}}

Efficiency module 3

2020-12-10T19:01:03Z

Evg-zhabotinsky: A bit more complete explanation, especially that pollution reduction isn't just at the power plant.

{{Languages}}
{{:Infobox:Efficiency module 3}}

The efficiency module 3 reduces the electricity cost to run the machine by 50% of its base energy usage.

Note that minimal energy usage is 20% of base energy usage, but using more than 80% worth of efficiency modules makes sense if other modules are used, as they increase power usage and that effect is additive with the decrease from efficiency modules.

Efficiency modules also reduce pollution, because it is directly proportional to the machine's power consumption, see [[Pollution#Modules|pollution]].

== History ==
{{history|0.13.0|
* Blueprints support modules.}}

{{history|0.7.0|
* Pollution mechanic introduced.}}

{{history|0.6.0|
* Introduced}}

== See also ==

* [[Module|Modules]]
** [[Efficiency module]]
** [[Efficiency module 2]]

{{ProductionNav}}
{{C|Modules}}

Efficiency module 2

2020-12-10T18:59:08Z

Evg-zhabotinsky: A bit more complete explanation, especially that pollution reduction isn't just at the power plant.

{{Languages}}
{{:Infobox:Efficiency module 2}}

The efficiency module 2 reduces the electricity cost to run the machine by 40% of its base energy usage.

Note that minimal energy usage is 20% of base energy usage, but using more than 80% worth of efficiency modules makes sense if other modules are used, as they increase power usage and that effect is additive with the decrease from efficiency modules.

Efficiency modules also reduce pollution, because it is directly proportional to the machine's power consumption, see [[Pollution#Modules|pollution]].

== History ==
{{history|0.13.0|
* Blueprints support modules.}}

{{history|0.7.0|
* Pollution mechanic introduced.}}

{{history|0.6.0|
* Introduced}}

== See also ==

* [[Module|Modules]]
** [[Efficiency module]]
** [[Efficiency module 3]]

{{ProductionNav}}
{{C|Modules}}

Efficiency module

2020-12-10T18:55:25Z

Evg-zhabotinsky: A bit more complete explanation, especially that pollution reduction isn't just at the power plant.

{{Languages}}
{{:Infobox:Efficiency module}}

The efficiency module reduces the electricity cost to run the machine by 30% of its base energy usage.

Note that minimal energy usage is 20% of base energy usage, but using more than 80% worth of efficiency modules makes sense if other modules are used, as they increase power usage and that effect is additive with the decrease from efficiency modules.

Efficiency modules also reduce pollution, because it is directly proportional to the machine's power consumption, see [[Pollution#Modules|pollution]].

== History ==
{{history|0.13.0|
* Blueprints support modules.}}

{{history|0.7.0|
* Pollution mechanic introduced.}}

{{history|0.6.0|
* Introduced}}

== See also ==

* [[Module|Modules]]
** [[Efficiency module 2]]
** [[Efficiency module 3]]

{{ProductionNav}}
{{C|Modules}}

Wood

2020-12-10T15:26:46Z

Evg-zhabotinsky: /* Trivia */

{{Languages}}
{{:Infobox:Wood}}

'''Wood''' is a basic resource that can be collected by harvesting [[tree]]s. Wood can be used in crafting recipes but can also be used as [[fuel]] in all [[burner devices]] as well as in [[car]]s, [[tank]]s and [[locomotive]]s.

*Dead trees will give 2 wood.
*Big trees will give 4 wood.

== Trivia ==
*Wood is the only crafting material that cannot be harvested or produced using automation.
*It is also the only crafting material that can be bulk-harvested with [[construction robot]]s using [[Deconstruction planner]].

== History ==
{{history|0.17.0|
* Removed Wood from the game (And raw wood renamed to Wood).}}

{{history|0.13.0|
* Changed stack size to 100}}

{{history|0.11.0|
* Changed raw wood fuel value}}

{{history|0.10.1|
* New icons}}

{{history|0.9.2|
* Dry trees now give 4 wood.}}

{{history|0.1.0|
* Introduced}}

{{IntermediateNav}}
{{C|Resources}}