Blueprint - Revision history

Bilka: /* Placing the blueprint */ typos

2026-02-20T18:25:10Z

Placing the blueprint: typos

← Older revision		Revision as of 18:25, 20 February 2026
Line 51:		Line 51:
	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.		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.

	Holding {{keybinding\|~~Shift~~}} will activate "Force Building" mode. This will mark all trees and rocks underneath the blueprint for deconstruction, as well as place ghosts for [[landfill]] if building over water. If playing in [[Space Age]]{{SA}}, it will instead place [[ice platform]]{{SA}} or [[foundation]]{{SA}}, depending on what is appropriate for the current planet.		Holding {{keybinding\|shift}} will activate "Force Building" mode. This will mark all trees and rocks underneath the blueprint for deconstruction, as well as place ghosts for [[landfill]] if building over water. If playing in [[Space Age]]{{SA}}, it will instead place [[ice platform]]{{SA}} or [[foundation]]{{SA}}, depending on what is appropriate for the current planet.

	Holding {{keybinding\|~~Control~~\|~~Shift~~}} will activate "Super Force Building" mode. This acts the same as force building, but will also mark '''all''' other buildings for deconstruction. If building over [[transport belt]]s, the game will attempt to place ghosts for [[underground belt]]s of the same tier, if possible.		Holding {{keybinding\|ctrl\|shift}} will activate "Super Force Building" mode. This acts the same as force building, but will also mark '''all''' other buildings for deconstruction. If building over [[transport belt]]s, the game will attempt to place ghosts for [[underground belt]]s of the same tier, if possible.

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

Tertius3: /* Parameterisation */ Typos

2025-01-31T15:08:41Z

Parameterisation: Typos

← Older revision		Revision as of 15:08, 31 January 2025
Line 84:		Line 84:
	[[File:Parameter begin.png\|300px]]{{clear}}		[[File:Parameter begin.png\|300px]]{{clear}}

	In the above image, we have an [[iron plate]] signal with a value of 5, a [[copper plate]] signal with a value of 10, and a virtual signal "A" with a value of 1. By clicking the purple ~~paramterisation~~ button in the top right of the blueprint setup screen, we get the parameterisation GUI:		In the above image, we have an [[iron plate]] signal with a value of 5, a [[copper plate]] signal with a value of 10, and a virtual signal "A" with a value of 1. By clicking the purple parameterisation button in the top right of the blueprint setup screen, we get the parameterisation GUI:

	[[File:Parameter gui2.png]]		[[File:Parameter gui2.png]]
Line 90:		Line 90:
	There is a separate parameter for each unique signal and their values. Hovering the mouse over each value will tell you the origin of each signal. The above image shows that the iron plate signal has a value of 5 in a constant combinator. This is very useful if the blueprint contains multiple buildings with many different parameters. If there are two different signals with the same value, or multiple sources of the same signal, that value or signal is treated as a single parameter.		There is a separate parameter for each unique signal and their values. Hovering the mouse over each value will tell you the origin of each signal. The above image shows that the iron plate signal has a value of 5 in a constant combinator. This is very useful if the blueprint contains multiple buildings with many different parameters. If there are two different signals with the same value, or multiple sources of the same signal, that value or signal is treated as a single parameter.

	There are several ways we can play with the values of the combinator. In order to be able to be modified, the "Parameter" ~~button~~ next to a signal or value must be ticked. Further, these parameters can be reordered by clicking and dragging the bars on the far right. Reordering does play an important part in more advanced uses.		There are several ways we can play with the values of the combinator. In order to be able to be modified, the "Parameter" checkbox next to a signal or value must be ticked. Further, these parameters can be reordered by clicking and dragging the bars on the far right. Reordering does play an important part in more advanced uses.

	[[File:Parameter formulas.png]]		[[File:Parameter formulas.png]]

Iridium235: Added quality blueprints fact to Trivia

2024-12-11T12:32:22Z

Added quality blueprints fact to Trivia

