New Horizons:MSBT functions
From Animal Crossing Mods Wiki
The following table contains all used MSBT functions in Animal Crossing: New Horizons. The purpose of some functions is still unknown and therefore the functions lack a proper name.
String arguments always contain their length as the first byte of the argument data.
| Type | Sub-Type | Name | Description | Arguments | |||
|---|---|---|---|---|---|---|---|
| Name | Data-Type | Size | Description | ||||
| 0 | 0 | ruby
|
Renders an annotation text over a specified number of characters. Typically used in the Japanese localization. | charSpan
|
Unsigned Integer | 2 | The number of characters over which the annotation is centered |
value
|
String | n | The value of the annotation | ||||
| 0 | 1 | - | Unknown | ||||
| 0 | 2 | size
|
Changes the text/font size of the text. | value
|
Unsigned Integer | 2 | The new font size to use from this point until the next font change or end of message |
| 0 | 3 | color
|
Changes the color of the text. | id
|
Unsigned Integer | 2 | The id of the color to use from this point until the next color change or end of message |
| 0 | 4 | pageBreak
|
Breaks the current text and causes the dialog to pause/wait for user input before clearing the display and rendering the next parts. | - | |||
| 10 | 0 | delay
|
Delays text rendering for a set number of frames. | frames
|
Unsigned Integer | 2 | The number of frames to delay for |
| 10 | 1 | delay8
|
Delays text rendering for 8 frames. | - | |||
| 10 | 2 | delay20
|
Delays text rendering for 20 frames. | - | |||
| 10 | 3 | delay40
|
Delays text rendering for 40 frames. | - | |||
| 10 | 4 | - | Unknown | ||||
| 10 | 5 | - | Unknown | ||||
| 10 | 6 | - | Unknown | ||||
| 10 | 7 | - | Unknown | ||||
| 10 | 8 | - | Unknown | ||||
| 10 | 9 | - | Unknown | ||||
| 10 | 10 | - | Unknown | ||||
| 10 | 11 | - | Unknown | ||||
| 10 | 12 | - | Unknown | ||||
| 10 | 13 | - | Unknown | ||||
| 10 | 14 | - | Unknown | ||||
| 10 | 15 | setNpcTalkChoices
|
Sets chat/talk choices for NPCs. | chatOption
|
Byte | 1 | Unknown |
cancelOption
|
Byte | 1 | Unknown | ||||
| 10 | 16 | - | Unknown | ||||
| 15 | 0 | endTag
|
Indicates the end of a message string. | - | |||
| 20 | 0 | - | Unknown | ||||
| 20 | 1 | - | Unknown | ||||
| 20 | 2 | - | Unknown | ||||
| 20 | 3 | - | Unknown | ||||
| 40 | x | anim
|
Triggers a NPC animation. x is the ID of the animation table.
|
id
|
Byte | 1 | ID of the animation table (not part of the argument byte data) |
target
|
Byte | 1 | NPC target number | ||||
| 45 | x | snpcAnim
|
Triggers a NPC animation for special NPCs. x is the ID of the animation table.
|
id
|
Byte | 1 | ID of the animation table (not part of the argument byte data) |
target
|
Byte | 1 | NPC target number | ||||
targetSpec
|
String | n | Unknown | ||||
| 50 | 0 | wordInfo
|
Contains information about the next word (usually item names). The indices for the articles refer to MSBT messages found in the STR_Article file.
|
gender
|
Byte | 1 | The index of the gender for the word. |
indefArticle
|
Byte | 1 | The index of the indefinite article for the word. | ||||
defArticle
|
Byte | 1 | The index of the definite article for the word. | ||||
| 50 | 1 | - | Unknown | ||||
| 50 | 2 | wordArticle
|
Inserts the proper article for a subsequent word (usually item names). The data for this is usually encoded into the source MSBT of the word. | - | |||
| 50 | 3 | capitalizeNextLetter
|
Capitalizes the first letter of the next word (unconfirmed). | - | |||
| 50 | 4 | capitalizeNextWord
|
Capitalizes the next word. | - | |||
| 50 | 5 | gender1
|
Contains gender information about the next word. | m
|
String | n | Masculine |
f
|
String | n | Feminine | ||||
| 50 | 6 | gender2
|
Contains gender information about the next word. | m
|
String | n | Masculine |
f
|
String | n | Feminine | ||||
| 50 | 7 | gender3
|
Contains gender information about the next word. | m
|
String | n | Masculine |
f
|
String | n | Feminine | ||||
| 50 | 8 | - | Unknown | ||||
| 50 | 9 | - | Unknown | ||||
| 50 | 10 | gender4
|
Contains gender information about the next word. | m
|
String | n | Masculine |
f
|
String | n | Feminine | ||||
| 50 | 11 | - | Unknown | ||||
| 50 | 13 | - | Unknown | ||||
| 50 | 14 | gender5
|
Contains gender information about the next word (only in KRko).
|
m
|
String | n | Masculine |
f
|
String | n | Feminine | ||||
| 50 | 15 | - | Unknown | ||||
| 50 | 16 | - | Unknown | ||||
| 50 | 17 | gender8
|
Contains gender information about the next word. | m
|
String | n | Masculine |
f
|
String | n | Feminine | ||||
n
|
String | n | Neuter | ||||
| 50 | 18 | - | Unknown | ||||
| 50 | 19 | - | Unknown | ||||
| 50 | 20 | gender6
|
Contains gender information about the next word. | m
|
String | n | Masculine |
f
|
String | n | Feminine | ||||
| 50 | 21 | - | Unknown | ||||
| 50 | 22 | wordCase
|
Contains information about the grammatical case of the word (only in EUde, EUnl and EUru).
|
nom
|
String | n | Nominative |
acc
|
String | n | Accusative | ||||
dat
|
String | n | Dative | ||||
gen
|
String | n | Genitive | ||||
| 50 | 23 | - | Unknown | ||||
| 50 | 24 | gender7
|
Contains gender information about the next word (only in EUru).
|
m
|
String | n | Masculine |
f
|
String | n | Feminine | ||||
n
|
String | n | Neuter | ||||
pl
|
String | n | Plural | ||||
| 50 | 25 | weatherArea
|
Contains information about the current weather for both hemispheres. | north
|
String | n | Northern hemisphere weather |
south
|
String | n | Southern hemisphere weather | ||||
| 50 | 26 | - | Unknown | ||||
| 50 | 27 | - | Unknown | ||||
| 50 | 28 | - | Unknown | ||||
| 50 | 29 | - | Unknown | ||||
NPC Animation Table
| ID | Name | Description |
|---|---|---|
| 0 | EmotEnd
|
|
| 1 | EmotEnd
|
|
| 2 | Smiling
|
|
| 3 | HappyFlower
|
|
| 4 | Love
|
|
| 5 | WrySmile
|
|
| 6 | FaintSmile
|
|
| 7 | BigSmile
|
|
| 8 | Angry
|
|
| 9 | Outraged
|
|
| 10 | Fuming
|
|
| 11 | Worried
|
|
| 12 | Sighing
|
|
| 13 | Thinking
|
|
| 14 | SadSpiral
|
|
| 15 | Frantic
|
|
| 16 | Crying
|
|
| 17 | BrokenHeart
|
|
| 18 | OhGeez
|
|
| 19 | Confused
|
|
| 20 | Laughing
|
|
| 21 | HappyDance
|
|
| 22 | Clapping
|
|
| 23 | Dance
|
|
| 24 | EmotEnd
|
|
| 25 | Shaki
|
|
| 26 | Shocked
|
|
| 27 | Aha
|
|
| 28 | TakenAback
|
|
| 29 | Surprised
|
|
| 30 | IdeaBulb
|
|
| 31 | Oops
|
|
| 32 | Cheering
|
|
| 33 | Greeting
|
|
| 34 | Greeting
|
|
| 35 | Apologize
|
|
| 36 | Hello
|
|
| 37 | Nodding
|
|
| 38 | QuestionMark
|
|
| 39 | Negative
|
|
| 40 | Assent
|
|
| 41 | Explain
|
|
| 42 | ColdChill
|
|
| 43 | Shaking
|
|
| 44 | Sneezing
|
|
| 45 | Hot
|
|
| 46 | Sleepy
|
|
| 47 | Sleep
|
|
| 48 | EmotEnd
|
|
| 49 | AbsentMindedness
|
|
| 50 | Blushing
|
|
| 51 | Scheming
|
|
| 52 | Hesitate
|
|
| 53 | SmugFace
|
|
| 54 | Grin
|
|
| 55 | ShyBoy
|
|
| 56 | Restless
|
|
| 57 | Serious
|
|
| 58 | Silent
|
|
| 59 | Pardon
|
|
| 60 | NpcShuffle
|
|
| 61 | NpcHoldout
|
Special NPC Animation Table
| ID | Name | Description |
|---|---|---|
| 0 | GulCollapsed
|
Collapsed animation for Gulliver and Gullivarrr
|
| 1 | GstSurprised
|
Surprised animation for Wisp
|
| 2 | DodWireless
|
Wireless animation for Orville and Wilbur
|
| 3 | DodRoger
|
Roger animation for Orville and Wilbur
|
| 4 | TkkEh
|
Eh animation for K.K.
|
| 5 | TkkNodding
|
Nodding animation for K.K.
|
| 6 | TkkQuestionMark
|
QuestionMark animation for K.K.
|