Blueprint File Format Header - Revision history

Oasisdog: /* Header of file */

2018-07-25T02:13:17Z

‎Header of file

Oasisdog at 06:04, 14 February 2018

2018-02-14T06:04:33Z

SgSkallagrim: /* header.smbph */

2017-02-17T10:37:00Z

‎header.smbph

SgSkallagrim: /* smbph.bt */

2017-02-17T10:34:25Z

‎smbph.bt

SgSkallagrim at 10:33, 17 February 2017

2017-02-17T10:33:22Z

SgSkallagrim: /* Statistic */

2017-02-16T23:13:53Z

‎Statistic

SgSkallagrim: Created page with "=header.smbph= A file that contains information about entity type/class, followed by its boundary around the blueprint. After that, the amount of blocks are listed. Ships also..."

2017-02-16T23:09:04Z

Created page with "=header.smbph= A file that contains information about entity type/class, followed by its boundary around the blueprint. After that, the amount of blocks are listed. Ships also..."

New page

=header.smbph=
A file that contains information about entity type/class, followed by its boundary around the blueprint.
After that, the amount of blocks are listed. Ships also have statistics at the end of the file.
Docked entities have their own header file and have no influence on the main entity header file.
This file is written using Big-endian.

==Header of file==
{| class="wikitable"
! Purpose !! Data type !! Version
|-
| Version || int32 || 0
|-
| Entity type || int32 || 0
|-
| Entity classification || int32 || 3
|-
| Box min || [float, float, float] || 0
|-
| Box max || [float, float, float] || 0
|}

===Entity type===
{| class="wikitable"
! Name !! Id
|-
| Ship || 0
|-
| Shop || 1
|-
| Space Station || 2
|-
| Asteroid || 3
|-
| Managed Asteroid || 4
|-
| Planet || 5
|}

===Entity classification===

{| class="wikitable"
! Entity !! Id !! Name
|-
| rowspan=9 | Ship || 0 || General
|-
| 1 || Mining
|-
| 2 || Support
|-
| 3 || Cargo
|-
| 4 || Attack
|-
| 5 || Defence
|-
| 6 || Carrier
|-
| 7 || Scout
|-
| 8 || Scavenger
|-
| rowspan=9 | Space Station || 9 || General
|-
| 10 || Shipyard
|-
| 11 || Outpost
|-
| 12 || Defense
|-
| 13 || Mining
|-
| 14 || Factory
|-
| 15 || Trade
|-
| 16 || Warp Gate
|-
| 17 || Shopping
|-
| rowspan=1 | Asteroid || 18 || General
|-
| rowspan=1 | Managed Asteroid || 19 || General
|-
| rowspan=1 | Planet || 20 || General
|-
| rowspan=1 | Shop || 21 || General
|}

==Block quantities==
{| class="wikitable"
! Purpose !! Data type !! Version
|-
| Number of entries || int32 || 0
|-
| Entry[Block id, Quantity] || [int16, int32] || 0
|}

==Statistic==
Statistics were added with version 1 of the 'header.smbph'.

{| class="wikitable"
! Purpose !! Data type !! Version
|-
| Has statistic || Boolean || 1
|}

===Statistic data===
Only ships have this section!

{| class="wikitable"
! Purpose !! Data type !! Statistic version
|-
| Statistic version || int16 || 0
|-
| Offensive 1 || double || 0
|-
| Defensive || double || 0
|-
| Power || double || 0
|-
| Mobility || double || 0
|-
| Danger || double || 0
|-
| Survivability || double || 0
|-
| Offensive 2 || double || 0
|-
| Support || double || 0
|-
| Mining || double || 1
|}

@@ Line 231: / Line 231: @@
      BoundingBox boundingBox;
      ElementCountMap elementCountMap;
-     byte hasStatistics;
+     byte hasStatistic;
-     Statistic statistic;
+     Statistic statistic;   // Ships only
 } Header;
 Header header;
 </pre>

← Older revision		Revision as of 10:33, 17 February 2017
Line 131:		Line 131:
	\| Mining \|\| double \|\| 1		\| Mining \|\| double \|\| 1
	\|}		\|}
		+
		+	==Additional Resources==
		+	In order to assist developers, the following files are provided to help understand and work with blueprint files.
		+
		+	===010 Editor===
		+	The following *.bt files are format definitions for the [http://www.sweetscape.com/010editor 010 Hex Editor].
		+
		+	===smbph.bt===
		+	<pre>
		+	//--------------------------------------
		+	//--- 010 Editor v6.0 Binary Template
		+	//
		+	// File: smbph.bt
		+	// Revision: v0.199.435
		+	// Purpose: StarMade Blueprint Header file
		+	//--------------------------------------
		+
		+	struct Vector3f
		+	{
		+	float x;
		+	float y;
		+	float z;
		+	};
		+
		+	enum <unsigned int> EntityType
		+	{
		+	Ship = 0,
		+	Shop = 1,
		+	SpaceStatiion = 2,
		+	Asteroid = 3,
		+	Managed Asteroid = 4,
		+	Planet = 5
		+	};
		+
		+	enum <unsigned int> ClassificationType
		+	{
		+	General = 0,
		+	Mining = 1,
		+	Support = 2,
		+	Cargo = 3,
		+	Attack = 4,
		+	Defense = 5,
		+	Carrier = 6,
		+	Scout = 7,
		+	Scavenger = 8,
		+	General = 9,
		+	Shipyard = 10,
		+	Outpost = 11,
		+	Defense = 12,
		+	Mining = 13,
		+	Factory = 14,
		+	Trade = 15,
		+	Warp_Gate = 16,
		+	Shopping = 17,
		+	General = 18,
		+	General = 19,
		+	General = 20,
		+	General = 21,
		+	General = 22,
		+	};
		+
		+	typedef struct
		+	{
		+	Vector3f min;
		+	Vector3f max;
		+	} BoundingBox;
		+
		+	typedef struct
		+	{
		+	short blockId;
		+	int blockCount;
		+	} Element;
		+
		+	typedef struct
		+	{
		+	int numElements;
		+	Element elements[numElements];
		+	} ElementCountMap;
		+
		+	typedef struct
		+	{
		+	int16 version;
		+	double offensive0;
		+	double defensive;
		+	double power;
		+	double mobility;
		+	double danger;
		+	double survivability;
		+	double offensive1;
		+	double support;
		+	double mining;
		+	} Statistic;
		+
		+	typedef struct
		+	{
		+	int version;
		+	EntityType entityType;
		+	ClassificationType classificationType;
		+	BoundingBox boundingBox;
		+	ElementCountMap elementCountMap;
		+	byte hasStatistics;
		+	Statistic statistic;
		+	} Header;
		+
		+	Header header;
		+	</pre>

@@ Line 11: / Line 11: @@
 | Version || int32 || 0
 |-
-| Version String || byte[27] || 5
+| Version String Size || int32 || 5
 |-
 | Entity type || int32 || 0

@@ Line 1: / Line 1: @@
 =header.smbph=
-A file that contains information about entity type/class, followed by its boundary around the blueprint.
+A file that contains information about entity type/class, followed by its boundary around the [[Blueprint_File_Formats|blueprint]].
 After that, the amount of blocks are listed. Ships also have statistics at the end of the file.
 Docked entities have their own header file and have no influence on the  main entity  header file.

@@ Line 102: / Line 102: @@
 ! Purpose !! Data type !! Version
 |-
-| Has statistic || Boolean || 1
+| Has statistic || Boolean (byte) || 1
 |}