DS game only
Opcodes appear inside INLINE_CMD tokens as the second u16:
0x0024 (opcode | 0x8000) [0x0027 (arg | 0x8000)]* 0x003B [data... 0x0000].
The op column is the opcode value (word & 0x7FFF);
the wire column is the literal u16 you find in the file.
330,769 CMDs counted across 50,196 non-empty entries in 1,328 message files.
Verification levels
verifiedβ parser handler decompiled; opcode's effect online.flags/ sub-handler dispatch confirmed.dispatch tracedβ opcode known to route toFUN_02057754(the registry-99 substitution table); specific output verified by in-game test.corpus onlyβ semantics from user gameplay testing or inferred from surrounding text; not yet confirmed by static analysis.
Categories
| Code | Name | Meaning |
|---|---|---|
F | Formatting | Color, font, inline style |
S | Substitution | Inserts runtime data (player name, NPC name, item, etc.) |
D | Dialog | Textbox layout, speaker portrait, expression β header-like config |
M | Menu | Choice list structure |
C | Flow | Branching, conditional, line-flag mode select |
X | Script | Engine script call / marker |
P | Display | Renderer-side display control (close box, wait, separator) |
U | Unknown | Function not yet identified |
Width budgets (text substitution)
For length-fitting EN translations, the substitution opcodes carry a character-width budget when the engine inlines their output:
| Tag form | Opcode | Width (chars) | Source |
|---|---|---|---|
[PLAYER_NAME] | 0x01F4 | 10 | Save slot, user input |
[SCHOOL_NAME] | 0x01F8 | 10 | Save data |
[NAME:<id>] | 0x01F7 | β€12 (longest canon NPC) | NpcDataOfs[id] |
[ITEM:<id>] | 0x01FB | β€24 | itemname.ofs[id] |
[PARTICLE:<slot>] | 0x01FF | β€6 | NpcDataOfs +0x5C+(slot*0x10) |
[NPC_DAT:0] | 0x0202 | β€6 (pronoun) | NpcDataOfs +0x20 |
[NPC_DAT:1] | 0x0202 | standalone phrase | NpcDataOfs +0x2C |
[CHOICES:99] | 0x0205 | 20 | Runtime context (object/item) |
[GUEST:<n>] | 0x01F5 | 10 | Guest slot (0..3) |
Full opcode table
Sorted by hex value:
op wire name cat args count verify notes 0x00000x8000COLORFormatting 1 24,540 corpus only Text color. Args: 1=red, 2=orange, 3=green, 4=blue, 5=yellow, 6=gray, 8=pink, 0=default 0x00010x8001CODE_8001Formatting 1 4 corpus only Rare formatting code. 0x00040x8004CODE_8004Formatting 1 30 corpus only Formatting variant. 0x00080x8008CODE_8008Unknown 1 5 corpus only 3 param variants. 0x00090x8009CONDFlow 1-2 305 corpus only Conditional check. 30 unique conditions. 0x000c0x800cOP_800CFlow 1 82 verified Form-feed equivalent (terminates message entry). 0x00100x8010CTXFlow 2 7 verified Parser sets line.flags=3 (arg-mode 3). 0x00110x8011REFFlow 2 2,758 verified Parser sets line.flags=2. 0x00120x8012LINKFlow 1 4,320 verified Parser sets line.flags=1. Most common arg: 0x01=2675, 0x02=1221. 0x00130x8013MENUMenu 1 5,870 verified Parser clears line.flags low-nibble (arg-mode 0). Menu option terminator/ID. 0x00150x8015CODE_8015Flow 1 86 corpus only Mostly arg 0x218 (Γ82). 0x00160x8016EXPRDialog 2 47,314 corpus only Facial expression. 432 unique IDs. First param always 0x9B72. 0x00170x8017TEXTBOXDialog 3-4 59,020 corpus only Textbox layout. 154 configs. 0x00180x8018SPEAKERDialog 2 59,407 corpus only Speaker portrait ID. 129 combos. 0x001a0x801aCODE_801AUnknown 4 4 corpus only Very rare 4-arg code. 0x001b0x801bCODE_801BUnknown 4 4 corpus only Very rare 4-arg code. 0x001c0x801cCODE_801CUnknown 2 2 corpus only Very rare. 0x00200x8020CODE_8020Flow 0 383 corpus only Flow marker, no params. 0x00210x8021CODE_8021Flow 0 382 corpus only Flow marker, no params. 0x00220x8022CODE_8022Menu 1 146 corpus only Menu response handler. 0x00280x8028CODE_8028Unknown 3 38 corpus only 3-param code, unknown semantics. 0x00290x8029CODE_8029Unknown 3 5 corpus only 3-param code, unknown semantics. 0x002b0x802bCODE_802BUnknown 2 75 corpus only Mostly (0,0) Γ72. 0x002d0x802dCODE_802DUnknown 3 84 corpus only Unknown 3-param. 0x002e0x802eCODE_802EUnknown 1 36 corpus only Unknown. 0x002f0x802fCODE_802FUnknown 0 1 corpus only Single occurrence in corpus. 0x00300x8030CODE_8030Unknown 2 18 corpus only 17 unique combos. 0x00310x8031CODE_8031Unknown 1 6 corpus only 6 variants. 0x00370x8037HEADERDialog 1-2 2,526 verified HEADER opcode β only valid as first CMD in entry. Always opens with 0x0024 0x8037; closes with 0x003B 0x0000. 0x003a0x803aCODE_803AScript 1 62 corpus only 19 param variants. 0x00490x8049SCRIPT_8049Script 2-3 2,718 corpus only Script call. 485 unique param combos. 0x004a0x804aCODE_804AScript 0 100 corpus only Script marker, no params. 0x004b0x804bSCRIPT_804BScript 3 17 corpus only Script call variant. 0x004c0x804cSCRIPT_804CScript 3 743 verified Parser sub-handler FUN_0206726C: reads 2 typed args, sets line.flags bit 4, stores at line.args[0xA..0xF]. 0x004d0x804dSCRIPT_804DScript 4 15 corpus only Script call variant. 0x004f0x804fOP_804FScript 0 8,070 corpus only Script/logic marker, no params. Splits dialog into logical phrases. 0x00530x8053OP_8053Unknown 0 2 corpus only Not in user CSV. 0x00540x8054CODE_8054Script 0 2 corpus only Rare script marker. 0x00550x8055CODE_8055Script 0 72 corpus only Script marker, no params. 0x005f0x805fCODE_805FScript 0 672 corpus only Script marker, no params. 0x00600x8060CODE_8060Script 1 12 corpus only Always arg 0x8000. 0x00610x8061CODE_8061Script 1 144 corpus only Args 0x8008 (Γ84), 0x800B (Γ60). 0x00640x8064CODE_8064Script 0-1 216 corpus only No-param (Γ188), arg 0x8001 (Γ28). 0x01f40x81f4PLAYER_NAMESubstitution 0 10,778 dispatch traced Routed to FUN_02057754 with key 0x1F4 (registry-99 lookup). Substituted with player name. Width budget: 10 chars. 0x01f50x81f5GUESTSubstitution 1 8 dispatch traced Routed to FUN_02057754 key 0x1F5. 4 guest slots (args 0..3). 0x01f70x81f7NAMESubstitution 1 657 dispatch traced NPC name by ID. FUN_02057754 key 0x1F7. Source: data/npc/NpcDataOfs.ofs[arg]. 0x01f80x81f8SCHOOL_NAMESubstitution 0 6 dispatch traced FUN_02057754 key 0x1F8. School name from save data. 0x01fb0x81fbITEMSubstitution 1 610 corpus only Item name by ID. Source: data/item/itemname.ofs[arg]. 0x01ff0x81ffPARTICLESubstitution 1 60,685 corpus only NPC sentence-ender particle. 6 slot variants (args 0..5). Source: NpcDataOfs +0x5C+(arg*0x10). MOST COMMON OPCODE. 0x02020x8202NPC_DATSubstitution 1 21,815 verified arg 0 = PRONOUN (NpcDataOfs +0x20, substituted inline). arg 1 = CATCHPHRASE (NpcDataOfs +0x2C, standalone phrase). 0x02030x8203ENDDisplay 0 536 corpus only End dialog sequence. 0x02040x8204DISP_8204Display 0 168 corpus only Display control. 0x02050x8205CHOICESSubstitution 1 497 corpus only Dynamic object/item reference in dialog. Width budget: 20 chars. 0x02060x8206CHOICESubstitution 1 742 corpus only Dynamic object reference. Always arg 0x8083. 0x02080x8208DISP_8208Display 1 9 corpus only 5 param variants. 0x02120x8212OP_0212Unknown 1 4,317 corpus only Function not yet identified (uncatalogued). 0x02130x8213CLOSEDisplay 0 1,454 corpus only Close textbox. 0x02140x8214WAIT_ANIMDisplay 0 1,260 corpus only Wait for animation. 0x02150x8215SEPDisplay 0 1,192 corpus only Section separator. 0x02170x8217DISP_8217Display 1 601 corpus only Args 0x8000 (Γ384), 0x8001 (Γ217). 0x02180x8218DISP_8218Display 0 2 corpus only Rare display. 0x021a0x821aDISP_821ADisplay 0 374 corpus only Display control. 0x021c0x821cDISP_821CDisplay 1 59 corpus only Always arg 0x8004. 0x021d0x821dDISP_821DDisplay 1 59 corpus only Always arg 0x8004. 0x02210x8221PLAYER_NAME2Substitution 1 86 corpus only Player name variant. Args 0x8000 (Γ54), 0x8001 (Γ32). 0x02270x8227DISP_8227Display 1 52 corpus only 3 param variants. 0x02280x8228DISP_8228Display 1 53 corpus only 4 param variants. 0x02290x8229TREND_PRODUCTSubstitution 1 584 corpus only Trigger/event. Mostly arg 0x8004 (Γ507). Also references UCC food slots (multi-name). 0x022a0x822aDISP_822ADisplay 1 228 corpus only 3 params. 0x022b0x822bDISP_822BDisplay 2 745 corpus only Complex display/animation. 19 combos. 0x02300x8230RESETDisplay 0 1,155 corpus only Reset display state. 0x02310x8231DISP_8231Display 0 827 corpus only Display control. 0x023a0x823aDISP_823ADisplay 1 148 corpus only 13 param variants. 0x023b0x823bDISP_823BDisplay 1 274 corpus only Args 0x8002 (Γ156), 0x8003 (Γ118). 0x023c0x823cDISP_823CDisplay 2 17 corpus only 2 combos. 0x023d0x823dDISP_823DDisplay 1 136 corpus only Mostly arg 0x8083. 0x023e0x823eDISP_823EDisplay 0 6 corpus only Rare display. 0x023f0x823fDISP_823FDisplay 0 2 corpus only Rare. 0x02400x8240DISP_8240Display 0 2 corpus only Rare. 0x02410x8241DISP_8241Display 0 35 corpus only Display. 0x02440x8244DISP_8244Display 2 20 corpus only 15 combos. 0x02450x8245DISP_8245Display 0 31 corpus only Display. 0x02460x8246DISP_8246Display 0 30 corpus only Display. 0x02470x8247SYS_MENUDisplay 0 3 corpus only System menu trigger. 0x02480x8248DISP_8248Display 0 9 corpus only Display. 0x02490x8249DISP_8249Display 1 45 corpus only Args 0x8001 (Γ37), 0x8083 (Γ8). 0x024a0x824aDISP_824ADisplay 1 45 corpus only Args 0x8001 (Γ38), 0x8083 (Γ7). 0x024b0x824bDISP_824BDisplay 1 5 corpus only 3 params. 0x024e0x824eDISP_824EDisplay 2 99 corpus only 22 combos.
Parser-visible opcodes
These six opcodes affect the parser FUN_02066c58 directly
(line-flag mutation or sub-handler dispatch). Everything else is forwarded
to the renderer.
Opcode Parser effect 0x37HEADER. Only valid as first CMD; reads 1β2 typed args between 0x27 separators. 0x10line.flags = (flags & 0xF0) | 3 (arg-mode 3 β name field)0x11line.flags = (flags & 0xF0) | 20x12line.flags = (flags & 0xF0) | 10x13line.flags &= 0xF0 (clear low nibble β no-arg mode)0x4CSub-handler FUN_0206726C: reads 2 typed args, stores at line.args[0xA..0xF], OR-sets bit 4 of line.flags.
Sources
notes/opcode_master_reference.md β full corpus censussrc/translator/opcode_registry.py β tag β opcode mapping used by the encoderarm9_full_plaintext.bin @ 0x02066c58 β parserarm9_full_plaintext.bin @ 0x02057754 β substitution dispatch (keys 0x1F4β0x1F8)