StarMade Wiki - User contributions [en]

Blueprint File Format Header

2018-07-25T02:13:17Z

Oasisdog: /* Header of file */

=header.smbph=
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.
This file is written using Big-endian.

==Header of file==
{| class="wikitable"
! Purpose !! Data type !! Version
|-
| Version || int32 || 0
|-
| Version String Size || int32 || 5
|-
| Version String || byte[Version String Size] || 5
|-
| 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 (byte) || 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
|}

==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 hasStatistic;
Statistic statistic; // Ships only
} Header;

Header header;
</pre>

Blueprint File Format Header

2018-02-14T06:04:33Z

Oasisdog:

=header.smbph=
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.
This file is written using Big-endian.

==Header of file==
{| class="wikitable"
! Purpose !! Data type !! Version
|-
| Version || int32 || 0
|-
| Version String || byte[27] || 5
|-
| 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 (byte) || 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
|}

==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 hasStatistic;
Statistic statistic; // Ships only
} Header;

Header header;
</pre>

File:Power Capacitor.png

2016-08-01T02:46:34Z

Oasisdog:

File:Power Reactor Module.png

2016-08-01T02:46:13Z

Oasisdog:

File:Ship Core.png

2016-08-01T02:35:04Z

Oasisdog:

File:Damage Pulse Module.png

2016-08-01T02:33:43Z

Oasisdog:

File:Damage Beam Module.png

2016-08-01T02:33:25Z

Oasisdog:

File:Missile Tube.png

2016-08-01T02:31:48Z

Oasisdog:

File:Cannon Computer.png

2016-08-01T02:27:00Z

Oasisdog: Oasisdog uploaded a new version of File:Cannon Computer.png

File:Cannon Barrel.png

2016-08-01T02:22:09Z

Oasisdog: Oasisdog uploaded a new version of File:Cannon Barrel.png