In other languages: Deutsch 日本語 Русский

Upgrade planner: Difference between revisions

From Official Factorio Wiki
Jump to navigation Jump to search
(Added more example images. Still WIP.)
m (Changed "stack inserter" to "bulk inserter". Still outdated (as it still includes filter inserters but none of the 2.0 additions), but it's one step closer to freeing that redirect.)
 
(36 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Languages}}{{:Infobox:TheBloke/Upgrade planner}}
{{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 [[bulk 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.


The '''upgrade planner''' is a tool for the mass updating of entities to alternative items of the same size and type. It can be used both on buildings that have already been placed and also to modify the contents of a blueprint. It is most commonly used to upgrade entities to their higher tier equivalents. For example to replace [[transport belt]]s with [[fast transport belt]]s and later to [[express transport belt]]s. In addition it is also able to convert belts to [[underground belt]]s and [[pipe]]s to [[underground pipe]]s, as well as being able to replace several other categories of items. Using an upgrade planner in the game world is similar to the operation of a [[deconstruction planner]] and a [[blueprint]], in that the player selects a rectangular area in which the upgrade planner will function and this results in orders being queued for [[construction robot]]s.


== Basic operation ==
== Basic operation ==


[[File:UpgradePlanner-DraggingAPlanner.png|thumb|right|200px|Dragging an upgrade planner. The tooltip shows the upgrades that will happen.]]
[[File:UpgradePlanner-PendingUpgradeOperationCircles.png|thumb|right|200px|Pending upgrade planner operations indicated by yellow circles.]]
=== Getting an upgrade planner ===
=== Getting an upgrade planner ===


A blank planner can be obtained by:
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.)
* Clicking the green upgrade planner icon on the [[shortcut bar]] (available once [[Construction robotics (research)|construction robotics]] has been researched in at least one game.)
* Opening the blueprint library and clicking '''New Upgrade planner'''.


Either of these methods 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 if the player wishes to apply a filter to it, and/or pin it to their [[quickbar]].
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 the planner in the game world ===
=== Using a planner in the game world ===


With a planner held in the hand the player can drag it over structures in the game world to mark them for upgrade in exactly the same way that they might drag a blueprint or deconstruction planner. Yellow circles will appear over any item queued for update. These update operations will be performed by [[construction robot]]s.
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.


=== Cancelling upgrade operations ===
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.


Pending upgrade operations can be cancelled by holding {{Keybinding|Shift}} while dragging an upgrade planner over the affected area.
The planner can be used anywhere on the map where the player has [[radar]] coverage (map view). Upgrade planners can also affect ghost entities. Any ghost eligible for update will immediately change to the new entity.


=== Using the planner to update a blueprint ===
<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>


* The blueprint to be upgraded must reside in an inventory. It is not currently possible to apply an upgrade planner to a blueprint in the blueprint library.
=== Cancelling updates ===
* With a planner in the hand, open the edit window for a blueprint by clicking {{Keybinding|rmb}} on it.
* Click {{Keybinding|lmb}} on the grey upgrade planner slot, visible in the top right corner of the blueprint.
* The entities in the blueprint will immediately update. If a filtered planner is used, only those entities in the filter will change. An unfiltered planner will update all eligible entities.
* The update is immediate and irreversible.


== Filtered vs Unfiltered planners ==
Pending upgrade operations can be cancelled by holding {{Keybinding|shift}} while click-dragging the upgrade planner over the affected area.


Upgrade planners accept a list of item filters to control what types of items are upgraded, and to what. When an upgrade planner is first picked up it is blank and unfiltered.
=== Updating blueprints ===


=== Using a blank upgrade planner (unfiltered) ===
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.


When a blank upgrade planner is used it will update to the next highest tier any items considered automatically upgradable. The list of item types eligible for this are as follows:
* The blueprint to be updated must reside in an inventory. It is not currently possible to use an upgrade planner in the blueprint library.
* Belts
* With a planner held in the hand, the edit window for a blueprint should be opened by clicking {{Keybinding|rmb}} on it.
* Undergrounds
* The upgrade planner can be applied by clicking {{Keybinding|lmb}} on the grey upgrade planner slot in the top right corner of the blueprint.
* Splitters
* 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.
* Inserters
* The update is immediate and cannot be undone, except by applying another upgrade planner with filters set to change back the affected entities.
* Assembling machines
<br/>
: [[File:UpgradePlanner-BlueprintExample.gif|border]]


Any items of the above types will be upgraded to the next highest tier. For example a transport belt will change to a fast transport belt; a fast splitter will change to an express splitter; an assembling machine 2 will change to an assembling machine 3.
== Upgrade planner filters ==


=== Filtering an upgrade planner ===
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.


The edit window for the planner can be accessed by clicking with {{Keybinding|rmb}} on an upgrade planner. This click can be done via the inventory UI or directly on a [[quickbar]] link, but it must be done to an upgrade planner that is already in the inventory.
=== Using a blank upgrade planner (unfiltered) ===


== Items that can be altered ==
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:


The upgrade planner can operate on the items listed below. A planner can swap any item in each category to any other item in that same category. For example a [[transport belt]] can be changed to a fast or express transport belt and also to any kind of underground, but not to a splitter or a chest.
* [[Transport belts|Belts]]
* [[Underground belts]]
* [[Splitters]]
* [[Inserters]]
* [[Assembling machine]]s
* [[Furnace]]s


=== Belts and undergrounds ===
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]].


* [[Transport belt]]
=== Filtering an upgrade planner ===
* [[Fast transport belt]]
* [[Express transport belt]]
* [[Underground belt]]
* [[Fast underground belt]]
* [[Express underground belt]]
 
=== Splitters ===
 
* [[Splitter]]
* [[Fast splitter]]
* [[Express splitter]]
 
=== Inserters ===
 
* [[Burner inserter]]
* [[Inserter]]
* [[Fast inserter]]
* [[Filter inserter]]
* [[Stack inserter]]
* [[Stack filter inserter]]
 
=== Pipes ===
 
* [[Pipe]]
* [[Underground pipe]]
 
=== Chests ===


* [[Wooden chest]]
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.
* [[Iron chest]]
* [[Steel chest]]
* [[Active provider chest]]
* [[Passive provider chest]]
* [[Storage chest]]
* [[Buffer chest]]
* [[Requester chest]]


=== Power poles ===
==== The filter window ====


* [[Small electric pole]]
The filter window consists of 24 entity slot pairs.
* [[Medium electric pole]]


=== Boilers/Turbines ===
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.


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


=== Furnaces ===
==== Editing the filters ====


* [[Stone furnace]]
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.
* [[Steel furnace]]


=== Assembling machines ===
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.


* [[Assembling machine 1]]
When there is only one possible update target the right slot will be filled in automatically.
* [[Assembling machine 2]]
* [[Assembling machine 3]]


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


* [[Speed module]]
== Valid entities ==
* [[Speed module 2]]
[[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.]]
* [[Speed module 3]]
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]].
* [[Productivity module]]
* [[Productivity module 2]]
* [[Productivity module 3]]
* [[Efficiency module]]
* [[Efficiency module 2]]
* [[Efficiency module 3]]


