A C# reader and writer for MSBT, the message files (MsgStdBn) Nintendo titles keep their dialogue and
UI text in, with an editable text form and the Tears of the Kingdom tag definitions. Also reads and writes
MSBF flow files (MsgFlwBn) and MSBP project files (MsgPrjBn).
MsbtFile file = MsbtFile.FromBinary(bytes);
string text = file.ToEditorText(); // one "Label: text" line per message
file.ApplyEditorText(edited); // replaces those messages
byte[] rebuilt = file.ToBinary(); // an unedited file writes back the same bytesTalk_001: {{setEmotion emotion="Pleasure" noVoice="false"}}{{setVoice asset="Humming"}}Hello!\nHow are you?
Buff_Name: Attack Up +{{number14 ref="SimpleIntForMessage2" index="-1" isDirect="true"}}
Odd_One: {cmd:0xe:77:5:0x010203}raw bytes for a tag nobody has named
- One line per labelled message, sorted by label. Blank lines and lines starting with
#are ignored. - In the text,
\n,\r,\t,\\and\{are escapes. A value is wrapped in quotes only when it is empty, has leading or trailing whitespace, or starts with a quote; inside quotes\\and\"are the escapes. {{name arg="value" ...}}is a tag with a definition. Arguments with a value map show the name of the value. Bytes the definition doesn't account for show asextra="HEX".{cmd:0xe:group:type:0xHEX}is a tag as raw bytes, and{cmd:0xf:group:type:}the end of one. A tag is only shown by name when decoding and re-encoding it gives back exactly its bytes, so the text of an unedited file always rebuilds the original.ApplyEditorTextchanges only the messages named in the text. A label the file doesn't have is an error unlessaddNewLabelsis set. Errors areFormatExceptions that give the line.
A tag's parameter block is laid out as the definition lists its arguments: u8 and bool take one byte, u16 and
s16 two, and a str is a 16-bit byte length followed by UTF-16 characters. The block is padded to an even length
with 0xCD. The definitions are MsbtTags.TotK, from the game config file (TotK.gcf) that ships with TKVSC; any
other file with an msbt.tags list loads with MsbtTags.FromGcfFile.
MsbfFile flow = MsbfFile.FromBinary(bytes);
MsbfNode start = flow.EntryPoint("003_062")!; // FEN1 label -> FLW3 node
MsbfNode next = flow.Nodes[start.Next];
byte[] rebuilt = flow.ToBinary();
MsbpFile project = MsbpFile.FromBinary(bytes);
MsbpColor red = project.Colors[0]; // CLR1, named through CLB1 when presentA flow node is its type (message, branch, event, entry), a subtype and six 16-bit fields; Next is the third.
Branch nodes take Param4 targets from the branch table starting at Param5 (BranchTargets). In Skyward
Sword, message nodes hold the file in Param3 and the message index in Param4, and event nodes hold the event
in Param3. MSBP sections other than CLR1 and CLB1 are kept as raw bytes.
- Files with attributes (ATR1), styles (TSY1) or number lines (NLI1) are read and written, but none of the game's files use them, so that path is only tested on synthetic data.
- Named tags need UTF-16 files. A tag with a string argument in a UTF-8 or UTF-32 file stays raw.
- The label table's slot count is kept from the file read. A new file gets 101.
- Only TotK's tags are defined. BotW's message files read and write, but their tags show as raw bytes.
dotnet build MsbtSharp.sln -c ReleaseAGPL-3.0-or-later. See license.md.