← Older revision		Revision as of 12:32, 11 December 2024
Line 136:		Line 136:
	* 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.		* 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]].		* The maximum of size a blueprint is 10k by 10k [[Map_structure#Tile\|tiles]].

			== Trivia ==

			* In [[Space Age]]{{SA}}, it is possible to get a [[quality]] blueprint by recycling them with [[Quality module\|quality modules]]. Quality blueprints function identically to their normal counterparts

	== History ==		== History ==

Yorven: /* Parameterisation */ Image formatting, added "show parameters" setting comment

2024-12-09T01:16:24Z

Parameterisation: Image formatting, added "show parameters" setting comment

← Older revision		Revision as of 01:16, 9 December 2024
Line 84:		Line 84:
	[[File:Parameter begin.png\|300px]]{{clear}}		[[File:Parameter begin.png\|300px]]{{clear}}

	In the above image, we have an [[iron plate]] signal with a value of 5, a [[copper plate]] signal with a value of 10, and a virtual signal "A" with a value of 1. By clicking the purple paramterisation button in the top right of the blueprint screen, we get the parameterisation GUI:		In the above image, we have an [[iron plate]] signal with a value of 5, a [[copper plate]] signal with a value of 10, and a virtual signal "A" with a value of 1. By clicking the purple paramterisation button in the top right of the blueprint setup screen, we get the parameterisation GUI:

	[[File:Parameter gui2.png]]		[[File:Parameter gui2.png]]

Line 103:		Line 104:

	Once finished configuring it, we press the green button, which saves our settings. The blueprint can now be placed. With our example, doing so will bring up the following box.		Once finished configuring it, we press the green button, which saves our settings. The blueprint can now be placed. With our example, doing so will bring up the following box.

	[[File:Parameter build.png]]		[[File:Parameter build.png]]

Line 113:		Line 115:

	Our "A" signal has stayed the same, but its value is now 16, which is double the variable "x", which we set to be 8		Our "A" signal has stayed the same, but its value is now 16, which is double the variable "x", which we set to be 8
	~~<!-- Am I allowed~~ to ~~paste~~ a ~~link to a community blueprint sharing website? I would like to share the~~ blueprint ~~of the constant combinator used in this example~~.~~-->~~
			Normally, the purple parameter icons are only available in the parameterisation GUI. Alternatively, if the "show parameters in selection lists" option is enabled under game Setting > Interface > Interaction, parameters 0 through 9 become available as [[Circuit network#Virtual signals\|virtual signals]] under the "Unsorted" tab to expedite the process of setting up a parameterised blueprint.

	== Importing/Exporting blueprints ==		== Importing/Exporting blueprints ==

Yorven: /* Parameterisation */ Added rich text link

2024-12-07T00:35:35Z

Parameterisation: Added rich text link

← Older revision		Revision as of 00:35, 7 December 2024
Line 78:		Line 78:
	* Recipes in buildings		* Recipes in buildings
	* Output control signals for the [[circuit network]]		* Output control signals for the [[circuit network]]
	* Icons, their values, and constants within [[combinators]]		* Icons, their values, and constants within [[combinators]] and their descriptions
	* ~~Icons~~ within the ~~name~~ of [[train stop]]s		* [[Rich text]] tags within the names of [[train stop]]s, among other buildings

	The following example will demonstrate parameterisation with a constant combinator:		The following example will demonstrate parameterisation with a constant combinator:

Yorven: Added force/super force building; new images & example for parameterisation (See comment)

2024-11-22T23:11:57Z

Added force/super force building; new images & example for parameterisation (See comment)

← Older revision		Revision as of 23:11, 22 November 2024
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.
Line 11:		Line 9:
	{{Achievement\|automated-construction}}		{{Achievement\|automated-construction}}
	{{Achievement\|you-are-doing-it-right}}		{{Achievement\|you-are-doing-it-right}}


	== Usage ==		== Usage ==
Line 35:		Line 34:

	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 purple "Parameterise" button in the top right is used to configure the settings of any buildings or [[circuit network]] entity within the blueprint. More on this feature below.

	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.		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.
Line 46:		Line 47:
	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".		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 {{keybinding\|R}} key.		The blueprint can be rotated using the {{keybinding\|R}} key. {{keybinding\|H}} will flip it horizontally; {{keybinding\|V}} will flip it vertically. Note that blueprints which contain [[rail signal]]s, [[rail chain signal\|chain signals]], or [[train stop]]s cannot be flipped, only rotated.

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

			Holding {{keybinding\|Shift}} will activate "Force Building" mode. This will mark all trees and rocks underneath the blueprint for deconstruction, as well as place ghosts for [[landfill]] if building over water. If playing in [[Space Age]]{{SA}}, it will instead place [[ice platform]]{{SA}} or [[foundation]]{{SA}}, depending on what is appropriate for the current planet.

			Holding {{keybinding\|Control\|Shift}} will activate "Super Force Building" mode. This acts the same as force building, but will also mark '''all''' other buildings for deconstruction. If building over [[transport belt]]s, the game will attempt to place ghosts for [[underground belt]]s of the same tier, if possible.

	[[File:Blueprint-example-04.png‎]]		[[File:Blueprint-example-04.png‎]]
Line 69:		Line 74:

	=== Parameterisation ===		=== 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:		Nearly everything in the game that can be configured can also be parameterised within a blueprint. Settings which would have had to be changed manually one at a time can be set automatically with a single selection during blueprint construction. This allows for more generic blueprints which can be specifically configured for a particular need.
	[[File:~~parameterisation_example1~~.png]]{{clear}}		Some settings which can be parameterised include, but are not limited to:
			* Recipes in buildings
			* Output control signals for the [[circuit network]]
			* Icons, their values, and constants within [[combinators]]
			* Icons within the name of [[train stop]]s

			The following example will demonstrate parameterisation with a constant combinator:
			[[File:Parameter begin.png\|300px]]{{clear}}

			In the above image, we have an [[iron plate]] signal with a value of 5, a [[copper plate]] signal with a value of 10, and a virtual signal "A" with a value of 1. By clicking the purple paramterisation button in the top right of the blueprint screen, we get the parameterisation GUI:
			[[File:Parameter gui2.png]]

			There is a separate parameter for each unique signal and their values. Hovering the mouse over each value will tell you the origin of each signal. The above image shows that the iron plate signal has a value of 5 in a constant combinator. This is very useful if the blueprint contains multiple buildings with many different parameters. If there are two different signals with the same value, or multiple sources of the same signal, that value or signal is treated as a single parameter.

			There are several ways we can play with the values of the combinator. In order to be able to be modified, the "Parameter" button next to a signal or value must be ticked. Further, these parameters can be reordered by clicking and dragging the bars on the far right. Reordering does play an important part in more advanced uses.
			[[File:Parameter formulas.png]]

			In the above image, the iron and copper icons have been replaced with special parameter icons. These signals can be chosen upon building the blueprint. Whatever signals are chosen will inherit the original signal values of 5 and 10, respectively. Each parameter can be given a name, which will show up when building the blueprint. This is optional, but recommended.

			Clicking "Ingredient of" will allow us to select a parameter icon of an above parameter icon. This is why the order of the parameters is important. In our example, if Parameter 0 is set to, say, [[steel plate]], Parameter 1 will automatically set itself to whatever the ingredient of that item is: in this case, [[iron plate]]. It is important to have enough available parameters for the number of ingredients. If we were to set Parameter 0 to instead [[electronic circuit]], Parameter 1 would do nothing, as there are two ingredients to that item. A parameter will always choose the default recipe of an item as listed in the Factoriopedia. Alternate recipes such as those added in [[Space Age]]{{SA}} will not be considered.

			A parameter that is a constant can set as a parameter, and given an optional variable. In the above image, the Iron Value of 5 has been set as a parameter, which will be set separately from the signal itself.

			Giving a constant an optional variable allows itself to be used in a formula for a later constant. In the above image, the Copper Value of 10 has been set as a parameter, and given the variable "x". The variable can be anything, but it's best to keep it as something simple. Further, our "A Value" value of 1 is selected as a parameter, and the formula box is checked.

			There are several formulas available. Hovering the mouse over the formula box will show a list of available formulas given the current blueprint. In this example, the "A Value" constant can be set based on the stack size or rocket capacity of whatever Parameter 0 or 1 comes out to be. We can also use our variable "x" from above. We can type in basic mathematical operators like +, -, , and /. This example uses the formula "x2", meaning the A Value constant will be set to double whatever variable "x" turns out to be.

			Once finished configuring it, we press the green button, which saves our settings. The blueprint can now be placed. With our example, doing so will bring up the following box.
			[[File:Parameter build.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:~~		We are given options to configure both the original iron plate signal, and the value of the copper plate signal. The other signals are determined by what we input in these two boxes. This example goes with a steel plate and a value of 8. Building this will give the following result.
	[[File:~~parameterisation_example2~~.png]]{{clear}}		[[File:Parameter final result.png]]{{clear}}

	~~In this example, we select two parameters, which is the~~ iron plate ~~and copper~~ plate:		Our original iron plate signal is now steel plate, with its original value of 5.
	~~[[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:~~		Our original copper plate signal is now iron plate with a value of 8, as that is the sole ingredient of steel plates
	~~[[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:~~		Our "A" signal has stayed the same, but its value is now 16, which is double the variable "x", which we set to be 8
	~~[[File:parameterisation_example4~~.~~png]]{{clear}}~~		<!-- Am I allowed to paste a link to a community blueprint sharing website? I would like to share the blueprint of the constant combinator used in this example.-->

	== Importing/Exporting blueprints ==		== Importing/Exporting blueprints ==
Line 104:		Line 135:

	== History ==		== History ==
			{{history\|2.0.7\|
			* Blueprint parametrisation. Allows to make more generic bluprints, which are configured upon building.
			* Added super forced building mode. Ctrl + Shift + Build marks for deconstruction player's colliding entities and replaces ghosts and tiles.}}

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

Zippy: Added description of parameterisation. It's not perfect, but it's something for now.

2024-11-11T00:51:30Z

Added description of parameterisation. It's not perfect, but it's something for now.

@@ Line 67: / Line 67: @@
 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 ==

Brin: Incomplete

2024-11-03T13:19:41Z

Incomplete

← Older revision		Revision as of 13:19, 3 November 2024
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.

Bilka: /* Placing the blueprint */ ARRRR

2024-08-30T13:41:41Z

Placing the blueprint: ARRRR

← Older revision		Revision as of 13:41, 30 August 2024
Line 44:		Line 44:
	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".		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 {{keybinding\|r}} key.		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.		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.

Alfonse: Section on blueprinting on top of other entities moved to its own page.

2023-02-10T05:28:34Z

Section on blueprinting on top of other entities moved to its own page.

← Older revision		Revision as of 05:28, 10 February 2023
Line 12:		Line 12:
	== 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 gun turret defense setup:

	[[File:Blueprint-example-01.png]]		[[File:Blueprint-example-01.png]]
Line 24:		Line 20:
	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 28:
	=== 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 40:
	=== 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 52:
	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]].

Line 65:		Line 65:
	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.

	~~== Placement and existing entities ==~~

	If the player attempts to place a blueprint such that new entities from the blueprint overlap with existing entities, then the placement system will attempt to resolve this conflict. If the conflicting entity in the terrain is the same as the one from the blueprint, then there is no conflict and the blueprint can be placed.

	If the conflicting entity in the terrain is a [[tree]], [[rock]], or [[cliff]], then the blueprint cannot be placed by left-clicking. If you shift-left-click to place the blueprint, then the conflicting terrain entity will be set to be destroyed (only if it is one of the above) and the ghost will be placed on top of it.

	By default, if the conflicting entity is player-placed and it is not the same as the one from the blueprint, then the blueprint cannot be placed by {{Keybinding\|lmb}}. If you {{Keybinding\|shift\|lmb}} to place the blueprint, any conflicts of this type are resolved by not affecting conflicting entities in the terrain.

	~~=== Upgrades ===~~

	There are exceptions to the previous rule about conflicting player-placed entities. If the entity in the blueprint exactly overlays the placed entity and the blueprint version is an upgraded form of the existing one, then the blueprint can be placed by left-clicking. For these conflicts, the entity on the terrain will be marked to be upgraded to the one from the blueprint.

	What entities upgrade to which other entities is defined by the [[upgrade planner#valid entities]]. If there is a [[transport belt]] on the ground and you place a blueprint that exactly overlays the entity with a [[fast transport belt]], then the belt will be marked to be upgraded to a fast belt.

	~~There are some properties of entities which can cause problems with upgrading. In particular, recipes and modules can confound the process.~~

	When the two entities are exactly the same, differences in recipes work as follows. If the blueprinted entity has a recipe, then that will overwrite the recipe in the terrain entity. If the blueprinted entity does not have a recipe, then it will leave the recipe (if any) in the terrain entity untouched.

	When it comes to upgradable buildings with recipes (like [[assembling machine]]s), things work out as follows. If the terrain entity has no recipe, but the blueprinted entity does, then placing it will simultaneously upgrade the building and set its recipe. If the terrain entity has a recipe, but the blueprinted entity does not, then placing it will upgrade the building (if the new building can craft using the previous recipe).

	However, if both buildings have a recipe, these will cause a conflict and the blueprint cannot be placed. This will be true ''even if'' the recipe is ''the same''. That is, if you want a blueprint to be able to upgrade a building that has an existing recipe, that blueprint ''must not'' have a recipe for that building.

	~~Modules work a lot like recipes.~~

	If the entity in the terrain has modules, but the blueprint does not, then the placement can still work provided that the entity being upgraded to can contain the same number of modules as the terrain entity. That is, you cannot "upgrade" a module-containing assembler 2 to an assembler 1 because assembler 1s cannot have modules.

	If the terrain entity does not have modules, and the blueprint entity does, the placement will mark the target entity to have those modules ''only if'' they are the exact same entity. That is, you can upgrade an assembling machine 2 with no modules to an assembling machine 2 with 2 modules, but you cannot upgrade it to an [[assembling machine 3]] with modules. You can upgrade it to an assembling machine 3 with no modules, then upgrade that to one with modules, but this requires two separate blueprints.

	If both the entity on the ground and in the blueprint have modules, the placement will only work if they are the same entity with the exact same module layout (in number, kind, and position in the list of modules). That is, while a blueprint can upgrade an assembler 3 with no modules to one with 4 [[productivity module\|productivity module 1s]], a blueprint cannot later upgrade it to use [[productivity module 2]]s. However, the inability to place the blueprint can still be a hint to upgrade the modules manually with an upgrade planner. Once the entity on the ground is upgraded to match the blueprint, the print can be placed (though it will do nothing to that particular assembler).

	~~=== Circuits networks ===~~

	When creating a blueprint, any [[circuit network]] wiring or conditions are also copied into the blueprint. When placing a blueprint, if there are matching or upgraded versions of that entity on the ground, any changes to circuit logic is also copied into the existing or upgraded entity. This means that blueprints can add or modify circuit logic to existing entities, for example, to turn on or off belts.

	~~This also includes other properties, such as [[chest]] limits or [[storage chest]] filters, or [[splitter]] filters.~~

	However, there is no notion of "turning off" circuit logic or "removing wiring" with blueprinting on top of existing entities. Once those entities have wiring or logic, they will be retained. New blueprints can ''change'' the logic however, so if you want to make a blueprint turn off a condition from an earlier one, you need to change the logic into one that always passes.

	== Importing/Exporting blueprints ==		== Importing/Exporting blueprints ==