=== Walls/Gates ===
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.


* [[Wall]]
{| class="wikitable"
* [[Gate]]
!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 || [[Bulk 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 ==
{{history|0.17.10|
* "Make upgrade planner" function is now accessible via keyboard shortcut.}}


{{history|0.17.0|
{{history|0.17.0|

Latest revision as of 07:37, 22 October 2024

Upgrade planner.png
Upgrade planner

UpgradePlanner-BlankPlannerDemo.gif

Using an unfiltered upgrade planner.

Stack size

1

Prototype type

upgrade-item

Internal name

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 ghosts. 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 belts with fast transport belts or fast inserters with bulk inserters - the upgrade planner is able to change a wide range of entities including transport belts, underground belts, splitters, inserters, assembling machines, chests, power poles, rail signals, modules, furnaces 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 robots. 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 blueprints, 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 ( Upgrade planner button.png ) on the shortcut bar (available once 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 (Left mouse button 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 Left mouse button is released yellow circles will appear over any existing structures that are now queued for update. These update operations will be performed by construction robots.

The planner can be used anywhere on the map where the player has radar coverage (map view). Upgrade planners can also affect ghost entities. Any ghost eligible for update will immediately change to the new entity.

Cancelling updates

Pending upgrade operations can be cancelled by holding 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 Right mouse button on it.
  • The upgrade planner can be applied by clicking Left mouse button 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.


UpgradePlanner-BlueprintExample.gif

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:

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.

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 Right mouse button 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.

Editing the filters

A filter is applied by first clicking Left mouse button on the left-hand slot of any slot pair. This brings up the Select upgrade window. This is similar to the 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 Right mouse button on the slot.

Valid entities

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 or express transport belt and also to any kind of underground belt, but not to a splitter or a 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.

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 Bulk 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

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

  • 0.17.10:
    • "Make upgrade planner" function is now accessible via keyboard shortcut.

See also