Blueprint File Formats - Revision history

SgSkallagrim: /* Header */

2017-02-17T11:07:32Z

‎Header

SgSkallagrim: /* smbpl.bt */

2017-02-17T10:37:54Z

‎smbpl.bt

SgSkallagrim: /* File Layout */

2017-02-17T09:35:17Z

‎File Layout

SgSkallagrim: /* File Layout */

2017-02-17T09:34:48Z

‎File Layout

SgSkallagrim at 08:58, 17 February 2017

2017-02-17T08:58:55Z

SgSkallagrim: /* Data */

2017-02-16T22:05:09Z

‎Data

SgSkallagrim: /* Metadata */

2017-02-16T22:04:32Z

‎Metadata

SgSkallagrim: /* Header */

2017-02-16T22:04:05Z

‎Header

SgSkallagrim: /* Logic */

2017-02-16T22:03:24Z

‎Logic

SgSkallagrim: /* Block Data */

2017-01-29T14:21:42Z

‎Block Data

@@ Line 34: / Line 34: @@
 ; Entity Type : Indicates whether the blueprint is for a Ship, Shop, Space Station, Asteroid or Planet.
-; Entity Class : Indicates the class of an entity. Like General, Mining, Attack or Defense and so on. Part of header since header version 2.
+; Entity Class : Indicates the class of an entity. Like General, Mining, Attack or Defense and so on. Part of header since header version 3.
 ; Bounding Box : A pair of three-dimensional coordinates providing the minimum and maximum block coordinates for the blueprint.  These are relative to a 0,0,0 base, so the minimum coordinates will be negative and the maximum coordinates will be positive.  The size of the blueprint is determined by subtracting the minimum coordinates from the maximum ones in each dimension.
 ; Element Map: An array of structures describing the number and types of each block in the blueprint.

@@ Line 206: / Line 206: @@
+{
      int version;
      int numControllers;
      ControllerEntity entities[numControllers];

@@ Line 22: / Line 22: @@
 | header.smbph || The [[#Header|header]] file.
 |-
-| meta.smbpm || The [[#Meta|metadata]] file.
+| meta.smbpm || The [[#Metadata|metadata]] file.
 |-
 | logic.smbpl || The [[#Logic|logic]] file.

@@ Line 20: / Line 20: @@
 ! File Name !! Purpose
 |-
-| header.smbph || The [[#header|header]] file.
+| header.smbph || The [[#Header|header]] file.
 |-
-| meta.smbpm || The [[#meta|metadata]] file.
+| meta.smbpm || The [[#Meta|metadata]] file.
 |-
-| logic.smbpl || The [[#logic|logic]] file.
+| logic.smbpl || The [[#Logic|logic]] file.
 |-
 | DATA/ || A directory containing the *.smd2 block [[#data|chunk data]] files.

@@ Line 29: / Line 29: @@
 |}
-==[[Blueprint_File_Format_Header|Header]]==
+==Header==
-The header file describes the following basic bits of information about the blueprint:
+The [[Blueprint_File_Format_Header|header file]] describes the following basic bits of information about the blueprint:
 ; Entity Type : Indicates whether the blueprint is for a Ship, Shop, Space Station, Asteroid or Planet.
@@ Line 41: / Line 41: @@
 With the information from the header, it's possible to calculate the size and composition of the blueprint to, for example, produce a list of materials needed for construction or determine if a ship can fit in a particular space.
-==[[Blueprint_File_Format_Metadata|Metadata]]==
+==Metadata==
-The metadata file contains all the other information about a blueprint except for block positions.  This includes things like docked turrets, contents of storage boxes on the ship, etc.  It is arranged in two sections: docking and Tags.
+The [[Blueprint_File_Format_Metadata|metadata file]] contains all the other information about a blueprint except for block positions.  This includes things like docked turrets, contents of storage boxes on the ship, etc.  It is arranged in two sections: docking and Tags.
 ; Docking : This section contains an array of structures describing the name of the blueprint for the docked entity, its size and position, the docking style and its docked orientation.
@@ Line 68: / Line 68: @@
 :* Vector4f (A vector of 4 floats)
-==[[Blueprint_File_Format_Logic|Logic]]==
+==Logic==
-The logic file describes all of the [[Linking|linked]] module groups in the ship.  It is structured as an array or arrays of block information.
+The [[Blueprint_File_Format_Logic|logic file]] describes all of the [[Linking|linked]] module groups in the ship.  It is structured as an array or arrays of block information.
 ; Controller Map : An array of Controller Entity structures, one for each linked master.
@@ Line 78: / Line 78: @@
 There is a hierarchy of groups, starting with the Controller Entity with controller position 8, 8, 8 (corresponding to the [[Ship Core]]) which will contain a list of Controller Groups containing the master blocks (such as the various computers.)  Within each of these groups will be the positions of those master blocks, and those positions will correspond to the Controller Entity positions of the other Entities in the Controller Map.
-==[[Blueprint_File_Format_Smd|Data]]==
+==Data==
-Data files are contained within the DATA directory for a given blueprint.  These files contain the actual block data - types, positions and orientations, organized into segments and further organized into regions.  Each region will be in its own file named with the following format <blueprintname>.<regionX>.<regionY>.<regionZ>.smd2.  For a blueprint called Alpha, the data file for region 0, 0, 0 would be called Alpha.0.0.0.smd2.
+[[Blueprint_File_Format_Smd|Data files]] are contained within the DATA directory for a given blueprint.  These files contain the actual block data - types, positions and orientations, organized into segments and further organized into regions.  Each region will be in its own file named with the following format <blueprintname>.<regionX>.<regionY>.<regionZ>.smd2.  For a blueprint called Alpha, the data file for region 0, 0, 0 would be called Alpha.0.0.0.smd2.
 The region file contains the following information:
@@ Line 88: / Line 88: @@
 ; [[Blueprint_File_Format_Block_Data|Block Data]] : A bit-packed structure describing the block id, orientation, hitpoints and whether the block is active.
-===[[Blueprint_File_Format_Block_Data|Block Data]]===
+===Block Data===
-The Block Data structure consists of three bytes which contain a bit-packed representation of each block in the blueprint.
+The [[Blueprint_File_Format_Block_Data|Block Data]] structure consists of three bytes which contain a bit-packed representation of each block in the blueprint.
 [[Blueprint_File_Format_Block_Data|More info]]

@@ Line 103: / Line 103: @@
 | colspan=7 bgcolor=blue align=center | Hit Points
 | colspan=11 bgcolor=green align=center | Block ID
 |}
-====[[Blueprint_File_Format_Block_Data#Orientation|Orientation]]====
+The [[Blueprint_File_Format_Block_Data#Orientation|Orientation]] field represents how the block is facing in the blueprint.  When all the bits in this field are zero, the block will be in its default orientation. <br/>
-The [[Blueprint_File_Format_Block_Data#Orientation|Orientation]] field represents how the block is facing in the blueprint.  When all the bits in this field are zero, the block will be in its default orientation.  The bits are interpeted as follows:
+Blocks than can be active have 1 for 'inaktive' and 0 for 'active'.Others have 0 as Active-bit.
 ==Additional Resources==