In other languages: Deutsch Français 日本語 Русский Українська 简体中文

Blueprint: Difference between revisions

From Official Factorio Wiki
Jump to navigation Jump to search
(→‎Placing the blueprint: explained blueprints & map view.)
(Added description of parameterisation. It's not perfect, but it's something for now.)
 
(12 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{Languages}}
{{Languages}}
{{:Infobox:Blueprint}}
{{:Infobox:Blueprint}}
{{cleanup|2.0 changes, such as quality of life features and parameterization.}}


'''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''' 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]]. This can store an unlimited amount of blueprints while taking only one inventory spot.
Blueprints can be stored in a [[blueprint book]] or [[blueprint library]] to prevent them occupying inventory space or for organization or sharing purposes.


== Achievements ==
== Achievements ==
Line 12: Line 14:
== Usage ==
== Usage ==


Blank blueprints can be crafted by clicking the ( [[File:Blueprint_button.png|20px]] ) button in the [[shortcut bar]].
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 gun turret defense setup:
 
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]]
[[File:Blueprint-example-01.png]]
Line 24: Line 22:
To create a blueprint select the blueprint item out of the toolbar or the inventory.
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}}).
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.
All player-placed entities which will be included in the blueprint will be highlighted with a green square.
Once everything you intend to 'copy' is inside the drag box, release the mouse button and the 'Blueprint icon setup' menu will open.


[[File:Blueprint-example-02.png‎]]
[[File:Blueprint-example-02.png‎]]
Line 31: Line 30:
=== Blueprint icon setup ===
=== Blueprint icon setup ===


On the top left of the "Setup new blueprint" menu there are four icon slots.
On the top left of the "Setup new blueprint" menu there are four icon slots. These are displayed on the blueprint's icon and can be used to quickly identify a blueprint. When creating a new blueprint, the game automatically selects some of the icons representing the entities in the blueprint.  
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.
These default icons 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.
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.
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.
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‎]]
[[File:Blueprint-example-03.png‎]]
Line 43: Line 42:
=== Placing the blueprint ===
=== Placing the blueprint ===


To use/place the created blueprint select it from the tool belt or inventory.
To use/place the created blueprint select it from the tool belt or inventory. The process of placing a blueprint is very similar to that of using [[copy and paste]] functionality.
The whole building setup of the blueprint will be shown at your mouse cursor.
 
In this case the Blueprint was renamed to "Example blueprint".
When you select a blueprint, 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]].
It is possible to place the blueprint rotated; this is done by using the {{keybinding|R}} key.
 
Placing a blueprint creates [[ghost]] entities. If these are within the green (or orange) 110×110 tiles area of a [[roboport]], or within range of a [[personal roboport]] installed in [[modular armor]] or [[spidertron]], construction robots may be able to build them using available materials.


