-
Notifications
You must be signed in to change notification settings - Fork 18
Blueprint File Format
Blueprints are stored as text files using the .blueprint file extension. They consist of sections, each one starting with a # sign, terminated by a line break.
#Name: Displayed name of this blueprint
#Creator: Character name of the blueprint creator
#Description: Text describing the blueprint, enclosed by quotation marks ("), line breaks are serialized as \n
#Category: Category used in the blueprint rune's piece table, gets automatically created if it does not exist, defaults to Blueprints
#SnapPoints: Every line following this section is interpreted as a snap point position until another section is reached
#Pieces: Every line following this section is interpreted as an actual building piece of the blueprint
SnapPoint lines are Vector3 coordinates relative to the center of the blueprint divided by semicolons (;):
- X coordinate as
float - Y coordinate as
float - Z coordinate as
float
Piece lines consist of the prefab name, a category, a Vector3 for the position relative to the center of the blueprint, a Quaternion for rotation and additional information divided by semicolons (;):
- Piece prefab name as
string - Original piece category as
string - X coordinate of the position as
float - Y coordinate of the position as
float - Z coordinate of the position as
float - X component of the rotation as
float - Y component of the rotation as
float - Z component of the rotation as
float - W component of the rotation as
float - "Additional information" as
string(used to store piece specific information, text of signs for example)
The "center" of a blueprint is determined while capturing the blueprint. If it has a center marker set, all positions are relative to this center marker. If no center marker is present, the smallest position of all captured pieces ("lower left corner") is used as the "center".
Example blueprint taken from the Rudimentary Dungeon Kit mod.
#Name:RDK_FloorStone3x3
#Creator:Spank
#Description:"3x3 stone floor base\n\nFilling in floor gaps of LAR Rooms"
#Category:RDK
#SnapPoints
-2.999989;-0.5;3.000012
-3.000011;-0.5;-2.999988
3.000011;-0.5;2.999988
2.999989;-0.5;-3.000012
#Pieces
stone_floor_2x2;Building;-2.000008;0;-1.999992;0;0.7071083;0;0.7071053;
stone_floor_2x2;Building;-2;0;8.225441E-06;0;0.7071083;0;0.7071053;
stone_floor_2x2;Building;-1.999992;0;2.000008;0;0.7071083;0;0.7071053;
stone_floor_2x2;Building;-7.629395E-06;0;-2;0;0.7071083;0;0.7071053;
stone_floor_2x2;Building;0;0;0;0;0.7071083;0;0.7071053;
stone_floor_2x2;Building;7.629395E-06;0;2;0;0.7071083;0;0.7071053;
stone_floor_2x2;Building;1.999992;0;-2.000008;0;0.7071083;0;0.7071053;
stone_floor_2x2;Building;2;0;-8.106232E-06;0;0.7071083;0;0.7071053;
stone_floor_2x2;Building;2.000008;0;1.999992;0;0.7071083;0;0.7071053;