LMS > Overview > Project File (MSBP)
This file is identified by the magic number MsgPrjBn. This file defines various metadata for MSBT files.
This page describes file format version 3 and 4.
| Type | Description |
|---|---|
CLR1 | Colors |
CLB1 | Color labels |
ATI2 | Attributes |
ALB1 | Attribute labels |
ALI2 | Attribute enum labels |
TGG2 | Tag groups |
TAG2 | Tags |
TGP2 | Tag parameters |
TGL2 | Tag string list |
SYL3 | Styles |
SLB1 | Style labels |
CTI1 | Project contents |
All blocks are optional.
CLR1 Block
| Offset | Size | Description |
|---|---|---|
| 0x0 | 4 | Number of colors |
| 0x4 | 4 per color | RGBA colors |
CLB1 Block
This block contains labels for the CLR1 block.
ATI2 Block
This block defines the layout of a global attribute structure.
| Offset | Size | Description |
|---|---|---|
| 0x0 | 4 | Number of attributes |
| 0x4 | 8 per attribute | Attributes |
Attribute
If the attribute type is an enum, the enum id is an index into the ALI2 block.
| Offset | Size | Description |
|---|---|---|
| 0x0 | 1 | Type |
| 0x1 | 1 | Padding |
| 0x2 | 2 | Enum id |
| 0x4 | 4 | Offset |
ALB1 Block
This block contains labels for the ATI2 block.
ALI2 Block
This block contains names for enum values. It is referenced by the ATI2 block.
| Offset | Size | Description |
|---|---|---|
| 0x0 | 4 | Number of enums |
| 0x4 | 4 per enum | Offsets to enum declarations, relative to start of block |
| Enum declarations |
Enum Declaration
| Offset | Size | Description |
|---|---|---|
| 0x0 | 4 | Number of enum member names |
| 0x4 | 4 per enum | Offsets to enum member names, relative to start of enum declaration |
| Null-terminated enum member names |
Every enum declaration is padded until its size is a multiple of 4 bytes.
TGG2 Block
This block defines control tag groups for MSBT files.
Control tags allow developers to apply modifiers (such as bold or cursive) and insert placeholders for other text. Tags are organized into groups.
| Offset | Size | Description |
|---|---|---|
| 0x0 | 2 | Number of tag groups |
| 0x2 | 2 | Padding |
| 0x4 | 4 per group | Offsets to tag groups, relative to start of block |
| Tag groups |
Tag Group
Every tag group is identified by an id. In version 3, the id is simply the index of the group. In version 4, it is explicitly stored in the file.
Version 3:
| Offset | Size | Description |
|---|---|---|
| 0x0 | 2 | Number of tags |
| 0x2 | 2 per tag | Tag indices (in TAG2 block) |
| Null-terminated tag group name |
Version 4:
| Offset | Size | Description |
|---|---|---|
| 0x0 | 2 | Tag group id |
| 0x2 | 2 | Number of tags |
| 0x4 | 2 per tag | Tag indices (in TAG2 block) |
| Null-terminated tag group name |
Every tag group is padded so that its size is a multiple of 4.
TAG2 Block
| Offset | Size | Description |
|---|---|---|
| 0x0 | 2 | Number of tags |
| 0x2 | 2 | Padding |
| 0x4 | 4 per tag | Offsets to tags, relative to start of block |
Tag
| Offset | Size | Description |
|---|---|---|
| 0x0 | 2 | Number of tag parameters |
| 0x2 | 2 per parameter | Tag parameter indices (in TGP2 block) |
| Null-terminated tag name |
Every tag is padded so that its size is a multiple of 4.
TGP2 Block
| Offset | Size | Description |
|---|---|---|
| 0x0 | 2 | Number of parameters |
| 0x2 | 2 | Padding |
| 0x4 | 4 per parameter | Offsets to parameters, relative to start of block |
Tag Parameter
If the parameter type is not an enum:
| Offset | Size | Description |
|---|---|---|
| 0x0 | 1 | Parameter type |
| 0x1 | Null terminated parameter name |
If the parameter type is an enum:
| Offset | Size | Description |
|---|---|---|
| 0x0 | 1 | Parameter type |
| 0x1 | Null terminated parameter name | |
| 0x1 | 1 | Padding |
| 0x2 | 2 | Number of enum members |
| 0x4 | 2 per list item | Enum member name indices (in TGL2 block) |
| Null terminated parameter name |
Every tag parameter is padded so that its size is a multiple of 4.
TGL2 Block
This block defines enum member names for tag parameters.
| Offset | Size | Description |
|---|---|---|
| 0x0 | 2 | Number of enum member names |
| 0x2 | 2 | Padding |
| 0x4 | 4 per list item | Offsets to enum member names, relative to start of block |
| Null-terminated enum member names |
SYL3 Block
| Offset | Size | Description |
|---|---|---|
| 0x0 | 4 | Number of styles |
| 0x4 | 16 per style | Styles |
Style
| Offset | Size | Description |
|---|---|---|
| 0x0 | 4 | Region width |
| 0x4 | 4 | Line num |
| 0x8 | 4 | Font index |
| 0xC | 4 | Base color index |
SLB1 Block
This block contains labels for the SYL3 block.
CTI1 Block
This block contains the names of the source files that the MSBT and MSBF files were generated from. The source files often have the .mstxt or .msflw extension.
| Offset | Size | Description |
|---|---|---|
| 0x0 | 4 | Number of filenames |
| 0x4 | 4 per filename | Offsets to filename strings |
| Null-terminated filename strings |
Value Types
The following type ids are used by attributes and tag parameters.
| ID | Description |
|---|---|
| 0 | Int8 |
| 1 | Uint8 |
| 2 | Int16 |
| 3 | Uint16 |
| 4 | Int32 |
| 5 | Uint32 |
| 6 | Float |
| 7 | Double |
| 8 | String |
| 9 | Enum |