3D:Text Format

From CloudModding OoT Wiki
Jump to: navigation, search

Dialogue in OoT 3D contains control codes, which may for instance center text, change colour or embed icons in the text. This article documents the behaviour of various control codes.

This formatting is used in dialogue lines inside the QM format.

Control codes

All text control codes begin with 0x7F. The table below details the various codes and when necessary what arguments they take.

Format Description
00 Message end
01 Wait for input
02 xx Horizontal spacing (kerning)
03 xxxx Go To Message ID (xxxx)
04 Instant Text On
05 Instant Text Off
06 Shop Message Box
07 Event Trigger
08 xx Delay x frames
0A xx Close after x frames
0B Player's name
0C Begin Ocarina Playing
0E xxxx Play sound clip (xxxx)
0E 00 01 00 05 xx Play sound clip?
0F xx Item obtained? (see below)
10 xx Set text speed (00-03, higher is slower)
11 xx xx xx Message Background
12 (Current Marathon time)
13 (Current Race time)
14 (Current archery score)
15 (#Gold Skulltulas destroyed)
16 (Current fish weight)
17 (Current Hyrulian time)
18 xx Read variable xx (see below)
19 Unskippable text
1A FFFF FFFF Dialog choice (2-way)
1B FFFF FFFF FFFF Dialog choice (3-way)
1C Newline
1D xx Text colour (see below)
1E Center text
23 xx  ???
24 xx Button Icons (see below)
25 xx xx xx Credit titles
26 xx If flag set (see below)
27 Else
28 End
29 If not in MQ mode
2A Else
2B End

Special arguments

Item IDs (04)

Item IDs match the Item List from the original game perfectly, with the addition that 0x7B is used for Biggoron's Sword.

Text colours (1D)

Value Description
00 White
41 Red
42 Green
43 Blue?
44 Light blue
45 Pink
46 Yellow?
47 Black?

Variable IDs (18)

Value Description
00 Best horseback archery score
01 Poe collection points
02 Largest fish caught
03 Best horse race time
04 Best marathon time
06 Best Dampé race time

Icon IDs (24)

Value Icon
00
01
02
(unused)
03
(unused)
04
05
(unused)
06
07
08
09
0A
0B
0F
10
(unused)
11
12
(unused)
14
16
17
18
19
1A
1B
1C
1D
1E
1F
21 [Green arrow]
22

Flag IDs (26)

The flag is set if singular, unset if plural (for the purposes of the conditionals above).

Value Description
00 Singular/plural flag for current archery score (see 14)
02 Singular/plural flag for current fish weight (see 16)
xx Singular/plural flag for value stored in variable xx - 3

Special Characters

All special character codes begin with 0x7FC2 and 0x7FC3. Currently the only known 0x7FC2 is 0x7FC2A1 which is ¡ (Inverted Exclamation Point).

This is an incomplete list of 0x7FC3.

Format Description
80 À
81 Á
82 Â
84 Ä
87 Ç
88 È
89 É
8A Ê
8D Í
91 Ñ
92 Ò
93 Ó
94 Ô
96 Ö
9A Ú
9C Ü
9F ß
A0 à
A1 á
A2 â
A4 ä
A7 ç
A8 è
A9 é
AA ê
AB ë
AC ì
AD í
AE î
AF ï
B1 ñ
B2 ò
B3 ó
B4 ô
B6 ö
B9 ù
BA ú
BB û
BC ü

See also