player_mask

Significance

player_mask is the game code's identifier for the mask Link is currently wearing on his face.

Syntax

• zs $filepath -m -- Prints the current value from the file data.
• zs $filepath -m (uint8_t) -- Interprets the extra string parameter as a whole number (any base) and stores the resulting integer to the relevant bits, if said integer falls within the range of values representable by a zero-extended byte in MIPS (0x00 <= x <= 0xFF).

Tested Inputs

ID	Mask Name
0	(no mask)
1	Mask of Truth
2	Kafei's Mask
3	All-Night Mask
4	Bunny Hood
5	Keaton Mask
6	Garo's Mask
7	Romani Mask
8	Circus Leader's Mask
9	Postman's Hat
10	Couple's Mask
11	Great Fairy's Mask
12	Gibdo Mask
13	Don Gero's Mask
14	Kamaro's Mask
15	Captain's Hat
16	Stone Mask
17	Bremen Mask
18	Blast Mask
19	Mask of Scents
20	Giant's Mask
21	Fierce Deity's Mask
22	Goron Mask
23	Zora Mask
24	Deku Mask

Notes

Changes to this value only seem to hold out if the designated mask is already mapped to one of the three C buttons. (After all, it's not possible to put on or take off a mask without using a C button, and it's not possible to vacate or replace the mapping of a C button to which the currently worn mask is already assigned.) Choosing one of the values in the table above without also making sure that the saved data remembers that same mask value being set to one of the three C buttons will cause the game to load with the mask briefly equipped right before it is automatically removed from Link's face.

Most of the possible values not listed in the table above have not been tested, but so far anything that isn't in the table just seems to hang up the game (assertions in z_player_lib.c). Because stable results are only observable if the requested mask assignment was already available through one of the C buttons, properly testing values beyond 0x18 is difficult.

Note that using this feature to equip one of the five transformation masks (Deku, Goron, Zora, Giant or Fierce Deity) does not actually engage the transformation or cause the game to start up with Link transformed to that form. Rather, Link is seen simply wearing the mask plain on his face as though it were a regular mask.

Relevant Bits

file[0x0004]7..0

Derived Cheat Codes

GameShark	ROM Version
	JAP (1.0)
	JAP (1.1)
	JAP (GC)
	USA (preview)
803FFF03 00??	USA
	USA (GC)
	EUR (1.0)
	EUR (1.1)
	EUR (GC)
	EUR (debug)