[[File:Blueprint-example-04.png‎]]
[[File:Blueprint-example-04.png‎]]
Line 53: Line 54:
After the blueprint gets placed somewhere, the buildings are placed as ghost buildings.
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.
[[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]].
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‎]]
[[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.  
Blueprints can be placed from map view as long as the area has been explored.


[[File:Factorio_Blueprint_MapView.jpg|450px|thumb|left]]
[[File:Factorio_Blueprint_MapView.jpg|250px]]


=== Viewing and clearing a blueprint ===
=== Viewing and clearing a blueprint ===
Line 65: Line 67:
Right clicking on a blueprint allows you to view, edit and clear it.
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.
By clearing it, it will become blank so it can be set again.
=== Parameterisation ===
Any building that contains parameters can be customized in the blueprint tool, both when creating the blueprint, and when placing one. The following example will demonstrate parameterisation with a constant combinator:
[[File:parameterisation_example1.png]]{{clear}}
Note in the image, the values set for the iron plate, copper plate and the letter A. The paramaterisation button is a pink square, and once clicked for this example, we will get a screen like this. We can name different parameters, and can also select which ones can be changed later:
[[File:parameterisation_example2.png]]{{clear}}
In this example, we select two parameters, which is the iron plate and copper plate:
[[File:parameterisation_example3.png]]{{clear}}
Then we get this small screen when placing a blueprint with parameter checkboxes ticked. We change those two parameters to '1' and '2', which were the iron plate and copper plate:
[[File:parameterisation_example_sm.png]]{{clear}}
The end result is this, we have replaced two of those choices with '1' and '2', note that the value of 5 remained for those two signals:
[[File:parameterisation_example4.png]]{{clear}}


== Importing/Exporting blueprints ==
== Importing/Exporting blueprints ==
Line 99: Line 117:


{{history|0.15.0|
{{history|0.15.0|
* Blueprint library: Allows for keeping players blueprints between individual game saves and allows sharing blueprints in multiplayer games.
* [[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.
* 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.
* Alternative select with blueprints (shift + select) skips the blueprint setup GUI.
Line 109: Line 127:


{{history|0.13.13|
{{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.}}
* Added [[Types/EntityPrototypeFlags|entity prototype flags]] not-blueprintable and not-deconstructable, so these can be controlled by mod makers.}}


{{history|0.13.9|
{{history|0.13.9|

Latest revision as of 00:51, 11 November 2024

Blueprint.png
 Blueprint

Blueprint-example-03.png

Stack size

1

Prototype type

blueprint

Internal name

blueprint

Not-enough-repair-packs-icon.png
Page "Blueprint" has been recommended for clean-up. Reason: 2.0 changes, such as quality of life features and parameterization.
This may mean fixing grammar or broken links, providing better explanations, or removing incorrect/outdated info.
Further recommendations for this page's clean-up can be made at Talk: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 robots 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

Automated-construction-achievement.png Automated construction

Construct 100 machines using robots.

You-are-doing-it-right-achievement.png You are doing it right

Construct more machines using robots than manually.

Usage

Blank blueprints can be crafted by clicking the ( Blueprint button.png ) button in the shortcut bar. The blank blueprint can now be used to 'copy' a set of buildings. For example, copying this small gun turret defense setup:

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 Q).

All player-placed entities which will be included in the blueprint will be highlighted with a green square. Once everything you intend to 'copy' is inside the drag box, release the mouse button and the 'Blueprint icon setup' menu will open.

Blueprint-example-02.png

Blueprint icon setup

On the top left of the "Setup new blueprint" menu there are four icon slots. These are displayed on the blueprint's icon and can be used to quickly identify a blueprint. When creating a new blueprint, the game automatically selects some of the icons representing the entities in the blueprint.

These default icons 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.

Blueprint-example-03.png

Placing the blueprint

To use/place the created blueprint select it from the tool belt or inventory. The process of placing a blueprint is very similar to that of using copy and paste functionality.

When you select a blueprint, 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 the blueprint rotated; this is done by using the R key.

Placing a blueprint creates ghost entities. If these are within the green (or orange) 110×110 tiles area of a roboport, or within range of a personal roboport installed in modular armor or spidertron, construction robots may be able to build them using available materials.

Blueprint-example-04.png

After the blueprint gets placed somewhere, the buildings are placed as ghost buildings. Construction robots 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.

Blueprint-example-05.png

Blueprints can be placed from map view as long as the area has been explored.

Factorio Blueprint MapView.jpg

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.

Parameterisation

Any building that contains parameters can be customized in the blueprint tool, both when creating the blueprint, and when placing one. The following example will demonstrate parameterisation with a constant combinator:

Parameterisation example1.png

Note in the image, the values set for the iron plate, copper plate and the letter A. The paramaterisation button is a pink square, and once clicked for this example, we will get a screen like this. We can name different parameters, and can also select which ones can be changed later:

Parameterisation example2.png

In this example, we select two parameters, which is the iron plate and copper plate:

Parameterisation example3.png

Then we get this small screen when placing a blueprint with parameter checkboxes ticked. We change those two parameters to '1' and '2', which were the iron plate and copper plate:

Parameterisation example sm.png

The end result is this, we have replaced two of those choices with '1' and '2', note that the value of 5 remained for those two signals:

Parameterisation example4.png

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.
Clicking the Export to string button ( ExportToString.png ) 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 ( ImportString.png ). 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 Shift to place the objects that aren't blocked.
  • The above trick will also mark rocks and trees for deconstruction.
  • Buildings marked for 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 tiles.

History

  • 0.17.10:
    • "Make blueprint" function is now accessible via keyboard shortcut.
  • 0.17.0:
    • Trains can be blueprinted.
  • 0.15.24:
    • In multiplayer, admins are allowed to modify other players' blueprints in the library, including deleting them.
  • 0.15.3:
    • Blueprints can be destroyed by clicking the trash can icon in the GUI.
  • 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.
  • 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.
  • 0.13.7:
    • Rocks can be mined while holding blueprints.
  • 0.13.5:
    • Blueprints with labels will now show the label when holding them in the active hand.
  • 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 roboports in blueprints.
    • Virtual signals can be used in blueprint icons.
  • 0.12.2:
    • Enabled swapping held blueprints with other blueprints directly.
    • Force building blueprints will mark colliding trees for deconstruction.
  • 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.
  • 0.11.18:
    • Blueprints can be built over things marked for deconstruction.
    • Blueprints can be force built by shift clicking.
  • 0.11.10:
    • Added Lua API for reading/writing information from blueprints.
  • 0.10.2:
    • The rotation of turrets in blueprints no longer matters when testing for entity collision.
  • 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.
  • 0.9.4:
    • Limit the size of the blueprint preview, so it is usable for very large blueprints.

See also

Production items

Tools

Furnaces

Agriculture

Environmental protection

Retrieved from "https://wiki.factorio.com/index.php?title=Blueprint&oldid=205890"