Preview of a blueprint string.
This is a technical description of the blueprint string format, used to share blueprints with other users.
A blueprint string is a JSON representation of the blueprint, compressed with zlib deflate using compression level 9 and then encoded using base64 with a version byte in front of the encoded string. The version byte is currently 0 (for all Factorio versions through 1.1).
So to get the JSON representation of a blueprint from a blueprint string, skip the first byte, base64 decode the string, and finally decompress using zlib inflate.
Json representation of a blueprint/blueprint book
The json representation of a blueprint or blueprint book is one large object inside another "wrapping" object, its key inside that object is either blueprint or blueprint-book.
Blueprint book object
Key |
Description |
Data type
|
item
|
String, the name of the item that was saved ("blueprint-book" in vanilla).
|
String
|
label
|
String, the name of the blueprint set by the user.
|
String
|
label_color
|
The color of the label of this blueprint. Optional. #Color object.
|
Object
|
blueprints
|
The actual content of the blueprint book, array of objects containing an "index" key and 0-based value and a "blueprint" key with a #Blueprint object as the value.
|
Array
|
active_index
|
Index of the currently selected blueprint, 0-based.
|
Integer
|
version
|
The map version of the map the blueprint was created in, see Version string format.
|
Integer (long)
|
Blueprint object
Key |
Description |
Data type
|
item
|
String, the name of the item that was saved ("blueprint" in vanilla).
|
String
|
label
|
String, the name of the blueprint set by the user.
|
String
|
label_color
|
The color of the label of this blueprint. Optional. #Color object.
|
Object
|
entities
|
The actual content of the blueprint, array of #Entity objects.
|
Array
|
tiles
|
The tiles included in the blueprint, array of #Tile objects.
|
Array
|
icons
|
The icons of the blueprint set by the user, array of #Icon objects.
|
Array
|
schedules
|
The schedules for trains in this blueprint, array of #Schedule objects.
|
Array
|
version
|
The map version of the map the blueprint was created in.
|
Integer (long)
|
Icon object
Key |
Description |
Data type
|
index
|
Index of the icon, 1-based.
|
Integer
|
signal
|
The icon that is displayed, #SignalID object.
|
Object
|
SignalID object
Key |
Description |
Data type
|
name
|
Name of the signal prototype this signal is set to.
|
String
|
type
|
Type of the signal. Either "item", "fluid" or "virtual".
|
String
|
Entity object
Key |
Description |
Data type
|
entity_number
|
Index of the entity, 1-based.
|
Integer
|
name
|
Prototype name of the entity (e.g. "offshore-pump").
|
String
|
position
|
#Position object, position of the entity within the blueprint.
|
Object
|
direction
|
Direction of the entity, uint (optional).
|
Integer
|
orientation
|
Orientation of cargo wagon or locomotive, value 0 to 1 (optional).
|
Floating Point
|
connections
|
Circuit connection, object with keys starting from 1, values are #Connection objects (optional).
|
Object
|
neighbours
|
Copper wire connections, array of entity_numbers (optional).
|
Array
|
control_behavior
|
|
Object
|
items
|
Item requests by this entity, this is what defines the item-request-proxy when the blueprint is placed, optional. #Item request object
|
Object
|
recipe
|
Name of the recipe prototype this assembling machine is set to, optional, string.
|
String
|
bar
|
Used by Prototype/Container, optional. The index of the first inaccessible item slot due to limiting with the red "bar". 0-based Types/ItemStackIndex.
|
Integer
|
inventory
|
Cargo wagon inventory configuration, optional. #Inventory object
|
Object
|
infinity_settings
|
Used by Prototype/InfinityContainer, optional. #Infinity settings object
|
Object
|
type
|
Type of the underground belt or loader, optional. Either "input" or "output".
|
String
|
input_priority
|
Input priority of the splitter, optional. Either "right" or "left", "none" is omitted.
|
String
|
output_priority
|
Output priority of the splitter, optional. Either "right" or "left", "none" is omitted.
|
String
|
filter
|
Filter of the splitter, optional. Name of the item prototype the filter is set to, string.
|
String
|
filters
|
Filters of the filter inserter or loader, optional. Array of #Item filter objects.
|
Array
|
filter_mode
|
Filter mode of the filter inserter, optional. Either "whitelist" or "blacklist".
|
String
|
override_stack_size
|
The stack size the inserter is set to, optional. Types/uint8.
|
Integer
|
drop_position
|
The drop position the inserter is set to, optional. #Position object.
|
Object
|
pickup_position
|
The pickup position the inserter is set to, optional. #Position object.
|
Object
|
request_filters
|
Used by Prototype/LogisticContainer, optional. #Logistic filter object.
|
Array
|
request_from_buffers
|
Boolean. Whether this requester chest can request from buffer chests.
|
Boolean
|
parameters
|
Used by Programmable speaker, optional. #Speaker parameter object.
|
Object
|
alert_parameters
|
Used by Programmable speaker, optional. #Speaker alert parameter object
|
Object
|
auto_launch
|
Used by the rocket silo, optional. Boolean, whether auto launch is enabled.
|
Boolean
|
variation
|
Used by Prototype/SimpleEntityWithForce or Prototype/SimpleEntityWithOwner, optional. Types/GraphicsVariation
|
|
color
|
Color of the Prototype/SimpleEntityWithForce, Prototype/SimpleEntityWithOwner, or train station, optional. #Color object.
|
Object
|
station
|
The name of the train station, optional.
|
String
|
Inventory object
Key |
Description |
Data type
|
filters
|
Array of #Item filter objects.
|
Array
|
bar
|
The index of the first inaccessible item slot due to limiting with the red "bar". 0-based, optional. Types/ItemStackIndex.
|
Integer
|
Schedule object
Key |
Description |
Data type
|
schedule
|
Array of #Schedule Record objects.
|
Array
|
locomotives
|
Array of entity numbers of locomotives using this schedule.
|
Array
|
Schedule Record object
Key |
Description |
Data type
|
station
|
The name of the stop for this schedule record.
|
String
|
wait_conditions
|
Array of #Wait Condition objects.
|
Array
|
Wait Condition object
Key |
Description |
Data type
|
type
|
One of "time", "inactivity", "full", "empty", "item_count", "circuit", "robots_inactive", "fluid_count", "passenger_present", "passenger_not_present".
|
String
|
compare_type
|
Either "and", or "or". Tells how this condition is to be compared with the preceding conditions in the corresponding wait_conditions array.
|
String
|
ticks
|
Number of ticks to wait or of inactivity. Only present when type is "time" or "inactivity". Optional.
|
uint
|
condition
|
CircuitCondition Object, only present when type is "item_count", "circuit" or "fluid_count".
|
Object
|
Tile object
Key |
Description |
Data type
|
name
|
Prototype name of the tile (e.g. "concrete")
|
String
|
position
|
#Position object, position of the entity within the blueprint.
|
Object
|
Position object
Key |
Description |
Data type
|
x
|
X position within the blueprint, 0 is the center.
|
Floating point
|
y
|
Y position within the blueprint, 0 is the center.
|
Floating point
|
Connection object
Object containing information about the connections to other entities formed by red or green wires.
Key |
Description |
Data type
|
1
|
First connection point. The default for everything that doesn't have multiple connection points.#Connection point object
|
Object
|
2
|
Second connection point. For example, the "output" part of an arithmetic combinator.#Connection point object
|
Object
|
Connection point object
The actual point where a wire is connected to. Contains information about where it is connected to.
Key |
Description |
Data type
|
red
|
An array of #Connection data object containing all the connections from this point created by red wire.
|
Array
|
green
|
An array of #Connection data object containing all the connections from this point created by green wire.
|
Array
|
Connection data object
Information about a single connection between two connection points.
Key |
Description |
Data type
|
entity_id
|
ID of the entity this connection is connected with.
|
Integer
|
circuit_id
|
The circuit connector id of the entity this connection is connected to, see defines.circuit_connector_id.
|
Integer
|
Item request object
1 or more instances of key/value pairs.
Key is the name of the item, string.
Value is the amount of items to be requested, Types/ItemCountType.
Item filter object
Key |
Description |
Data type
|
name
|
Name of the item prototype this filter is set to.
|
String
|
index
|
Index of the filter, 1-based.
|
Integer
|
Infinity settings object
Key |
Description
|
remove_unfiltered_items
|
Boolean. Whether the "remove unfiltered items" checkbox is checked.
|
Boolean
|
filters
|
Filters of the infinity container, optional. Array of #Infinity filter objects.
|
Array
|
Infinity filter object
Key |
Description
|
name
|
Name of the item prototype the filter is set to, string.
|
String
|
count
|
Number the filter is set to, Types/ItemCountType.
|
Integer
|
mode
|
Mode of the filter. Either "at-least", "at-most", or "exactly".
|
String
|
index
|
Index of the filter, 1-based.
|
Integer
|
Logistic filter object
Key |
Description |
Data type
|
name
|
Name of the item prototype this filter is set to.
|
String
|
index
|
Index of the filter, 1-based.
|
Integer
|
count
|
Number the filter is set to, Types/ItemCountType. Is 0 for storage chests.
|
Integer
|
Speaker parameter object
Key |
Description |
Data type
|
playback_volume
|
Types/double. Volume of the speaker.
|
Floating point
|
playback_globally
|
Boolean, whether global playback is enabled.
|
Boolean
|
allow_polyphony
|
Boolean, whether polyphony is allowed.
|
Boolean
|
Speaker alert parameter object
Key |
Description |
Data type
|
show_alert
|
Boolean, whether an alert is shown.
|
Boolean
|
show_on_map
|
Boolean, whether an alert icon is shown on the map.
|
Boolean
|
icon_signal_id
|
The icon that is displayed with the alert, #SignalID object.
|
Object
|
alert_message
|
String, message of the alert.
|
String
|
Color object
Key |
Description |
Data type
|
r
|
red, number from 0 to 1.
|
Floating point
|
g
|
green, number from 0 to 1.
|
Floating point
|
b
|
blue, number from 0 to 1.
|
Floating point
|
a
|
transparency, number from 0 to 1.
|
Floating point
|