TLoZ: ALTTP Hacking Resources - User contributions [en]

Dumps

2017-12-25T02:27:30Z

Tatters:

{|border="1" align="right" cellpadding="4" cellspacing="0" style="margin: 0 0 1em 1em; background: #f7f8ff; border: 1px #8888cc solid; border-collapse: collapse; font-size: 95%"
|- style=background:#ccccff
!Symbol
!Meaning
!Symbol
!Meaning
|-
|(U)
|US Rom
|(E)
|Europe
|-
|(J)
|Japan
|(G)
|German
|-
|(JU)
|USA/Japan
|(JUE)
|USA/Europe/Japan
|-
|(!)
|Good Rom
|[a]
|Alternative version
|-
|[b*]
|Bad Dump
|[f*]
|Fixed to run better on
copiers or emulators
|-
|[h*]
|Hack
|[o*]
|OverDump
|-
|[m*]
|Multilanguage
|C
|Conversion
|}

== A Link to the Past ==

The ROMs do not have a 200 byte header.

=== Europe ===
{|{{prettytable}}
!Rom file name
!Sha224sum of Unmodified ROM
|-
|Legend of Zelda, The - A Link to the Past (F).smc
|{{hex|ce01d282524568b695d8dfaf6b50fbd2c1f4809b6e8efab80a9d4f49}}
|-
|Legend of Zelda, The - A Link to the Past (E) [!].smc
|{{hex|06c064a08e0fe40fc343d33ca698fb2c087a66e57cb3e081fe92b59a}}
|-
|Legend of Zelda, The - A Link to the Past (FC).smc
|{{hex|a3fe17922edb8c55ccaa12accd0ca1b9b8a975d5782c9cd27c8ef178}}
|-
|Legend of Zelda, The - A Link to the Past (G) [!].smc
|{{hex|fd042211f3fa11b184e7bc48dd60d3aa327f2710d51aaabf5f779fcb}}
|-
|Legend of Zelda, The - A Link to the Past (G) [a1].smc
|{{hex|f1039737394d90e01230477d10b752fb677bf0e9d002dabf6cc8cb3b}}
|}

=== America ===
{|{{prettytable}}
!Rom file name
!Sha224sum of Unmodified ROM
|-
|Legend of Zelda, The - A Link to the Past (U) [!].smc
|{{hex|5060008d659987af5df4f2d86597f2d6de856cf3d7f73bde44c771c1}}
|-
|Legend of Zelda, The - A Link to the Past (U) [h1C].smc
|{{hex|cbda4838b3694fcaa371cec82fe2c88f4b743463e245d1a0097c2a71}}
|-
|Legend of Zelda, The - A Link to the Past (U) [h2C].smc
|{{hex|e353c3dde0f6c091438198bfaed23ef1e87c463180609ab2c4840c79}}
|}
=== Japan ===

{|{{prettytable}}
!Rom file name
!Sha224sum of Unmodified ROM
|-
|Zelda no Densetsu - Kamigami no Triforce (J) (V1.0).smc
|{{hex|f891217bb7b2a861e19b2861b7d52eaaa80b4485889dbed2821a60d4}}
|-
|Zelda no Densetsu - Kamigami no Triforce (J) (V1.0) [h1C].smc
|{{hex|56bbe399dda8a177fa7fa174736705c432c05e16045282ded2b44d4a}}
|-
|Zelda no Densetsu - Kamigami no Triforce (J) (V1.1).smc
|{{hex|0be0c173062f02d8dae18be980eadf4a2f8ffbf5d740732ed8710d18}}
|-
|Zelda no Densetsu - Kamigami no Triforce (J) (V1.2).smc
|{{hex|c4f5c90a13db9d4c26ee830fbb93236c1cc2ca22ad737fa5c02a115e}}
|}
{{toc}}

Credits

2017-12-25T02:24:56Z

Tatters:

==Wishes==
* {{address|0x|742E1|74303|34}} = Pointers for wishes. Comes in pairs of two in little endian. 16 screens and 17 pointers. The spare pointer serves to mark the end.

{{red|00 00 }}{{blue|3C 00 }}{{green|68 00 }}{{hex|AA 00 }}{{hex|E8 00 28 01 5B 01 98 01}}
{{hex|CF 01 07 02 42 02 7D 02 B0 02 EA 02 22 03 52 03}}
{{hex|95 03}}

* {{red|00 00}} = First screen (Return of the King)
* {{blue|3C 00}} = Second screen (Sanctuary)
* {{green|68 00}} = Third screen (Village)

Basically the data for the pointers to the screens are:
* {{0x|73F4C}} + {{hex|00}} → {{0x|73F4C}} + {{hex|3C}} - {{hex|1}}
* {{0x|73F4C}} + {{hex|3C}} → {{0x|73F4C}} + {{hex|68}} - {{hex|1}}
* And so forth.

==Credits==
To parse the ending credits data (scrolling credits), I'll take this one as an example:

* {{0x|7317A}} = {{hex|EXECUTIVE PRODUCER}}

{{0x|73170}} - {{hex|XX XX XX XX XX XX XX XX }}{{red|07 }}{{blue|23 }}{{green|3C 4F 3C 3A 4C 4B}}
{{0x|73180}} - {{green|40 4D 3C 9F 47 49 46 3B 4C 3A 3C 49 FF }}{{hex|XX XX XX}}

* {{red|07}} = start from the 7th tile from the left of the screen (Note scrolling credits have no vertical position, and return of the king section have them hardcoded)
* {{blue|23}} = ({{$|23 + }}{{$|1}}) / {{$|2}} = {{$|12}} bytes to read
* Then read {{$|12}} bytes - {{hex|3C 4F 3C 3A 4C 4B 40 4D 3C 9F 47 49 46 3B 4C 3A 3C 49}}

For each 12 bytes look up the table definition and draw the character on screen at the position.

Now to pointers to the data.

Pointers start at {{0x|7393D}}

Data around there is as follows:
{{hex|94 91 9B 97 8D 8B 9F 9B 83 8F 83 86 83 }}{{red|00 00 }}{{hex|14}}
{{hex|00 14 00 14 00 15 00 27 00 14 00 14 00 14 00 14}}
{{hex|00 14 00 14 00 14 00 14 00 39 00 14 00 14 00 14}}

That {{red|00 00}}, is a relative position to {{0x|73178}}, funnily enough, the next value is {{hex|14 00}}, which points straight to the {{$|FF}}! {{$|FF}} is a special placeholder to show a blank line (as the game's engine does)

In other words from the above

{{hex|00 00}} = EXECUTIVE PRODUCER
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|15 00}} = NAME FIRST LINE
{{hex|27 00}} = NAME SECOND LINE
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|39 00}} = NEXT LABEL (forgot what it is)
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|...}}

This continues until the last pointer at {{0x|73C4F}}, so the data ends at {{0x|73C50}} ({{0x|73C51}} has assembly!) -- you'll notice that the lines with the death counts have the place names written this way but not the actual number. That bit is hardcoded.

So the next thing is what about the RETURN OF THE KING data? (puns) There's 4 byte control code rather than two in the credits area.

For the line THE RETURN OF THE KING, the data actually starts 4 bytes before {{0x|73F50}} at {{0x|73F4C}}
@{{0x|73F40}}
{{hex|30 A9 FF 9D 02 10 A9 01 85 14 AB 60 62 65 00 2B}}
{{hex|2D 21 1E 9F 2B 1E 2D 2E 2B 27 9F 28 1F 9F 2D 21}}
{{hex|1E 9F 24 22 27 20 62 E9 00 19 64 75 6E 71 68 61}}

{{hex|62 65 00 2B}}
{{hex|62 E9 00 19}}
{{hex|63 09 00 19}}
{{hex|62 EB 00 11}}
{{hex|63 0B 00 11}}

First + second byte are related to the position of the data (16 bytes BIG endian) - to actually control the starting location of the text, you would subtract 2ONE for every tile you want to move left ({{hex|62 64}}), and add 2ONE if you want to move it right ({{hex|62 66}}). I could go into SNES screen positioning tutorial but that would just bore you, but I can assure this this goes straight into a DMA RAM area to the GPU.
* 3rd byte is always - {{hex|00}} (the code ANDs them out anyway lol)
* 4th byte - length - formula is {{hex|(value + 1) / 2}} in terms of text to read after that byte just like the above. So the first line we would read {{$|16}} bytes (THE RETURN OF THE KING)
{{source|Euclid}}
==Table==
The game contains a table to store all of its characters. The table's location for each region is as follows.

{|{{prettytable}}
!JP
|-
|{{address|0x|75A68||0xA0}}
|}
{{source|SmallHacker}}
{{toc}}

Credits

2017-12-25T02:22:32Z

Tatters: /* Table */

==Wishes==
* {{address|0x|742E1|74303|34}} = Pointers for wishes. Comes in pairs of two in little endian. 16 screens and 17 pointers. The spare pointer serves to mark the end.

{{red|00 00 }}{{blue|3C 00 }}{{green|68 00 }}{{hex|AA 00 }}{{hex|E8 00 28 01 5B 01 98 01}}
{{hex|CF 01 07 02 42 02 7D 02 B0 02 EA 02 22 03 52 03}}
{{hex|95 03}}

* {{red|00 00}} = First screen (Return of the King)
* {{blue|3C 00}} = Second screen (Sanctuary)
* {{green|68 00}} = Third screen (Village)

Basically the data for the pointers to the screens are:
* {{0x|73F4C}} + {{hex|00}} → {{0x|73F4C}} + {{hex|3C}} - {{hex|1}}
* {{0x|73F4C}} + {{hex|3C}} → {{0x|73F4C}} + {{hex|68}} - {{hex|1}}
* And so forth.

==Credits==
To parse the ending credits data (scrolling credits), I'll take this one as an example:

* {{0x|7317A}} = {{hex|EXECUTIVE PRODUCER}}

{{0x|73170}} - {{hex|XX XX XX XX XX XX XX XX }}{{red|07 }}{{blue|23 }}{{green|3C 4F 3C 3A 4C 4B}}
{{0x|73180}} - {{green|40 4D 3C 9F 47 49 46 3B 4C 3A 3C 49 FF }}{{hex|XX XX XX}}

* {{red|07}} = start from the 7th tile from the left of the screen (Note scrolling credits have no vertical position, and return of the king section have them hardcoded)
* {{blue|23}} = ({{$|23 + }}{{$|1}}) / {{$|2}} = {{$|12}} bytes to read
* Then read {{$|12}} bytes - {{hex|3C 4F 3C 3A 4C 4B 40 4D 3C 9F 47 49 46 3B 4C 3A 3C 49}}

For each 12 bytes look up the table definition and draw the character on screen at the position.

Now to pointers to the data.

Pointers start at {{0x|7393D}}

Data around there is as follows:
{{hex|94 91 9B 97 8D 8B 9F 9B 83 8F 83 86 83 }}{{red|00 00 }}{{hex|14}}
{{hex|00 14 00 14 00 15 00 27 00 14 00 14 00 14 00 14}}
{{hex|00 14 00 14 00 14 00 14 00 39 00 14 00 14 00 14}}

That {{red|00 00}}, is a relative position to {{0x|73178}}, funnily enough, the next value is {{hex|14 00}}, which points straight to the {{$|FF}}! {{$|FF}} is a special placeholder to show a blank line (as the game's engine does)

In other words from the above

{{hex|00 00}} = EXECUTIVE PRODUCER
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|15 00}} = NAME FIRST LINE
{{hex|27 00}} = NAME SECOND LINE
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|39 00}} = NEXT LABEL (forgot what it is)
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|...}}

This continues until the last pointer at {{0x|73C4F}}, so the data ends at {{0x|73C50}} ({{0x|73C51}} has assembly!) -- you'll notice that the lines with the death counts have the place names written this way but not the actual number. That bit is hardcoded.

So the next thing is what about the RETURN OF THE KING data? (puns) There's 4 byte control code rather than two in the credits area.

For the line THE RETURN OF THE KING, the data actually starts 4 bytes before {{0x|73F50}} at {{0x|73F4C}}
@{{0x|73F40}}
{{hex|30 A9 FF 9D 02 10 A9 01 85 14 AB 60 62 65 00 2B}}
{{hex|2D 21 1E 9F 2B 1E 2D 2E 2B 27 9F 28 1F 9F 2D 21}}
{{hex|1E 9F 24 22 27 20 62 E9 00 19 64 75 6E 71 68 61}}

{{hex|62 65 00 2B}}
{{hex|62 E9 00 19}}
{{hex|63 09 00 19}}
{{hex|62 EB 00 11}}
{{hex|63 0B 00 11}}

First + second byte are related to the position of the data (16 bytes BIG endian) - to actually control the starting location of the text, you would subtract 2ONE for every tile you want to move left ({{hex|62 64}}), and add 2ONE if you want to move it right ({{hex|62 66}}). I could go into SNES screen positioning tutorial but that would just bore you, but I can assure this this goes straight into a DMA RAM area to the GPU.
* 3rd byte is always - {{hex|00}} (the code ANDs them out anyway lol)
* 4th byte - length - formula is {{hex|(value + 1) / 2}} in terms of text to read after that byte just like the above. So the first line we would read {{$|16}} bytes (THE RETURN OF THE KING)

==Table==
The game contains a table to store all of its characters. The table's location for each region is as follows.

{|{{prettytable}}
!JP
|-
|{{address|0x|75A68||0xA0}}
|}

{{toc}}

Credits

2017-12-25T02:22:11Z

Tatters:

==Wishes==
* {{address|0x|742E1|74303|34}} = Pointers for wishes. Comes in pairs of two in little endian. 16 screens and 17 pointers. The spare pointer serves to mark the end.

{{red|00 00 }}{{blue|3C 00 }}{{green|68 00 }}{{hex|AA 00 }}{{hex|E8 00 28 01 5B 01 98 01}}
{{hex|CF 01 07 02 42 02 7D 02 B0 02 EA 02 22 03 52 03}}
{{hex|95 03}}

* {{red|00 00}} = First screen (Return of the King)
* {{blue|3C 00}} = Second screen (Sanctuary)
* {{green|68 00}} = Third screen (Village)

Basically the data for the pointers to the screens are:
* {{0x|73F4C}} + {{hex|00}} → {{0x|73F4C}} + {{hex|3C}} - {{hex|1}}
* {{0x|73F4C}} + {{hex|3C}} → {{0x|73F4C}} + {{hex|68}} - {{hex|1}}
* And so forth.

==Credits==
To parse the ending credits data (scrolling credits), I'll take this one as an example:

* {{0x|7317A}} = {{hex|EXECUTIVE PRODUCER}}

{{0x|73170}} - {{hex|XX XX XX XX XX XX XX XX }}{{red|07 }}{{blue|23 }}{{green|3C 4F 3C 3A 4C 4B}}
{{0x|73180}} - {{green|40 4D 3C 9F 47 49 46 3B 4C 3A 3C 49 FF }}{{hex|XX XX XX}}

* {{red|07}} = start from the 7th tile from the left of the screen (Note scrolling credits have no vertical position, and return of the king section have them hardcoded)
* {{blue|23}} = ({{$|23 + }}{{$|1}}) / {{$|2}} = {{$|12}} bytes to read
* Then read {{$|12}} bytes - {{hex|3C 4F 3C 3A 4C 4B 40 4D 3C 9F 47 49 46 3B 4C 3A 3C 49}}

For each 12 bytes look up the table definition and draw the character on screen at the position.

Now to pointers to the data.

Pointers start at {{0x|7393D}}

Data around there is as follows:
{{hex|94 91 9B 97 8D 8B 9F 9B 83 8F 83 86 83 }}{{red|00 00 }}{{hex|14}}
{{hex|00 14 00 14 00 15 00 27 00 14 00 14 00 14 00 14}}
{{hex|00 14 00 14 00 14 00 14 00 39 00 14 00 14 00 14}}

That {{red|00 00}}, is a relative position to {{0x|73178}}, funnily enough, the next value is {{hex|14 00}}, which points straight to the {{$|FF}}! {{$|FF}} is a special placeholder to show a blank line (as the game's engine does)

In other words from the above

{{hex|00 00}} = EXECUTIVE PRODUCER
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|15 00}} = NAME FIRST LINE
{{hex|27 00}} = NAME SECOND LINE
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|39 00}} = NEXT LABEL (forgot what it is)
{{hex|14 00}} = BLANK
{{hex|14 00}} = BLANK
{{hex|...}}

This continues until the last pointer at {{0x|73C4F}}, so the data ends at {{0x|73C50}} ({{0x|73C51}} has assembly!) -- you'll notice that the lines with the death counts have the place names written this way but not the actual number. That bit is hardcoded.

So the next thing is what about the RETURN OF THE KING data? (puns) There's 4 byte control code rather than two in the credits area.

For the line THE RETURN OF THE KING, the data actually starts 4 bytes before {{0x|73F50}} at {{0x|73F4C}}
@{{0x|73F40}}
{{hex|30 A9 FF 9D 02 10 A9 01 85 14 AB 60 62 65 00 2B}}
{{hex|2D 21 1E 9F 2B 1E 2D 2E 2B 27 9F 28 1F 9F 2D 21}}
{{hex|1E 9F 24 22 27 20 62 E9 00 19 64 75 6E 71 68 61}}

{{hex|62 65 00 2B}}
{{hex|62 E9 00 19}}
{{hex|63 09 00 19}}
{{hex|62 EB 00 11}}
{{hex|63 0B 00 11}}

First + second byte are related to the position of the data (16 bytes BIG endian) - to actually control the starting location of the text, you would subtract 2ONE for every tile you want to move left ({{hex|62 64}}), and add 2ONE if you want to move it right ({{hex|62 66}}). I could go into SNES screen positioning tutorial but that would just bore you, but I can assure this this goes straight into a DMA RAM area to the GPU.
* 3rd byte is always - {{hex|00}} (the code ANDs them out anyway lol)
* 4th byte - length - formula is {{hex|(value + 1) / 2}} in terms of text to read after that byte just like the above. So the first line we would read {{$|16}} bytes (THE RETURN OF THE KING)

==Table==
The game contains a table to store all of its characters. The table's location for each region is as follows.

{|{{prettytable}}
!JP
|-
|{{address|0x|75A68||0xA0}}
|}

{{toc}}

Credits

2017-12-25T02:14:57Z

Tatters:

Template:Toc

2017-12-24T23:45:41Z

Tatters:

<includeonly>==Navigate==
{|{{prettytable}}
! [[Template:Toc|Table of Contents]]
|-
|<center>[[Sprites]] {{*}} [[Dungeons]] {{*}} [[Overworld]] {{*}} [[Underworld]] {{*}} [[SRAM Map]] {{*}} [[RAM|RAM Map]] {{*}} [[ROM|ROM Map]] {{*}} [[Music]] {{*}} [[Monologue]] {{*}} [[Credits]] {{*}} [[Dumps]] {{*}} [[Miscellaneous]] {{*}} [[To-Do/Suggestions]]</center>
|}
</includeonly><noinclude>{{Toc}}[[Category:Templates]]</noinclude>

Credits

2017-12-24T23:44:40Z

Tatters: Created page with "==Wishes== * {{address|0x|742E1|74303|34}} = Pointers for wishes. Comes in pairs of two in little endian. 16 screens and 17 pointers. The spare pointer serves to mark the end...."

Template:Toc

2017-12-24T23:33:46Z

Tatters:

<includeonly>==Navigate==
{|{{prettytable}}
! [[Template:Toc|Table of Contents]]
|-
|<center>[[Sprites]] {{*}} [[Dungeons]] {{*}} [[Overworld]] {{*}} [[Underworld]] {{*}} [[SRAM Map]] {{*}} [[RAM|RAM Map]] {{*}} [[ROM|ROM Map]] {{*}} [[Music]] {{*}} [[Monologue]] {{*}} [[Dumps]] {{*}} [[Miscellaneous]] {{*}} [[To-Do/Suggestions]]</center>
|}
</includeonly><noinclude>{{Toc}}[[Category:Templates]]</noinclude>

Main Page

2017-12-24T23:33:27Z

Tatters:

This is a wiki dedicated to documenting ''The Legend of Zelda - A Link to the Past''.

[https://discordapp.com/invite/jP5csBn Join the chat!]
{{toc}}

Template:Toc

2017-12-24T23:33:00Z

Tatters:

<includeonly>
==Navigate==
{|{{prettytable}}
! [[Template:Toc|Table of Contents]]
|-
|<center>[[Sprites]] {{*}} [[Dungeons]] {{*}} [[Overworld]] {{*}} [[Underworld]] {{*}} [[SRAM Map]] {{*}} [[RAM|RAM Map]] {{*}} [[ROM|ROM Map]] {{*}} [[Music]] {{*}} [[Monologue]] {{*}} [[Dumps]] {{*}} [[Miscellaneous]] {{*}} [[To-Do/Suggestions]]</center>
|}
</includeonly><noinclude>{{Toc}}[[Category:Templates]]</noinclude>

Underworld:Important Hex Addresses/Object Data

2017-12-24T00:21:11Z

Tatters: /* Subtype 3 Objects */

{{subpage|Underworld:Important Hex Addresses#Object_Data}}
==Data location==
* {{$|0F8000}} to {{$|0F83BF}} = Pointer Table, 3 byte long addresses, indexed by room ID.
* {{$|01EBA0}} to {{$|01FFF4}} = Data
* {{$|050000}} to {{$|053729}} = Data
* {{$|0F8780}} to {{$|0FFF4D}} = Data

==Byte layout==
* Byte 0: {{red|aaaa}} {{blue|bbbb}}.
**The a bits are transformed to {{red|aaaa}}{{hex|0000}} and select the type of empty space to fill in. Hyrule Magic calls this 'Floor 1' - Gets stored to {{$|7E0490}}
**The b bits are transformed to {{blue|bbbb}}{{hex|0000}} and are the what Hyrule Magic calls 'Floor 2' - Gets stored to {{$|7E046A}}

* Byte {{hex|1}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
** The {{red|a}} bits are unused and should not be used
** The {{blue|b}} bits determine the room's layout type, ranging from {{hex|0}} to {{hex|7}}.
** The {{green|c}} and {{purple|d}} bits are unknown, but I have a feeling it's related to {{$|AA}} and {{$|A9}}

After that the bytes come in {{hex|3}} or {{hex|2}} byte object structures, used by routine {{$|01:88E4}}. Objects are loaded until an object with value {{0x|FFFF}} occurs. If a value {{0x|FFF0}} is loaded, the game will start loading Type 2 objects and will not go back to loading Type 1 objects until it is time to load the next layer. (Layer as in HM, not to be confused with the SNES' Backgrounds.) A value of {{0x|FFFF}} will also terminate the loading of Type 2 objects. The routine immediately terminates if that happens during the loading of either object type.

===Type 1 Object structure: (3 bytes)===

* Byte {{hex|3}}: Routine to use. If this byte is ≥ {{0x|F8}} and < {{0x|FC}}, then it is a subtype 3 object. If the index is ≥ {{hex|FC}}, it is a subtype 2 object. If not, it is a subtype 1 object.

* Subtype 1 Objects, first and second byte
** High Byte: {{brown|yyyy yy}}{{green|cc}}
** Low Byte: {{grey|xxxx xx}}{{red|aa}}
*** The {{red|a}} bits are stored to {{$|B2}}
*** The {{green|c}} bits are stored to {{$|B4}}
*** The {{grey|x}} and {{brown|y}} bits are transformed into: {{hex|000}}{{brown|y yyyy y}}{{grey|xxx xxx}}{{hex|0}} - This is a tilemap address that indexes into {{$|7E2000}} and / or {{$|7E4000}}

Use Byte {{hex|3}} * 2 as an index into the table at {{$|8200}}. This is the routine that is used to draw and otherwise handle the object. Subtype 1 objects have a maximum width and height of 4. Width and height are measured in terms of 32 {{x}} 32 pixels. (⟸ last part is questionable)

====Subtype 2 Objects, 1st, 2nd, & 3rd bytes====
* Byte {{hex|3}}: {{white|ff}}{{purple|dd dddd}}
* Byte {{hex|2}}: {{pink|eeee}} {{green|cccc}}
* Byte {{hex|1}}: {{red|aaaa aa}}{{blue|bb}}
**The {{red|a}} bits are unused, but after all they are the marker for this type of object subtype.
**The {{blue|b}}, {{green|c}}, {{pink|e}}, and {{white|f}} bits are transformed into a VRAM tilemap address: {{hex|000}}{{green|c ccc}}{{white|f}} {{white|f}}{{blue|bb}}{{pink|e eee}}{{hex|0}}

Might I add this is one messed up format? The {{purple|d}} bits are used as an index into the table at {{$|8470}}. Since such indices are going to be even, the {{purple|d}} bits are transformed into: {{hex|0000 0000 0}}{{purple|ddd ddd}}{{hex|0}}.

====Subtype 3 Objects====
*Similar to Subtype 1, with a few small exceptions.
*The vram address is calculated the same way. However, {{$|B2}} and {{$|B4}} are not used as length or width dimensions here. The routine that is used is determined as follows:
*Take the original index (times two) that a Subtype 1 would have used. AND that with {{0x|000E}}. Then shift left 3 times to produce {{hex|0000 0000 0}}{{pink|eee}} {{hex|0000}}. Then, OR in {{$|B2}} and {{$|B4}} and shift left once, so the final result is: {{hex|0000 0000}} {{pink|eee}}{{red|a a}}{{blue|bb}}{{hex|0}}.
*Also, this value indexes into {{$|85F0}} instead of {{$|8200}}.

===Type 2 Object Structure: (2 bytes)===
*High Byte: {{green|cccc cccc}}
*Low Byte: {{blue|bbbb}} {{purple|dd}}{{red|aa}}
**The {{red|a}} bits form a 2-bit value ({{hex|0000 0}}{{red|aa}}{{hex|0}}) that determines the routine to use for the object. In Hyrule Magic, corresponds to the "direction" of the door.
**The {{blue|b}} bits are transformed into {{hex|000}}{{blue|b bbb}}{{hex|0}} and stored to {{$|02}} ⟹ X. Corresponds to "Pos" of door objects in the Hyrule Magic. Note that these range from {{0x|00}} to {{0x|16}} (always even) which if you halve those values is 0 - 11 in decimal. This is easily verifiable in Hyrule Magic.
**The {{green|c}} bits are shifted into the lower byte and stored to {{$|04}} ⟹ A and {{$|0A}}. This is later used to grab the tiles used to draw the door and the area below it. In Hyrule Magic, corresponds to "type". Note the type is 1/2 of the number listed here. This is because to avoid using an ASL A command, the {{green|c}} bits are always even.
**The {{purple|d}} bits are unused.

Next I'll go into the nitty gritty of the various types (the value of {{$|04}}). Again note that we'll only be dealing with even values {{blue|b}}/{{green|c}} that's what you'll see in the code. To convert between here [as well as the code] and Hyrule Magic, take the hex value here and divide by two. Convert to decimal and that's your Hyrule Magic "type."

*Types:
{|{{Prettytable}}
! ID
! Description
|-
|{{0x|00}}
|Basic door. Index = {{$|0460}}
|-
|{{0x|02}}
|Normal door?
|-
|{{0x|04}}
|???
|-
|{{0x|06}}
|???
|-
|{{0x|08}}
|Waterfall door (only used in Swamp palace; in one room at that!)
|-
|{{0x|0A}}
|???
|-
|{{0x|0C}}
|Trap door (probably other types but this seems to be most common)
|-
|{{0x|12}}
|Adds a property to some doors allowing you to exit to the overworld (this is accomplished by writing to the tile attribute map)
|-
|{{0x|14}}
|Transition to dark room?
|-
|{{0x|16}}
|Toggles the target BG Link will emerge on. '''Ex.''' if Link starts on BG0 in the next room he'll be on BG1.
|-
|{{0x|20}}
| rowspan="2"|Locked door specifically for BG0.
|-
|{{0x|22}}
|-
|{{0x|24}}
| rowspan="2"|Locked door for either BG0 or BG1
|-
|{{0x|26}}
|-
|{{0x|30}}
|Large exploded pathway resulting from a switch being pulled (unusual to have as a door as it's huge)
|-
|{{0x|32}}
|Sword activated door. '''Ex.''' Agahnim's room with the curtain door you have to slash.
|-
|{{0x|46}}
|warp door?
|}

{{toc}}

Underworld:Important Hex Addresses/Object Data

2017-12-24T00:20:49Z

Tatters: /* Subtype 2 Objects, 1st, 2nd, & 3rd bytes */

{{subpage|Underworld:Important Hex Addresses#Object_Data}}
==Data location==
* {{$|0F8000}} to {{$|0F83BF}} = Pointer Table, 3 byte long addresses, indexed by room ID.
* {{$|01EBA0}} to {{$|01FFF4}} = Data
* {{$|050000}} to {{$|053729}} = Data
* {{$|0F8780}} to {{$|0FFF4D}} = Data

==Byte layout==
* Byte 0: {{red|aaaa}} {{blue|bbbb}}.
**The a bits are transformed to {{red|aaaa}}{{hex|0000}} and select the type of empty space to fill in. Hyrule Magic calls this 'Floor 1' - Gets stored to {{$|7E0490}}
**The b bits are transformed to {{blue|bbbb}}{{hex|0000}} and are the what Hyrule Magic calls 'Floor 2' - Gets stored to {{$|7E046A}}

* Byte {{hex|1}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
** The {{red|a}} bits are unused and should not be used
** The {{blue|b}} bits determine the room's layout type, ranging from {{hex|0}} to {{hex|7}}.
** The {{green|c}} and {{purple|d}} bits are unknown, but I have a feeling it's related to {{$|AA}} and {{$|A9}}

After that the bytes come in {{hex|3}} or {{hex|2}} byte object structures, used by routine {{$|01:88E4}}. Objects are loaded until an object with value {{0x|FFFF}} occurs. If a value {{0x|FFF0}} is loaded, the game will start loading Type 2 objects and will not go back to loading Type 1 objects until it is time to load the next layer. (Layer as in HM, not to be confused with the SNES' Backgrounds.) A value of {{0x|FFFF}} will also terminate the loading of Type 2 objects. The routine immediately terminates if that happens during the loading of either object type.

===Type 1 Object structure: (3 bytes)===

* Byte {{hex|3}}: Routine to use. If this byte is ≥ {{0x|F8}} and < {{0x|FC}}, then it is a subtype 3 object. If the index is ≥ {{hex|FC}}, it is a subtype 2 object. If not, it is a subtype 1 object.

* Subtype 1 Objects, first and second byte
** High Byte: {{brown|yyyy yy}}{{green|cc}}
** Low Byte: {{grey|xxxx xx}}{{red|aa}}
*** The {{red|a}} bits are stored to {{$|B2}}
*** The {{green|c}} bits are stored to {{$|B4}}
*** The {{grey|x}} and {{brown|y}} bits are transformed into: {{hex|000}}{{brown|y yyyy y}}{{grey|xxx xxx}}{{hex|0}} - This is a tilemap address that indexes into {{$|7E2000}} and / or {{$|7E4000}}

Use Byte {{hex|3}} * 2 as an index into the table at {{$|8200}}. This is the routine that is used to draw and otherwise handle the object. Subtype 1 objects have a maximum width and height of 4. Width and height are measured in terms of 32 {{x}} 32 pixels. (⟸ last part is questionable)

====Subtype 2 Objects, 1st, 2nd, & 3rd bytes====
* Byte {{hex|3}}: {{white|ff}}{{purple|dd dddd}}
* Byte {{hex|2}}: {{pink|eeee}} {{green|cccc}}
* Byte {{hex|1}}: {{red|aaaa aa}}{{blue|bb}}
**The {{red|a}} bits are unused, but after all they are the marker for this type of object subtype.
**The {{blue|b}}, {{green|c}}, {{pink|e}}, and {{white|f}} bits are transformed into a VRAM tilemap address: {{hex|000}}{{green|c ccc}}{{white|f}} {{white|f}}{{blue|bb}}{{pink|e eee}}{{hex|0}}

Might I add this is one messed up format? The {{purple|d}} bits are used as an index into the table at {{$|8470}}. Since such indices are going to be even, the {{purple|d}} bits are transformed into: {{hex|0000 0000 0}}{{purple|ddd ddd}}{{hex|0}}.

====Subtype 3 Objects====
**Similar to Subtype 1, with a few small exceptions.
**The vram address is calculated the same way. However, {{$|B2}} and {{$|B4}} are not used as length or width dimensions here. The routine that is used is determined as follows:
**Take the original index (times two) that a Subtype 1 would have used. AND that with {{0x|000E}}. Then shift left 3 times to produce {{hex|0000 0000 0}}{{pink|eee}} {{hex|0000}}. Then, OR in {{$|B2}} and {{$|B4}} and shift left once, so the final result is: {{hex|0000 0000}} {{pink|eee}}{{red|a a}}{{blue|bb}}{{hex|0}}.
**Also, this value indexes into {{$|85F0}} instead of {{$|8200}}.

===Type 2 Object Structure: (2 bytes)===
*High Byte: {{green|cccc cccc}}
*Low Byte: {{blue|bbbb}} {{purple|dd}}{{red|aa}}
**The {{red|a}} bits form a 2-bit value ({{hex|0000 0}}{{red|aa}}{{hex|0}}) that determines the routine to use for the object. In Hyrule Magic, corresponds to the "direction" of the door.
**The {{blue|b}} bits are transformed into {{hex|000}}{{blue|b bbb}}{{hex|0}} and stored to {{$|02}} ⟹ X. Corresponds to "Pos" of door objects in the Hyrule Magic. Note that these range from {{0x|00}} to {{0x|16}} (always even) which if you halve those values is 0 - 11 in decimal. This is easily verifiable in Hyrule Magic.
**The {{green|c}} bits are shifted into the lower byte and stored to {{$|04}} ⟹ A and {{$|0A}}. This is later used to grab the tiles used to draw the door and the area below it. In Hyrule Magic, corresponds to "type". Note the type is 1/2 of the number listed here. This is because to avoid using an ASL A command, the {{green|c}} bits are always even.
**The {{purple|d}} bits are unused.

Next I'll go into the nitty gritty of the various types (the value of {{$|04}}). Again note that we'll only be dealing with even values {{blue|b}}/{{green|c}} that's what you'll see in the code. To convert between here [as well as the code] and Hyrule Magic, take the hex value here and divide by two. Convert to decimal and that's your Hyrule Magic "type."

*Types:
{|{{Prettytable}}
! ID
! Description
|-
|{{0x|00}}
|Basic door. Index = {{$|0460}}
|-
|{{0x|02}}
|Normal door?
|-
|{{0x|04}}
|???
|-
|{{0x|06}}
|???
|-
|{{0x|08}}
|Waterfall door (only used in Swamp palace; in one room at that!)
|-
|{{0x|0A}}
|???
|-
|{{0x|0C}}
|Trap door (probably other types but this seems to be most common)
|-
|{{0x|12}}
|Adds a property to some doors allowing you to exit to the overworld (this is accomplished by writing to the tile attribute map)
|-
|{{0x|14}}
|Transition to dark room?
|-
|{{0x|16}}
|Toggles the target BG Link will emerge on. '''Ex.''' if Link starts on BG0 in the next room he'll be on BG1.
|-
|{{0x|20}}
| rowspan="2"|Locked door specifically for BG0.
|-
|{{0x|22}}
|-
|{{0x|24}}
| rowspan="2"|Locked door for either BG0 or BG1
|-
|{{0x|26}}
|-
|{{0x|30}}
|Large exploded pathway resulting from a switch being pulled (unusual to have as a door as it's huge)
|-
|{{0x|32}}
|Sword activated door. '''Ex.''' Agahnim's room with the curtain door you have to slash.
|-
|{{0x|46}}
|warp door?
|}

{{toc}}

Underworld:Important Hex Addresses/Object Data

2017-12-24T00:19:58Z

Tatters:

{{subpage|Underworld:Important Hex Addresses#Object_Data}}
==Data location==
* {{$|0F8000}} to {{$|0F83BF}} = Pointer Table, 3 byte long addresses, indexed by room ID.
* {{$|01EBA0}} to {{$|01FFF4}} = Data
* {{$|050000}} to {{$|053729}} = Data
* {{$|0F8780}} to {{$|0FFF4D}} = Data

==Byte layout==
* Byte 0: {{red|aaaa}} {{blue|bbbb}}.
**The a bits are transformed to {{red|aaaa}}{{hex|0000}} and select the type of empty space to fill in. Hyrule Magic calls this 'Floor 1' - Gets stored to {{$|7E0490}}
**The b bits are transformed to {{blue|bbbb}}{{hex|0000}} and are the what Hyrule Magic calls 'Floor 2' - Gets stored to {{$|7E046A}}

* Byte {{hex|1}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
** The {{red|a}} bits are unused and should not be used
** The {{blue|b}} bits determine the room's layout type, ranging from {{hex|0}} to {{hex|7}}.
** The {{green|c}} and {{purple|d}} bits are unknown, but I have a feeling it's related to {{$|AA}} and {{$|A9}}

After that the bytes come in {{hex|3}} or {{hex|2}} byte object structures, used by routine {{$|01:88E4}}. Objects are loaded until an object with value {{0x|FFFF}} occurs. If a value {{0x|FFF0}} is loaded, the game will start loading Type 2 objects and will not go back to loading Type 1 objects until it is time to load the next layer. (Layer as in HM, not to be confused with the SNES' Backgrounds.) A value of {{0x|FFFF}} will also terminate the loading of Type 2 objects. The routine immediately terminates if that happens during the loading of either object type.

===Type 1 Object structure: (3 bytes)===

* Byte {{hex|3}}: Routine to use. If this byte is ≥ {{0x|F8}} and < {{0x|FC}}, then it is a subtype 3 object. If the index is ≥ {{hex|FC}}, it is a subtype 2 object. If not, it is a subtype 1 object.

* Subtype 1 Objects, first and second byte
** High Byte: {{brown|yyyy yy}}{{green|cc}}
** Low Byte: {{grey|xxxx xx}}{{red|aa}}
*** The {{red|a}} bits are stored to {{$|B2}}
*** The {{green|c}} bits are stored to {{$|B4}}
*** The {{grey|x}} and {{brown|y}} bits are transformed into: {{hex|000}}{{brown|y yyyy y}}{{grey|xxx xxx}}{{hex|0}} - This is a tilemap address that indexes into {{$|7E2000}} and / or {{$|7E4000}}

Use Byte {{hex|3}} * 2 as an index into the table at {{$|8200}}. This is the routine that is used to draw and otherwise handle the object. Subtype 1 objects have a maximum width and height of 4. Width and height are measured in terms of 32 {{x}} 32 pixels. (⟸ last part is questionable)

====Subtype 2 Objects, 1st, 2nd, & 3rd bytes====
** Byte {{hex|3}}: {{white|ff}}{{purple|dd dddd}}
** Byte {{hex|2}}: {{pink|eeee}} {{green|cccc}}
** Byte {{hex|1}}: {{red|aaaa aa}}{{blue|bb}}
***The {{red|a}} bits are unused, but after all they are the marker for this type of object subtype.
***The {{blue|b}}, {{green|c}}, {{pink|e}}, and {{white|f}} bits are transformed into a VRAM tilemap address: {{hex|000}}{{green|c ccc}}{{white|f}} {{white|f}}{{blue|bb}}{{pink|e eee}}{{hex|0}}

Might I add this is one messed up format? The {{purple|d}} bits are used as an index into the table at {{$|8470}}. Since such indices are going to be even, the {{purple|d}} bits are transformed into: {{hex|0000 0000 0}}{{purple|ddd ddd}}{{hex|0}}.

====Subtype 3 Objects====
**Similar to Subtype 1, with a few small exceptions.
**The vram address is calculated the same way. However, {{$|B2}} and {{$|B4}} are not used as length or width dimensions here. The routine that is used is determined as follows:
**Take the original index (times two) that a Subtype 1 would have used. AND that with {{0x|000E}}. Then shift left 3 times to produce {{hex|0000 0000 0}}{{pink|eee}} {{hex|0000}}. Then, OR in {{$|B2}} and {{$|B4}} and shift left once, so the final result is: {{hex|0000 0000}} {{pink|eee}}{{red|a a}}{{blue|bb}}{{hex|0}}.
**Also, this value indexes into {{$|85F0}} instead of {{$|8200}}.

===Type 2 Object Structure: (2 bytes)===
*High Byte: {{green|cccc cccc}}
*Low Byte: {{blue|bbbb}} {{purple|dd}}{{red|aa}}
**The {{red|a}} bits form a 2-bit value ({{hex|0000 0}}{{red|aa}}{{hex|0}}) that determines the routine to use for the object. In Hyrule Magic, corresponds to the "direction" of the door.
**The {{blue|b}} bits are transformed into {{hex|000}}{{blue|b bbb}}{{hex|0}} and stored to {{$|02}} ⟹ X. Corresponds to "Pos" of door objects in the Hyrule Magic. Note that these range from {{0x|00}} to {{0x|16}} (always even) which if you halve those values is 0 - 11 in decimal. This is easily verifiable in Hyrule Magic.
**The {{green|c}} bits are shifted into the lower byte and stored to {{$|04}} ⟹ A and {{$|0A}}. This is later used to grab the tiles used to draw the door and the area below it. In Hyrule Magic, corresponds to "type". Note the type is 1/2 of the number listed here. This is because to avoid using an ASL A command, the {{green|c}} bits are always even.
**The {{purple|d}} bits are unused.

Next I'll go into the nitty gritty of the various types (the value of {{$|04}}). Again note that we'll only be dealing with even values {{blue|b}}/{{green|c}} that's what you'll see in the code. To convert between here [as well as the code] and Hyrule Magic, take the hex value here and divide by two. Convert to decimal and that's your Hyrule Magic "type."

*Types:
{|{{Prettytable}}
! ID
! Description
|-
|{{0x|00}}
|Basic door. Index = {{$|0460}}
|-
|{{0x|02}}
|Normal door?
|-
|{{0x|04}}
|???
|-
|{{0x|06}}
|???
|-
|{{0x|08}}
|Waterfall door (only used in Swamp palace; in one room at that!)
|-
|{{0x|0A}}
|???
|-
|{{0x|0C}}
|Trap door (probably other types but this seems to be most common)
|-
|{{0x|12}}
|Adds a property to some doors allowing you to exit to the overworld (this is accomplished by writing to the tile attribute map)
|-
|{{0x|14}}
|Transition to dark room?
|-
|{{0x|16}}
|Toggles the target BG Link will emerge on. '''Ex.''' if Link starts on BG0 in the next room he'll be on BG1.
|-
|{{0x|20}}
| rowspan="2"|Locked door specifically for BG0.
|-
|{{0x|22}}
|-
|{{0x|24}}
| rowspan="2"|Locked door for either BG0 or BG1
|-
|{{0x|26}}
|-
|{{0x|30}}
|Large exploded pathway resulting from a switch being pulled (unusual to have as a door as it's huge)
|-
|{{0x|32}}
|Sword activated door. '''Ex.''' Agahnim's room with the curtain door you have to slash.
|-
|{{0x|46}}
|warp door?
|}

{{toc}}

Underworld:Important Hex Addresses

2017-12-24T00:18:38Z

Tatters: /* Object Data */

Underworld:Important Hex Addresses/Object Data

2017-12-24T00:17:39Z

Tatters: Created page with "{{subpage|Underworld:Important Hex Addresses}} ==Data location== * {{$|0F8000}} to {{$|0F83BF}} = Pointer Table, 3 byte long addresses, indexed by room ID. * {{$|01EBA0}} to {..."

{{subpage|Underworld:Important Hex Addresses}}
==Data location==
* {{$|0F8000}} to {{$|0F83BF}} = Pointer Table, 3 byte long addresses, indexed by room ID.
* {{$|01EBA0}} to {{$|01FFF4}} = Data
* {{$|050000}} to {{$|053729}} = Data
* {{$|0F8780}} to {{$|0FFF4D}} = Data

==Byte layout==
* Byte 0: {{red|aaaa}} {{blue|bbbb}}.
**The a bits are transformed to {{red|aaaa}}{{hex|0000}} and select the type of empty space to fill in. Hyrule Magic calls this 'Floor 1' - Gets stored to {{$|7E0490}}
**The b bits are transformed to {{blue|bbbb}}{{hex|0000}} and are the what Hyrule Magic calls 'Floor 2' - Gets stored to {{$|7E046A}}

* Byte {{hex|1}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
** The {{red|a}} bits are unused and should not be used
** The {{blue|b}} bits determine the room's layout type, ranging from {{hex|0}} to {{hex|7}}.
** The {{green|c}} and {{purple|d}} bits are unknown, but I have a feeling it's related to {{$|AA}} and {{$|A9}}

After that the bytes come in {{hex|3}} or {{hex|2}} byte object structures, used by routine {{$|01:88E4}}. Objects are loaded until an object with value {{0x|FFFF}} occurs. If a value {{0x|FFF0}} is loaded, the game will start loading Type 2 objects and will not go back to loading Type 1 objects until it is time to load the next layer. (Layer as in HM, not to be confused with the SNES' Backgrounds.) A value of {{0x|FFFF}} will also terminate the loading of Type 2 objects. The routine immediately terminates if that happens during the loading of either object type.

===Type 1 Object structure: (3 bytes)===

* Byte {{hex|3}}: Routine to use. If this byte is ≥ {{0x|F8}} and < {{0x|FC}}, then it is a subtype 3 object. If the index is ≥ {{hex|FC}}, it is a subtype 2 object. If not, it is a subtype 1 object.

* Subtype 1 Objects, first and second byte
** High Byte: {{brown|yyyy yy}}{{green|cc}}
** Low Byte: {{grey|xxxx xx}}{{red|aa}}
*** The {{red|a}} bits are stored to {{$|B2}}
*** The {{green|c}} bits are stored to {{$|B4}}
*** The {{grey|x}} and {{brown|y}} bits are transformed into: {{hex|000}}{{brown|y yyyy y}}{{grey|xxx xxx}}{{hex|0}} - This is a tilemap address that indexes into {{$|7E2000}} and / or {{$|7E4000}}

Use Byte {{hex|3}} * 2 as an index into the table at {{$|8200}}. This is the routine that is used to draw and otherwise handle the object. Subtype 1 objects have a maximum width and height of 4. Width and height are measured in terms of 32 {{x}} 32 pixels. (⟸ last part is questionable)

====Subtype 2 Objects, 1st, 2nd, & 3rd bytes====
** Byte {{hex|3}}: {{white|ff}}{{purple|dd dddd}}
** Byte {{hex|2}}: {{pink|eeee}} {{green|cccc}}
** Byte {{hex|1}}: {{red|aaaa aa}}{{blue|bb}}
***The {{red|a}} bits are unused, but after all they are the marker for this type of object subtype.
***The {{blue|b}}, {{green|c}}, {{pink|e}}, and {{white|f}} bits are transformed into a VRAM tilemap address: {{hex|000}}{{green|c ccc}}{{white|f}} {{white|f}}{{blue|bb}}{{pink|e eee}}{{hex|0}}

Might I add this is one messed up format? The {{purple|d}} bits are used as an index into the table at {{$|8470}}. Since such indices are going to be even, the {{purple|d}} bits are transformed into: {{hex|0000 0000 0}}{{purple|ddd ddd}}{{hex|0}}.

====Subtype 3 Objects====
**Similar to Subtype 1, with a few small exceptions.
**The vram address is calculated the same way. However, {{$|B2}} and {{$|B4}} are not used as length or width dimensions here. The routine that is used is determined as follows:
**Take the original index (times two) that a Subtype 1 would have used. AND that with {{0x|000E}}. Then shift left 3 times to produce {{hex|0000 0000 0}}{{pink|eee}} {{hex|0000}}. Then, OR in {{$|B2}} and {{$|B4}} and shift left once, so the final result is: {{hex|0000 0000}} {{pink|eee}}{{red|a a}}{{blue|bb}}{{hex|0}}.
**Also, this value indexes into {{$|85F0}} instead of {{$|8200}}.

===Type 2 Object Structure: (2 bytes)===
*High Byte: {{green|cccc cccc}}
*Low Byte: {{blue|bbbb}} {{purple|dd}}{{red|aa}}
**The {{red|a}} bits form a 2-bit value ({{hex|0000 0}}{{red|aa}}{{hex|0}}) that determines the routine to use for the object. In Hyrule Magic, corresponds to the "direction" of the door.
**The {{blue|b}} bits are transformed into {{hex|000}}{{blue|b bbb}}{{hex|0}} and stored to {{$|02}} ⟹ X. Corresponds to "Pos" of door objects in the Hyrule Magic. Note that these range from {{0x|00}} to {{0x|16}} (always even) which if you halve those values is 0 - 11 in decimal. This is easily verifiable in Hyrule Magic.
**The {{green|c}} bits are shifted into the lower byte and stored to {{$|04}} ⟹ A and {{$|0A}}. This is later used to grab the tiles used to draw the door and the area below it. In Hyrule Magic, corresponds to "type". Note the type is 1/2 of the number listed here. This is because to avoid using an ASL A command, the {{green|c}} bits are always even.
**The {{purple|d}} bits are unused.

Next I'll go into the nitty gritty of the various types (the value of {{$|04}}). Again note that we'll only be dealing with even values {{blue|b}}/{{green|c}} that's what you'll see in the code. To convert between here [as well as the code] and Hyrule Magic, take the hex value here and divide by two. Convert to decimal and that's your Hyrule Magic "type."

*Types:
{|{{Prettytable}}
! ID
! Description
|-
|{{0x|00}}
|Basic door. Index = {{$|0460}}
|-
|{{0x|02}}
|Normal door?
|-
|{{0x|04}}
|???
|-
|{{0x|06}}
|???
|-
|{{0x|08}}
|Waterfall door (only used in Swamp palace; in one room at that!)
|-
|{{0x|0A}}
|???
|-
|{{0x|0C}}
|Trap door (probably other types but this seems to be most common)
|-
|{{0x|12}}
|Adds a property to some doors allowing you to exit to the overworld (this is accomplished by writing to the tile attribute map)
|-
|{{0x|14}}
|Transition to dark room?
|-
|{{0x|16}}
|Toggles the target BG Link will emerge on. '''Ex.''' if Link starts on BG0 in the next room he'll be on BG1.
|-
|{{0x|20}}
| rowspan="2"|Locked door specifically for BG0.
|-
|{{0x|22}}
|-
|{{0x|24}}
| rowspan="2"|Locked door for either BG0 or BG1
|-
|{{0x|26}}
|-
|{{0x|30}}
|Large exploded pathway resulting from a switch being pulled (unusual to have as a door as it's huge)
|-
|{{0x|32}}
|Sword activated door. '''Ex.''' Agahnim's room with the curtain door you have to slash.
|-
|{{0x|46}}
|warp door?
|}

{{toc}}

Underworld:Important Hex Addresses

2017-12-24T00:14:35Z

Tatters: /* Type 2 Object Structure: (2 bytes) */

{{subpage|Underworld}}

==Room Data==
===Room Headers===
*{{$|027502}} to {{$|027781}} = Pointer Table, {{hex|2}} byte local addresses, indexed by room ID.
*{{$|027781}} to {{$|027FEF}} = Data

<blockquote>
Headers are {{$|0E}} (Decimal: 14) bytes formatted thusly:
*Byte {{hex|0}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
**The {{red|a}} bits are transformed into {{hex|0000 0}}{{red|aaa}} and stored to {{$|0414}} ("BG2" in Hyrule Magic)
**The {{blue|b}} bits are transformed into {{hex|0000 0}}{{blue|bbb}} and stored to {{$|046C}} ("Collision" in Hyrule Magic)
**The {{green|c}} bit is unused
**The {{purple|d}} bit is stored to {{$|7EC005}} (If set, use a lights out routine in the room transition)

*Byte {{hex|1}}: {{red|aa}}{{blue|bb bbbb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{blue|bbbb bb}}{{hex|00}}, thus making them a multiple of 4.
This value is used to load 4 different palettes for the dungeon, and corresponds to, you guessed it, Palette # in Hyrule Magic!

The resulting index is used to load values for {{$|0AB6}}, {{$|0AAC}}, {{$|0AAD}}, and {{$|0AAE}}

*Byte {{hex|2}}: gets stored to {{$|0AA2}} (GFX # in Hyrule Magic)
*Byte {{hex|3}}: value + #$40 gets stored to {{$|0AA3}} (Sprite GFX # in Hyrule Magic)
*Byte {{hex|4}}: gets stored to {{$|00AD}} ("[[Room Effects|Effect]]" in Hyrule Magic)
*Byte {{hex|5}}: {{red|aa}}{{blue|bb bbbb}}
**{{red|a}} = ?
**The {{blue|b}} bits are "[[Room Tags|Tag1]]" in Hyrule Magic and gets stored to {{$|00AE}}.
*Byte {{hex|6}}: {{red|aa}}{{blue|bb bbbb}}
**{{red|a}} = ?
**The {{blue|b}} bits are "[[Room Tags|Tag2]]" in Hyrule Magic and get stored to {{$|00AF}}

These are the planes to use for bytes {{hex|9}} through {{hex|D}}. This determines which
BG you appear on, and possibly more.

*Byte {{hex|7}}: {{red|aa}}{{blue|bb}} {{green|cc}}{{purple|dd}}
**The {{red|a}} bits are transformed into {{hex|0000 00}}{{red|aa}} and stored to {{$|063F}}
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|063E}}
**The {{green|c}} bits are transformed into {{hex|0000 00}}{{green|cc}} and stored to {{$|063D}}
**The {{purple|d}} bits are transformed into {{hex|0000 00}}{{purple|dd}} and stored to {{$|063C}}

Note, the only safe values for a plane seem to be {{hex|0}},{{hex|1}}, or {{hex|2}}. Hyrule Magic
appears to violate this rule by letting you put {{hex|3}} down, but nothing higher.

*Byte {{hex|8}}: {{red|aaaa aa}}{{blue|bb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|0640}}

*Byte {{hex|9}}: stored to {{$|7EC000}} These are all room numbers that you could possibly exit to.
*Byte {{hex|A}}: stored to {{$|7EC001}}
*Byte {{hex|B}}: stored to {{$|7EC002}}
*Byte {{hex|C}}: stored to {{$|7EC003}}
*Byte {{hex|D}}: stored to {{$|7EC004}}
</blockquote>

===Sprite Data===
* {{$|04D62E}} to {{$|04D92E}} = Pointer Table, 2 byte local addresses, indexed by room.
* {{$|04D92E}} to {{$|04EC9D}} = Data

<blockquote>
Sprite data is formatted thusly:
*Byte {{hex|0}}: Stored to {{$|0FB3}}. Corresponds with "Sort Spr" in Hyrule Magic. In a layered room this indicates sprites in the foreground are to be drawn on top of sprites in the background.
**Bit {{hex|0}} - If {{hex|0}}, sprites will sort
**Bits {{hex|7,6,5,4,3,2,1}} - Unknown, should all be {{hex|1}}
After the byte {{hex|0}}, you will see 3 byte clusters that break down thus:

*Byte {{hex|0}}:
**Bits {{hex|4,3,2,1,0}} - Y coordinate (in pixels from the top, starting at {{hex|0}}) of the sprite divided by 16.
**Bits {{hex|6,5}} - If these are set, they will be used to generate a subtype, stored to {{$|0E30}}, X.
**Bit {{hex|7}} - If set, the sprite is on BG2, if not it's on BG1
* Byte {{hex|1}}:
** Bits {{hex|4,3,2,1,0}} - X coordinate (in pixels from the far left, starting at {{hex|0}}) of the sprite divided by 16.
** Bits {{hex|7,6,5}} - If all these bits are set then this is an Overlord, otherwise it's a normal sprite. If only some of them are set they can be used to generate a subtype, stored at {{$|0E30}}, X
* Byte {{hex|2}}: Sprite or Overlord type. If a sprite, this will get loaded into a slot at {{$|0E20}}, X. If an Overlord, will get loaded to {{$|0B00}}, X.

The array is terminated with a byte of {{$|FF}}.
</blockquote>

===Object Data===
====Data location====
* {{$|0F8000}} to {{$|0F83BF}} = Pointer Table, 3 byte long addresses, indexed by room ID.
* {{$|01EBA0}} to {{$|01FFF4}} = Data
* {{$|050000}} to {{$|053729}} = Data
* {{$|0F8780}} to {{$|0FFF4D}} = Data

====Byte layout====
* Byte 0: {{red|aaaa}} {{blue|bbbb}}.
**The a bits are transformed to {{red|aaaa}}{{hex|0000}} and select the type of empty space to fill in. Hyrule Magic calls this 'Floor 1' - Gets stored to {{$|7E0490}}
**The b bits are transformed to {{blue|bbbb}}{{hex|0000}} and are the what Hyrule Magic calls 'Floor 2' - Gets stored to {{$|7E046A}}

* Byte {{hex|1}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
** The {{red|a}} bits are unused and should not be used
** The {{blue|b}} bits determine the room's layout type, ranging from {{hex|0}} to {{hex|7}}.
** The {{green|c}} and {{purple|d}} bits are unknown, but I have a feeling it's related to {{$|AA}} and {{$|A9}}

After that the bytes come in {{hex|3}} or {{hex|2}} byte object structures, used by routine {{$|01:88E4}}. Objects are loaded until an object with value {{0x|FFFF}} occurs. If a value {{0x|FFF0}} is loaded, the game will start loading Type 2 objects and will not go back to loading Type 1 objects until it is time to load the next layer. (Layer as in HM, not to be confused with the SNES' Backgrounds.) A value of {{0x|FFFF}} will also terminate the loading of Type 2 objects. The routine immediately terminates if that happens during the loading of either object type.

=====Type 1 Object structure: (3 bytes)=====

* Byte {{hex|3}}: Routine to use. If this byte is ≥ {{0x|F8}} and < {{0x|FC}}, then it is a subtype 3 object. If the index is ≥ {{hex|FC}}, it is a subtype 2 object. If not, it is a subtype 1 object.

* Subtype 1 Objects, first and second byte
** High Byte: {{brown|yyyy yy}}{{green|cc}}
** Low Byte: {{grey|xxxx xx}}{{red|aa}}
*** The {{red|a}} bits are stored to {{$|B2}}
*** The {{green|c}} bits are stored to {{$|B4}}
*** The {{grey|x}} and {{brown|y}} bits are transformed into: {{hex|000}}{{brown|y yyyy y}}{{grey|xxx xxx}}{{hex|0}} - This is a tilemap address that indexes into {{$|7E2000}} and / or {{$|7E4000}}

Use Byte {{hex|3}} * 2 as an index into the table at {{$|8200}}. This is the routine that is used to draw and otherwise handle the object. Subtype 1 objects have a maximum width and height of 4. Width and height are measured in terms of 32 {{x}} 32 pixels. (⟸ last part is questionable)

======Subtype 2 Objects, 1st, 2nd, & 3rd bytes======
** Byte {{hex|3}}: {{white|ff}}{{purple|dd dddd}}
** Byte {{hex|2}}: {{pink|eeee}} {{green|cccc}}
** Byte {{hex|1}}: {{red|aaaa aa}}{{blue|bb}}
***The {{red|a}} bits are unused, but after all they are the marker for this type of object subtype.
***The {{blue|b}}, {{green|c}}, {{pink|e}}, and {{white|f}} bits are transformed into a VRAM tilemap address: {{hex|000}}{{green|c ccc}}{{white|f}} {{white|f}}{{blue|bb}}{{pink|e eee}}{{hex|0}}

Might I add this is one messed up format? The {{purple|d}} bits are used as an index into the table at {{$|8470}}. Since such indices are going to be even, the {{purple|d}} bits are transformed into: {{hex|0000 0000 0}}{{purple|ddd ddd}}{{hex|0}}.

======Subtype 3 Objects======
**Similar to Subtype 1, with a few small exceptions.
**The vram address is calculated the same way. However, {{$|B2}} and {{$|B4}} are not used as length or width dimensions here. The routine that is used is determined as follows:
**Take the original index (times two) that a Subtype 1 would have used. AND that with {{0x|000E}}. Then shift left 3 times to produce {{hex|0000 0000 0}}{{pink|eee}} {{hex|0000}}. Then, OR in {{$|B2}} and {{$|B4}} and shift left once, so the final result is: {{hex|0000 0000}} {{pink|eee}}{{red|a a}}{{blue|bb}}{{hex|0}}.
**Also, this value indexes into {{$|85F0}} instead of {{$|8200}}.

=====Type 2 Object Structure: (2 bytes)=====
*High Byte: {{green|cccc cccc}}
*Low Byte: {{blue|bbbb}} {{purple|dd}}{{red|aa}}
**The {{red|a}} bits form a 2-bit value ({{hex|0000 0}}{{red|aa}}{{hex|0}}) that determines the routine to use for the object. In Hyrule Magic, corresponds to the "direction" of the door.
**The {{blue|b}} bits are transformed into {{hex|000}}{{blue|b bbb}}{{hex|0}} and stored to {{$|02}} ⟹ X. Corresponds to "Pos" of door objects in the Hyrule Magic. Note that these range from {{0x|00}} to {{0x|16}} (always even) which if you halve those values is 0 - 11 in decimal. This is easily verifiable in Hyrule Magic.
**The {{green|c}} bits are shifted into the lower byte and stored to {{$|04}} ⟹ A and {{$|0A}}. This is later used to grab the tiles used to draw the door and the area below it. In Hyrule Magic, corresponds to "type". Note the type is 1/2 of the number listed here. This is because to avoid using an ASL A command, the {{green|c}} bits are always even.
**The {{purple|d}} bits are unused.

Next I'll go into the nitty gritty of the various types (the value of {{$|04}}). Again note that we'll only be dealing with even values {{blue|b}}/{{green|c}} that's what you'll see in the code. To convert between here [as well as the code] and Hyrule Magic, take the hex value here and divide by two. Convert to decimal and that's your Hyrule Magic "type."

*Types:
{|{{Prettytable}}
! ID
! Description
|-
|{{0x|00}}
|Basic door. Index = {{$|0460}}
|-
|{{0x|02}}
|Normal door?
|-
|{{0x|04}}
|???
|-
|{{0x|06}}
|???
|-
|{{0x|08}}
|Waterfall door (only used in Swamp palace; in one room at that!)
|-
|{{0x|0A}}
|???
|-
|{{0x|0C}}
|Trap door (probably other types but this seems to be most common)
|-
|{{0x|12}}
|Adds a property to some doors allowing you to exit to the overworld (this is accomplished by writing to the tile attribute map)
|-
|{{0x|14}}
|Transition to dark room?
|-
|{{0x|16}}
|Toggles the target BG Link will emerge on. '''Ex.''' if Link starts on BG0 in the next room he'll be on BG1.
|-
|{{0x|20}}
| rowspan="2"|Locked door specifically for BG0.
|-
|{{0x|22}}
|-
|{{0x|24}}
| rowspan="2"|Locked door for either BG0 or BG1
|-
|{{0x|26}}
|-
|{{0x|30}}
|Large exploded pathway resulting from a switch being pulled (unusual to have as a door as it's huge)
|-
|{{0x|32}}
|Sword activated door. '''Ex.''' Agahnim's room with the curtain door you have to slash.
|-
|{{0x|46}}
|warp door?
|}

===Dungeon Secrets Data===
* {{$|00DB69}} to {{$|00DDE8}} = Pointer Table, 2 byte local addresses, indexed by room ID.
* {{$|00DDE9}} to {{$|00E6B1}} = Data
<blockquote>
Data comes in 3 byte chunks and is terminated by an instance of {{$|FFFF}}

* Bytes {{hex|0}}, {{hex|1}}: A word that denotes the VRAM address that the item is found at. This identifies the item as belonging to that part of the screen.
* Byte {{hex|2}}: Identifies the type of item that is hiding there. E.g. {{$|08}} is a key
</blockquote>

===Push Block Data===
The block data has three primary pointer locations. The pointer is stored as a long address.

{|{{prettytable}}
|+Primary pointer location
!USA
!JP
!GER
|-
|{{0x|15AFA}}, {{0x|15B01}}, {{0x|15B08}}, {{0x|15B0F}}
|{{0x|1585E}}, {{0x|15865}}, {{0x|1586C}}, {{0x|15873}}
|{{0x|15B7C}}, {{0x|15B83}}, {{0x|15B8A}}, {{0x|15B91}}
|}

The data has a total max in little endian at:

{|{{prettytable}}
|+Total max location
!USA
|-
|{{Address|0x|8896||2}}
|}

* In the USA version, the data is located at {{$|0271DE}} to {{$|027369}}.
<Blockquote>
4 bytes per entry:
{{red|a a }}{{blue|x }} {{green|y}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the block (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the block (expressed as tilemap coordinate)
</blockquote>

===(Inter Room) Torch Data===
The torch data has three primary pointer locations. The pointers are stored as a long address.

{|{{prettytable}}
|+Primary pointer location
!USA
!JP
!GER
|-
|{{0x|15B16}}, {{0x|15B1D}}, {{0x|15B24}}
|{{0x|1587A}}, {{0x|15881}}, {{0x|15888}}
|{{0x|15B98}}, {{0x|15B9F}}, {{0x|15BA6}}
|}

* In the USA version, the data goes from {{0x|2736A}} to {{0x|27489}}.
<Blockquote>
Consists of variable length segments consisting of:

{{red|a a }}{{blue|x }}{{green|y }}{{blue|x }}{{green|y }}{{hex|... }}{{$|FFFF}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the torch (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the torch (expressed as tilemap coordinate)
*{{$|FFFF}}: Delimeter
</blockquote>

===Chest Contents===
The chest contents have three primary pointer locations. The values at each location point to the same pointer. Yes, you read that right. The pointer is stored as a long address.

{|{{prettytable}}
|+Primary pointer location
!USA
!JP
!GER
|-
|{{0x|EBFB}}, {{0x|EC0A}}, {{0x|EC10}}
|{{0x|EC08}}, {{0x|EC17}}, {{0x|EC26}}
|{{0x|EBD5}}, {{0x|EBE4}}, {{0x|EBF3}}
|}

The addresses below contain the size limit for the data for each region:

{|{{prettytable}}
|+Max Size
!USA
!JP
!GER
|-
|{{0x|EBF6}}
|{{0x|EBF4}}
|{{0x|EBD0}}
|}

*In the original USA version the data goes from {{$|00E96E}} to {{$|00EB65}}.
<blockquote>
Array of chest information in 3 byte chunks. 168 entries in all ({{0x|A8}})

*First word - Room number it is located in. MSB determines whether it is a big chest or not. (big chest if set)
*Last byte - index of the type of item contained in the chest.
</blockquote>

==Room layout==
In Hyrule Magic, there's a label and textbox for room layouts. The layout value goes from {{$|0}} to {{$|7}}

The location:

{|{{prettytable}}
!USA
!JP
|-
|{{0x|26F2F}}
|{{0x|26C0F}}
|}

In the aforementioned location, there are 8 long pointers (Lo-Hi-Bank).

==Entrance Data==
There are {{$|85}} (Decimal: 133) normal entrances to the underworld from the overworld, and {{$|7}} (Decimal: 7) starting locations.
Normal entrances and starting locations use mostly the same types of data formatted the same, however they are located in different places in the ROM.
They are located and formatted thus:

===Entrance Room===
*{{$|014813}} to {{$|01491C}} = Normal Entrance Data
*{{$|015B6E}} to {{$|015B7B}} = Starting Location Data
<blockquote>
Each entry is a 2 byte Room ID where the player is placed after using an entrance.
</blockquote>

===Scroll Edges===
*{{$|01491D}} to {{$|014D44}} = Normal Entrance Data
*{{$|015B7C}} to {{$|015BB3}} = Starting Location Data
<blockquote>
Unsure about what these do exactly.
Each entry is 8 bytes long.
*Format: 1 byte each. Corresponds to hyrule magic values in the "More" a.k.a. Entrance Properties dialog box.
**HU -
**FU -
**HD -
**FD -
**HL -
**FL -
**HR -
**FR -
</blockquote>

===X Scroll===
*{{$|014D45}} to {{$|014E4E}} = Normal Entrance Data
*{{$|015BB4}} to {{$|015BC1}} = Starting Location Data
<blockquote>

</blockquote>

===Y Scroll===
*{{$|014E4F}} to {{$|014F58}} = Normal Entrance Data
*{{$|015BC2}} to {{$|015BCF}} = Starting Location Data
<blockquote>

</blockquote>

===X Coordinate===
*{{$|014F59}} to {{$|015062}} = Normal Entrance Data
*{{$|015BD0}} to {{$|015BDD}} = Starting Location Data
<blockquote>
Each entry is a 2 byte X coordinate where the player starts after using the corresponding entrance.
</blockquote>

===Y Coordinate===
*{{$|015063}} to {{$|01516C}} = Normal Entrance Data
*{{$|015BDE}} to {{$|015BEB}} = Starting Location Data
<blockquote>
Each entry is a 2 byte y coordinate where the player starts after using the corresponding entrance.
</blockquote>

===X Camera Coordinate===
*{{$|01516D}} to {{$|015276}} = Normal Entrance Data
*{{$|015BEC}} to {{$|015BF9}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

===Y Camera Coordinate===
*{{$|015277}} to {{$|015380}} = Normal Entrance Data
*{{$|015BFA}} to {{$|015C07}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

===Entrance Blockset===
*{{$|015381}} to {{$|015405}} = Normal Entrance Data
*{{$|015C08}} to {{$|015C0E}} = Starting Location Data
<blockquote>
1 byte each. This blockset affects walls and a few other things and persists through all rooms the player accesses from this entrance.
</blockquote>

===Floor Values===
*{{$|015406}} to {{$|01548A}} = Normal Entrance Data
*{{$|015C0F}} to {{$|015C15}} = Starting Location Data
<blockquote>
This tells us what kind of properties the floor has. 1 byte each:
*If 1, then it has floors that you can fall through to the next level
*If 0, I think it means it can be fallen down to
*If -1, has no pits
*If -2, ????
</blockquote>

===Dungeon Values===
*{{$|01548B}} to {{$|01550F}} = Normal Entrance Data
*{{$|015C16}} to {{$|015C1C}} = Starting Location Data
<blockquote>
1 Byte each.
Dungeons actually in the game are numbered like so {{$|00}}, {{$|02}}, {{$|04}}, ..., {{$|18}}, {{$|1A}}.
{{$|1C}} and {{$|1E}} are unused (and hence could potentially be added.) Notice they are all even numbers.
In asm routines these values are divided by two sometimes to provide an index into other arrays.
That's why. The definition of a "dungeon" is something with a key, compass, and map.

A value of {{$|FF}} (-1) denotes it doesn't belong to a dungeon.
</blockquote>

===Doorway Type===
*{{$|015510}} to {{$|015594}} = Normal Entrance Data
*{{$|015C2B}} to {{$|015C31}} = Starting Location Data
<blockquote>
This is used only when you exit the given room. For example, let's say you enter through a skull doorway in Skullwoods.
But that's not really a door way, it's just a set of tiles that are no different from a hole you might create after picking
up a big rock. But if you entered from a building door, the game has to know whether to put the door frame when you exit.
*1 byte:
**{{hex|0}} = no doorway when exiting
**{{hex|1}} = draws a door frame upon exiting
**{{hex|2}} = ???? HM says vertical doorframe. But in the original game, no doorway is vertical.

</blockquote>

===Ladder And BG Settings===
*{{$|015595}} to {{$|015619}} = Normal Entrance Data
*{{$|015C1D}} to {{$|015C23}} = Starting Location Data
<blockquote>
*1 byte each, with the following 2 bit layout: {{hex|xxx}}{{red|a}}{{pink|xxx}}{{blue|b}}
**{{hex|x}} - unimportant
**{{red|a}} - if set, then Link enters on the lower level (BG2)
**{{blue|b}} - if set... not sure what happens exactly. Check the game engine to be sure.
</blockquote>

===Horizontal And Vertical Scroll Properties===
*{{$|01561A}} to {{$|01569E}} = Normal Entrance Data
*{{$|015C24}} to {{$|015C2A}} = Starting Location Data
<blockquote>
For these, I guess if the flags in the appropriate places are set, then the room will be able to scroll in those directions.

*1 byte each, with the following layout: {{hex|xx}}{{red|a}}{{hex|xxx}}{{blue|b}}{{hex|x}}
**{{red|a}} - Horizontal flag
**{{blue|b}} - Vertical flag
</blockquote>

===Scroll Quadrant===
*{{$|01569F}} to {{$|015723}} = Normal Entrance Data
<blockquote>
*1 byte each, has four different expected values:
**0h, 2h, 10h, 12h
</blockquote>

===Exit Door Location===
*{{$|015724}} to {{$|01582D}} = Normal Entrance Data
*{{$|015C32}} to {{$|015C3F}} = Starting Location Data
<blockquote>
1 word each. Denotes X and Y coordinates for overworld?
</blockquote>

===Music===
*{{$|01582E}} to {{$|0158B2}} = Normal Entrance Data (JP: 15592 - 15616)
*{{$|015C4E}} to {{$|015C54}} = Starting Location Data
<blockquote>
1 byte each. A value of {{$|FF}} plays the same music as the overworld screen from which the player entered.
</blockquote>

===Entrance Values===
*{{$|015C40}} to {{$|015C4D}} = Starting Location Data
<blockquote>
1 word each. Since the starting locations have to reference an entrance, this is necessary.
</blockquote>

{{toc}}

Underworld:Important Hex Addresses

2017-12-24T00:14:12Z

Tatters: /* Object Data */

{{subpage|Underworld}}

==Room Data==
===Room Headers===
*{{$|027502}} to {{$|027781}} = Pointer Table, {{hex|2}} byte local addresses, indexed by room ID.
*{{$|027781}} to {{$|027FEF}} = Data

<blockquote>
Headers are {{$|0E}} (Decimal: 14) bytes formatted thusly:
*Byte {{hex|0}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
**The {{red|a}} bits are transformed into {{hex|0000 0}}{{red|aaa}} and stored to {{$|0414}} ("BG2" in Hyrule Magic)
**The {{blue|b}} bits are transformed into {{hex|0000 0}}{{blue|bbb}} and stored to {{$|046C}} ("Collision" in Hyrule Magic)
**The {{green|c}} bit is unused
**The {{purple|d}} bit is stored to {{$|7EC005}} (If set, use a lights out routine in the room transition)

*Byte {{hex|1}}: {{red|aa}}{{blue|bb bbbb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{blue|bbbb bb}}{{hex|00}}, thus making them a multiple of 4.
This value is used to load 4 different palettes for the dungeon, and corresponds to, you guessed it, Palette # in Hyrule Magic!

The resulting index is used to load values for {{$|0AB6}}, {{$|0AAC}}, {{$|0AAD}}, and {{$|0AAE}}

*Byte {{hex|2}}: gets stored to {{$|0AA2}} (GFX # in Hyrule Magic)
*Byte {{hex|3}}: value + #$40 gets stored to {{$|0AA3}} (Sprite GFX # in Hyrule Magic)
*Byte {{hex|4}}: gets stored to {{$|00AD}} ("[[Room Effects|Effect]]" in Hyrule Magic)
*Byte {{hex|5}}: {{red|aa}}{{blue|bb bbbb}}
**{{red|a}} = ?
**The {{blue|b}} bits are "[[Room Tags|Tag1]]" in Hyrule Magic and gets stored to {{$|00AE}}.
*Byte {{hex|6}}: {{red|aa}}{{blue|bb bbbb}}
**{{red|a}} = ?
**The {{blue|b}} bits are "[[Room Tags|Tag2]]" in Hyrule Magic and get stored to {{$|00AF}}

These are the planes to use for bytes {{hex|9}} through {{hex|D}}. This determines which
BG you appear on, and possibly more.

*Byte {{hex|7}}: {{red|aa}}{{blue|bb}} {{green|cc}}{{purple|dd}}
**The {{red|a}} bits are transformed into {{hex|0000 00}}{{red|aa}} and stored to {{$|063F}}
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|063E}}
**The {{green|c}} bits are transformed into {{hex|0000 00}}{{green|cc}} and stored to {{$|063D}}
**The {{purple|d}} bits are transformed into {{hex|0000 00}}{{purple|dd}} and stored to {{$|063C}}

Note, the only safe values for a plane seem to be {{hex|0}},{{hex|1}}, or {{hex|2}}. Hyrule Magic
appears to violate this rule by letting you put {{hex|3}} down, but nothing higher.

*Byte {{hex|8}}: {{red|aaaa aa}}{{blue|bb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|0640}}

*Byte {{hex|9}}: stored to {{$|7EC000}} These are all room numbers that you could possibly exit to.
*Byte {{hex|A}}: stored to {{$|7EC001}}
*Byte {{hex|B}}: stored to {{$|7EC002}}
*Byte {{hex|C}}: stored to {{$|7EC003}}
*Byte {{hex|D}}: stored to {{$|7EC004}}
</blockquote>

===Sprite Data===
* {{$|04D62E}} to {{$|04D92E}} = Pointer Table, 2 byte local addresses, indexed by room.
* {{$|04D92E}} to {{$|04EC9D}} = Data

<blockquote>
Sprite data is formatted thusly:
*Byte {{hex|0}}: Stored to {{$|0FB3}}. Corresponds with "Sort Spr" in Hyrule Magic. In a layered room this indicates sprites in the foreground are to be drawn on top of sprites in the background.
**Bit {{hex|0}} - If {{hex|0}}, sprites will sort
**Bits {{hex|7,6,5,4,3,2,1}} - Unknown, should all be {{hex|1}}
After the byte {{hex|0}}, you will see 3 byte clusters that break down thus:

*Byte {{hex|0}}:
**Bits {{hex|4,3,2,1,0}} - Y coordinate (in pixels from the top, starting at {{hex|0}}) of the sprite divided by 16.
**Bits {{hex|6,5}} - If these are set, they will be used to generate a subtype, stored to {{$|0E30}}, X.
**Bit {{hex|7}} - If set, the sprite is on BG2, if not it's on BG1
* Byte {{hex|1}}:
** Bits {{hex|4,3,2,1,0}} - X coordinate (in pixels from the far left, starting at {{hex|0}}) of the sprite divided by 16.
** Bits {{hex|7,6,5}} - If all these bits are set then this is an Overlord, otherwise it's a normal sprite. If only some of them are set they can be used to generate a subtype, stored at {{$|0E30}}, X
* Byte {{hex|2}}: Sprite or Overlord type. If a sprite, this will get loaded into a slot at {{$|0E20}}, X. If an Overlord, will get loaded to {{$|0B00}}, X.

The array is terminated with a byte of {{$|FF}}.
</blockquote>

===Object Data===
====Data location====
* {{$|0F8000}} to {{$|0F83BF}} = Pointer Table, 3 byte long addresses, indexed by room ID.
* {{$|01EBA0}} to {{$|01FFF4}} = Data
* {{$|050000}} to {{$|053729}} = Data
* {{$|0F8780}} to {{$|0FFF4D}} = Data

====Byte layout====
* Byte 0: {{red|aaaa}} {{blue|bbbb}}.
**The a bits are transformed to {{red|aaaa}}{{hex|0000}} and select the type of empty space to fill in. Hyrule Magic calls this 'Floor 1' - Gets stored to {{$|7E0490}}
**The b bits are transformed to {{blue|bbbb}}{{hex|0000}} and are the what Hyrule Magic calls 'Floor 2' - Gets stored to {{$|7E046A}}

* Byte {{hex|1}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
** The {{red|a}} bits are unused and should not be used
** The {{blue|b}} bits determine the room's layout type, ranging from {{hex|0}} to {{hex|7}}.
** The {{green|c}} and {{purple|d}} bits are unknown, but I have a feeling it's related to {{$|AA}} and {{$|A9}}

After that the bytes come in {{hex|3}} or {{hex|2}} byte object structures, used by routine {{$|01:88E4}}. Objects are loaded until an object with value {{0x|FFFF}} occurs. If a value {{0x|FFF0}} is loaded, the game will start loading Type 2 objects and will not go back to loading Type 1 objects until it is time to load the next layer. (Layer as in HM, not to be confused with the SNES' Backgrounds.) A value of {{0x|FFFF}} will also terminate the loading of Type 2 objects. The routine immediately terminates if that happens during the loading of either object type.

=====Type 1 Object structure: (3 bytes)=====

* Byte {{hex|3}}: Routine to use. If this byte is ≥ {{0x|F8}} and < {{0x|FC}}, then it is a subtype 3 object. If the index is ≥ {{hex|FC}}, it is a subtype 2 object. If not, it is a subtype 1 object.

* Subtype 1 Objects, first and second byte
** High Byte: {{brown|yyyy yy}}{{green|cc}}
** Low Byte: {{grey|xxxx xx}}{{red|aa}}
*** The {{red|a}} bits are stored to {{$|B2}}
*** The {{green|c}} bits are stored to {{$|B4}}
*** The {{grey|x}} and {{brown|y}} bits are transformed into: {{hex|000}}{{brown|y yyyy y}}{{grey|xxx xxx}}{{hex|0}} - This is a tilemap address that indexes into {{$|7E2000}} and / or {{$|7E4000}}

Use Byte {{hex|3}} * 2 as an index into the table at {{$|8200}}. This is the routine that is used to draw and otherwise handle the object. Subtype 1 objects have a maximum width and height of 4. Width and height are measured in terms of 32 {{x}} 32 pixels. (⟸ last part is questionable)

======Subtype 2 Objects, 1st, 2nd, & 3rd bytes======
** Byte {{hex|3}}: {{white|ff}}{{purple|dd dddd}}
** Byte {{hex|2}}: {{pink|eeee}} {{green|cccc}}
** Byte {{hex|1}}: {{red|aaaa aa}}{{blue|bb}}
***The {{red|a}} bits are unused, but after all they are the marker for this type of object subtype.
***The {{blue|b}}, {{green|c}}, {{pink|e}}, and {{white|f}} bits are transformed into a VRAM tilemap address: {{hex|000}}{{green|c ccc}}{{white|f}} {{white|f}}{{blue|bb}}{{pink|e eee}}{{hex|0}}

Might I add this is one messed up format? The {{purple|d}} bits are used as an index into the table at {{$|8470}}. Since such indices are going to be even, the {{purple|d}} bits are transformed into: {{hex|0000 0000 0}}{{purple|ddd ddd}}{{hex|0}}.

======Subtype 3 Objects======
**Similar to Subtype 1, with a few small exceptions.
**The vram address is calculated the same way. However, {{$|B2}} and {{$|B4}} are not used as length or width dimensions here. The routine that is used is determined as follows:
**Take the original index (times two) that a Subtype 1 would have used. AND that with {{0x|000E}}. Then shift left 3 times to produce {{hex|0000 0000 0}}{{pink|eee}} {{hex|0000}}. Then, OR in {{$|B2}} and {{$|B4}} and shift left once, so the final result is: {{hex|0000 0000}} {{pink|eee}}{{red|a a}}{{blue|bb}}{{hex|0}}.
**Also, this value indexes into {{$|85F0}} instead of {{$|8200}}.

=====Type 2 Object Structure: (2 bytes)=====
*High Byte: {{green|cccc cccc}}
*Low Byte: {{blue|bbbb}} {{purple|dd}}{{red|aa}}
**The {{red|a}} bits form a 2-bit value ({{hex|0000 0}}{{red|aa}}{{hex|0}}) that determines the routine to use for the object. In Hyrule Magic, corresponds to the "direction" of the door.
**The {{blue|b}} bits are transformed into {{hex|000}}{{blue|b bbb}}{{hex|0}} and stored to {{$|02}} ⟹ X. Corresponds to "Pos" of door objects in the Hyrule Magic. Note that these range from {{0x|00}} to {{0x|16}} (always even) which if you halve those values is 0 - 11 in decimal. This is easily verifiable in Hyrule Magic.
**The {{green|c}} bits are shifted into the lower byte and stored to {{$|04}} ⟹ A and {{$|0A}}. This is later used to grab the tiles used to draw the door and the area below it. In Hyrule Magic, corresponds to "type". Note the type is 1/2 of the number listed here. This is because to avoid using an ASL A command, the {{green|c}} bits are always even.
**The {{purple|d}} bits are unused.

Next I'll go into the nitty gritty of the various types (the value of {{$|04}}). Again note that we'll only be dealing with even values {{blue|b}}/{{green|c}} that's what you'll see in the code. To convert between here [as well as the code] and Hyrule Magic, take the hex value here and divide by two. Convert to decimal and that's your Hyrule Magic "type."

*Types:
{|{{Prettytable}}
! ID
! Description
|-
|{{0x|00}}
|Basic door. Index = {{$|0460}}
|-
|{{0x|02}}
|Normal door?
|-
|{{0x|04}}
|???
|-
|{{0x|06}}
|???
|-
|{{0x|08}}
|Waterfall door (only used in Swamp palace; in one room at that!)
|-
|{{0x|0A}}
|???
|-
|{{0x|0C}}
|Trap door (probably other types but this seems to be most common)
|-
|{{0x|12}}
|Adds a property to some doors allowing you to exit to the overworld (this is accomplished by writing to the tile attribute map)
|-
|{{0x|14}}
|Transition to dark room?
|-
|{{0x|16}}
|Toggles the target BG Link will emerge on. '''Ex.''' if Link starts on BG0 in the next room he'll be on BG1.
|-
|{{0x|20}}
| rowspan="2"|Locked door specifically for BG0.
|-
|{{0x|22}}
|-
|{{0x|24}}
| rowspan="2"|Locked door for either BG0 or BG1
|-
|{{0x|26}}
|-
|{{0x|30}}
|Large exploded pathway resulting from a switch being pulled (unusual to have as a door as it's huge)
|-
|{{0x|32}}
|Sword activated door. '''Ex.''' Agahnim's room with the curtain door you have to slash.
|-
|{{0x|46}}
|warp door?
|}
</blockquote>

===Dungeon Secrets Data===
* {{$|00DB69}} to {{$|00DDE8}} = Pointer Table, 2 byte local addresses, indexed by room ID.
* {{$|00DDE9}} to {{$|00E6B1}} = Data
<blockquote>
Data comes in 3 byte chunks and is terminated by an instance of {{$|FFFF}}

* Bytes {{hex|0}}, {{hex|1}}: A word that denotes the VRAM address that the item is found at. This identifies the item as belonging to that part of the screen.
* Byte {{hex|2}}: Identifies the type of item that is hiding there. E.g. {{$|08}} is a key
</blockquote>

===Push Block Data===
The block data has three primary pointer locations. The pointer is stored as a long address.

{|{{prettytable}}
|+Primary pointer location
!USA
!JP
!GER
|-
|{{0x|15AFA}}, {{0x|15B01}}, {{0x|15B08}}, {{0x|15B0F}}
|{{0x|1585E}}, {{0x|15865}}, {{0x|1586C}}, {{0x|15873}}
|{{0x|15B7C}}, {{0x|15B83}}, {{0x|15B8A}}, {{0x|15B91}}
|}

The data has a total max in little endian at:

{|{{prettytable}}
|+Total max location
!USA
|-
|{{Address|0x|8896||2}}
|}

* In the USA version, the data is located at {{$|0271DE}} to {{$|027369}}.
<Blockquote>
4 bytes per entry:
{{red|a a }}{{blue|x }} {{green|y}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the block (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the block (expressed as tilemap coordinate)
</blockquote>

===(Inter Room) Torch Data===
The torch data has three primary pointer locations. The pointers are stored as a long address.

{|{{prettytable}}
|+Primary pointer location
!USA
!JP
!GER
|-
|{{0x|15B16}}, {{0x|15B1D}}, {{0x|15B24}}
|{{0x|1587A}}, {{0x|15881}}, {{0x|15888}}
|{{0x|15B98}}, {{0x|15B9F}}, {{0x|15BA6}}
|}

* In the USA version, the data goes from {{0x|2736A}} to {{0x|27489}}.
<Blockquote>
Consists of variable length segments consisting of:

{{red|a a }}{{blue|x }}{{green|y }}{{blue|x }}{{green|y }}{{hex|... }}{{$|FFFF}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the torch (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the torch (expressed as tilemap coordinate)
*{{$|FFFF}}: Delimeter
</blockquote>

===Chest Contents===
The chest contents have three primary pointer locations. The values at each location point to the same pointer. Yes, you read that right. The pointer is stored as a long address.

{|{{prettytable}}
|+Primary pointer location
!USA
!JP
!GER
|-
|{{0x|EBFB}}, {{0x|EC0A}}, {{0x|EC10}}
|{{0x|EC08}}, {{0x|EC17}}, {{0x|EC26}}
|{{0x|EBD5}}, {{0x|EBE4}}, {{0x|EBF3}}
|}

The addresses below contain the size limit for the data for each region:

{|{{prettytable}}
|+Max Size
!USA
!JP
!GER
|-
|{{0x|EBF6}}
|{{0x|EBF4}}
|{{0x|EBD0}}
|}

*In the original USA version the data goes from {{$|00E96E}} to {{$|00EB65}}.
<blockquote>
Array of chest information in 3 byte chunks. 168 entries in all ({{0x|A8}})

*First word - Room number it is located in. MSB determines whether it is a big chest or not. (big chest if set)
*Last byte - index of the type of item contained in the chest.
</blockquote>

==Room layout==
In Hyrule Magic, there's a label and textbox for room layouts. The layout value goes from {{$|0}} to {{$|7}}

The location:

{|{{prettytable}}
!USA
!JP
|-
|{{0x|26F2F}}
|{{0x|26C0F}}
|}

In the aforementioned location, there are 8 long pointers (Lo-Hi-Bank).

==Entrance Data==
There are {{$|85}} (Decimal: 133) normal entrances to the underworld from the overworld, and {{$|7}} (Decimal: 7) starting locations.
Normal entrances and starting locations use mostly the same types of data formatted the same, however they are located in different places in the ROM.
They are located and formatted thus:

===Entrance Room===
*{{$|014813}} to {{$|01491C}} = Normal Entrance Data
*{{$|015B6E}} to {{$|015B7B}} = Starting Location Data
<blockquote>
Each entry is a 2 byte Room ID where the player is placed after using an entrance.
</blockquote>

===Scroll Edges===
*{{$|01491D}} to {{$|014D44}} = Normal Entrance Data
*{{$|015B7C}} to {{$|015BB3}} = Starting Location Data
<blockquote>
Unsure about what these do exactly.
Each entry is 8 bytes long.
*Format: 1 byte each. Corresponds to hyrule magic values in the "More" a.k.a. Entrance Properties dialog box.
**HU -
**FU -
**HD -
**FD -
**HL -
**FL -
**HR -
**FR -
</blockquote>

===X Scroll===
*{{$|014D45}} to {{$|014E4E}} = Normal Entrance Data
*{{$|015BB4}} to {{$|015BC1}} = Starting Location Data
<blockquote>

</blockquote>

===Y Scroll===
*{{$|014E4F}} to {{$|014F58}} = Normal Entrance Data
*{{$|015BC2}} to {{$|015BCF}} = Starting Location Data
<blockquote>

</blockquote>

===X Coordinate===
*{{$|014F59}} to {{$|015062}} = Normal Entrance Data
*{{$|015BD0}} to {{$|015BDD}} = Starting Location Data
<blockquote>
Each entry is a 2 byte X coordinate where the player starts after using the corresponding entrance.
</blockquote>

===Y Coordinate===
*{{$|015063}} to {{$|01516C}} = Normal Entrance Data
*{{$|015BDE}} to {{$|015BEB}} = Starting Location Data
<blockquote>
Each entry is a 2 byte y coordinate where the player starts after using the corresponding entrance.
</blockquote>

===X Camera Coordinate===
*{{$|01516D}} to {{$|015276}} = Normal Entrance Data
*{{$|015BEC}} to {{$|015BF9}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

===Y Camera Coordinate===
*{{$|015277}} to {{$|015380}} = Normal Entrance Data
*{{$|015BFA}} to {{$|015C07}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

===Entrance Blockset===
*{{$|015381}} to {{$|015405}} = Normal Entrance Data
*{{$|015C08}} to {{$|015C0E}} = Starting Location Data
<blockquote>
1 byte each. This blockset affects walls and a few other things and persists through all rooms the player accesses from this entrance.
</blockquote>

===Floor Values===
*{{$|015406}} to {{$|01548A}} = Normal Entrance Data
*{{$|015C0F}} to {{$|015C15}} = Starting Location Data
<blockquote>
This tells us what kind of properties the floor has. 1 byte each:
*If 1, then it has floors that you can fall through to the next level
*If 0, I think it means it can be fallen down to
*If -1, has no pits
*If -2, ????
</blockquote>

===Dungeon Values===
*{{$|01548B}} to {{$|01550F}} = Normal Entrance Data
*{{$|015C16}} to {{$|015C1C}} = Starting Location Data
<blockquote>
1 Byte each.
Dungeons actually in the game are numbered like so {{$|00}}, {{$|02}}, {{$|04}}, ..., {{$|18}}, {{$|1A}}.
{{$|1C}} and {{$|1E}} are unused (and hence could potentially be added.) Notice they are all even numbers.
In asm routines these values are divided by two sometimes to provide an index into other arrays.
That's why. The definition of a "dungeon" is something with a key, compass, and map.

A value of {{$|FF}} (-1) denotes it doesn't belong to a dungeon.
</blockquote>

===Doorway Type===
*{{$|015510}} to {{$|015594}} = Normal Entrance Data
*{{$|015C2B}} to {{$|015C31}} = Starting Location Data
<blockquote>
This is used only when you exit the given room. For example, let's say you enter through a skull doorway in Skullwoods.
But that's not really a door way, it's just a set of tiles that are no different from a hole you might create after picking
up a big rock. But if you entered from a building door, the game has to know whether to put the door frame when you exit.
*1 byte:
**{{hex|0}} = no doorway when exiting
**{{hex|1}} = draws a door frame upon exiting
**{{hex|2}} = ???? HM says vertical doorframe. But in the original game, no doorway is vertical.

</blockquote>

===Ladder And BG Settings===
*{{$|015595}} to {{$|015619}} = Normal Entrance Data
*{{$|015C1D}} to {{$|015C23}} = Starting Location Data
<blockquote>
*1 byte each, with the following 2 bit layout: {{hex|xxx}}{{red|a}}{{pink|xxx}}{{blue|b}}
**{{hex|x}} - unimportant
**{{red|a}} - if set, then Link enters on the lower level (BG2)
**{{blue|b}} - if set... not sure what happens exactly. Check the game engine to be sure.
</blockquote>

===Horizontal And Vertical Scroll Properties===
*{{$|01561A}} to {{$|01569E}} = Normal Entrance Data
*{{$|015C24}} to {{$|015C2A}} = Starting Location Data
<blockquote>
For these, I guess if the flags in the appropriate places are set, then the room will be able to scroll in those directions.

*1 byte each, with the following layout: {{hex|xx}}{{red|a}}{{hex|xxx}}{{blue|b}}{{hex|x}}
**{{red|a}} - Horizontal flag
**{{blue|b}} - Vertical flag
</blockquote>

===Scroll Quadrant===
*{{$|01569F}} to {{$|015723}} = Normal Entrance Data
<blockquote>
*1 byte each, has four different expected values:
**0h, 2h, 10h, 12h
</blockquote>

===Exit Door Location===
*{{$|015724}} to {{$|01582D}} = Normal Entrance Data
*{{$|015C32}} to {{$|015C3F}} = Starting Location Data
<blockquote>
1 word each. Denotes X and Y coordinates for overworld?
</blockquote>

===Music===
*{{$|01582E}} to {{$|0158B2}} = Normal Entrance Data (JP: 15592 - 15616)
*{{$|015C4E}} to {{$|015C54}} = Starting Location Data
<blockquote>
1 byte each. A value of {{$|FF}} plays the same music as the overworld screen from which the player entered.
</blockquote>

===Entrance Values===
*{{$|015C40}} to {{$|015C4D}} = Starting Location Data
<blockquote>
1 word each. Since the starting locations have to reference an entrance, this is necessary.
</blockquote>

{{toc}}

Underworld:Important Hex Addresses

2017-12-23T23:34:09Z

Tatters: /* Push Block Data */

{{subpage|Underworld}}

==Room Data==
===Room Headers===
*{{$|027502}} to {{$|027781}} = Pointer Table, {{hex|2}} byte local addresses, indexed by room ID.
*{{$|027781}} to {{$|027FEF}} = Data

<blockquote>
Headers are {{$|0E}} (Decimal: 14) bytes formatted thusly:
*Byte {{hex|0}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
**The {{red|a}} bits are transformed into {{hex|0000 0}}{{red|aaa}} and stored to {{$|0414}} ("BG2" in Hyrule Magic)
**The {{blue|b}} bits are transformed into {{hex|0000 0}}{{blue|bbb}} and stored to {{$|046C}} ("Collision" in Hyrule Magic)
**The {{green|c}} bit is unused
**The {{purple|d}} bit is stored to {{$|7EC005}} (If set, use a lights out routine in the room transition)

*Byte {{hex|1}}: {{red|aa}}{{blue|bb bbbb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{blue|bbbb bb}}{{hex|00}}, thus making them a multiple of 4.
This value is used to load 4 different palettes for the dungeon, and corresponds to, you guessed it, Palette # in Hyrule Magic!

The resulting index is used to load values for {{$|0AB6}}, {{$|0AAC}}, {{$|0AAD}}, and {{$|0AAE}}

*Byte {{hex|2}}: gets stored to {{$|0AA2}} (GFX # in Hyrule Magic)
*Byte {{hex|3}}: value + #$40 gets stored to {{$|0AA3}} (Sprite GFX # in Hyrule Magic)
*Byte {{hex|4}}: gets stored to {{$|00AD}} ("[[Room Effects|Effect]]" in Hyrule Magic)
*Byte {{hex|5}}: {{red|aa}}{{blue|bb bbbb}}
**{{red|a}} = ?
**The {{blue|b}} bits are "[[Room Tags|Tag1]]" in Hyrule Magic and gets stored to {{$|00AE}}.
*Byte {{hex|6}}: {{red|aa}}{{blue|bb bbbb}}
**{{red|a}} = ?
**The {{blue|b}} bits are "[[Room Tags|Tag2]]" in Hyrule Magic and get stored to {{$|00AF}}

These are the planes to use for bytes {{hex|9}} through {{hex|D}}. This determines which
BG you appear on, and possibly more.

*Byte {{hex|7}}: {{red|aa}}{{blue|bb}} {{green|cc}}{{purple|dd}}
**The {{red|a}} bits are transformed into {{hex|0000 00}}{{red|aa}} and stored to {{$|063F}}
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|063E}}
**The {{green|c}} bits are transformed into {{hex|0000 00}}{{green|cc}} and stored to {{$|063D}}
**The {{purple|d}} bits are transformed into {{hex|0000 00}}{{purple|dd}} and stored to {{$|063C}}

Note, the only safe values for a plane seem to be {{hex|0}},{{hex|1}}, or {{hex|2}}. Hyrule Magic
appears to violate this rule by letting you put {{hex|3}} down, but nothing higher.

*Byte {{hex|8}}: {{red|aaaa aa}}{{blue|bb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|0640}}

*Byte {{hex|9}}: stored to {{$|7EC000}} These are all room numbers that you could possibly exit to.
*Byte {{hex|A}}: stored to {{$|7EC001}}
*Byte {{hex|B}}: stored to {{$|7EC002}}
*Byte {{hex|C}}: stored to {{$|7EC003}}
*Byte {{hex|D}}: stored to {{$|7EC004}}
</blockquote>

===Sprite Data===
* {{$|04D62E}} to {{$|04D92E}} = Pointer Table, 2 byte local addresses, indexed by room.
* {{$|04D92E}} to {{$|04EC9D}} = Data

<blockquote>
Sprite data is formatted thusly:
*Byte {{hex|0}}: Stored to {{$|0FB3}}. Corresponds with "Sort Spr" in Hyrule Magic. In a layered room this indicates sprites in the foreground are to be drawn on top of sprites in the background.
**Bit {{hex|0}} - If {{hex|0}}, sprites will sort
**Bits {{hex|7,6,5,4,3,2,1}} - Unknown, should all be {{hex|1}}
After the byte {{hex|0}}, you will see 3 byte clusters that break down thus:

*Byte {{hex|0}}:
**Bits {{hex|4,3,2,1,0}} - Y coordinate (in pixels from the top, starting at {{hex|0}}) of the sprite divided by 16.
**Bits {{hex|6,5}} - If these are set, they will be used to generate a subtype, stored to {{$|0E30}}, X.
**Bit {{hex|7}} - If set, the sprite is on BG2, if not it's on BG1
* Byte {{hex|1}}:
** Bits {{hex|4,3,2,1,0}} - X coordinate (in pixels from the far left, starting at {{hex|0}}) of the sprite divided by 16.
** Bits {{hex|7,6,5}} - If all these bits are set then this is an Overlord, otherwise it's a normal sprite. If only some of them are set they can be used to generate a subtype, stored at {{$|0E30}}, X
* Byte {{hex|2}}: Sprite or Overlord type. If a sprite, this will get loaded into a slot at {{$|0E20}}, X. If an Overlord, will get loaded to {{$|0B00}}, X.

The array is terminated with a byte of {{$|FF}}.
</blockquote>

===Object Data===
* {{$|0F8000}} to {{$|0F83BF}} = Pointer Table, 3 byte long addresses, indexed by room ID.
* {{$|01EBA0}} to {{$|01FFF4}} = Data
* {{$|050000}} to {{$|053729}} = Data
* {{$|0F8780}} to {{$|0FFF4D}} = Data
<blockquote>
Byte layout:

* Byte 0: {{red|aaaa}} {{blue|bbbb}}.
**The a bits are transformed to {{red|aaaa}}{{hex|0000}} and select the type of empty space to fill in. Hyrule Magic calls this 'Floor 1' - Gets stored to {{$|7E0490}}
**The b bits are transformed to {{blue|bbbb}}{{hex|0000}} and are the what Hyrule Magic calls 'Floor 2' - Gets stored to {{$|7E046A}}

* Byte {{hex|1}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
** The {{red|a}} bits are unused and should not be used
** The {{blue|b}} bits determine the room's layout type, ranging from {{hex|0}} to {{hex|7}}.
** The {{green|c}} and {{purple|d}} bits are unknown, but I have a feeling it's related to {{$|AA}} and {{$|A9}}

After that the bytes come in {{hex|3}} or {{hex|2}} byte object structures, used by routine {{$|01:88E4}}. Objects are loaded until an object with value {{0x|FFFF}} occurs. If a value {{0x|FFF0}} is loaded, the game will start loading Type 2 objects and will not go back to loading Type 1 objects until it is time to load the next layer. (Layer as in HM, not to be confused with the SNES' Backgrounds.) A value of {{0x|FFFF}} will also terminate the loading of Type 2 objects. The routine immediately terminates if that happens during the loading of either object type.

Type 1 Object structure: (3 bytes):

* Byte {{hex|3}}: Routine to use. If this byte is ≥ {{0x|F8}} and < {{0x|FC}}, then it is a subtype 3 object. If the index is ≥ {{hex|FC}}, it is a subtype 2 object. If not, it is a subtype 1 object.

* Subtype 1 Objects, first and second byte
** High Byte: {{brown|yyyy yy}}{{green|cc}}
** Low Byte: {{grey|xxxx xx}}{{red|aa}}
*** The {{red|a}} bits are stored to {{$|B2}}
*** The {{green|c}} bits are stored to {{$|B4}}
*** The {{grey|x}} and {{brown|y}} bits are transformed into: {{hex|000}}{{brown|y yyyy y}}{{grey|xxx xxx}}{{hex|0}} - This is a tilemap address that indexes into {{$|7E2000}} and / or {{$|7E4000}}

Use Byte {{hex|3}} * 2 as an index into the table at {{$|8200}}. This is the routine that is used to draw and otherwise handle the object. Subtype 1 objects have a maximum width and height of 4. Width and height are measured in terms of 32 {{x}} 32 pixels. (⟸ last part is questionable)

*Subtype 2 Objects, 1st, 2nd, & 3rd bytes:
** Byte {{hex|3}}: {{white|ff}}{{purple|dd dddd}}
** Byte {{hex|2}}: {{pink|eeee}} {{green|cccc}}
** Byte {{hex|1}}: {{red|aaaa aa}}{{blue|bb}}
***The {{red|a}} bits are unused, but after all they are the marker for this type of object subtype.
***The {{blue|b}}, {{green|c}}, {{pink|e}}, and {{white|f}} bits are transformed into a VRAM tilemap address: {{hex|000}}{{green|c ccc}}{{white|f}} {{white|f}}{{blue|bb}}{{pink|e eee}}{{hex|0}}

Might I add this is one messed up format? The {{purple|d}} bits are used as an index into the table at {{$|8470}}. Since such indices are going to be even, the {{purple|d}} bits are transformed into: {{hex|0000 0000 0}}{{purple|ddd ddd}}{{hex|0}}.

*Subtype 3 Objects
**Similar to Subtype 1, with a few small exceptions.
**The vram address is calculated the same way. However, {{$|B2}} and {{$|B4}} are not used as length or width dimensions here. The routine that is used is determined as follows:
**Take the original index (times two) that a Subtype 1 would have used. AND that with {{0x|000E}}. Then shift left 3 times to produce {{hex|0000 0000 0}}{{pink|eee}} {{hex|0000}}. Then, OR in {{$|B2}} and {{$|B4}} and shift left once, so the final result is: {{hex|0000 0000}} {{pink|eee}}{{red|a a}}{{blue|bb}}{{hex|0}}.
**Also, this value indexes into {{$|85F0}} instead of {{$|8200}}.

Type 2 Object Structure: (2 bytes)
*High Byte: {{green|cccc cccc}}
*Low Byte: {{blue|bbbb}} {{purple|dd}}{{red|aa}}
**The {{red|a}} bits form a 2-bit value ({{hex|0000 0}}{{red|aa}}{{hex|0}}) that determines the routine to use for the object. In Hyrule Magic, corresponds to the "direction" of the door.
**The {{blue|b}} bits are transformed into {{hex|000}}{{blue|b bbb}}{{hex|0}} and stored to {{$|02}} ⟹ X. Corresponds to "Pos" of door objects in the Hyrule Magic. Note that these range from {{0x|00}} to {{0x|16}} (always even) which if you halve those values is 0 - 11 in decimal. This is easily verifiable in Hyrule Magic.
**The {{green|c}} bits are shifted into the lower byte and stored to {{$|04}} ⟹ A and {{$|0A}}. This is later used to grab the tiles used to draw the door and the area below it. In Hyrule Magic, corresponds to "type". Note the type is 1/2 of the number listed here. This is because to avoid using an ASL A command, the {{green|c}} bits are always even.
**The {{purple|d}} bits are unused.

Next I'll go into the nitty gritty of the various types (the value of {{$|04}}). Again note that we'll only be dealing with even values {{blue|b}}/{{green|c}} that's what you'll see in the code. To convert between here [as well as the code] and Hyrule Magic, take the hex value here and divide by two. Convert to decimal and that's your Hyrule Magic "type."

*Types:
{|{{Prettytable}}
! ID
! Description
|-
|{{0x|00}}
|Basic door. Index = {{$|0460}}
|-
|{{0x|02}}
|Normal door?
|-
|{{0x|04}}
|???
|-
|{{0x|06}}
|???
|-
|{{0x|08}}
|Waterfall door (only used in Swamp palace; in one room at that!)
|-
|{{0x|0A}}
|???
|-
|{{0x|0C}}
|Trap door (probably other types but this seems to be most common)
|-
|{{0x|12}}
|Adds a property to some doors allowing you to exit to the overworld (this is accomplished by writing to the tile attribute map)
|-
|{{0x|14}}
|Transition to dark room?
|-
|{{0x|16}}
|Toggles the target BG Link will emerge on. '''Ex.''' if Link starts on BG0 in the next room he'll be on BG1.
|-
|{{0x|20}}
| rowspan="2"|Locked door specifically for BG0.
|-
|{{0x|22}}
|-
|{{0x|24}}
| rowspan="2"|Locked door for either BG0 or BG1
|-
|{{0x|26}}
|-
|{{0x|30}}
|Large exploded pathway resulting from a switch being pulled (unusual to have as a door as it's huge)
|-
|{{0x|32}}
|Sword activated door. '''Ex.''' Agahnim's room with the curtain door you have to slash.
|-
|{{0x|46}}
|warp door?
|}
</blockquote>

===Dungeon Secrets Data===
* {{$|00DB69}} to {{$|00DDE8}} = Pointer Table, 2 byte local addresses, indexed by room ID.
* {{$|00DDE9}} to {{$|00E6B1}} = Data
<blockquote>
Data comes in 3 byte chunks and is terminated by an instance of {{$|FFFF}}

* Bytes {{hex|0}}, {{hex|1}}: A word that denotes the VRAM address that the item is found at. This identifies the item as belonging to that part of the screen.
* Byte {{hex|2}}: Identifies the type of item that is hiding there. E.g. {{$|08}} is a key
</blockquote>

===Push Block Data===
The block data has three primary pointer locations. The pointer is stored as a long address.

{|{{prettytable}}
|+Primary pointer location
!USA
!JP
!GER
|-
|{{0x|15AFA}}, {{0x|15B01}}, {{0x|15B08}}, {{0x|15B0F}}
|{{0x|1585E}}, {{0x|15865}}, {{0x|1586C}}, {{0x|15873}}
|{{0x|15B7C}}, {{0x|15B83}}, {{0x|15B8A}}, {{0x|15B91}}
|}

The data has a total max in little endian at:

{|{{prettytable}}
|+Total max location
!USA
|-
|{{Address|0x|8896||2}}
|}

* In the USA version, the data is located at {{$|0271DE}} to {{$|027369}}.
<Blockquote>
4 bytes per entry:
{{red|a a }}{{blue|x }} {{green|y}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the block (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the block (expressed as tilemap coordinate)
</blockquote>

===(Inter Room) Torch Data===
The torch data has three primary pointer locations. The pointers are stored as a long address.

{|{{prettytable}}
|+Primary pointer location
!USA
!JP
!GER
|-
|{{0x|15B16}}, {{0x|15B1D}}, {{0x|15B24}}
|{{0x|1587A}}, {{0x|15881}}, {{0x|15888}}
|{{0x|15B98}}, {{0x|15B9F}}, {{0x|15BA6}}
|}

* In the USA version, the data goes from {{0x|2736A}} to {{0x|27489}}.
<Blockquote>
Consists of variable length segments consisting of:

{{red|a a }}{{blue|x }}{{green|y }}{{blue|x }}{{green|y }}{{hex|... }}{{$|FFFF}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the torch (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the torch (expressed as tilemap coordinate)
*{{$|FFFF}}: Delimeter
</blockquote>

===Chest Contents===
The chest contents have three primary pointer locations. The values at each location point to the same pointer. Yes, you read that right. The pointer is stored as a long address.

{|{{prettytable}}
|+Primary pointer location
!USA
!JP
!GER
|-
|{{0x|EBFB}}, {{0x|EC0A}}, {{0x|EC10}}
|{{0x|EC08}}, {{0x|EC17}}, {{0x|EC26}}
|{{0x|EBD5}}, {{0x|EBE4}}, {{0x|EBF3}}
|}

The addresses below contain the size limit for the data for each region:

{|{{prettytable}}
|+Max Size
!USA
!JP
!GER
|-
|{{0x|EBF6}}
|{{0x|EBF4}}
|{{0x|EBD0}}
|}

*In the original USA version the data goes from {{$|00E96E}} to {{$|00EB65}}.
<blockquote>
Array of chest information in 3 byte chunks. 168 entries in all ({{0x|A8}})

*First word - Room number it is located in. MSB determines whether it is a big chest or not. (big chest if set)
*Last byte - index of the type of item contained in the chest.
</blockquote>

==Room layout==
In Hyrule Magic, there's a label and textbox for room layouts. The layout value goes from {{$|0}} to {{$|7}}

The location:

{|{{prettytable}}
!USA
!JP
|-
|{{0x|26F2F}}
|{{0x|26C0F}}
|}

In the aforementioned location, there are 8 long pointers (Lo-Hi-Bank).

==Entrance Data==
There are {{$|85}} (Decimal: 133) normal entrances to the underworld from the overworld, and {{$|7}} (Decimal: 7) starting locations.
Normal entrances and starting locations use mostly the same types of data formatted the same, however they are located in different places in the ROM.
They are located and formatted thus:

===Entrance Room===
*{{$|014813}} to {{$|01491C}} = Normal Entrance Data
*{{$|015B6E}} to {{$|015B7B}} = Starting Location Data
<blockquote>
Each entry is a 2 byte Room ID where the player is placed after using an entrance.
</blockquote>

===Scroll Edges===
*{{$|01491D}} to {{$|014D44}} = Normal Entrance Data
*{{$|015B7C}} to {{$|015BB3}} = Starting Location Data
<blockquote>
Unsure about what these do exactly.
Each entry is 8 bytes long.
*Format: 1 byte each. Corresponds to hyrule magic values in the "More" a.k.a. Entrance Properties dialog box.
**HU -
**FU -
**HD -
**FD -
**HL -
**FL -
**HR -
**FR -
</blockquote>

===X Scroll===
*{{$|014D45}} to {{$|014E4E}} = Normal Entrance Data
*{{$|015BB4}} to {{$|015BC1}} = Starting Location Data
<blockquote>

</blockquote>

===Y Scroll===
*{{$|014E4F}} to {{$|014F58}} = Normal Entrance Data
*{{$|015BC2}} to {{$|015BCF}} = Starting Location Data
<blockquote>

</blockquote>

===X Coordinate===
*{{$|014F59}} to {{$|015062}} = Normal Entrance Data
*{{$|015BD0}} to {{$|015BDD}} = Starting Location Data
<blockquote>
Each entry is a 2 byte X coordinate where the player starts after using the corresponding entrance.
</blockquote>

===Y Coordinate===
*{{$|015063}} to {{$|01516C}} = Normal Entrance Data
*{{$|015BDE}} to {{$|015BEB}} = Starting Location Data
<blockquote>
Each entry is a 2 byte y coordinate where the player starts after using the corresponding entrance.
</blockquote>

===X Camera Coordinate===
*{{$|01516D}} to {{$|015276}} = Normal Entrance Data
*{{$|015BEC}} to {{$|015BF9}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

===Y Camera Coordinate===
*{{$|015277}} to {{$|015380}} = Normal Entrance Data
*{{$|015BFA}} to {{$|015C07}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

===Entrance Blockset===
*{{$|015381}} to {{$|015405}} = Normal Entrance Data
*{{$|015C08}} to {{$|015C0E}} = Starting Location Data
<blockquote>
1 byte each. This blockset affects walls and a few other things and persists through all rooms the player accesses from this entrance.
</blockquote>

===Floor Values===
*{{$|015406}} to {{$|01548A}} = Normal Entrance Data
*{{$|015C0F}} to {{$|015C15}} = Starting Location Data
<blockquote>
This tells us what kind of properties the floor has. 1 byte each:
*If 1, then it has floors that you can fall through to the next level
*If 0, I think it means it can be fallen down to
*If -1, has no pits
*If -2, ????
</blockquote>

===Dungeon Values===
*{{$|01548B}} to {{$|01550F}} = Normal Entrance Data
*{{$|015C16}} to {{$|015C1C}} = Starting Location Data
<blockquote>
1 Byte each.
Dungeons actually in the game are numbered like so {{$|00}}, {{$|02}}, {{$|04}}, ..., {{$|18}}, {{$|1A}}.
{{$|1C}} and {{$|1E}} are unused (and hence could potentially be added.) Notice they are all even numbers.
In asm routines these values are divided by two sometimes to provide an index into other arrays.
That's why. The definition of a "dungeon" is something with a key, compass, and map.

A value of {{$|FF}} (-1) denotes it doesn't belong to a dungeon.
</blockquote>

===Doorway Type===
*{{$|015510}} to {{$|015594}} = Normal Entrance Data
*{{$|015C2B}} to {{$|015C31}} = Starting Location Data
<blockquote>
This is used only when you exit the given room. For example, let's say you enter through a skull doorway in Skullwoods.
But that's not really a door way, it's just a set of tiles that are no different from a hole you might create after picking
up a big rock. But if you entered from a building door, the game has to know whether to put the door frame when you exit.
*1 byte:
**{{hex|0}} = no doorway when exiting
**{{hex|1}} = draws a door frame upon exiting
**{{hex|2}} = ???? HM says vertical doorframe. But in the original game, no doorway is vertical.

</blockquote>

===Ladder And BG Settings===
*{{$|015595}} to {{$|015619}} = Normal Entrance Data
*{{$|015C1D}} to {{$|015C23}} = Starting Location Data
<blockquote>
*1 byte each, with the following 2 bit layout: {{hex|xxx}}{{red|a}}{{pink|xxx}}{{blue|b}}
**{{hex|x}} - unimportant
**{{red|a}} - if set, then Link enters on the lower level (BG2)
**{{blue|b}} - if set... not sure what happens exactly. Check the game engine to be sure.
</blockquote>

===Horizontal And Vertical Scroll Properties===
*{{$|01561A}} to {{$|01569E}} = Normal Entrance Data
*{{$|015C24}} to {{$|015C2A}} = Starting Location Data
<blockquote>
For these, I guess if the flags in the appropriate places are set, then the room will be able to scroll in those directions.

*1 byte each, with the following layout: {{hex|xx}}{{red|a}}{{hex|xxx}}{{blue|b}}{{hex|x}}
**{{red|a}} - Horizontal flag
**{{blue|b}} - Vertical flag
</blockquote>

===Scroll Quadrant===
*{{$|01569F}} to {{$|015723}} = Normal Entrance Data
<blockquote>
*1 byte each, has four different expected values:
**0h, 2h, 10h, 12h
</blockquote>

===Exit Door Location===
*{{$|015724}} to {{$|01582D}} = Normal Entrance Data
*{{$|015C32}} to {{$|015C3F}} = Starting Location Data
<blockquote>
1 word each. Denotes X and Y coordinates for overworld?
</blockquote>

===Music===
*{{$|01582E}} to {{$|0158B2}} = Normal Entrance Data (JP: 15592 - 15616)
*{{$|015C4E}} to {{$|015C54}} = Starting Location Data
<blockquote>
1 byte each. A value of {{$|FF}} plays the same music as the overworld screen from which the player entered.
</blockquote>

===Entrance Values===
*{{$|015C40}} to {{$|015C4D}} = Starting Location Data
<blockquote>
1 word each. Since the starting locations have to reference an entrance, this is necessary.
</blockquote>

{{toc}}

Underworld:Important Hex Addresses

2017-12-23T23:25:34Z

Tatters: /* Chest Contents */

{{subpage|Underworld}}

==Room Data==
===Room Headers===
*{{$|027502}} to {{$|027781}} = Pointer Table, {{hex|2}} byte local addresses, indexed by room ID.
*{{$|027781}} to {{$|027FEF}} = Data

<blockquote>
Headers are {{$|0E}} (Decimal: 14) bytes formatted thusly:
*Byte {{hex|0}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
**The {{red|a}} bits are transformed into {{hex|0000 0}}{{red|aaa}} and stored to {{$|0414}} ("BG2" in Hyrule Magic)
**The {{blue|b}} bits are transformed into {{hex|0000 0}}{{blue|bbb}} and stored to {{$|046C}} ("Collision" in Hyrule Magic)
**The {{green|c}} bit is unused
**The {{purple|d}} bit is stored to {{$|7EC005}} (If set, use a lights out routine in the room transition)

*Byte {{hex|1}}: {{red|aa}}{{blue|bb bbbb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{blue|bbbb bb}}{{hex|00}}, thus making them a multiple of 4.
This value is used to load 4 different palettes for the dungeon, and corresponds to, you guessed it, Palette # in Hyrule Magic!

The resulting index is used to load values for {{$|0AB6}}, {{$|0AAC}}, {{$|0AAD}}, and {{$|0AAE}}

*Byte {{hex|2}}: gets stored to {{$|0AA2}} (GFX # in Hyrule Magic)
*Byte {{hex|3}}: value + #$40 gets stored to {{$|0AA3}} (Sprite GFX # in Hyrule Magic)
*Byte {{hex|4}}: gets stored to {{$|00AD}} ("[[Room Effects|Effect]]" in Hyrule Magic)
*Byte {{hex|5}}: {{red|aa}}{{blue|bb bbbb}}
**{{red|a}} = ?
**The {{blue|b}} bits are "[[Room Tags|Tag1]]" in Hyrule Magic and gets stored to {{$|00AE}}.
*Byte {{hex|6}}: {{red|aa}}{{blue|bb bbbb}}
**{{red|a}} = ?
**The {{blue|b}} bits are "[[Room Tags|Tag2]]" in Hyrule Magic and get stored to {{$|00AF}}

These are the planes to use for bytes {{hex|9}} through {{hex|D}}. This determines which
BG you appear on, and possibly more.

*Byte {{hex|7}}: {{red|aa}}{{blue|bb}} {{green|cc}}{{purple|dd}}
**The {{red|a}} bits are transformed into {{hex|0000 00}}{{red|aa}} and stored to {{$|063F}}
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|063E}}
**The {{green|c}} bits are transformed into {{hex|0000 00}}{{green|cc}} and stored to {{$|063D}}
**The {{purple|d}} bits are transformed into {{hex|0000 00}}{{purple|dd}} and stored to {{$|063C}}

Note, the only safe values for a plane seem to be {{hex|0}},{{hex|1}}, or {{hex|2}}. Hyrule Magic
appears to violate this rule by letting you put {{hex|3}} down, but nothing higher.

*Byte {{hex|8}}: {{red|aaaa aa}}{{blue|bb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|0640}}

*Byte {{hex|9}}: stored to {{$|7EC000}} These are all room numbers that you could possibly exit to.
*Byte {{hex|A}}: stored to {{$|7EC001}}
*Byte {{hex|B}}: stored to {{$|7EC002}}
*Byte {{hex|C}}: stored to {{$|7EC003}}
*Byte {{hex|D}}: stored to {{$|7EC004}}
</blockquote>

===Sprite Data===
* {{$|04D62E}} to {{$|04D92E}} = Pointer Table, 2 byte local addresses, indexed by room.
* {{$|04D92E}} to {{$|04EC9D}} = Data

<blockquote>
Sprite data is formatted thusly:
*Byte {{hex|0}}: Stored to {{$|0FB3}}. Corresponds with "Sort Spr" in Hyrule Magic. In a layered room this indicates sprites in the foreground are to be drawn on top of sprites in the background.
**Bit {{hex|0}} - If {{hex|0}}, sprites will sort
**Bits {{hex|7,6,5,4,3,2,1}} - Unknown, should all be {{hex|1}}
After the byte {{hex|0}}, you will see 3 byte clusters that break down thus:

*Byte {{hex|0}}:
**Bits {{hex|4,3,2,1,0}} - Y coordinate (in pixels from the top, starting at {{hex|0}}) of the sprite divided by 16.
**Bits {{hex|6,5}} - If these are set, they will be used to generate a subtype, stored to {{$|0E30}}, X.
**Bit {{hex|7}} - If set, the sprite is on BG2, if not it's on BG1
* Byte {{hex|1}}:
** Bits {{hex|4,3,2,1,0}} - X coordinate (in pixels from the far left, starting at {{hex|0}}) of the sprite divided by 16.
** Bits {{hex|7,6,5}} - If all these bits are set then this is an Overlord, otherwise it's a normal sprite. If only some of them are set they can be used to generate a subtype, stored at {{$|0E30}}, X
* Byte {{hex|2}}: Sprite or Overlord type. If a sprite, this will get loaded into a slot at {{$|0E20}}, X. If an Overlord, will get loaded to {{$|0B00}}, X.

The array is terminated with a byte of {{$|FF}}.
</blockquote>

===Object Data===
* {{$|0F8000}} to {{$|0F83BF}} = Pointer Table, 3 byte long addresses, indexed by room ID.
* {{$|01EBA0}} to {{$|01FFF4}} = Data
* {{$|050000}} to {{$|053729}} = Data
* {{$|0F8780}} to {{$|0FFF4D}} = Data
<blockquote>
Byte layout:

* Byte 0: {{red|aaaa}} {{blue|bbbb}}.
**The a bits are transformed to {{red|aaaa}}{{hex|0000}} and select the type of empty space to fill in. Hyrule Magic calls this 'Floor 1' - Gets stored to {{$|7E0490}}
**The b bits are transformed to {{blue|bbbb}}{{hex|0000}} and are the what Hyrule Magic calls 'Floor 2' - Gets stored to {{$|7E046A}}

* Byte {{hex|1}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
** The {{red|a}} bits are unused and should not be used
** The {{blue|b}} bits determine the room's layout type, ranging from {{hex|0}} to {{hex|7}}.
** The {{green|c}} and {{purple|d}} bits are unknown, but I have a feeling it's related to {{$|AA}} and {{$|A9}}

After that the bytes come in {{hex|3}} or {{hex|2}} byte object structures, used by routine {{$|01:88E4}}. Objects are loaded until an object with value {{0x|FFFF}} occurs. If a value {{0x|FFF0}} is loaded, the game will start loading Type 2 objects and will not go back to loading Type 1 objects until it is time to load the next layer. (Layer as in HM, not to be confused with the SNES' Backgrounds.) A value of {{0x|FFFF}} will also terminate the loading of Type 2 objects. The routine immediately terminates if that happens during the loading of either object type.

Type 1 Object structure: (3 bytes):

* Byte {{hex|3}}: Routine to use. If this byte is ≥ {{0x|F8}} and < {{0x|FC}}, then it is a subtype 3 object. If the index is ≥ {{hex|FC}}, it is a subtype 2 object. If not, it is a subtype 1 object.

* Subtype 1 Objects, first and second byte
** High Byte: {{brown|yyyy yy}}{{green|cc}}
** Low Byte: {{grey|xxxx xx}}{{red|aa}}
*** The {{red|a}} bits are stored to {{$|B2}}
*** The {{green|c}} bits are stored to {{$|B4}}
*** The {{grey|x}} and {{brown|y}} bits are transformed into: {{hex|000}}{{brown|y yyyy y}}{{grey|xxx xxx}}{{hex|0}} - This is a tilemap address that indexes into {{$|7E2000}} and / or {{$|7E4000}}

Use Byte {{hex|3}} * 2 as an index into the table at {{$|8200}}. This is the routine that is used to draw and otherwise handle the object. Subtype 1 objects have a maximum width and height of 4. Width and height are measured in terms of 32 {{x}} 32 pixels. (⟸ last part is questionable)

*Subtype 2 Objects, 1st, 2nd, & 3rd bytes:
** Byte {{hex|3}}: {{white|ff}}{{purple|dd dddd}}
** Byte {{hex|2}}: {{pink|eeee}} {{green|cccc}}
** Byte {{hex|1}}: {{red|aaaa aa}}{{blue|bb}}
***The {{red|a}} bits are unused, but after all they are the marker for this type of object subtype.
***The {{blue|b}}, {{green|c}}, {{pink|e}}, and {{white|f}} bits are transformed into a VRAM tilemap address: {{hex|000}}{{green|c ccc}}{{white|f}} {{white|f}}{{blue|bb}}{{pink|e eee}}{{hex|0}}

Might I add this is one messed up format? The {{purple|d}} bits are used as an index into the table at {{$|8470}}. Since such indices are going to be even, the {{purple|d}} bits are transformed into: {{hex|0000 0000 0}}{{purple|ddd ddd}}{{hex|0}}.

*Subtype 3 Objects
**Similar to Subtype 1, with a few small exceptions.
**The vram address is calculated the same way. However, {{$|B2}} and {{$|B4}} are not used as length or width dimensions here. The routine that is used is determined as follows:
**Take the original index (times two) that a Subtype 1 would have used. AND that with {{0x|000E}}. Then shift left 3 times to produce {{hex|0000 0000 0}}{{pink|eee}} {{hex|0000}}. Then, OR in {{$|B2}} and {{$|B4}} and shift left once, so the final result is: {{hex|0000 0000}} {{pink|eee}}{{red|a a}}{{blue|bb}}{{hex|0}}.
**Also, this value indexes into {{$|85F0}} instead of {{$|8200}}.

Type 2 Object Structure: (2 bytes)
*High Byte: {{green|cccc cccc}}
*Low Byte: {{blue|bbbb}} {{purple|dd}}{{red|aa}}
**The {{red|a}} bits form a 2-bit value ({{hex|0000 0}}{{red|aa}}{{hex|0}}) that determines the routine to use for the object. In Hyrule Magic, corresponds to the "direction" of the door.
**The {{blue|b}} bits are transformed into {{hex|000}}{{blue|b bbb}}{{hex|0}} and stored to {{$|02}} ⟹ X. Corresponds to "Pos" of door objects in the Hyrule Magic. Note that these range from {{0x|00}} to {{0x|16}} (always even) which if you halve those values is 0 - 11 in decimal. This is easily verifiable in Hyrule Magic.
**The {{green|c}} bits are shifted into the lower byte and stored to {{$|04}} ⟹ A and {{$|0A}}. This is later used to grab the tiles used to draw the door and the area below it. In Hyrule Magic, corresponds to "type". Note the type is 1/2 of the number listed here. This is because to avoid using an ASL A command, the {{green|c}} bits are always even.
**The {{purple|d}} bits are unused.

Next I'll go into the nitty gritty of the various types (the value of {{$|04}}). Again note that we'll only be dealing with even values {{blue|b}}/{{green|c}} that's what you'll see in the code. To convert between here [as well as the code] and Hyrule Magic, take the hex value here and divide by two. Convert to decimal and that's your Hyrule Magic "type."

*Types:
{|{{Prettytable}}
! ID
! Description
|-
|{{0x|00}}
|Basic door. Index = {{$|0460}}
|-
|{{0x|02}}
|Normal door?
|-
|{{0x|04}}
|???
|-
|{{0x|06}}
|???
|-
|{{0x|08}}
|Waterfall door (only used in Swamp palace; in one room at that!)
|-
|{{0x|0A}}
|???
|-
|{{0x|0C}}
|Trap door (probably other types but this seems to be most common)
|-
|{{0x|12}}
|Adds a property to some doors allowing you to exit to the overworld (this is accomplished by writing to the tile attribute map)
|-
|{{0x|14}}
|Transition to dark room?
|-
|{{0x|16}}
|Toggles the target BG Link will emerge on. '''Ex.''' if Link starts on BG0 in the next room he'll be on BG1.
|-
|{{0x|20}}
| rowspan="2"|Locked door specifically for BG0.
|-
|{{0x|22}}
|-
|{{0x|24}}
| rowspan="2"|Locked door for either BG0 or BG1
|-
|{{0x|26}}
|-
|{{0x|30}}
|Large exploded pathway resulting from a switch being pulled (unusual to have as a door as it's huge)
|-
|{{0x|32}}
|Sword activated door. '''Ex.''' Agahnim's room with the curtain door you have to slash.
|-
|{{0x|46}}
|warp door?
|}
</blockquote>

===Dungeon Secrets Data===
* {{$|00DB69}} to {{$|00DDE8}} = Pointer Table, 2 byte local addresses, indexed by room ID.
* {{$|00DDE9}} to {{$|00E6B1}} = Data
<blockquote>
Data comes in 3 byte chunks and is terminated by an instance of {{$|FFFF}}

* Bytes {{hex|0}}, {{hex|1}}: A word that denotes the VRAM address that the item is found at. This identifies the item as belonging to that part of the screen.
* Byte {{hex|2}}: Identifies the type of item that is hiding there. E.g. {{$|08}} is a key
</blockquote>

===Push Block Data===
* {{$|0271DE}} to {{$|027369}} = Data
<Blockquote>
4 bytes per entry:
{{red|a a }}{{blue|x }} {{green|y}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the block (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the block (expressed as tilemap coordinate)
</blockquote>

===(Inter Room) Torch Data===
The torch data has three primary pointer locations. The pointers are stored as a long address.

{|{{prettytable}}
|+Primary pointer location
!USA
!JP
!GER
|-
|{{0x|15B16}}, {{0x|15B1D}}, {{0x|15B24}}
|{{0x|1587A}}, {{0x|15881}}, {{0x|15888}}
|{{0x|15B98}}, {{0x|15B9F}}, {{0x|15BA6}}
|}

* In the USA version, the data goes from {{0x|2736A}} to {{0x|27489}}.
<Blockquote>
Consists of variable length segments consisting of:

{{red|a a }}{{blue|x }}{{green|y }}{{blue|x }}{{green|y }}{{hex|... }}{{$|FFFF}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the torch (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the torch (expressed as tilemap coordinate)
*{{$|FFFF}}: Delimeter
</blockquote>

===Chest Contents===
The chest contents have three primary pointer locations. The values at each location point to the same pointer. Yes, you read that right. The pointer is stored as a long address.

{|{{prettytable}}
|+Primary pointer location
!USA
!JP
!GER
|-
|{{0x|EBFB}}, {{0x|EC0A}}, {{0x|EC10}}
|{{0x|EC08}}, {{0x|EC17}}, {{0x|EC26}}
|{{0x|EBD5}}, {{0x|EBE4}}, {{0x|EBF3}}
|}

The addresses below contain the size limit for the data for each region:

{|{{prettytable}}
|+Max Size
!USA
!JP
!GER
|-
|{{0x|EBF6}}
|{{0x|EBF4}}
|{{0x|EBD0}}
|}

*In the original USA version the data goes from {{$|00E96E}} to {{$|00EB65}}.
<blockquote>
Array of chest information in 3 byte chunks. 168 entries in all ({{0x|A8}})

*First word - Room number it is located in. MSB determines whether it is a big chest or not. (big chest if set)
*Last byte - index of the type of item contained in the chest.
</blockquote>

==Room layout==
In Hyrule Magic, there's a label and textbox for room layouts. The layout value goes from {{$|0}} to {{$|7}}

The location:

{|{{prettytable}}
!USA
!JP
|-
|{{0x|26F2F}}
|{{0x|26C0F}}
|}

In the aforementioned location, there are 8 long pointers (Lo-Hi-Bank).

==Entrance Data==
There are {{$|85}} (Decimal: 133) normal entrances to the underworld from the overworld, and {{$|7}} (Decimal: 7) starting locations.
Normal entrances and starting locations use mostly the same types of data formatted the same, however they are located in different places in the ROM.
They are located and formatted thus:

===Entrance Room===
*{{$|014813}} to {{$|01491C}} = Normal Entrance Data
*{{$|015B6E}} to {{$|015B7B}} = Starting Location Data
<blockquote>
Each entry is a 2 byte Room ID where the player is placed after using an entrance.
</blockquote>

===Scroll Edges===
*{{$|01491D}} to {{$|014D44}} = Normal Entrance Data
*{{$|015B7C}} to {{$|015BB3}} = Starting Location Data
<blockquote>
Unsure about what these do exactly.
Each entry is 8 bytes long.
*Format: 1 byte each. Corresponds to hyrule magic values in the "More" a.k.a. Entrance Properties dialog box.
**HU -
**FU -
**HD -
**FD -
**HL -
**FL -
**HR -
**FR -
</blockquote>

===X Scroll===
*{{$|014D45}} to {{$|014E4E}} = Normal Entrance Data
*{{$|015BB4}} to {{$|015BC1}} = Starting Location Data
<blockquote>

</blockquote>

===Y Scroll===
*{{$|014E4F}} to {{$|014F58}} = Normal Entrance Data
*{{$|015BC2}} to {{$|015BCF}} = Starting Location Data
<blockquote>

</blockquote>

===X Coordinate===
*{{$|014F59}} to {{$|015062}} = Normal Entrance Data
*{{$|015BD0}} to {{$|015BDD}} = Starting Location Data
<blockquote>
Each entry is a 2 byte X coordinate where the player starts after using the corresponding entrance.
</blockquote>

===Y Coordinate===
*{{$|015063}} to {{$|01516C}} = Normal Entrance Data
*{{$|015BDE}} to {{$|015BEB}} = Starting Location Data
<blockquote>
Each entry is a 2 byte y coordinate where the player starts after using the corresponding entrance.
</blockquote>

===X Camera Coordinate===
*{{$|01516D}} to {{$|015276}} = Normal Entrance Data
*{{$|015BEC}} to {{$|015BF9}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

===Y Camera Coordinate===
*{{$|015277}} to {{$|015380}} = Normal Entrance Data
*{{$|015BFA}} to {{$|015C07}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

===Entrance Blockset===
*{{$|015381}} to {{$|015405}} = Normal Entrance Data
*{{$|015C08}} to {{$|015C0E}} = Starting Location Data
<blockquote>
1 byte each. This blockset affects walls and a few other things and persists through all rooms the player accesses from this entrance.
</blockquote>

===Floor Values===
*{{$|015406}} to {{$|01548A}} = Normal Entrance Data
*{{$|015C0F}} to {{$|015C15}} = Starting Location Data
<blockquote>
This tells us what kind of properties the floor has. 1 byte each:
*If 1, then it has floors that you can fall through to the next level
*If 0, I think it means it can be fallen down to
*If -1, has no pits
*If -2, ????
</blockquote>

===Dungeon Values===
*{{$|01548B}} to {{$|01550F}} = Normal Entrance Data
*{{$|015C16}} to {{$|015C1C}} = Starting Location Data
<blockquote>
1 Byte each.
Dungeons actually in the game are numbered like so {{$|00}}, {{$|02}}, {{$|04}}, ..., {{$|18}}, {{$|1A}}.
{{$|1C}} and {{$|1E}} are unused (and hence could potentially be added.) Notice they are all even numbers.
In asm routines these values are divided by two sometimes to provide an index into other arrays.
That's why. The definition of a "dungeon" is something with a key, compass, and map.

A value of {{$|FF}} (-1) denotes it doesn't belong to a dungeon.
</blockquote>

===Doorway Type===
*{{$|015510}} to {{$|015594}} = Normal Entrance Data
*{{$|015C2B}} to {{$|015C31}} = Starting Location Data
<blockquote>
This is used only when you exit the given room. For example, let's say you enter through a skull doorway in Skullwoods.
But that's not really a door way, it's just a set of tiles that are no different from a hole you might create after picking
up a big rock. But if you entered from a building door, the game has to know whether to put the door frame when you exit.
*1 byte:
**{{hex|0}} = no doorway when exiting
**{{hex|1}} = draws a door frame upon exiting
**{{hex|2}} = ???? HM says vertical doorframe. But in the original game, no doorway is vertical.

</blockquote>

===Ladder And BG Settings===
*{{$|015595}} to {{$|015619}} = Normal Entrance Data
*{{$|015C1D}} to {{$|015C23}} = Starting Location Data
<blockquote>
*1 byte each, with the following 2 bit layout: {{hex|xxx}}{{red|a}}{{pink|xxx}}{{blue|b}}
**{{hex|x}} - unimportant
**{{red|a}} - if set, then Link enters on the lower level (BG2)
**{{blue|b}} - if set... not sure what happens exactly. Check the game engine to be sure.
</blockquote>

===Horizontal And Vertical Scroll Properties===
*{{$|01561A}} to {{$|01569E}} = Normal Entrance Data
*{{$|015C24}} to {{$|015C2A}} = Starting Location Data
<blockquote>
For these, I guess if the flags in the appropriate places are set, then the room will be able to scroll in those directions.

*1 byte each, with the following layout: {{hex|xx}}{{red|a}}{{hex|xxx}}{{blue|b}}{{hex|x}}
**{{red|a}} - Horizontal flag
**{{blue|b}} - Vertical flag
</blockquote>

===Scroll Quadrant===
*{{$|01569F}} to {{$|015723}} = Normal Entrance Data
<blockquote>
*1 byte each, has four different expected values:
**0h, 2h, 10h, 12h
</blockquote>

===Exit Door Location===
*{{$|015724}} to {{$|01582D}} = Normal Entrance Data
*{{$|015C32}} to {{$|015C3F}} = Starting Location Data
<blockquote>
1 word each. Denotes X and Y coordinates for overworld?
</blockquote>

===Music===
*{{$|01582E}} to {{$|0158B2}} = Normal Entrance Data (JP: 15592 - 15616)
*{{$|015C4E}} to {{$|015C54}} = Starting Location Data
<blockquote>
1 byte each. A value of {{$|FF}} plays the same music as the overworld screen from which the player entered.
</blockquote>

===Entrance Values===
*{{$|015C40}} to {{$|015C4D}} = Starting Location Data
<blockquote>
1 word each. Since the starting locations have to reference an entrance, this is necessary.
</blockquote>

{{toc}}

Underworld:Important Hex Addresses

2017-12-23T23:25:03Z

Tatters:

{{subpage|Underworld}}

==Room Data==
===Room Headers===
*{{$|027502}} to {{$|027781}} = Pointer Table, {{hex|2}} byte local addresses, indexed by room ID.
*{{$|027781}} to {{$|027FEF}} = Data

<blockquote>
Headers are {{$|0E}} (Decimal: 14) bytes formatted thusly:
*Byte {{hex|0}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
**The {{red|a}} bits are transformed into {{hex|0000 0}}{{red|aaa}} and stored to {{$|0414}} ("BG2" in Hyrule Magic)
**The {{blue|b}} bits are transformed into {{hex|0000 0}}{{blue|bbb}} and stored to {{$|046C}} ("Collision" in Hyrule Magic)
**The {{green|c}} bit is unused
**The {{purple|d}} bit is stored to {{$|7EC005}} (If set, use a lights out routine in the room transition)

*Byte {{hex|1}}: {{red|aa}}{{blue|bb bbbb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{blue|bbbb bb}}{{hex|00}}, thus making them a multiple of 4.
This value is used to load 4 different palettes for the dungeon, and corresponds to, you guessed it, Palette # in Hyrule Magic!

The resulting index is used to load values for {{$|0AB6}}, {{$|0AAC}}, {{$|0AAD}}, and {{$|0AAE}}

*Byte {{hex|2}}: gets stored to {{$|0AA2}} (GFX # in Hyrule Magic)
*Byte {{hex|3}}: value + #$40 gets stored to {{$|0AA3}} (Sprite GFX # in Hyrule Magic)
*Byte {{hex|4}}: gets stored to {{$|00AD}} ("[[Room Effects|Effect]]" in Hyrule Magic)
*Byte {{hex|5}}: {{red|aa}}{{blue|bb bbbb}}
**{{red|a}} = ?
**The {{blue|b}} bits are "[[Room Tags|Tag1]]" in Hyrule Magic and gets stored to {{$|00AE}}.
*Byte {{hex|6}}: {{red|aa}}{{blue|bb bbbb}}
**{{red|a}} = ?
**The {{blue|b}} bits are "[[Room Tags|Tag2]]" in Hyrule Magic and get stored to {{$|00AF}}

These are the planes to use for bytes {{hex|9}} through {{hex|D}}. This determines which
BG you appear on, and possibly more.

*Byte {{hex|7}}: {{red|aa}}{{blue|bb}} {{green|cc}}{{purple|dd}}
**The {{red|a}} bits are transformed into {{hex|0000 00}}{{red|aa}} and stored to {{$|063F}}
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|063E}}
**The {{green|c}} bits are transformed into {{hex|0000 00}}{{green|cc}} and stored to {{$|063D}}
**The {{purple|d}} bits are transformed into {{hex|0000 00}}{{purple|dd}} and stored to {{$|063C}}

Note, the only safe values for a plane seem to be {{hex|0}},{{hex|1}}, or {{hex|2}}. Hyrule Magic
appears to violate this rule by letting you put {{hex|3}} down, but nothing higher.

*Byte {{hex|8}}: {{red|aaaa aa}}{{blue|bb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|0640}}

*Byte {{hex|9}}: stored to {{$|7EC000}} These are all room numbers that you could possibly exit to.
*Byte {{hex|A}}: stored to {{$|7EC001}}
*Byte {{hex|B}}: stored to {{$|7EC002}}
*Byte {{hex|C}}: stored to {{$|7EC003}}
*Byte {{hex|D}}: stored to {{$|7EC004}}
</blockquote>

===Sprite Data===
* {{$|04D62E}} to {{$|04D92E}} = Pointer Table, 2 byte local addresses, indexed by room.
* {{$|04D92E}} to {{$|04EC9D}} = Data

<blockquote>
Sprite data is formatted thusly:
*Byte {{hex|0}}: Stored to {{$|0FB3}}. Corresponds with "Sort Spr" in Hyrule Magic. In a layered room this indicates sprites in the foreground are to be drawn on top of sprites in the background.
**Bit {{hex|0}} - If {{hex|0}}, sprites will sort
**Bits {{hex|7,6,5,4,3,2,1}} - Unknown, should all be {{hex|1}}
After the byte {{hex|0}}, you will see 3 byte clusters that break down thus:

*Byte {{hex|0}}:
**Bits {{hex|4,3,2,1,0}} - Y coordinate (in pixels from the top, starting at {{hex|0}}) of the sprite divided by 16.
**Bits {{hex|6,5}} - If these are set, they will be used to generate a subtype, stored to {{$|0E30}}, X.
**Bit {{hex|7}} - If set, the sprite is on BG2, if not it's on BG1
* Byte {{hex|1}}:
** Bits {{hex|4,3,2,1,0}} - X coordinate (in pixels from the far left, starting at {{hex|0}}) of the sprite divided by 16.
** Bits {{hex|7,6,5}} - If all these bits are set then this is an Overlord, otherwise it's a normal sprite. If only some of them are set they can be used to generate a subtype, stored at {{$|0E30}}, X
* Byte {{hex|2}}: Sprite or Overlord type. If a sprite, this will get loaded into a slot at {{$|0E20}}, X. If an Overlord, will get loaded to {{$|0B00}}, X.

The array is terminated with a byte of {{$|FF}}.
</blockquote>

===Object Data===
* {{$|0F8000}} to {{$|0F83BF}} = Pointer Table, 3 byte long addresses, indexed by room ID.
* {{$|01EBA0}} to {{$|01FFF4}} = Data
* {{$|050000}} to {{$|053729}} = Data
* {{$|0F8780}} to {{$|0FFF4D}} = Data
<blockquote>
Byte layout:

* Byte 0: {{red|aaaa}} {{blue|bbbb}}.
**The a bits are transformed to {{red|aaaa}}{{hex|0000}} and select the type of empty space to fill in. Hyrule Magic calls this 'Floor 1' - Gets stored to {{$|7E0490}}
**The b bits are transformed to {{blue|bbbb}}{{hex|0000}} and are the what Hyrule Magic calls 'Floor 2' - Gets stored to {{$|7E046A}}

* Byte {{hex|1}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
** The {{red|a}} bits are unused and should not be used
** The {{blue|b}} bits determine the room's layout type, ranging from {{hex|0}} to {{hex|7}}.
** The {{green|c}} and {{purple|d}} bits are unknown, but I have a feeling it's related to {{$|AA}} and {{$|A9}}

After that the bytes come in {{hex|3}} or {{hex|2}} byte object structures, used by routine {{$|01:88E4}}. Objects are loaded until an object with value {{0x|FFFF}} occurs. If a value {{0x|FFF0}} is loaded, the game will start loading Type 2 objects and will not go back to loading Type 1 objects until it is time to load the next layer. (Layer as in HM, not to be confused with the SNES' Backgrounds.) A value of {{0x|FFFF}} will also terminate the loading of Type 2 objects. The routine immediately terminates if that happens during the loading of either object type.

Type 1 Object structure: (3 bytes):

* Byte {{hex|3}}: Routine to use. If this byte is ≥ {{0x|F8}} and < {{0x|FC}}, then it is a subtype 3 object. If the index is ≥ {{hex|FC}}, it is a subtype 2 object. If not, it is a subtype 1 object.

* Subtype 1 Objects, first and second byte
** High Byte: {{brown|yyyy yy}}{{green|cc}}
** Low Byte: {{grey|xxxx xx}}{{red|aa}}
*** The {{red|a}} bits are stored to {{$|B2}}
*** The {{green|c}} bits are stored to {{$|B4}}
*** The {{grey|x}} and {{brown|y}} bits are transformed into: {{hex|000}}{{brown|y yyyy y}}{{grey|xxx xxx}}{{hex|0}} - This is a tilemap address that indexes into {{$|7E2000}} and / or {{$|7E4000}}

Use Byte {{hex|3}} * 2 as an index into the table at {{$|8200}}. This is the routine that is used to draw and otherwise handle the object. Subtype 1 objects have a maximum width and height of 4. Width and height are measured in terms of 32 {{x}} 32 pixels. (⟸ last part is questionable)

*Subtype 2 Objects, 1st, 2nd, & 3rd bytes:
** Byte {{hex|3}}: {{white|ff}}{{purple|dd dddd}}
** Byte {{hex|2}}: {{pink|eeee}} {{green|cccc}}
** Byte {{hex|1}}: {{red|aaaa aa}}{{blue|bb}}
***The {{red|a}} bits are unused, but after all they are the marker for this type of object subtype.
***The {{blue|b}}, {{green|c}}, {{pink|e}}, and {{white|f}} bits are transformed into a VRAM tilemap address: {{hex|000}}{{green|c ccc}}{{white|f}} {{white|f}}{{blue|bb}}{{pink|e eee}}{{hex|0}}

Might I add this is one messed up format? The {{purple|d}} bits are used as an index into the table at {{$|8470}}. Since such indices are going to be even, the {{purple|d}} bits are transformed into: {{hex|0000 0000 0}}{{purple|ddd ddd}}{{hex|0}}.

*Subtype 3 Objects
**Similar to Subtype 1, with a few small exceptions.
**The vram address is calculated the same way. However, {{$|B2}} and {{$|B4}} are not used as length or width dimensions here. The routine that is used is determined as follows:
**Take the original index (times two) that a Subtype 1 would have used. AND that with {{0x|000E}}. Then shift left 3 times to produce {{hex|0000 0000 0}}{{pink|eee}} {{hex|0000}}. Then, OR in {{$|B2}} and {{$|B4}} and shift left once, so the final result is: {{hex|0000 0000}} {{pink|eee}}{{red|a a}}{{blue|bb}}{{hex|0}}.
**Also, this value indexes into {{$|85F0}} instead of {{$|8200}}.

Type 2 Object Structure: (2 bytes)
*High Byte: {{green|cccc cccc}}
*Low Byte: {{blue|bbbb}} {{purple|dd}}{{red|aa}}
**The {{red|a}} bits form a 2-bit value ({{hex|0000 0}}{{red|aa}}{{hex|0}}) that determines the routine to use for the object. In Hyrule Magic, corresponds to the "direction" of the door.
**The {{blue|b}} bits are transformed into {{hex|000}}{{blue|b bbb}}{{hex|0}} and stored to {{$|02}} ⟹ X. Corresponds to "Pos" of door objects in the Hyrule Magic. Note that these range from {{0x|00}} to {{0x|16}} (always even) which if you halve those values is 0 - 11 in decimal. This is easily verifiable in Hyrule Magic.
**The {{green|c}} bits are shifted into the lower byte and stored to {{$|04}} ⟹ A and {{$|0A}}. This is later used to grab the tiles used to draw the door and the area below it. In Hyrule Magic, corresponds to "type". Note the type is 1/2 of the number listed here. This is because to avoid using an ASL A command, the {{green|c}} bits are always even.
**The {{purple|d}} bits are unused.

Next I'll go into the nitty gritty of the various types (the value of {{$|04}}). Again note that we'll only be dealing with even values {{blue|b}}/{{green|c}} that's what you'll see in the code. To convert between here [as well as the code] and Hyrule Magic, take the hex value here and divide by two. Convert to decimal and that's your Hyrule Magic "type."

*Types:
{|{{Prettytable}}
! ID
! Description
|-
|{{0x|00}}
|Basic door. Index = {{$|0460}}
|-
|{{0x|02}}
|Normal door?
|-
|{{0x|04}}
|???
|-
|{{0x|06}}
|???
|-
|{{0x|08}}
|Waterfall door (only used in Swamp palace; in one room at that!)
|-
|{{0x|0A}}
|???
|-
|{{0x|0C}}
|Trap door (probably other types but this seems to be most common)
|-
|{{0x|12}}
|Adds a property to some doors allowing you to exit to the overworld (this is accomplished by writing to the tile attribute map)
|-
|{{0x|14}}
|Transition to dark room?
|-
|{{0x|16}}
|Toggles the target BG Link will emerge on. '''Ex.''' if Link starts on BG0 in the next room he'll be on BG1.
|-
|{{0x|20}}
| rowspan="2"|Locked door specifically for BG0.
|-
|{{0x|22}}
|-
|{{0x|24}}
| rowspan="2"|Locked door for either BG0 or BG1
|-
|{{0x|26}}
|-
|{{0x|30}}
|Large exploded pathway resulting from a switch being pulled (unusual to have as a door as it's huge)
|-
|{{0x|32}}
|Sword activated door. '''Ex.''' Agahnim's room with the curtain door you have to slash.
|-
|{{0x|46}}
|warp door?
|}
</blockquote>

===Dungeon Secrets Data===
* {{$|00DB69}} to {{$|00DDE8}} = Pointer Table, 2 byte local addresses, indexed by room ID.
* {{$|00DDE9}} to {{$|00E6B1}} = Data
<blockquote>
Data comes in 3 byte chunks and is terminated by an instance of {{$|FFFF}}

* Bytes {{hex|0}}, {{hex|1}}: A word that denotes the VRAM address that the item is found at. This identifies the item as belonging to that part of the screen.
* Byte {{hex|2}}: Identifies the type of item that is hiding there. E.g. {{$|08}} is a key
</blockquote>

===Push Block Data===
* {{$|0271DE}} to {{$|027369}} = Data
<Blockquote>
4 bytes per entry:
{{red|a a }}{{blue|x }} {{green|y}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the block (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the block (expressed as tilemap coordinate)
</blockquote>

===(Inter Room) Torch Data===
The torch data has three primary pointer locations. The pointers are stored as a long address.

{|{{prettytable}}
|+Primary pointer location
!USA
!JP
!GER
|-
|{{0x|15B16}}, {{0x|15B1D}}, {{0x|15B24}}
|{{0x|1587A}}, {{0x|15881}}, {{0x|15888}}
|{{0x|15B98}}, {{0x|15B9F}}, {{0x|15BA6}}
|}

* In the USA version, the data goes from {{0x|2736A}} to {{0x|27489}}.
<Blockquote>
Consists of variable length segments consisting of:

{{red|a a }}{{blue|x }}{{green|y }}{{blue|x }}{{green|y }}{{hex|... }}{{$|FFFF}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the torch (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the torch (expressed as tilemap coordinate)
*{{$|FFFF}}: Delimeter
</blockquote>

===Chest Contents===
The chest contents have three primary pointer locations. The values at each location point to the same pointer. Yes, you read that right. The pointer is stored as a long address.

{|{{prettytable}}
|+Primary pointer location
!USA
!JP
!GER
|-
|{{0x|EBFB}}, {{0x|EC0A}}, {{0x|EC10}}
|{{0x|EC08}}, {{0x|EC17}}, {{0x|EC26}}
|{{0x|EBD5}}, {{0x|EBE4}}, {{0x|EBF3}}
|}

The addresses below contain the size limit for the data for each region:

{|{{prettytable}}
|+Max Size
!USA
!JP
!G
|-
|{{0x|EBF6}}
|{{0x|EBF4}}
|{{0x|EBD0}}
|}

*In the original USA version the data goes from {{$|00E96E}} to {{$|00EB65}}.
<blockquote>
Array of chest information in 3 byte chunks. 168 entries in all ({{0x|A8}})

*First word - Room number it is located in. MSB determines whether it is a big chest or not. (big chest if set)
*Last byte - index of the type of item contained in the chest.
</blockquote>

==Room layout==
In Hyrule Magic, there's a label and textbox for room layouts. The layout value goes from {{$|0}} to {{$|7}}

The location:

{|{{prettytable}}
!USA
!JP
|-
|{{0x|26F2F}}
|{{0x|26C0F}}
|}

In the aforementioned location, there are 8 long pointers (Lo-Hi-Bank).

==Entrance Data==
There are {{$|85}} (Decimal: 133) normal entrances to the underworld from the overworld, and {{$|7}} (Decimal: 7) starting locations.
Normal entrances and starting locations use mostly the same types of data formatted the same, however they are located in different places in the ROM.
They are located and formatted thus:

===Entrance Room===
*{{$|014813}} to {{$|01491C}} = Normal Entrance Data
*{{$|015B6E}} to {{$|015B7B}} = Starting Location Data
<blockquote>
Each entry is a 2 byte Room ID where the player is placed after using an entrance.
</blockquote>

===Scroll Edges===
*{{$|01491D}} to {{$|014D44}} = Normal Entrance Data
*{{$|015B7C}} to {{$|015BB3}} = Starting Location Data
<blockquote>
Unsure about what these do exactly.
Each entry is 8 bytes long.
*Format: 1 byte each. Corresponds to hyrule magic values in the "More" a.k.a. Entrance Properties dialog box.
**HU -
**FU -
**HD -
**FD -
**HL -
**FL -
**HR -
**FR -
</blockquote>

===X Scroll===
*{{$|014D45}} to {{$|014E4E}} = Normal Entrance Data
*{{$|015BB4}} to {{$|015BC1}} = Starting Location Data
<blockquote>

</blockquote>

===Y Scroll===
*{{$|014E4F}} to {{$|014F58}} = Normal Entrance Data
*{{$|015BC2}} to {{$|015BCF}} = Starting Location Data
<blockquote>

</blockquote>

===X Coordinate===
*{{$|014F59}} to {{$|015062}} = Normal Entrance Data
*{{$|015BD0}} to {{$|015BDD}} = Starting Location Data
<blockquote>
Each entry is a 2 byte X coordinate where the player starts after using the corresponding entrance.
</blockquote>

===Y Coordinate===
*{{$|015063}} to {{$|01516C}} = Normal Entrance Data
*{{$|015BDE}} to {{$|015BEB}} = Starting Location Data
<blockquote>
Each entry is a 2 byte y coordinate where the player starts after using the corresponding entrance.
</blockquote>

===X Camera Coordinate===
*{{$|01516D}} to {{$|015276}} = Normal Entrance Data
*{{$|015BEC}} to {{$|015BF9}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

===Y Camera Coordinate===
*{{$|015277}} to {{$|015380}} = Normal Entrance Data
*{{$|015BFA}} to {{$|015C07}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

===Entrance Blockset===
*{{$|015381}} to {{$|015405}} = Normal Entrance Data
*{{$|015C08}} to {{$|015C0E}} = Starting Location Data
<blockquote>
1 byte each. This blockset affects walls and a few other things and persists through all rooms the player accesses from this entrance.
</blockquote>

===Floor Values===
*{{$|015406}} to {{$|01548A}} = Normal Entrance Data
*{{$|015C0F}} to {{$|015C15}} = Starting Location Data
<blockquote>
This tells us what kind of properties the floor has. 1 byte each:
*If 1, then it has floors that you can fall through to the next level
*If 0, I think it means it can be fallen down to
*If -1, has no pits
*If -2, ????
</blockquote>

===Dungeon Values===
*{{$|01548B}} to {{$|01550F}} = Normal Entrance Data
*{{$|015C16}} to {{$|015C1C}} = Starting Location Data
<blockquote>
1 Byte each.
Dungeons actually in the game are numbered like so {{$|00}}, {{$|02}}, {{$|04}}, ..., {{$|18}}, {{$|1A}}.
{{$|1C}} and {{$|1E}} are unused (and hence could potentially be added.) Notice they are all even numbers.
In asm routines these values are divided by two sometimes to provide an index into other arrays.
That's why. The definition of a "dungeon" is something with a key, compass, and map.

A value of {{$|FF}} (-1) denotes it doesn't belong to a dungeon.
</blockquote>

===Doorway Type===
*{{$|015510}} to {{$|015594}} = Normal Entrance Data
*{{$|015C2B}} to {{$|015C31}} = Starting Location Data
<blockquote>
This is used only when you exit the given room. For example, let's say you enter through a skull doorway in Skullwoods.
But that's not really a door way, it's just a set of tiles that are no different from a hole you might create after picking
up a big rock. But if you entered from a building door, the game has to know whether to put the door frame when you exit.
*1 byte:
**{{hex|0}} = no doorway when exiting
**{{hex|1}} = draws a door frame upon exiting
**{{hex|2}} = ???? HM says vertical doorframe. But in the original game, no doorway is vertical.

</blockquote>

===Ladder And BG Settings===
*{{$|015595}} to {{$|015619}} = Normal Entrance Data
*{{$|015C1D}} to {{$|015C23}} = Starting Location Data
<blockquote>
*1 byte each, with the following 2 bit layout: {{hex|xxx}}{{red|a}}{{pink|xxx}}{{blue|b}}
**{{hex|x}} - unimportant
**{{red|a}} - if set, then Link enters on the lower level (BG2)
**{{blue|b}} - if set... not sure what happens exactly. Check the game engine to be sure.
</blockquote>

===Horizontal And Vertical Scroll Properties===
*{{$|01561A}} to {{$|01569E}} = Normal Entrance Data
*{{$|015C24}} to {{$|015C2A}} = Starting Location Data
<blockquote>
For these, I guess if the flags in the appropriate places are set, then the room will be able to scroll in those directions.

*1 byte each, with the following layout: {{hex|xx}}{{red|a}}{{hex|xxx}}{{blue|b}}{{hex|x}}
**{{red|a}} - Horizontal flag
**{{blue|b}} - Vertical flag
</blockquote>

===Scroll Quadrant===
*{{$|01569F}} to {{$|015723}} = Normal Entrance Data
<blockquote>
*1 byte each, has four different expected values:
**0h, 2h, 10h, 12h
</blockquote>

===Exit Door Location===
*{{$|015724}} to {{$|01582D}} = Normal Entrance Data
*{{$|015C32}} to {{$|015C3F}} = Starting Location Data
<blockquote>
1 word each. Denotes X and Y coordinates for overworld?
</blockquote>

===Music===
*{{$|01582E}} to {{$|0158B2}} = Normal Entrance Data (JP: 15592 - 15616)
*{{$|015C4E}} to {{$|015C54}} = Starting Location Data
<blockquote>
1 byte each. A value of {{$|FF}} plays the same music as the overworld screen from which the player entered.
</blockquote>

===Entrance Values===
*{{$|015C40}} to {{$|015C4D}} = Starting Location Data
<blockquote>
1 word each. Since the starting locations have to reference an entrance, this is necessary.
</blockquote>

{{toc}}

Overworld Areas

2017-12-23T23:22:37Z

Tatters: /* Special Areas */

{{subpage|Overworld}}

{{see|Standard Notation}}

Outdoor areas (also known as the Overworld) come in two flavors: Normal and special. Normal outdoor areas (the Light world and the Dark world) are mirrored 8{{x}}8 grids of 512{{x}}512-pixel cells for a total of 64 cells and a 4096{{x}}4096-pixel area in size. Normal outdoor grid cells can be quadruple in size (1024{{x}}1024 pixels), in which case their indices represent their top-left quadrants and the indices for the other three quadrants they occupy do not occur. Special outdoor areas (such as Zora's Domain) are separate individual mini-areas on their own.

== Area Index ==

In WRAM, there is a byte which indicates whether or not the player is currently in an indoor or outdoor area, and when the player is in an outdoor area, there is a word which contains the index of the outdoor area the player is currently in.

;{{$|7E001B}}[{{$|1}}]
: 0 while player is outside
: 1 while player is inside

;{{$|7E008A}}[{{$|2}}]
: the current area index while player is outside
: invalid while player is inside

== Player Coordinates ==

''See also: [[Player Position]]''

Let A be the current area index, (Px,Py) be the current absolute player coordinates, and (Lx,Ly) be the local coordinates of the player within the current area.

When the player is in the Light world (area index {{$|00}}..{{$|3F}}), the player's coordinates originate at the top-left corner of area {{$|00}}, and the coordinates can be calculated as follows.

<nowiki>Lx = Px - ( A % 8 ) * 512
Ly = Py - ( A / 8 ) * 512</nowiki>

When the player is in the Dark world (area index {{$|40}}..{{$|7F}}), the player's coordinates originate at the top-left corner of area {{$|40}}, and the coordinates can be calculated as follows.

<nowiki>Lx = Px - ( ( A - $40 ) % 8 ) * 512
Ly = Py - ( ( A - $40 ) / 8 ) * 512</nowiki>

When the player is in a special area (area index {{$|80}} and up), the player's coordinates originate at the top-left corner of the current special area. There are two special areas: {{$|80}} combines the Master Sword area and the area under the bridge east of the player's house, and {{$|81}} is Zora's Domain. Local coordinates within the Master Sword area and within Zora's Domain are equal to the absolute coordinates. The player is in the area under the bridge when their X coordinate is 256 or greater, and their local X coordinate is simply their absolute X coordinate minus 256.

== The Light World and the Dark World ==

The Light world and Dark world mirror each other: Any area index in the Light world refers to an area index in the Dark world of the same size and at the same location, except the Dark world index is increased by {{$|40}}. The following table lists the areas of both worlds by their Light world name for simplicity.

{|{{prettytable}}
! Index (Light World)
! Index (Dark World)
! Size (a{{x}}a)
! Description (for Light World)
|-
|{{$|00}} (0)
|{{$|40}} (64)
|1024
|Lost Woods
|-
|{{$|02}} (2)
|{{$|42}} (66)
|512
|Lumberjacks
|-
|{{$|03}} (3)
|{{$|43}} (67)
|1024
|Western Death Mountain
|-
|{{$|05}} (5)
|{{$|45}} (69)
|1024
|Eastern Death Mountain
|-
|{{$|07}} (7)
|{{$|47}} (71)
|512
|Turtle Rock
|-
|{{$|0A}} (10)
|{{$|4A}} (74)
|512
|Entrance to Death Mountain
|-
|{{$|0F}} (15)
|{{$|4F}} (79)
|512
|Entrance to Zora's Domain
|-
|{{$|10}} (16)
|{{$|50}} (80)
|512
|Path Between Kakariko Village and Lost Woods
|-
|{{$|11}} (17)
|{{$|51}} (81)
|512
|Kakariko Village Fortune Teller
|-
|{{$|12}} (18)
|{{$|52}} (82)
|512
|Pond Between Kakariko Village Fortune Teller and Sanctuary
|-
|{{$|13}} (19)
|{{$|53}} (83)
|512
|Sanctuary
|-
|{{$|14}} (20)
|{{$|54}} (84)
|512
|Graveyard
|-
|{{$|15}} (21)
|{{$|55}} (85)
|512
|River Between Graveyard and Witch's Hut
|-
|{{$|16}} (22)
|{{$|56}} (86)
|512
|Witch's Hut
|-
|{{$|17}} (23)
|{{$|57}} (87)
|512
|East of Witch's Hut
|-
|{{$|18}} (24)
|{{$|58}} (88)
|1024
|Kakariko Village
|-
|{{$|1A}} (26)
|{{$|5A}} (90)
|512
|Forest Between Kakariko Village and Hyrule Castle
|-
|{{$|1B}} (27)
|{{$|5B}} (91)
|1024
|Hyrule Castle
|-
|{{$|1D}} (29)
|{{$|5D}} (93)
|512
|Bridge Between Graveyard and Witch's Hut
|-
|{{$|1E}} (30)
|{{$|5E}} (94)
|1024
|Eastern Palace
|-
|{{$|22}} (34)
|{{$|62}} (98)
|512
|Smithy
|-
|{{$|25}} (37)
|{{$|65}} (101)
|512
|Path Between Hyrule Castle and Eastern Palace}} (top)
|-
|{{$|28}} (40)
|{{$|68}} (104)
|512
|Kakariko Village Maze Race
|-
|{{$|29}} (41)
|{{$|69}} (105)
|512
|Kakariko Village Library
|-
|{{$|2A}} (42)
|{{$|6A}} (106)
|512
|Haunted Grove
|-
|{{$|2B}} (43)
|{{$|6B}} (107)
|512
|Forest Between Haunted Grove and Link's House
|-
|{{$|2C}} (44)
|{{$|6C}} (108)
|512
|Link's House
|-
|{{$|2D}} (45)
|{{$|6D}} (109)
|512
|Path Between Hyrule Castle and Eastern Palace}} (bottom)
|-
|{{$|2E}} (46)
|{{$|6E}} (110)
|512
|Caves South of Eastern Palace (left)
|-
|{{$|2F}} (47)
|{{$|6F}} (111)
|512
|Caves South of Eastern Palace (right)
|-
|{{$|30}} (48)
|{{$|70}} (112)
|1024
|Desert of Mystery
|-
|{{$|32}} (50)
|{{$|72}} (114)
|512
|South of Haunted Grove
|-
|{{$|33}} (51)
|{{$|73}} (115)
|512
|Northwestern Great Swamp
|-
|{{$|34}} (52)
|{{$|74}} (116)
|512
|Northeastern Great Swamp
|-
|{{$|35}} (53)
|{{$|75}} (117)
|1024
|Lake Hylia
|-
|{{$|37}} (55)
|{{$|77}} (119)
|512
|Ice Cave
|-
|{{$|3A}} (58)
|{{$|7A}} (122)
|512
|Path Between Desert of Mystery and Great Swamp
|-
|{{$|3B}} (59)
|{{$|7B}} (123)
|512
|Southwestern Great Swamp
|-
|{{$|3C}} (60)
|{{$|7C}} (124)
|512
|Southeastern Great Swamp
|-
|{{$|3F}} (63)
|{{$|7F}} (127)
|512
|Path Between Lake Hylia and Ice Cave
|}

== Special Areas ==

;{{$|80}} ― 512{{x}}512
: Master Sword area ― (0, 0) to (255, 511)
: Area under the bridge ― (256, 0) to (511, 255)

;{{$|81}} ― 512{{x}}512
: Zora's Domain

==How maps are stored==
===Compression===
The background is composed of 32{{x}}32 blocks and are LZ1 compressed.

===Map32 to Map16 Conversion Values===
* {{0x|18000|1B3FE|3FE}} = Upper leftcorners (end with {{$|FF}} at {{0x|1B3FF}})
* {{0x|1B400|1E7FE|3FE}} = Upper right corners (end with {{$|FF}} at {{0x|1E7FF}})
* {{0x|20000|233FE|3FE}} = Lower leftcorners (end with {{$|FF}} at {{0x|233FF}})
* {{0x|23400|267EE|3FE}} = Lower right corners (end with {{$|FF}} at {{0x|267EF}})

{{note|1=Theses value come in pack of {{blue|4 bytes}}, followed by {{green|2 bytes}}. The {{green|2 bytes}} are 4 nibble value that are the extension of the {{blue|4 first}}}}

{{example|1=You have theses bytes:

{{blue|05 06 07 08 }}{{green|30 1A}}

* {{blue|05}} become {{$|305}}
* {{blue|06}} stays {{$|06}}
* {{blue|07}} become {{$|107}}
* {{blue|08}} become {{$|A08}}}}

==Map8 to Map16 Conversion Values==
* {{0x|78000|?????|470?}} = Map8 to Map16 conversion values (8 bytes per tile16), 2 byte each tile8
* {{red|v}}{{orange|h}}{{green|o}}{{blue|ppp}}{{purple|cc cccccccc}}
** {{red|v}} = mirror vertical
** {{orange|h}} = mirror horizontal
** {{green|o}} = ???
** {{blue|p}} = priority tile
** {{purple|c}} = tile index

==Map Size==
* {{0x|12844|12883}} = 1byte each map
** {{$|00}} = 512{{x}}512pixel map
** {{$|20}} = 1024{{x}}1024 pixel map

==Compressed tile arragement==
* {{0x|1794D}} = LONGPointers all tiles of maps [High] (mapid3)
* {{0x|17B2D}} = LONGPointers all tiles of maps [Low](mapid3)

{{Note|Data leading to is compressed using the LZ2 compression {{0x|05D97}} tiles gfx to load the map (correspond to GFX# in HM) surprisingly overworld only use 32 to 47 LW, 48 to 63 DW, 4 bytes per gfx}}

{{toc}}

Overworld Areas

2017-12-23T23:22:06Z

Tatters: /* Map32 to Map16 Conversion Values */

{{subpage|Overworld}}

{{see|Standard Notation}}

Outdoor areas (also known as the Overworld) come in two flavors: Normal and special. Normal outdoor areas (the Light world and the Dark world) are mirrored 8{{x}}8 grids of 512{{x}}512-pixel cells for a total of 64 cells and a 4096{{x}}4096-pixel area in size. Normal outdoor grid cells can be quadruple in size (1024{{x}}1024 pixels), in which case their indices represent their top-left quadrants and the indices for the other three quadrants they occupy do not occur. Special outdoor areas (such as Zora's Domain) are separate individual mini-areas on their own.

== Area Index ==

In WRAM, there is a byte which indicates whether or not the player is currently in an indoor or outdoor area, and when the player is in an outdoor area, there is a word which contains the index of the outdoor area the player is currently in.

;{{$|7E001B}}[{{$|1}}]
: 0 while player is outside
: 1 while player is inside

;{{$|7E008A}}[{{$|2}}]
: the current area index while player is outside
: invalid while player is inside

== Player Coordinates ==

''See also: [[Player Position]]''

Let A be the current area index, (Px,Py) be the current absolute player coordinates, and (Lx,Ly) be the local coordinates of the player within the current area.

When the player is in the Light world (area index {{$|00}}..{{$|3F}}), the player's coordinates originate at the top-left corner of area {{$|00}}, and the coordinates can be calculated as follows.

<nowiki>Lx = Px - ( A % 8 ) * 512
Ly = Py - ( A / 8 ) * 512</nowiki>

When the player is in the Dark world (area index {{$|40}}..{{$|7F}}), the player's coordinates originate at the top-left corner of area {{$|40}}, and the coordinates can be calculated as follows.

<nowiki>Lx = Px - ( ( A - $40 ) % 8 ) * 512
Ly = Py - ( ( A - $40 ) / 8 ) * 512</nowiki>

When the player is in a special area (area index {{$|80}} and up), the player's coordinates originate at the top-left corner of the current special area. There are two special areas: {{$|80}} combines the Master Sword area and the area under the bridge east of the player's house, and {{$|81}} is Zora's Domain. Local coordinates within the Master Sword area and within Zora's Domain are equal to the absolute coordinates. The player is in the area under the bridge when their X coordinate is 256 or greater, and their local X coordinate is simply their absolute X coordinate minus 256.

== The Light World and the Dark World ==

The Light world and Dark world mirror each other: Any area index in the Light world refers to an area index in the Dark world of the same size and at the same location, except the Dark world index is increased by {{$|40}}. The following table lists the areas of both worlds by their Light world name for simplicity.

{|{{prettytable}}
! Index (Light World)
! Index (Dark World)
! Size (a{{x}}a)
! Description (for Light World)
|-
|{{$|00}} (0)
|{{$|40}} (64)
|1024
|Lost Woods
|-
|{{$|02}} (2)
|{{$|42}} (66)
|512
|Lumberjacks
|-
|{{$|03}} (3)
|{{$|43}} (67)
|1024
|Western Death Mountain
|-
|{{$|05}} (5)
|{{$|45}} (69)
|1024
|Eastern Death Mountain
|-
|{{$|07}} (7)
|{{$|47}} (71)
|512
|Turtle Rock
|-
|{{$|0A}} (10)
|{{$|4A}} (74)
|512
|Entrance to Death Mountain
|-
|{{$|0F}} (15)
|{{$|4F}} (79)
|512
|Entrance to Zora's Domain
|-
|{{$|10}} (16)
|{{$|50}} (80)
|512
|Path Between Kakariko Village and Lost Woods
|-
|{{$|11}} (17)
|{{$|51}} (81)
|512
|Kakariko Village Fortune Teller
|-
|{{$|12}} (18)
|{{$|52}} (82)
|512
|Pond Between Kakariko Village Fortune Teller and Sanctuary
|-
|{{$|13}} (19)
|{{$|53}} (83)
|512
|Sanctuary
|-
|{{$|14}} (20)
|{{$|54}} (84)
|512
|Graveyard
|-
|{{$|15}} (21)
|{{$|55}} (85)
|512
|River Between Graveyard and Witch's Hut
|-
|{{$|16}} (22)
|{{$|56}} (86)
|512
|Witch's Hut
|-
|{{$|17}} (23)
|{{$|57}} (87)
|512
|East of Witch's Hut
|-
|{{$|18}} (24)
|{{$|58}} (88)
|1024
|Kakariko Village
|-
|{{$|1A}} (26)
|{{$|5A}} (90)
|512
|Forest Between Kakariko Village and Hyrule Castle
|-
|{{$|1B}} (27)
|{{$|5B}} (91)
|1024
|Hyrule Castle
|-
|{{$|1D}} (29)
|{{$|5D}} (93)
|512
|Bridge Between Graveyard and Witch's Hut
|-
|{{$|1E}} (30)
|{{$|5E}} (94)
|1024
|Eastern Palace
|-
|{{$|22}} (34)
|{{$|62}} (98)
|512
|Smithy
|-
|{{$|25}} (37)
|{{$|65}} (101)
|512
|Path Between Hyrule Castle and Eastern Palace}} (top)
|-
|{{$|28}} (40)
|{{$|68}} (104)
|512
|Kakariko Village Maze Race
|-
|{{$|29}} (41)
|{{$|69}} (105)
|512
|Kakariko Village Library
|-
|{{$|2A}} (42)
|{{$|6A}} (106)
|512
|Haunted Grove
|-
|{{$|2B}} (43)
|{{$|6B}} (107)
|512
|Forest Between Haunted Grove and Link's House
|-
|{{$|2C}} (44)
|{{$|6C}} (108)
|512
|Link's House
|-
|{{$|2D}} (45)
|{{$|6D}} (109)
|512
|Path Between Hyrule Castle and Eastern Palace}} (bottom)
|-
|{{$|2E}} (46)
|{{$|6E}} (110)
|512
|Caves South of Eastern Palace (left)
|-
|{{$|2F}} (47)
|{{$|6F}} (111)
|512
|Caves South of Eastern Palace (right)
|-
|{{$|30}} (48)
|{{$|70}} (112)
|1024
|Desert of Mystery
|-
|{{$|32}} (50)
|{{$|72}} (114)
|512
|South of Haunted Grove
|-
|{{$|33}} (51)
|{{$|73}} (115)
|512
|Northwestern Great Swamp
|-
|{{$|34}} (52)
|{{$|74}} (116)
|512
|Northeastern Great Swamp
|-
|{{$|35}} (53)
|{{$|75}} (117)
|1024
|Lake Hylia
|-
|{{$|37}} (55)
|{{$|77}} (119)
|512
|Ice Cave
|-
|{{$|3A}} (58)
|{{$|7A}} (122)
|512
|Path Between Desert of Mystery and Great Swamp
|-
|{{$|3B}} (59)
|{{$|7B}} (123)
|512
|Southwestern Great Swamp
|-
|{{$|3C}} (60)
|{{$|7C}} (124)
|512
|Southeastern Great Swamp
|-
|{{$|3F}} (63)
|{{$|7F}} (127)
|512
|Path Between Lake Hylia and Ice Cave
|}

== Special Areas ==

;{{$|80}} ― 512{{x}}512
: Master Sword area ― (0,0) to (255,511)
: Area under the bridge ― (256,0) to (511,255)

;{{$|81}} ― 512{{x}}512
: Zora's Domain

==How maps are stored==
===Compression===
The background is composed of 32{{x}}32 blocks and are LZ1 compressed.

===Map32 to Map16 Conversion Values===
* {{0x|18000|1B3FE|3FE}} = Upper leftcorners (end with {{$|FF}} at {{0x|1B3FF}})
* {{0x|1B400|1E7FE|3FE}} = Upper right corners (end with {{$|FF}} at {{0x|1E7FF}})
* {{0x|20000|233FE|3FE}} = Lower leftcorners (end with {{$|FF}} at {{0x|233FF}})
* {{0x|23400|267EE|3FE}} = Lower right corners (end with {{$|FF}} at {{0x|267EF}})

{{note|1=Theses value come in pack of {{blue|4 bytes}}, followed by {{green|2 bytes}}. The {{green|2 bytes}} are 4 nibble value that are the extension of the {{blue|4 first}}}}

{{example|1=You have theses bytes:

{{blue|05 06 07 08 }}{{green|30 1A}}

* {{blue|05}} become {{$|305}}
* {{blue|06}} stays {{$|06}}
* {{blue|07}} become {{$|107}}
* {{blue|08}} become {{$|A08}}}}

==Map8 to Map16 Conversion Values==
* {{0x|78000|?????|470?}} = Map8 to Map16 conversion values (8 bytes per tile16), 2 byte each tile8
* {{red|v}}{{orange|h}}{{green|o}}{{blue|ppp}}{{purple|cc cccccccc}}
** {{red|v}} = mirror vertical
** {{orange|h}} = mirror horizontal
** {{green|o}} = ???
** {{blue|p}} = priority tile
** {{purple|c}} = tile index

==Map Size==
* {{0x|12844|12883}} = 1byte each map
** {{$|00}} = 512{{x}}512pixel map
** {{$|20}} = 1024{{x}}1024 pixel map

==Compressed tile arragement==
* {{0x|1794D}} = LONGPointers all tiles of maps [High] (mapid3)
* {{0x|17B2D}} = LONGPointers all tiles of maps [Low](mapid3)

{{Note|Data leading to is compressed using the LZ2 compression {{0x|05D97}} tiles gfx to load the map (correspond to GFX# in HM) surprisingly overworld only use 32 to 47 LW, 48 to 63 DW, 4 bytes per gfx}}

{{toc}}

Overworld Areas

2017-12-23T23:20:14Z

Tatters: /* Map Size */

{{subpage|Overworld}}

{{see|Standard Notation}}

Outdoor areas (also known as the Overworld) come in two flavors: Normal and special. Normal outdoor areas (the Light world and the Dark world) are mirrored 8{{x}}8 grids of 512{{x}}512-pixel cells for a total of 64 cells and a 4096{{x}}4096-pixel area in size. Normal outdoor grid cells can be quadruple in size (1024{{x}}1024 pixels), in which case their indices represent their top-left quadrants and the indices for the other three quadrants they occupy do not occur. Special outdoor areas (such as Zora's Domain) are separate individual mini-areas on their own.

== Area Index ==

In WRAM, there is a byte which indicates whether or not the player is currently in an indoor or outdoor area, and when the player is in an outdoor area, there is a word which contains the index of the outdoor area the player is currently in.

;{{$|7E001B}}[{{$|1}}]
: 0 while player is outside
: 1 while player is inside

;{{$|7E008A}}[{{$|2}}]
: the current area index while player is outside
: invalid while player is inside

== Player Coordinates ==

''See also: [[Player Position]]''

Let A be the current area index, (Px,Py) be the current absolute player coordinates, and (Lx,Ly) be the local coordinates of the player within the current area.

When the player is in the Light world (area index {{$|00}}..{{$|3F}}), the player's coordinates originate at the top-left corner of area {{$|00}}, and the coordinates can be calculated as follows.

<nowiki>Lx = Px - ( A % 8 ) * 512
Ly = Py - ( A / 8 ) * 512</nowiki>

When the player is in the Dark world (area index {{$|40}}..{{$|7F}}), the player's coordinates originate at the top-left corner of area {{$|40}}, and the coordinates can be calculated as follows.

<nowiki>Lx = Px - ( ( A - $40 ) % 8 ) * 512
Ly = Py - ( ( A - $40 ) / 8 ) * 512</nowiki>

When the player is in a special area (area index {{$|80}} and up), the player's coordinates originate at the top-left corner of the current special area. There are two special areas: {{$|80}} combines the Master Sword area and the area under the bridge east of the player's house, and {{$|81}} is Zora's Domain. Local coordinates within the Master Sword area and within Zora's Domain are equal to the absolute coordinates. The player is in the area under the bridge when their X coordinate is 256 or greater, and their local X coordinate is simply their absolute X coordinate minus 256.

== The Light World and the Dark World ==

The Light world and Dark world mirror each other: Any area index in the Light world refers to an area index in the Dark world of the same size and at the same location, except the Dark world index is increased by {{$|40}}. The following table lists the areas of both worlds by their Light world name for simplicity.

{|{{prettytable}}
! Index (Light World)
! Index (Dark World)
! Size (a{{x}}a)
! Description (for Light World)
|-
|{{$|00}} (0)
|{{$|40}} (64)
|1024
|Lost Woods
|-
|{{$|02}} (2)
|{{$|42}} (66)
|512
|Lumberjacks
|-
|{{$|03}} (3)
|{{$|43}} (67)
|1024
|Western Death Mountain
|-
|{{$|05}} (5)
|{{$|45}} (69)
|1024
|Eastern Death Mountain
|-
|{{$|07}} (7)
|{{$|47}} (71)
|512
|Turtle Rock
|-
|{{$|0A}} (10)
|{{$|4A}} (74)
|512
|Entrance to Death Mountain
|-
|{{$|0F}} (15)
|{{$|4F}} (79)
|512
|Entrance to Zora's Domain
|-
|{{$|10}} (16)
|{{$|50}} (80)
|512
|Path Between Kakariko Village and Lost Woods
|-
|{{$|11}} (17)
|{{$|51}} (81)
|512
|Kakariko Village Fortune Teller
|-
|{{$|12}} (18)
|{{$|52}} (82)
|512
|Pond Between Kakariko Village Fortune Teller and Sanctuary
|-
|{{$|13}} (19)
|{{$|53}} (83)
|512
|Sanctuary
|-
|{{$|14}} (20)
|{{$|54}} (84)
|512
|Graveyard
|-
|{{$|15}} (21)
|{{$|55}} (85)
|512
|River Between Graveyard and Witch's Hut
|-
|{{$|16}} (22)
|{{$|56}} (86)
|512
|Witch's Hut
|-
|{{$|17}} (23)
|{{$|57}} (87)
|512
|East of Witch's Hut
|-
|{{$|18}} (24)
|{{$|58}} (88)
|1024
|Kakariko Village
|-
|{{$|1A}} (26)
|{{$|5A}} (90)
|512
|Forest Between Kakariko Village and Hyrule Castle
|-
|{{$|1B}} (27)
|{{$|5B}} (91)
|1024
|Hyrule Castle
|-
|{{$|1D}} (29)
|{{$|5D}} (93)
|512
|Bridge Between Graveyard and Witch's Hut
|-
|{{$|1E}} (30)
|{{$|5E}} (94)
|1024
|Eastern Palace
|-
|{{$|22}} (34)
|{{$|62}} (98)
|512
|Smithy
|-
|{{$|25}} (37)
|{{$|65}} (101)
|512
|Path Between Hyrule Castle and Eastern Palace}} (top)
|-
|{{$|28}} (40)
|{{$|68}} (104)
|512
|Kakariko Village Maze Race
|-
|{{$|29}} (41)
|{{$|69}} (105)
|512
|Kakariko Village Library
|-
|{{$|2A}} (42)
|{{$|6A}} (106)
|512
|Haunted Grove
|-
|{{$|2B}} (43)
|{{$|6B}} (107)
|512
|Forest Between Haunted Grove and Link's House
|-
|{{$|2C}} (44)
|{{$|6C}} (108)
|512
|Link's House
|-
|{{$|2D}} (45)
|{{$|6D}} (109)
|512
|Path Between Hyrule Castle and Eastern Palace}} (bottom)
|-
|{{$|2E}} (46)
|{{$|6E}} (110)
|512
|Caves South of Eastern Palace (left)
|-
|{{$|2F}} (47)
|{{$|6F}} (111)
|512
|Caves South of Eastern Palace (right)
|-
|{{$|30}} (48)
|{{$|70}} (112)
|1024
|Desert of Mystery
|-
|{{$|32}} (50)
|{{$|72}} (114)
|512
|South of Haunted Grove
|-
|{{$|33}} (51)
|{{$|73}} (115)
|512
|Northwestern Great Swamp
|-
|{{$|34}} (52)
|{{$|74}} (116)
|512
|Northeastern Great Swamp
|-
|{{$|35}} (53)
|{{$|75}} (117)
|1024
|Lake Hylia
|-
|{{$|37}} (55)
|{{$|77}} (119)
|512
|Ice Cave
|-
|{{$|3A}} (58)
|{{$|7A}} (122)
|512
|Path Between Desert of Mystery and Great Swamp
|-
|{{$|3B}} (59)
|{{$|7B}} (123)
|512
|Southwestern Great Swamp
|-
|{{$|3C}} (60)
|{{$|7C}} (124)
|512
|Southeastern Great Swamp
|-
|{{$|3F}} (63)
|{{$|7F}} (127)
|512
|Path Between Lake Hylia and Ice Cave
|}

== Special Areas ==

;{{$|80}} ― 512{{x}}512
: Master Sword area ― (0,0) to (255,511)
: Area under the bridge ― (256,0) to (511,255)

;{{$|81}} ― 512{{x}}512
: Zora's Domain

==How maps are stored==
===Compression===
The background is composed of 32{{x}}32 blocks and are LZ1 compressed.

===Map32 to Map16 Conversion Values===
* {{0x|18000|1B3FE|3FE}} = Upper leftcorners //end with $FF at 0x1B3FF
* {{0x|1B400|1E7FE|3FE}} = Upper right corners //end with $FF at 0x1E7FF
* {{0x|20000|233FE|3FE}} = Lower leftcorners //end with $FF at 0x233FF
* {{0x|23400|267EE|3FE}} = Lower right corners //end with $FF at 0x267EF

{{note|1=Theses value come in pack of {{blue|4 bytes}}, followed by {{green|2 bytes}}. The {{green|2 bytes}} are 4 nibble value that are the extension of the {{blue|4 first}}}}

{{example|1=You have theses bytes:

{{blue|05 06 07 08 }}{{green|30 1A}}

* {{blue|05}} become {{$|305}}
* {{blue|06}} stays {{$|06}}
* {{blue|07}} become {{$|107}}
* {{blue|08}} become {{$|A08}}}}

==Map8 to Map16 Conversion Values==
* {{0x|78000|?????|470?}} = Map8 to Map16 conversion values (8 bytes per tile16), 2 byte each tile8
* {{red|v}}{{orange|h}}{{green|o}}{{blue|ppp}}{{purple|cc cccccccc}}
** {{red|v}} = mirror vertical
** {{orange|h}} = mirror horizontal
** {{green|o}} = ???
** {{blue|p}} = priority tile
** {{purple|c}} = tile index

==Map Size==
* {{0x|12844|12883}} = 1byte each map
** {{$|00}} = 512{{x}}512pixel map
** {{$|20}} = 1024{{x}}1024 pixel map

==Compressed tile arragement==
* {{0x|1794D}} = LONGPointers all tiles of maps [High] (mapid3)
* {{0x|17B2D}} = LONGPointers all tiles of maps [Low](mapid3)

{{Note|Data leading to is compressed using the LZ2 compression {{0x|05D97}} tiles gfx to load the map (correspond to GFX# in HM) surprisingly overworld only use 32 to 47 LW, 48 to 63 DW, 4 bytes per gfx}}

{{toc}}

Underworld:Important Hex Addresses

2017-12-23T23:16:17Z

Tatters: /* (Inter Room) Torch Data */

{{subpage|Underworld}}

==Room Data==
===Room Headers===
*{{$|027502}} to {{$|027781}} = Pointer Table, {{hex|2}} byte local addresses, indexed by room ID.
*{{$|027781}} to {{$|027FEF}} = Data

<blockquote>
Headers are {{$|0E}} (Decimal: 14) bytes formatted thusly:
*Byte {{hex|0}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
**The {{red|a}} bits are transformed into {{hex|0000 0}}{{red|aaa}} and stored to {{$|0414}} ("BG2" in Hyrule Magic)
**The {{blue|b}} bits are transformed into {{hex|0000 0}}{{blue|bbb}} and stored to {{$|046C}} ("Collision" in Hyrule Magic)
**The {{green|c}} bit is unused
**The {{purple|d}} bit is stored to {{$|7EC005}} (If set, use a lights out routine in the room transition)

*Byte {{hex|1}}: {{red|aa}}{{blue|bb bbbb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{blue|bbbb bb}}{{hex|00}}, thus making them a multiple of 4.
This value is used to load 4 different palettes for the dungeon, and corresponds to, you guessed it, Palette # in Hyrule Magic!

The resulting index is used to load values for {{$|0AB6}}, {{$|0AAC}}, {{$|0AAD}}, and {{$|0AAE}}

*Byte {{hex|2}}: gets stored to {{$|0AA2}} (GFX # in Hyrule Magic)
*Byte {{hex|3}}: value + #$40 gets stored to {{$|0AA3}} (Sprite GFX # in Hyrule Magic)
*Byte {{hex|4}}: gets stored to {{$|00AD}} ("[[Room Effects|Effect]]" in Hyrule Magic)
*Byte {{hex|5}}: {{red|aa}}{{blue|bb bbbb}}
**{{red|a}} = ?
**The {{blue|b}} bits are "[[Room Tags|Tag1]]" in Hyrule Magic and gets stored to {{$|00AE}}.
*Byte {{hex|6}}: {{red|aa}}{{blue|bb bbbb}}
**{{red|a}} = ?
**The {{blue|b}} bits are "[[Room Tags|Tag2]]" in Hyrule Magic and get stored to {{$|00AF}}

These are the planes to use for bytes {{hex|9}} through {{hex|D}}. This determines which
BG you appear on, and possibly more.

*Byte {{hex|7}}: {{red|aa}}{{blue|bb}} {{green|cc}}{{purple|dd}}
**The {{red|a}} bits are transformed into {{hex|0000 00}}{{red|aa}} and stored to {{$|063F}}
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|063E}}
**The {{green|c}} bits are transformed into {{hex|0000 00}}{{green|cc}} and stored to {{$|063D}}
**The {{purple|d}} bits are transformed into {{hex|0000 00}}{{purple|dd}} and stored to {{$|063C}}

Note, the only safe values for a plane seem to be {{hex|0}},{{hex|1}}, or {{hex|2}}. Hyrule Magic
appears to violate this rule by letting you put {{hex|3}} down, but nothing higher.

*Byte {{hex|8}}: {{red|aaaa aa}}{{blue|bb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|0640}}

*Byte {{hex|9}}: stored to {{$|7EC000}} These are all room numbers that you could possibly exit to.
*Byte {{hex|A}}: stored to {{$|7EC001}}
*Byte {{hex|B}}: stored to {{$|7EC002}}
*Byte {{hex|C}}: stored to {{$|7EC003}}
*Byte {{hex|D}}: stored to {{$|7EC004}}
</blockquote>

===Sprite Data===
* {{$|04D62E}} to {{$|04D92E}} = Pointer Table, 2 byte local addresses, indexed by room.
* {{$|04D92E}} to {{$|04EC9D}} = Data

<blockquote>
Sprite data is formatted thusly:
*Byte {{hex|0}}: Stored to {{$|0FB3}}. Corresponds with "Sort Spr" in Hyrule Magic. In a layered room this indicates sprites in the foreground are to be drawn on top of sprites in the background.
**Bit {{hex|0}} - If {{hex|0}}, sprites will sort
**Bits {{hex|7,6,5,4,3,2,1}} - Unknown, should all be {{hex|1}}
After the byte {{hex|0}}, you will see 3 byte clusters that break down thus:

*Byte {{hex|0}}:
**Bits {{hex|4,3,2,1,0}} - Y coordinate (in pixels from the top, starting at {{hex|0}}) of the sprite divided by 16.
**Bits {{hex|6,5}} - If these are set, they will be used to generate a subtype, stored to {{$|0E30}}, X.
**Bit {{hex|7}} - If set, the sprite is on BG2, if not it's on BG1
* Byte {{hex|1}}:
** Bits {{hex|4,3,2,1,0}} - X coordinate (in pixels from the far left, starting at {{hex|0}}) of the sprite divided by 16.
** Bits {{hex|7,6,5}} - If all these bits are set then this is an Overlord, otherwise it's a normal sprite. If only some of them are set they can be used to generate a subtype, stored at {{$|0E30}}, X
* Byte {{hex|2}}: Sprite or Overlord type. If a sprite, this will get loaded into a slot at {{$|0E20}}, X. If an Overlord, will get loaded to {{$|0B00}}, X.

The array is terminated with a byte of {{$|FF}}.
</blockquote>

===Object Data===
* {{$|0F8000}} to {{$|0F83BF}} = Pointer Table, 3 byte long addresses, indexed by room ID.
* {{$|01EBA0}} to {{$|01FFF4}} = Data
* {{$|050000}} to {{$|053729}} = Data
* {{$|0F8780}} to {{$|0FFF4D}} = Data
<blockquote>
Byte layout:

* Byte 0: {{red|aaaa}} {{blue|bbbb}}.
**The a bits are transformed to {{red|aaaa}}{{hex|0000}} and select the type of empty space to fill in. Hyrule Magic calls this 'Floor 1' - Gets stored to {{$|7E0490}}
**The b bits are transformed to {{blue|bbbb}}{{hex|0000}} and are the what Hyrule Magic calls 'Floor 2' - Gets stored to {{$|7E046A}}

* Byte {{hex|1}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
** The {{red|a}} bits are unused and should not be used
** The {{blue|b}} bits determine the room's layout type, ranging from {{hex|0}} to {{hex|7}}.
** The {{green|c}} and {{purple|d}} bits are unknown, but I have a feeling it's related to {{$|AA}} and {{$|A9}}

After that the bytes come in {{hex|3}} or {{hex|2}} byte object structures, used by routine {{$|01:88E4}}. Objects are loaded until an object with value {{0x|FFFF}} occurs. If a value {{0x|FFF0}} is loaded, the game will start loading Type 2 objects and will not go back to loading Type 1 objects until it is time to load the next layer. (Layer as in HM, not to be confused with the SNES' Backgrounds.) A value of {{0x|FFFF}} will also terminate the loading of Type 2 objects. The routine immediately terminates if that happens during the loading of either object type.

Type 1 Object structure: (3 bytes):

* Byte {{hex|3}}: Routine to use. If this byte is ≥ {{0x|F8}} and < {{0x|FC}}, then it is a subtype 3 object. If the index is ≥ {{hex|FC}}, it is a subtype 2 object. If not, it is a subtype 1 object.

* Subtype 1 Objects, first and second byte
** High Byte: {{brown|yyyy yy}}{{green|cc}}
** Low Byte: {{grey|xxxx xx}}{{red|aa}}
*** The {{red|a}} bits are stored to {{$|B2}}
*** The {{green|c}} bits are stored to {{$|B4}}
*** The {{grey|x}} and {{brown|y}} bits are transformed into: {{hex|000}}{{brown|y yyyy y}}{{grey|xxx xxx}}{{hex|0}} - This is a tilemap address that indexes into {{$|7E2000}} and / or {{$|7E4000}}

Use Byte {{hex|3}} * 2 as an index into the table at {{$|8200}}. This is the routine that is used to draw and otherwise handle the object. Subtype 1 objects have a maximum width and height of 4. Width and height are measured in terms of 32 {{x}} 32 pixels. (⟸ last part is questionable)

*Subtype 2 Objects, 1st, 2nd, & 3rd bytes:
** Byte {{hex|3}}: {{white|ff}}{{purple|dd dddd}}
** Byte {{hex|2}}: {{pink|eeee}} {{green|cccc}}
** Byte {{hex|1}}: {{red|aaaa aa}}{{blue|bb}}
***The {{red|a}} bits are unused, but after all they are the marker for this type of object subtype.
***The {{blue|b}}, {{green|c}}, {{pink|e}}, and {{white|f}} bits are transformed into a VRAM tilemap address: {{hex|000}}{{green|c ccc}}{{white|f}} {{white|f}}{{blue|bb}}{{pink|e eee}}{{hex|0}}

Might I add this is one messed up format? The {{purple|d}} bits are used as an index into the table at {{$|8470}}. Since such indices are going to be even, the {{purple|d}} bits are transformed into: {{hex|0000 0000 0}}{{purple|ddd ddd}}{{hex|0}}.

*Subtype 3 Objects
**Similar to Subtype 1, with a few small exceptions.
**The vram address is calculated the same way. However, {{$|B2}} and {{$|B4}} are not used as length or width dimensions here. The routine that is used is determined as follows:
**Take the original index (times two) that a Subtype 1 would have used. AND that with {{0x|000E}}. Then shift left 3 times to produce {{hex|0000 0000 0}}{{pink|eee}} {{hex|0000}}. Then, OR in {{$|B2}} and {{$|B4}} and shift left once, so the final result is: {{hex|0000 0000}} {{pink|eee}}{{red|a a}}{{blue|bb}}{{hex|0}}.
**Also, this value indexes into {{$|85F0}} instead of {{$|8200}}.

Type 2 Object Structure: (2 bytes)
*High Byte: {{green|cccc cccc}}
*Low Byte: {{blue|bbbb}} {{purple|dd}}{{red|aa}}
**The {{red|a}} bits form a 2-bit value ({{hex|0000 0}}{{red|aa}}{{hex|0}}) that determines the routine to use for the object. In Hyrule Magic, corresponds to the "direction" of the door.
**The {{blue|b}} bits are transformed into {{hex|000}}{{blue|b bbb}}{{hex|0}} and stored to {{$|02}} ⟹ X. Corresponds to "Pos" of door objects in the Hyrule Magic. Note that these range from {{0x|00}} to {{0x|16}} (always even) which if you halve those values is 0 - 11 in decimal. This is easily verifiable in Hyrule Magic.
**The {{green|c}} bits are shifted into the lower byte and stored to {{$|04}} ⟹ A and {{$|0A}}. This is later used to grab the tiles used to draw the door and the area below it. In Hyrule Magic, corresponds to "type". Note the type is 1/2 of the number listed here. This is because to avoid using an ASL A command, the {{green|c}} bits are always even.
**The {{purple|d}} bits are unused.

Next I'll go into the nitty gritty of the various types (the value of {{$|04}}). Again note that we'll only be dealing with even values {{blue|b}}/{{green|c}} that's what you'll see in the code. To convert between here [as well as the code] and Hyrule Magic, take the hex value here and divide by two. Convert to decimal and that's your Hyrule Magic "type."

*Types:
{|{{Prettytable}}
! ID
! Description
|-
|{{0x|00}}
|Basic door. Index = {{$|0460}}
|-
|{{0x|02}}
|Normal door?
|-
|{{0x|04}}
|???
|-
|{{0x|06}}
|???
|-
|{{0x|08}}
|Waterfall door (only used in Swamp palace; in one room at that!)
|-
|{{0x|0A}}
|???
|-
|{{0x|0C}}
|Trap door (probably other types but this seems to be most common)
|-
|{{0x|12}}
|Adds a property to some doors allowing you to exit to the overworld (this is accomplished by writing to the tile attribute map)
|-
|{{0x|14}}
|Transition to dark room?
|-
|{{0x|16}}
|Toggles the target BG Link will emerge on. '''Ex.''' if Link starts on BG0 in the next room he'll be on BG1.
|-
|{{0x|20}}
| rowspan="2"|Locked door specifically for BG0.
|-
|{{0x|22}}
|-
|{{0x|24}}
| rowspan="2"|Locked door for either BG0 or BG1
|-
|{{0x|26}}
|-
|{{0x|30}}
|Large exploded pathway resulting from a switch being pulled (unusual to have as a door as it's huge)
|-
|{{0x|32}}
|Sword activated door. '''Ex.''' Agahnim's room with the curtain door you have to slash.
|-
|{{0x|46}}
|warp door?
|}
</blockquote>

===Dungeon Secrets Data===
* {{$|00DB69}} to {{$|00DDE8}} = Pointer Table, 2 byte local addresses, indexed by room ID.
* {{$|00DDE9}} to {{$|00E6B1}} = Data
<blockquote>
Data comes in 3 byte chunks and is terminated by an instance of {{$|FFFF}}

* Bytes {{hex|0}}, {{hex|1}}: A word that denotes the VRAM address that the item is found at. This identifies the item as belonging to that part of the screen.
* Byte {{hex|2}}: Identifies the type of item that is hiding there. E.g. {{$|08}} is a key
</blockquote>

===Push Block Data===
* {{$|0271DE}} to {{$|027369}} = Data
<Blockquote>
4 bytes per entry:
{{red|a a }}{{blue|x }} {{green|y}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the block (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the block (expressed as tilemap coordinate)
</blockquote>

===(Inter Room) Torch Data===
The torch data has three primary pointer locations. The pointers are stored as a long address.

{|{{prettytable}}
|+Primary pointer location
!USA
!JP
!G
|-
|{{0x|15B16}}, {{0x|15B1D}}, {{0x|15B24}}
|{{0x|1587A}}, {{0x|15881}}, {{0x|15888}}
|{{0x|15B98}}, {{0x|15B9F}}, {{0x|15BA6}}
|}

* In the USA version, the data goes from {{0x|2736A}} to {{0x|27489}}.
<Blockquote>
Consists of variable length segments consisting of:

{{red|a a }}{{blue|x }}{{green|y }}{{blue|x }}{{green|y }}{{hex|... }}{{$|FFFF}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the torch (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the torch (expressed as tilemap coordinate)
*{{$|FFFF}}: Delimeter
</blockquote>

===Chest Contents===
The chest contents have three primary pointer locations. The values at each location point to the same pointer. Yes, you read that right. The pointer is stored as a long address.

{|{{prettytable}}
|+Primary pointer location
!USA
!JP
!G
|-
|{{0x|EBFB}}, {{0x|EC0A}}, {{0x|EC10}}
|{{0x|EC08}}, {{0x|EC17}}, {{0x|EC26}}
|{{0x|EBD5}}, {{0x|EBE4}}, {{0x|EBF3}}
|}

The addresses below contain the size limit for the data for each region:

{|{{prettytable}}
|+Max Size
!USA
!JP
!G
|-
|{{0x|EBF6}}
|{{0x|EBF4}}
|{{0x|EBD0}}
|}

*In the original USA version the data goes from {{$|00E96E}} to {{$|00EB65}}.
<blockquote>
Array of chest information in 3 byte chunks. 168 entries in all ({{0x|A8}})

*First word - Room number it is located in. MSB determines whether it is a big chest or not. (big chest if set)
*Last byte - index of the type of item contained in the chest.
</blockquote>

==Room layout==
In Hyrule Magic, there's a label and textbox for room layouts. The layout value goes from {{$|0}} to {{$|7}}

The location:

{|{{prettytable}}
!USA
!JP
|-
|{{0x|26F2F}}
|{{0x|26C0F}}
|}

In the aforementioned location, there are 8 long pointers (Lo-Hi-Bank).

==Entrance Data==
There are {{$|85}} (Decimal: 133) normal entrances to the underworld from the overworld, and {{$|7}} (Decimal: 7) starting locations.
Normal entrances and starting locations use mostly the same types of data formatted the same, however they are located in different places in the ROM.
They are located and formatted thus:

===Entrance Room===
*{{$|014813}} to {{$|01491C}} = Normal Entrance Data
*{{$|015B6E}} to {{$|015B7B}} = Starting Location Data
<blockquote>
Each entry is a 2 byte Room ID where the player is placed after using an entrance.
</blockquote>

===Scroll Edges===
*{{$|01491D}} to {{$|014D44}} = Normal Entrance Data
*{{$|015B7C}} to {{$|015BB3}} = Starting Location Data
<blockquote>
Unsure about what these do exactly.
Each entry is 8 bytes long.
*Format: 1 byte each. Corresponds to hyrule magic values in the "More" a.k.a. Entrance Properties dialog box.
**HU -
**FU -
**HD -
**FD -
**HL -
**FL -
**HR -
**FR -
</blockquote>

===X Scroll===
*{{$|014D45}} to {{$|014E4E}} = Normal Entrance Data
*{{$|015BB4}} to {{$|015BC1}} = Starting Location Data
<blockquote>

</blockquote>

===Y Scroll===
*{{$|014E4F}} to {{$|014F58}} = Normal Entrance Data
*{{$|015BC2}} to {{$|015BCF}} = Starting Location Data
<blockquote>

</blockquote>

===X Coordinate===
*{{$|014F59}} to {{$|015062}} = Normal Entrance Data
*{{$|015BD0}} to {{$|015BDD}} = Starting Location Data
<blockquote>
Each entry is a 2 byte X coordinate where the player starts after using the corresponding entrance.
</blockquote>

===Y Coordinate===
*{{$|015063}} to {{$|01516C}} = Normal Entrance Data
*{{$|015BDE}} to {{$|015BEB}} = Starting Location Data
<blockquote>
Each entry is a 2 byte y coordinate where the player starts after using the corresponding entrance.
</blockquote>

===X Camera Coordinate===
*{{$|01516D}} to {{$|015276}} = Normal Entrance Data
*{{$|015BEC}} to {{$|015BF9}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

===Y Camera Coordinate===
*{{$|015277}} to {{$|015380}} = Normal Entrance Data
*{{$|015BFA}} to {{$|015C07}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

===Entrance Blockset===
*{{$|015381}} to {{$|015405}} = Normal Entrance Data
*{{$|015C08}} to {{$|015C0E}} = Starting Location Data
<blockquote>
1 byte each. This blockset affects walls and a few other things and persists through all rooms the player accesses from this entrance.
</blockquote>

===Floor Values===
*{{$|015406}} to {{$|01548A}} = Normal Entrance Data
*{{$|015C0F}} to {{$|015C15}} = Starting Location Data
<blockquote>
This tells us what kind of properties the floor has. 1 byte each:
*If 1, then it has floors that you can fall through to the next level
*If 0, I think it means it can be fallen down to
*If -1, has no pits
*If -2, ????
</blockquote>

===Dungeon Values===
*{{$|01548B}} to {{$|01550F}} = Normal Entrance Data
*{{$|015C16}} to {{$|015C1C}} = Starting Location Data
<blockquote>
1 Byte each.
Dungeons actually in the game are numbered like so {{$|00}}, {{$|02}}, {{$|04}}, ..., {{$|18}}, {{$|1A}}.
{{$|1C}} and {{$|1E}} are unused (and hence could potentially be added.) Notice they are all even numbers.
In asm routines these values are divided by two sometimes to provide an index into other arrays.
That's why. The definition of a "dungeon" is something with a key, compass, and map.

A value of {{$|FF}} (-1) denotes it doesn't belong to a dungeon.
</blockquote>

===Doorway Type===
*{{$|015510}} to {{$|015594}} = Normal Entrance Data
*{{$|015C2B}} to {{$|015C31}} = Starting Location Data
<blockquote>
This is used only when you exit the given room. For example, let's say you enter through a skull doorway in Skullwoods.
But that's not really a door way, it's just a set of tiles that are no different from a hole you might create after picking
up a big rock. But if you entered from a building door, the game has to know whether to put the door frame when you exit.
*1 byte:
**{{hex|0}} = no doorway when exiting
**{{hex|1}} = draws a door frame upon exiting
**{{hex|2}} = ???? HM says vertical doorframe. But in the original game, no doorway is vertical.

</blockquote>

===Ladder And BG Settings===
*{{$|015595}} to {{$|015619}} = Normal Entrance Data
*{{$|015C1D}} to {{$|015C23}} = Starting Location Data
<blockquote>
*1 byte each, with the following 2 bit layout: {{hex|xxx}}{{red|a}}{{pink|xxx}}{{blue|b}}
**{{hex|x}} - unimportant
**{{red|a}} - if set, then Link enters on the lower level (BG2)
**{{blue|b}} - if set... not sure what happens exactly. Check the game engine to be sure.
</blockquote>

===Horizontal And Vertical Scroll Properties===
*{{$|01561A}} to {{$|01569E}} = Normal Entrance Data
*{{$|015C24}} to {{$|015C2A}} = Starting Location Data
<blockquote>
For these, I guess if the flags in the appropriate places are set, then the room will be able to scroll in those directions.

*1 byte each, with the following layout: {{hex|xx}}{{red|a}}{{hex|xxx}}{{blue|b}}{{hex|x}}
**{{red|a}} - Horizontal flag
**{{blue|b}} - Vertical flag
</blockquote>

===Scroll Quadrant===
*{{$|01569F}} to {{$|015723}} = Normal Entrance Data
<blockquote>
*1 byte each, has four different expected values:
**0h, 2h, 10h, 12h
</blockquote>

===Exit Door Location===
*{{$|015724}} to {{$|01582D}} = Normal Entrance Data
*{{$|015C32}} to {{$|015C3F}} = Starting Location Data
<blockquote>
1 word each. Denotes X and Y coordinates for overworld?
</blockquote>

===Music===
*{{$|01582E}} to {{$|0158B2}} = Normal Entrance Data (JP: 15592 - 15616)
*{{$|015C4E}} to {{$|015C54}} = Starting Location Data
<blockquote>
1 byte each. A value of {{$|FF}} plays the same music as the overworld screen from which the player entered.
</blockquote>

===Entrance Values===
*{{$|015C40}} to {{$|015C4D}} = Starting Location Data
<blockquote>
1 word each. Since the starting locations have to reference an entrance, this is necessary.
</blockquote>

{{toc}}

Underworld:Important Hex Addresses

2017-12-23T23:14:54Z

Tatters: /* (Inter Room) Torch Data */

{{subpage|Underworld}}

==Room Data==
===Room Headers===
*{{$|027502}} to {{$|027781}} = Pointer Table, {{hex|2}} byte local addresses, indexed by room ID.
*{{$|027781}} to {{$|027FEF}} = Data

<blockquote>
Headers are {{$|0E}} (Decimal: 14) bytes formatted thusly:
*Byte {{hex|0}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
**The {{red|a}} bits are transformed into {{hex|0000 0}}{{red|aaa}} and stored to {{$|0414}} ("BG2" in Hyrule Magic)
**The {{blue|b}} bits are transformed into {{hex|0000 0}}{{blue|bbb}} and stored to {{$|046C}} ("Collision" in Hyrule Magic)
**The {{green|c}} bit is unused
**The {{purple|d}} bit is stored to {{$|7EC005}} (If set, use a lights out routine in the room transition)

*Byte {{hex|1}}: {{red|aa}}{{blue|bb bbbb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{blue|bbbb bb}}{{hex|00}}, thus making them a multiple of 4.
This value is used to load 4 different palettes for the dungeon, and corresponds to, you guessed it, Palette # in Hyrule Magic!

The resulting index is used to load values for {{$|0AB6}}, {{$|0AAC}}, {{$|0AAD}}, and {{$|0AAE}}

*Byte {{hex|2}}: gets stored to {{$|0AA2}} (GFX # in Hyrule Magic)
*Byte {{hex|3}}: value + #$40 gets stored to {{$|0AA3}} (Sprite GFX # in Hyrule Magic)
*Byte {{hex|4}}: gets stored to {{$|00AD}} ("[[Room Effects|Effect]]" in Hyrule Magic)
*Byte {{hex|5}}: {{red|aa}}{{blue|bb bbbb}}
**{{red|a}} = ?
**The {{blue|b}} bits are "[[Room Tags|Tag1]]" in Hyrule Magic and gets stored to {{$|00AE}}.
*Byte {{hex|6}}: {{red|aa}}{{blue|bb bbbb}}
**{{red|a}} = ?
**The {{blue|b}} bits are "[[Room Tags|Tag2]]" in Hyrule Magic and get stored to {{$|00AF}}

These are the planes to use for bytes {{hex|9}} through {{hex|D}}. This determines which
BG you appear on, and possibly more.

*Byte {{hex|7}}: {{red|aa}}{{blue|bb}} {{green|cc}}{{purple|dd}}
**The {{red|a}} bits are transformed into {{hex|0000 00}}{{red|aa}} and stored to {{$|063F}}
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|063E}}
**The {{green|c}} bits are transformed into {{hex|0000 00}}{{green|cc}} and stored to {{$|063D}}
**The {{purple|d}} bits are transformed into {{hex|0000 00}}{{purple|dd}} and stored to {{$|063C}}

Note, the only safe values for a plane seem to be {{hex|0}},{{hex|1}}, or {{hex|2}}. Hyrule Magic
appears to violate this rule by letting you put {{hex|3}} down, but nothing higher.

*Byte {{hex|8}}: {{red|aaaa aa}}{{blue|bb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|0640}}

*Byte {{hex|9}}: stored to {{$|7EC000}} These are all room numbers that you could possibly exit to.
*Byte {{hex|A}}: stored to {{$|7EC001}}
*Byte {{hex|B}}: stored to {{$|7EC002}}
*Byte {{hex|C}}: stored to {{$|7EC003}}
*Byte {{hex|D}}: stored to {{$|7EC004}}
</blockquote>

===Sprite Data===
* {{$|04D62E}} to {{$|04D92E}} = Pointer Table, 2 byte local addresses, indexed by room.
* {{$|04D92E}} to {{$|04EC9D}} = Data

<blockquote>
Sprite data is formatted thusly:
*Byte {{hex|0}}: Stored to {{$|0FB3}}. Corresponds with "Sort Spr" in Hyrule Magic. In a layered room this indicates sprites in the foreground are to be drawn on top of sprites in the background.
**Bit {{hex|0}} - If {{hex|0}}, sprites will sort
**Bits {{hex|7,6,5,4,3,2,1}} - Unknown, should all be {{hex|1}}
After the byte {{hex|0}}, you will see 3 byte clusters that break down thus:

*Byte {{hex|0}}:
**Bits {{hex|4,3,2,1,0}} - Y coordinate (in pixels from the top, starting at {{hex|0}}) of the sprite divided by 16.
**Bits {{hex|6,5}} - If these are set, they will be used to generate a subtype, stored to {{$|0E30}}, X.
**Bit {{hex|7}} - If set, the sprite is on BG2, if not it's on BG1
* Byte {{hex|1}}:
** Bits {{hex|4,3,2,1,0}} - X coordinate (in pixels from the far left, starting at {{hex|0}}) of the sprite divided by 16.
** Bits {{hex|7,6,5}} - If all these bits are set then this is an Overlord, otherwise it's a normal sprite. If only some of them are set they can be used to generate a subtype, stored at {{$|0E30}}, X
* Byte {{hex|2}}: Sprite or Overlord type. If a sprite, this will get loaded into a slot at {{$|0E20}}, X. If an Overlord, will get loaded to {{$|0B00}}, X.

The array is terminated with a byte of {{$|FF}}.
</blockquote>

===Object Data===
* {{$|0F8000}} to {{$|0F83BF}} = Pointer Table, 3 byte long addresses, indexed by room ID.
* {{$|01EBA0}} to {{$|01FFF4}} = Data
* {{$|050000}} to {{$|053729}} = Data
* {{$|0F8780}} to {{$|0FFF4D}} = Data
<blockquote>
Byte layout:

* Byte 0: {{red|aaaa}} {{blue|bbbb}}.
**The a bits are transformed to {{red|aaaa}}{{hex|0000}} and select the type of empty space to fill in. Hyrule Magic calls this 'Floor 1' - Gets stored to {{$|7E0490}}
**The b bits are transformed to {{blue|bbbb}}{{hex|0000}} and are the what Hyrule Magic calls 'Floor 2' - Gets stored to {{$|7E046A}}

* Byte {{hex|1}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
** The {{red|a}} bits are unused and should not be used
** The {{blue|b}} bits determine the room's layout type, ranging from {{hex|0}} to {{hex|7}}.
** The {{green|c}} and {{purple|d}} bits are unknown, but I have a feeling it's related to {{$|AA}} and {{$|A9}}

After that the bytes come in {{hex|3}} or {{hex|2}} byte object structures, used by routine {{$|01:88E4}}. Objects are loaded until an object with value {{0x|FFFF}} occurs. If a value {{0x|FFF0}} is loaded, the game will start loading Type 2 objects and will not go back to loading Type 1 objects until it is time to load the next layer. (Layer as in HM, not to be confused with the SNES' Backgrounds.) A value of {{0x|FFFF}} will also terminate the loading of Type 2 objects. The routine immediately terminates if that happens during the loading of either object type.

Type 1 Object structure: (3 bytes):

* Byte {{hex|3}}: Routine to use. If this byte is ≥ {{0x|F8}} and < {{0x|FC}}, then it is a subtype 3 object. If the index is ≥ {{hex|FC}}, it is a subtype 2 object. If not, it is a subtype 1 object.

* Subtype 1 Objects, first and second byte
** High Byte: {{brown|yyyy yy}}{{green|cc}}
** Low Byte: {{grey|xxxx xx}}{{red|aa}}
*** The {{red|a}} bits are stored to {{$|B2}}
*** The {{green|c}} bits are stored to {{$|B4}}
*** The {{grey|x}} and {{brown|y}} bits are transformed into: {{hex|000}}{{brown|y yyyy y}}{{grey|xxx xxx}}{{hex|0}} - This is a tilemap address that indexes into {{$|7E2000}} and / or {{$|7E4000}}

Use Byte {{hex|3}} * 2 as an index into the table at {{$|8200}}. This is the routine that is used to draw and otherwise handle the object. Subtype 1 objects have a maximum width and height of 4. Width and height are measured in terms of 32 {{x}} 32 pixels. (⟸ last part is questionable)

*Subtype 2 Objects, 1st, 2nd, & 3rd bytes:
** Byte {{hex|3}}: {{white|ff}}{{purple|dd dddd}}
** Byte {{hex|2}}: {{pink|eeee}} {{green|cccc}}
** Byte {{hex|1}}: {{red|aaaa aa}}{{blue|bb}}
***The {{red|a}} bits are unused, but after all they are the marker for this type of object subtype.
***The {{blue|b}}, {{green|c}}, {{pink|e}}, and {{white|f}} bits are transformed into a VRAM tilemap address: {{hex|000}}{{green|c ccc}}{{white|f}} {{white|f}}{{blue|bb}}{{pink|e eee}}{{hex|0}}

Might I add this is one messed up format? The {{purple|d}} bits are used as an index into the table at {{$|8470}}. Since such indices are going to be even, the {{purple|d}} bits are transformed into: {{hex|0000 0000 0}}{{purple|ddd ddd}}{{hex|0}}.

*Subtype 3 Objects
**Similar to Subtype 1, with a few small exceptions.
**The vram address is calculated the same way. However, {{$|B2}} and {{$|B4}} are not used as length or width dimensions here. The routine that is used is determined as follows:
**Take the original index (times two) that a Subtype 1 would have used. AND that with {{0x|000E}}. Then shift left 3 times to produce {{hex|0000 0000 0}}{{pink|eee}} {{hex|0000}}. Then, OR in {{$|B2}} and {{$|B4}} and shift left once, so the final result is: {{hex|0000 0000}} {{pink|eee}}{{red|a a}}{{blue|bb}}{{hex|0}}.
**Also, this value indexes into {{$|85F0}} instead of {{$|8200}}.

Type 2 Object Structure: (2 bytes)
*High Byte: {{green|cccc cccc}}
*Low Byte: {{blue|bbbb}} {{purple|dd}}{{red|aa}}
**The {{red|a}} bits form a 2-bit value ({{hex|0000 0}}{{red|aa}}{{hex|0}}) that determines the routine to use for the object. In Hyrule Magic, corresponds to the "direction" of the door.
**The {{blue|b}} bits are transformed into {{hex|000}}{{blue|b bbb}}{{hex|0}} and stored to {{$|02}} ⟹ X. Corresponds to "Pos" of door objects in the Hyrule Magic. Note that these range from {{0x|00}} to {{0x|16}} (always even) which if you halve those values is 0 - 11 in decimal. This is easily verifiable in Hyrule Magic.
**The {{green|c}} bits are shifted into the lower byte and stored to {{$|04}} ⟹ A and {{$|0A}}. This is later used to grab the tiles used to draw the door and the area below it. In Hyrule Magic, corresponds to "type". Note the type is 1/2 of the number listed here. This is because to avoid using an ASL A command, the {{green|c}} bits are always even.
**The {{purple|d}} bits are unused.

Next I'll go into the nitty gritty of the various types (the value of {{$|04}}). Again note that we'll only be dealing with even values {{blue|b}}/{{green|c}} that's what you'll see in the code. To convert between here [as well as the code] and Hyrule Magic, take the hex value here and divide by two. Convert to decimal and that's your Hyrule Magic "type."

*Types:
{|{{Prettytable}}
! ID
! Description
|-
|{{0x|00}}
|Basic door. Index = {{$|0460}}
|-
|{{0x|02}}
|Normal door?
|-
|{{0x|04}}
|???
|-
|{{0x|06}}
|???
|-
|{{0x|08}}
|Waterfall door (only used in Swamp palace; in one room at that!)
|-
|{{0x|0A}}
|???
|-
|{{0x|0C}}
|Trap door (probably other types but this seems to be most common)
|-
|{{0x|12}}
|Adds a property to some doors allowing you to exit to the overworld (this is accomplished by writing to the tile attribute map)
|-
|{{0x|14}}
|Transition to dark room?
|-
|{{0x|16}}
|Toggles the target BG Link will emerge on. '''Ex.''' if Link starts on BG0 in the next room he'll be on BG1.
|-
|{{0x|20}}
| rowspan="2"|Locked door specifically for BG0.
|-
|{{0x|22}}
|-
|{{0x|24}}
| rowspan="2"|Locked door for either BG0 or BG1
|-
|{{0x|26}}
|-
|{{0x|30}}
|Large exploded pathway resulting from a switch being pulled (unusual to have as a door as it's huge)
|-
|{{0x|32}}
|Sword activated door. '''Ex.''' Agahnim's room with the curtain door you have to slash.
|-
|{{0x|46}}
|warp door?
|}
</blockquote>

===Dungeon Secrets Data===
* {{$|00DB69}} to {{$|00DDE8}} = Pointer Table, 2 byte local addresses, indexed by room ID.
* {{$|00DDE9}} to {{$|00E6B1}} = Data
<blockquote>
Data comes in 3 byte chunks and is terminated by an instance of {{$|FFFF}}

* Bytes {{hex|0}}, {{hex|1}}: A word that denotes the VRAM address that the item is found at. This identifies the item as belonging to that part of the screen.
* Byte {{hex|2}}: Identifies the type of item that is hiding there. E.g. {{$|08}} is a key
</blockquote>

===Push Block Data===
* {{$|0271DE}} to {{$|027369}} = Data
<Blockquote>
4 bytes per entry:
{{red|a a }}{{blue|x }} {{green|y}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the block (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the block (expressed as tilemap coordinate)
</blockquote>

===(Inter Room) Torch Data===
The torch data has three primary pointer locations. The pointers are stored as a long address.

{|{{prettytable}}
|+Primary pointer location
!USA
!JP
!G
|-
|{{0x|15B16}}, {{0x|15B1D}}, {{0x|15B24}}
|{{0x|1587A}}, {{0x|15881}}, {{0x|15888}}
|{{0x|15B98}}, {{0x|15B9F}}, {{0x|15BA6}}
|}

* In the USA version, the data goes from {{$|02736A}} to {{$|027489}}.
<Blockquote>
Consists of variable length segments consisting of:

{{red|a a }}{{blue|x }}{{green|y }}{{blue|x }}{{green|y }}{{hex|... }}{{$|FFFF}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the torch (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the torch (expressed as tilemap coordinate)
*{{$|FFFF}}: Delimeter
</blockquote>

===Chest Contents===
The chest contents have three primary pointer locations. The values at each location point to the same pointer. Yes, you read that right. The pointer is stored as a long address.

{|{{prettytable}}
|+Primary pointer location
!USA
!JP
!G
|-
|{{0x|EBFB}}, {{0x|EC0A}}, {{0x|EC10}}
|{{0x|EC08}}, {{0x|EC17}}, {{0x|EC26}}
|{{0x|EBD5}}, {{0x|EBE4}}, {{0x|EBF3}}
|}

The addresses below contain the size limit for the data for each region:

{|{{prettytable}}
|+Max Size
!USA
!JP
!G
|-
|{{0x|EBF6}}
|{{0x|EBF4}}
|{{0x|EBD0}}
|}

*In the original USA version the data goes from {{$|00E96E}} to {{$|00EB65}}.
<blockquote>
Array of chest information in 3 byte chunks. 168 entries in all ({{0x|A8}})

*First word - Room number it is located in. MSB determines whether it is a big chest or not. (big chest if set)
*Last byte - index of the type of item contained in the chest.
</blockquote>

==Room layout==
In Hyrule Magic, there's a label and textbox for room layouts. The layout value goes from {{$|0}} to {{$|7}}

The location:

{|{{prettytable}}
!USA
!JP
|-
|{{0x|26F2F}}
|{{0x|26C0F}}
|}

In the aforementioned location, there are 8 long pointers (Lo-Hi-Bank).

==Entrance Data==
There are {{$|85}} (Decimal: 133) normal entrances to the underworld from the overworld, and {{$|7}} (Decimal: 7) starting locations.
Normal entrances and starting locations use mostly the same types of data formatted the same, however they are located in different places in the ROM.
They are located and formatted thus:

===Entrance Room===
*{{$|014813}} to {{$|01491C}} = Normal Entrance Data
*{{$|015B6E}} to {{$|015B7B}} = Starting Location Data
<blockquote>
Each entry is a 2 byte Room ID where the player is placed after using an entrance.
</blockquote>

===Scroll Edges===
*{{$|01491D}} to {{$|014D44}} = Normal Entrance Data
*{{$|015B7C}} to {{$|015BB3}} = Starting Location Data
<blockquote>
Unsure about what these do exactly.
Each entry is 8 bytes long.
*Format: 1 byte each. Corresponds to hyrule magic values in the "More" a.k.a. Entrance Properties dialog box.
**HU -
**FU -
**HD -
**FD -
**HL -
**FL -
**HR -
**FR -
</blockquote>

===X Scroll===
*{{$|014D45}} to {{$|014E4E}} = Normal Entrance Data
*{{$|015BB4}} to {{$|015BC1}} = Starting Location Data
<blockquote>

</blockquote>

===Y Scroll===
*{{$|014E4F}} to {{$|014F58}} = Normal Entrance Data
*{{$|015BC2}} to {{$|015BCF}} = Starting Location Data
<blockquote>

</blockquote>

===X Coordinate===
*{{$|014F59}} to {{$|015062}} = Normal Entrance Data
*{{$|015BD0}} to {{$|015BDD}} = Starting Location Data
<blockquote>
Each entry is a 2 byte X coordinate where the player starts after using the corresponding entrance.
</blockquote>

===Y Coordinate===
*{{$|015063}} to {{$|01516C}} = Normal Entrance Data
*{{$|015BDE}} to {{$|015BEB}} = Starting Location Data
<blockquote>
Each entry is a 2 byte y coordinate where the player starts after using the corresponding entrance.
</blockquote>

===X Camera Coordinate===
*{{$|01516D}} to {{$|015276}} = Normal Entrance Data
*{{$|015BEC}} to {{$|015BF9}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

===Y Camera Coordinate===
*{{$|015277}} to {{$|015380}} = Normal Entrance Data
*{{$|015BFA}} to {{$|015C07}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

===Entrance Blockset===
*{{$|015381}} to {{$|015405}} = Normal Entrance Data
*{{$|015C08}} to {{$|015C0E}} = Starting Location Data
<blockquote>
1 byte each. This blockset affects walls and a few other things and persists through all rooms the player accesses from this entrance.
</blockquote>

===Floor Values===
*{{$|015406}} to {{$|01548A}} = Normal Entrance Data
*{{$|015C0F}} to {{$|015C15}} = Starting Location Data
<blockquote>
This tells us what kind of properties the floor has. 1 byte each:
*If 1, then it has floors that you can fall through to the next level
*If 0, I think it means it can be fallen down to
*If -1, has no pits
*If -2, ????
</blockquote>

===Dungeon Values===
*{{$|01548B}} to {{$|01550F}} = Normal Entrance Data
*{{$|015C16}} to {{$|015C1C}} = Starting Location Data
<blockquote>
1 Byte each.
Dungeons actually in the game are numbered like so {{$|00}}, {{$|02}}, {{$|04}}, ..., {{$|18}}, {{$|1A}}.
{{$|1C}} and {{$|1E}} are unused (and hence could potentially be added.) Notice they are all even numbers.
In asm routines these values are divided by two sometimes to provide an index into other arrays.
That's why. The definition of a "dungeon" is something with a key, compass, and map.

A value of {{$|FF}} (-1) denotes it doesn't belong to a dungeon.
</blockquote>

===Doorway Type===
*{{$|015510}} to {{$|015594}} = Normal Entrance Data
*{{$|015C2B}} to {{$|015C31}} = Starting Location Data
<blockquote>
This is used only when you exit the given room. For example, let's say you enter through a skull doorway in Skullwoods.
But that's not really a door way, it's just a set of tiles that are no different from a hole you might create after picking
up a big rock. But if you entered from a building door, the game has to know whether to put the door frame when you exit.
*1 byte:
**{{hex|0}} = no doorway when exiting
**{{hex|1}} = draws a door frame upon exiting
**{{hex|2}} = ???? HM says vertical doorframe. But in the original game, no doorway is vertical.

</blockquote>

===Ladder And BG Settings===
*{{$|015595}} to {{$|015619}} = Normal Entrance Data
*{{$|015C1D}} to {{$|015C23}} = Starting Location Data
<blockquote>
*1 byte each, with the following 2 bit layout: {{hex|xxx}}{{red|a}}{{pink|xxx}}{{blue|b}}
**{{hex|x}} - unimportant
**{{red|a}} - if set, then Link enters on the lower level (BG2)
**{{blue|b}} - if set... not sure what happens exactly. Check the game engine to be sure.
</blockquote>

===Horizontal And Vertical Scroll Properties===
*{{$|01561A}} to {{$|01569E}} = Normal Entrance Data
*{{$|015C24}} to {{$|015C2A}} = Starting Location Data
<blockquote>
For these, I guess if the flags in the appropriate places are set, then the room will be able to scroll in those directions.

*1 byte each, with the following layout: {{hex|xx}}{{red|a}}{{hex|xxx}}{{blue|b}}{{hex|x}}
**{{red|a}} - Horizontal flag
**{{blue|b}} - Vertical flag
</blockquote>

===Scroll Quadrant===
*{{$|01569F}} to {{$|015723}} = Normal Entrance Data
<blockquote>
*1 byte each, has four different expected values:
**0h, 2h, 10h, 12h
</blockquote>

===Exit Door Location===
*{{$|015724}} to {{$|01582D}} = Normal Entrance Data
*{{$|015C32}} to {{$|015C3F}} = Starting Location Data
<blockquote>
1 word each. Denotes X and Y coordinates for overworld?
</blockquote>

===Music===
*{{$|01582E}} to {{$|0158B2}} = Normal Entrance Data (JP: 15592 - 15616)
*{{$|015C4E}} to {{$|015C54}} = Starting Location Data
<blockquote>
1 byte each. A value of {{$|FF}} plays the same music as the overworld screen from which the player entered.
</blockquote>

===Entrance Values===
*{{$|015C40}} to {{$|015C4D}} = Starting Location Data
<blockquote>
1 word each. Since the starting locations have to reference an entrance, this is necessary.
</blockquote>

{{toc}}

Underworld:Important Hex Addresses

2017-12-23T23:08:27Z

Tatters: /* Chest Contents */

{{subpage|Underworld}}

==Room Data==
===Room Headers===
*{{$|027502}} to {{$|027781}} = Pointer Table, {{hex|2}} byte local addresses, indexed by room ID.
*{{$|027781}} to {{$|027FEF}} = Data

<blockquote>
Headers are {{$|0E}} (Decimal: 14) bytes formatted thusly:
*Byte {{hex|0}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
**The {{red|a}} bits are transformed into {{hex|0000 0}}{{red|aaa}} and stored to {{$|0414}} ("BG2" in Hyrule Magic)
**The {{blue|b}} bits are transformed into {{hex|0000 0}}{{blue|bbb}} and stored to {{$|046C}} ("Collision" in Hyrule Magic)
**The {{green|c}} bit is unused
**The {{purple|d}} bit is stored to {{$|7EC005}} (If set, use a lights out routine in the room transition)

*Byte {{hex|1}}: {{red|aa}}{{blue|bb bbbb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{blue|bbbb bb}}{{hex|00}}, thus making them a multiple of 4.
This value is used to load 4 different palettes for the dungeon, and corresponds to, you guessed it, Palette # in Hyrule Magic!

The resulting index is used to load values for {{$|0AB6}}, {{$|0AAC}}, {{$|0AAD}}, and {{$|0AAE}}

*Byte {{hex|2}}: gets stored to {{$|0AA2}} (GFX # in Hyrule Magic)
*Byte {{hex|3}}: value + #$40 gets stored to {{$|0AA3}} (Sprite GFX # in Hyrule Magic)
*Byte {{hex|4}}: gets stored to {{$|00AD}} ("[[Room Effects|Effect]]" in Hyrule Magic)
*Byte {{hex|5}}: {{red|aa}}{{blue|bb bbbb}}
**{{red|a}} = ?
**The {{blue|b}} bits are "[[Room Tags|Tag1]]" in Hyrule Magic and gets stored to {{$|00AE}}.
*Byte {{hex|6}}: {{red|aa}}{{blue|bb bbbb}}
**{{red|a}} = ?
**The {{blue|b}} bits are "[[Room Tags|Tag2]]" in Hyrule Magic and get stored to {{$|00AF}}

These are the planes to use for bytes {{hex|9}} through {{hex|D}}. This determines which
BG you appear on, and possibly more.

*Byte {{hex|7}}: {{red|aa}}{{blue|bb}} {{green|cc}}{{purple|dd}}
**The {{red|a}} bits are transformed into {{hex|0000 00}}{{red|aa}} and stored to {{$|063F}}
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|063E}}
**The {{green|c}} bits are transformed into {{hex|0000 00}}{{green|cc}} and stored to {{$|063D}}
**The {{purple|d}} bits are transformed into {{hex|0000 00}}{{purple|dd}} and stored to {{$|063C}}

Note, the only safe values for a plane seem to be {{hex|0}},{{hex|1}}, or {{hex|2}}. Hyrule Magic
appears to violate this rule by letting you put {{hex|3}} down, but nothing higher.

*Byte {{hex|8}}: {{red|aaaa aa}}{{blue|bb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|0640}}

*Byte {{hex|9}}: stored to {{$|7EC000}} These are all room numbers that you could possibly exit to.
*Byte {{hex|A}}: stored to {{$|7EC001}}
*Byte {{hex|B}}: stored to {{$|7EC002}}
*Byte {{hex|C}}: stored to {{$|7EC003}}
*Byte {{hex|D}}: stored to {{$|7EC004}}
</blockquote>

===Sprite Data===
* {{$|04D62E}} to {{$|04D92E}} = Pointer Table, 2 byte local addresses, indexed by room.
* {{$|04D92E}} to {{$|04EC9D}} = Data

<blockquote>
Sprite data is formatted thusly:
*Byte {{hex|0}}: Stored to {{$|0FB3}}. Corresponds with "Sort Spr" in Hyrule Magic. In a layered room this indicates sprites in the foreground are to be drawn on top of sprites in the background.
**Bit {{hex|0}} - If {{hex|0}}, sprites will sort
**Bits {{hex|7,6,5,4,3,2,1}} - Unknown, should all be {{hex|1}}
After the byte {{hex|0}}, you will see 3 byte clusters that break down thus:

*Byte {{hex|0}}:
**Bits {{hex|4,3,2,1,0}} - Y coordinate (in pixels from the top, starting at {{hex|0}}) of the sprite divided by 16.
**Bits {{hex|6,5}} - If these are set, they will be used to generate a subtype, stored to {{$|0E30}}, X.
**Bit {{hex|7}} - If set, the sprite is on BG2, if not it's on BG1
* Byte {{hex|1}}:
** Bits {{hex|4,3,2,1,0}} - X coordinate (in pixels from the far left, starting at {{hex|0}}) of the sprite divided by 16.
** Bits {{hex|7,6,5}} - If all these bits are set then this is an Overlord, otherwise it's a normal sprite. If only some of them are set they can be used to generate a subtype, stored at {{$|0E30}}, X
* Byte {{hex|2}}: Sprite or Overlord type. If a sprite, this will get loaded into a slot at {{$|0E20}}, X. If an Overlord, will get loaded to {{$|0B00}}, X.

The array is terminated with a byte of {{$|FF}}.
</blockquote>

===Object Data===
* {{$|0F8000}} to {{$|0F83BF}} = Pointer Table, 3 byte long addresses, indexed by room ID.
* {{$|01EBA0}} to {{$|01FFF4}} = Data
* {{$|050000}} to {{$|053729}} = Data
* {{$|0F8780}} to {{$|0FFF4D}} = Data
<blockquote>
Byte layout:

* Byte 0: {{red|aaaa}} {{blue|bbbb}}.
**The a bits are transformed to {{red|aaaa}}{{hex|0000}} and select the type of empty space to fill in. Hyrule Magic calls this 'Floor 1' - Gets stored to {{$|7E0490}}
**The b bits are transformed to {{blue|bbbb}}{{hex|0000}} and are the what Hyrule Magic calls 'Floor 2' - Gets stored to {{$|7E046A}}

* Byte {{hex|1}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
** The {{red|a}} bits are unused and should not be used
** The {{blue|b}} bits determine the room's layout type, ranging from {{hex|0}} to {{hex|7}}.
** The {{green|c}} and {{purple|d}} bits are unknown, but I have a feeling it's related to {{$|AA}} and {{$|A9}}

After that the bytes come in {{hex|3}} or {{hex|2}} byte object structures, used by routine {{$|01:88E4}}. Objects are loaded until an object with value {{0x|FFFF}} occurs. If a value {{0x|FFF0}} is loaded, the game will start loading Type 2 objects and will not go back to loading Type 1 objects until it is time to load the next layer. (Layer as in HM, not to be confused with the SNES' Backgrounds.) A value of {{0x|FFFF}} will also terminate the loading of Type 2 objects. The routine immediately terminates if that happens during the loading of either object type.

Type 1 Object structure: (3 bytes):

* Byte {{hex|3}}: Routine to use. If this byte is ≥ {{0x|F8}} and < {{0x|FC}}, then it is a subtype 3 object. If the index is ≥ {{hex|FC}}, it is a subtype 2 object. If not, it is a subtype 1 object.

* Subtype 1 Objects, first and second byte
** High Byte: {{brown|yyyy yy}}{{green|cc}}
** Low Byte: {{grey|xxxx xx}}{{red|aa}}
*** The {{red|a}} bits are stored to {{$|B2}}
*** The {{green|c}} bits are stored to {{$|B4}}
*** The {{grey|x}} and {{brown|y}} bits are transformed into: {{hex|000}}{{brown|y yyyy y}}{{grey|xxx xxx}}{{hex|0}} - This is a tilemap address that indexes into {{$|7E2000}} and / or {{$|7E4000}}

Use Byte {{hex|3}} * 2 as an index into the table at {{$|8200}}. This is the routine that is used to draw and otherwise handle the object. Subtype 1 objects have a maximum width and height of 4. Width and height are measured in terms of 32 {{x}} 32 pixels. (⟸ last part is questionable)

*Subtype 2 Objects, 1st, 2nd, & 3rd bytes:
** Byte {{hex|3}}: {{white|ff}}{{purple|dd dddd}}
** Byte {{hex|2}}: {{pink|eeee}} {{green|cccc}}
** Byte {{hex|1}}: {{red|aaaa aa}}{{blue|bb}}
***The {{red|a}} bits are unused, but after all they are the marker for this type of object subtype.
***The {{blue|b}}, {{green|c}}, {{pink|e}}, and {{white|f}} bits are transformed into a VRAM tilemap address: {{hex|000}}{{green|c ccc}}{{white|f}} {{white|f}}{{blue|bb}}{{pink|e eee}}{{hex|0}}

Might I add this is one messed up format? The {{purple|d}} bits are used as an index into the table at {{$|8470}}. Since such indices are going to be even, the {{purple|d}} bits are transformed into: {{hex|0000 0000 0}}{{purple|ddd ddd}}{{hex|0}}.

*Subtype 3 Objects
**Similar to Subtype 1, with a few small exceptions.
**The vram address is calculated the same way. However, {{$|B2}} and {{$|B4}} are not used as length or width dimensions here. The routine that is used is determined as follows:
**Take the original index (times two) that a Subtype 1 would have used. AND that with {{0x|000E}}. Then shift left 3 times to produce {{hex|0000 0000 0}}{{pink|eee}} {{hex|0000}}. Then, OR in {{$|B2}} and {{$|B4}} and shift left once, so the final result is: {{hex|0000 0000}} {{pink|eee}}{{red|a a}}{{blue|bb}}{{hex|0}}.
**Also, this value indexes into {{$|85F0}} instead of {{$|8200}}.

Type 2 Object Structure: (2 bytes)
*High Byte: {{green|cccc cccc}}
*Low Byte: {{blue|bbbb}} {{purple|dd}}{{red|aa}}
**The {{red|a}} bits form a 2-bit value ({{hex|0000 0}}{{red|aa}}{{hex|0}}) that determines the routine to use for the object. In Hyrule Magic, corresponds to the "direction" of the door.
**The {{blue|b}} bits are transformed into {{hex|000}}{{blue|b bbb}}{{hex|0}} and stored to {{$|02}} ⟹ X. Corresponds to "Pos" of door objects in the Hyrule Magic. Note that these range from {{0x|00}} to {{0x|16}} (always even) which if you halve those values is 0 - 11 in decimal. This is easily verifiable in Hyrule Magic.
**The {{green|c}} bits are shifted into the lower byte and stored to {{$|04}} ⟹ A and {{$|0A}}. This is later used to grab the tiles used to draw the door and the area below it. In Hyrule Magic, corresponds to "type". Note the type is 1/2 of the number listed here. This is because to avoid using an ASL A command, the {{green|c}} bits are always even.
**The {{purple|d}} bits are unused.

Next I'll go into the nitty gritty of the various types (the value of {{$|04}}). Again note that we'll only be dealing with even values {{blue|b}}/{{green|c}} that's what you'll see in the code. To convert between here [as well as the code] and Hyrule Magic, take the hex value here and divide by two. Convert to decimal and that's your Hyrule Magic "type."

*Types:
{|{{Prettytable}}
! ID
! Description
|-
|{{0x|00}}
|Basic door. Index = {{$|0460}}
|-
|{{0x|02}}
|Normal door?
|-
|{{0x|04}}
|???
|-
|{{0x|06}}
|???
|-
|{{0x|08}}
|Waterfall door (only used in Swamp palace; in one room at that!)
|-
|{{0x|0A}}
|???
|-
|{{0x|0C}}
|Trap door (probably other types but this seems to be most common)
|-
|{{0x|12}}
|Adds a property to some doors allowing you to exit to the overworld (this is accomplished by writing to the tile attribute map)
|-
|{{0x|14}}
|Transition to dark room?
|-
|{{0x|16}}
|Toggles the target BG Link will emerge on. '''Ex.''' if Link starts on BG0 in the next room he'll be on BG1.
|-
|{{0x|20}}
| rowspan="2"|Locked door specifically for BG0.
|-
|{{0x|22}}
|-
|{{0x|24}}
| rowspan="2"|Locked door for either BG0 or BG1
|-
|{{0x|26}}
|-
|{{0x|30}}
|Large exploded pathway resulting from a switch being pulled (unusual to have as a door as it's huge)
|-
|{{0x|32}}
|Sword activated door. '''Ex.''' Agahnim's room with the curtain door you have to slash.
|-
|{{0x|46}}
|warp door?
|}
</blockquote>

===Dungeon Secrets Data===
* {{$|00DB69}} to {{$|00DDE8}} = Pointer Table, 2 byte local addresses, indexed by room ID.
* {{$|00DDE9}} to {{$|00E6B1}} = Data
<blockquote>
Data comes in 3 byte chunks and is terminated by an instance of {{$|FFFF}}

* Bytes {{hex|0}}, {{hex|1}}: A word that denotes the VRAM address that the item is found at. This identifies the item as belonging to that part of the screen.
* Byte {{hex|2}}: Identifies the type of item that is hiding there. E.g. {{$|08}} is a key
</blockquote>

===Push Block Data===
* {{$|0271DE}} to {{$|027369}} = Data
<Blockquote>
4 bytes per entry:
{{red|a a }}{{blue|x }} {{green|y}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the block (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the block (expressed as tilemap coordinate)
</blockquote>

===(Inter Room) Torch Data===
* {{$|02736A}} to {{$|027489}} = Data
<Blockquote>
Consists of variable length segments consisting of:

{{red|a a }}{{blue|x }}{{green|y }}{{blue|x }}{{green|y }}{{hex|... }}{{$|FFFF}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the torch (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the torch (expressed as tilemap coordinate)
*{{$|FFFF}}: Delimeter
</blockquote>

===Chest Contents===
The chest contents have three primary pointer locations. The values at each location point to the same pointer. Yes, you read that right. The pointer is stored as a long address.

{|{{prettytable}}
|+Primary pointer location
!USA
!JP
!G
|-
|{{0x|EBFB}}, {{0x|EC0A}}, {{0x|EC10}}
|{{0x|EC08}}, {{0x|EC17}}, {{0x|EC26}}
|{{0x|EBD5}}, {{0x|EBE4}}, {{0x|EBF3}}
|}

The addresses below contain the size limit for the data for each region:

{|{{prettytable}}
|+Max Size
!USA
!JP
!G
|-
|{{0x|EBF6}}
|{{0x|EBF4}}
|{{0x|EBD0}}
|}

*In the original USA version the data goes from {{$|00E96E}} to {{$|00EB65}}.
<blockquote>
Array of chest information in 3 byte chunks. 168 entries in all ({{0x|A8}})

*First word - Room number it is located in. MSB determines whether it is a big chest or not. (big chest if set)
*Last byte - index of the type of item contained in the chest.
</blockquote>

==Room layout==
In Hyrule Magic, there's a label and textbox for room layouts. The layout value goes from {{$|0}} to {{$|7}}

The location:

{|{{prettytable}}
!USA
!JP
|-
|{{0x|26F2F}}
|{{0x|26C0F}}
|}

In the aforementioned location, there are 8 long pointers (Lo-Hi-Bank).

==Entrance Data==
There are {{$|85}} (Decimal: 133) normal entrances to the underworld from the overworld, and {{$|7}} (Decimal: 7) starting locations.
Normal entrances and starting locations use mostly the same types of data formatted the same, however they are located in different places in the ROM.
They are located and formatted thus:

===Entrance Room===
*{{$|014813}} to {{$|01491C}} = Normal Entrance Data
*{{$|015B6E}} to {{$|015B7B}} = Starting Location Data
<blockquote>
Each entry is a 2 byte Room ID where the player is placed after using an entrance.
</blockquote>

===Scroll Edges===
*{{$|01491D}} to {{$|014D44}} = Normal Entrance Data
*{{$|015B7C}} to {{$|015BB3}} = Starting Location Data
<blockquote>
Unsure about what these do exactly.
Each entry is 8 bytes long.
*Format: 1 byte each. Corresponds to hyrule magic values in the "More" a.k.a. Entrance Properties dialog box.
**HU -
**FU -
**HD -
**FD -
**HL -
**FL -
**HR -
**FR -
</blockquote>

===X Scroll===
*{{$|014D45}} to {{$|014E4E}} = Normal Entrance Data
*{{$|015BB4}} to {{$|015BC1}} = Starting Location Data
<blockquote>

</blockquote>

===Y Scroll===
*{{$|014E4F}} to {{$|014F58}} = Normal Entrance Data
*{{$|015BC2}} to {{$|015BCF}} = Starting Location Data
<blockquote>

</blockquote>

===X Coordinate===
*{{$|014F59}} to {{$|015062}} = Normal Entrance Data
*{{$|015BD0}} to {{$|015BDD}} = Starting Location Data
<blockquote>
Each entry is a 2 byte X coordinate where the player starts after using the corresponding entrance.
</blockquote>

===Y Coordinate===
*{{$|015063}} to {{$|01516C}} = Normal Entrance Data
*{{$|015BDE}} to {{$|015BEB}} = Starting Location Data
<blockquote>
Each entry is a 2 byte y coordinate where the player starts after using the corresponding entrance.
</blockquote>

===X Camera Coordinate===
*{{$|01516D}} to {{$|015276}} = Normal Entrance Data
*{{$|015BEC}} to {{$|015BF9}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

===Y Camera Coordinate===
*{{$|015277}} to {{$|015380}} = Normal Entrance Data
*{{$|015BFA}} to {{$|015C07}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

===Entrance Blockset===
*{{$|015381}} to {{$|015405}} = Normal Entrance Data
*{{$|015C08}} to {{$|015C0E}} = Starting Location Data
<blockquote>
1 byte each. This blockset affects walls and a few other things and persists through all rooms the player accesses from this entrance.
</blockquote>

===Floor Values===
*{{$|015406}} to {{$|01548A}} = Normal Entrance Data
*{{$|015C0F}} to {{$|015C15}} = Starting Location Data
<blockquote>
This tells us what kind of properties the floor has. 1 byte each:
*If 1, then it has floors that you can fall through to the next level
*If 0, I think it means it can be fallen down to
*If -1, has no pits
*If -2, ????
</blockquote>

===Dungeon Values===
*{{$|01548B}} to {{$|01550F}} = Normal Entrance Data
*{{$|015C16}} to {{$|015C1C}} = Starting Location Data
<blockquote>
1 Byte each.
Dungeons actually in the game are numbered like so {{$|00}}, {{$|02}}, {{$|04}}, ..., {{$|18}}, {{$|1A}}.
{{$|1C}} and {{$|1E}} are unused (and hence could potentially be added.) Notice they are all even numbers.
In asm routines these values are divided by two sometimes to provide an index into other arrays.
That's why. The definition of a "dungeon" is something with a key, compass, and map.

A value of {{$|FF}} (-1) denotes it doesn't belong to a dungeon.
</blockquote>

===Doorway Type===
*{{$|015510}} to {{$|015594}} = Normal Entrance Data
*{{$|015C2B}} to {{$|015C31}} = Starting Location Data
<blockquote>
This is used only when you exit the given room. For example, let's say you enter through a skull doorway in Skullwoods.
But that's not really a door way, it's just a set of tiles that are no different from a hole you might create after picking
up a big rock. But if you entered from a building door, the game has to know whether to put the door frame when you exit.
*1 byte:
**{{hex|0}} = no doorway when exiting
**{{hex|1}} = draws a door frame upon exiting
**{{hex|2}} = ???? HM says vertical doorframe. But in the original game, no doorway is vertical.

</blockquote>

===Ladder And BG Settings===
*{{$|015595}} to {{$|015619}} = Normal Entrance Data
*{{$|015C1D}} to {{$|015C23}} = Starting Location Data
<blockquote>
*1 byte each, with the following 2 bit layout: {{hex|xxx}}{{red|a}}{{pink|xxx}}{{blue|b}}
**{{hex|x}} - unimportant
**{{red|a}} - if set, then Link enters on the lower level (BG2)
**{{blue|b}} - if set... not sure what happens exactly. Check the game engine to be sure.
</blockquote>

===Horizontal And Vertical Scroll Properties===
*{{$|01561A}} to {{$|01569E}} = Normal Entrance Data
*{{$|015C24}} to {{$|015C2A}} = Starting Location Data
<blockquote>
For these, I guess if the flags in the appropriate places are set, then the room will be able to scroll in those directions.

*1 byte each, with the following layout: {{hex|xx}}{{red|a}}{{hex|xxx}}{{blue|b}}{{hex|x}}
**{{red|a}} - Horizontal flag
**{{blue|b}} - Vertical flag
</blockquote>

===Scroll Quadrant===
*{{$|01569F}} to {{$|015723}} = Normal Entrance Data
<blockquote>
*1 byte each, has four different expected values:
**0h, 2h, 10h, 12h
</blockquote>

===Exit Door Location===
*{{$|015724}} to {{$|01582D}} = Normal Entrance Data
*{{$|015C32}} to {{$|015C3F}} = Starting Location Data
<blockquote>
1 word each. Denotes X and Y coordinates for overworld?
</blockquote>

===Music===
*{{$|01582E}} to {{$|0158B2}} = Normal Entrance Data (JP: 15592 - 15616)
*{{$|015C4E}} to {{$|015C54}} = Starting Location Data
<blockquote>
1 byte each. A value of {{$|FF}} plays the same music as the overworld screen from which the player entered.
</blockquote>

===Entrance Values===
*{{$|015C40}} to {{$|015C4D}} = Starting Location Data
<blockquote>
1 word each. Since the starting locations have to reference an entrance, this is necessary.
</blockquote>

{{toc}}

Underworld:Important Hex Addresses

2017-12-23T22:11:01Z

Tatters:

{{subpage|Underworld}}

==Room Data==
===Room Headers===
*{{$|027502}} to {{$|027781}} = Pointer Table, {{hex|2}} byte local addresses, indexed by room ID.
*{{$|027781}} to {{$|027FEF}} = Data

<blockquote>
Headers are {{$|0E}} (Decimal: 14) bytes formatted thusly:
*Byte {{hex|0}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
**The {{red|a}} bits are transformed into {{hex|0000 0}}{{red|aaa}} and stored to {{$|0414}} ("BG2" in Hyrule Magic)
**The {{blue|b}} bits are transformed into {{hex|0000 0}}{{blue|bbb}} and stored to {{$|046C}} ("Collision" in Hyrule Magic)
**The {{green|c}} bit is unused
**The {{purple|d}} bit is stored to {{$|7EC005}} (If set, use a lights out routine in the room transition)

*Byte {{hex|1}}: {{red|aa}}{{blue|bb bbbb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{blue|bbbb bb}}{{hex|00}}, thus making them a multiple of 4.
This value is used to load 4 different palettes for the dungeon, and corresponds to, you guessed it, Palette # in Hyrule Magic!

The resulting index is used to load values for {{$|0AB6}}, {{$|0AAC}}, {{$|0AAD}}, and {{$|0AAE}}

*Byte {{hex|2}}: gets stored to {{$|0AA2}} (GFX # in Hyrule Magic)
*Byte {{hex|3}}: value + #$40 gets stored to {{$|0AA3}} (Sprite GFX # in Hyrule Magic)
*Byte {{hex|4}}: gets stored to {{$|00AD}} ("[[Room Effects|Effect]]" in Hyrule Magic)
*Byte {{hex|5}}: {{red|aa}}{{blue|bb bbbb}}
**{{red|a}} = ?
**The {{blue|b}} bits are "[[Room Tags|Tag1]]" in Hyrule Magic and gets stored to {{$|00AE}}.
*Byte {{hex|6}}: {{red|aa}}{{blue|bb bbbb}}
**{{red|a}} = ?
**The {{blue|b}} bits are "[[Room Tags|Tag2]]" in Hyrule Magic and get stored to {{$|00AF}}

These are the planes to use for bytes {{hex|9}} through {{hex|D}}. This determines which
BG you appear on, and possibly more.

*Byte {{hex|7}}: {{red|aa}}{{blue|bb}} {{green|cc}}{{purple|dd}}
**The {{red|a}} bits are transformed into {{hex|0000 00}}{{red|aa}} and stored to {{$|063F}}
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|063E}}
**The {{green|c}} bits are transformed into {{hex|0000 00}}{{green|cc}} and stored to {{$|063D}}
**The {{purple|d}} bits are transformed into {{hex|0000 00}}{{purple|dd}} and stored to {{$|063C}}

Note, the only safe values for a plane seem to be {{hex|0}},{{hex|1}}, or {{hex|2}}. Hyrule Magic
appears to violate this rule by letting you put {{hex|3}} down, but nothing higher.

*Byte {{hex|8}}: {{red|aaaa aa}}{{blue|bb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|0640}}

*Byte {{hex|9}}: stored to {{$|7EC000}} These are all room numbers that you could possibly exit to.
*Byte {{hex|A}}: stored to {{$|7EC001}}
*Byte {{hex|B}}: stored to {{$|7EC002}}
*Byte {{hex|C}}: stored to {{$|7EC003}}
*Byte {{hex|D}}: stored to {{$|7EC004}}
</blockquote>

===Sprite Data===
* {{$|04D62E}} to {{$|04D92E}} = Pointer Table, 2 byte local addresses, indexed by room.
* {{$|04D92E}} to {{$|04EC9D}} = Data

<blockquote>
Sprite data is formatted thusly:
*Byte {{hex|0}}: Stored to {{$|0FB3}}. Corresponds with "Sort Spr" in Hyrule Magic. In a layered room this indicates sprites in the foreground are to be drawn on top of sprites in the background.
**Bit {{hex|0}} - If {{hex|0}}, sprites will sort
**Bits {{hex|7,6,5,4,3,2,1}} - Unknown, should all be {{hex|1}}
After the byte {{hex|0}}, you will see 3 byte clusters that break down thus:

*Byte {{hex|0}}:
**Bits {{hex|4,3,2,1,0}} - Y coordinate (in pixels from the top, starting at {{hex|0}}) of the sprite divided by 16.
**Bits {{hex|6,5}} - If these are set, they will be used to generate a subtype, stored to {{$|0E30}}, X.
**Bit {{hex|7}} - If set, the sprite is on BG2, if not it's on BG1
* Byte {{hex|1}}:
** Bits {{hex|4,3,2,1,0}} - X coordinate (in pixels from the far left, starting at {{hex|0}}) of the sprite divided by 16.
** Bits {{hex|7,6,5}} - If all these bits are set then this is an Overlord, otherwise it's a normal sprite. If only some of them are set they can be used to generate a subtype, stored at {{$|0E30}}, X
* Byte {{hex|2}}: Sprite or Overlord type. If a sprite, this will get loaded into a slot at {{$|0E20}}, X. If an Overlord, will get loaded to {{$|0B00}}, X.

The array is terminated with a byte of {{$|FF}}.
</blockquote>

===Object Data===
* {{$|0F8000}} to {{$|0F83BF}} = Pointer Table, 3 byte long addresses, indexed by room ID.
* {{$|01EBA0}} to {{$|01FFF4}} = Data
* {{$|050000}} to {{$|053729}} = Data
* {{$|0F8780}} to {{$|0FFF4D}} = Data
<blockquote>
Byte layout:

* Byte 0: {{red|aaaa}} {{blue|bbbb}}.
**The a bits are transformed to {{red|aaaa}}{{hex|0000}} and select the type of empty space to fill in. Hyrule Magic calls this 'Floor 1' - Gets stored to {{$|7E0490}}
**The b bits are transformed to {{blue|bbbb}}{{hex|0000}} and are the what Hyrule Magic calls 'Floor 2' - Gets stored to {{$|7E046A}}

* Byte {{hex|1}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
** The {{red|a}} bits are unused and should not be used
** The {{blue|b}} bits determine the room's layout type, ranging from {{hex|0}} to {{hex|7}}.
** The {{green|c}} and {{purple|d}} bits are unknown, but I have a feeling it's related to {{$|AA}} and {{$|A9}}

After that the bytes come in {{hex|3}} or {{hex|2}} byte object structures, used by routine {{$|01:88E4}}. Objects are loaded until an object with value {{0x|FFFF}} occurs. If a value {{0x|FFF0}} is loaded, the game will start loading Type 2 objects and will not go back to loading Type 1 objects until it is time to load the next layer. (Layer as in HM, not to be confused with the SNES' Backgrounds.) A value of {{0x|FFFF}} will also terminate the loading of Type 2 objects. The routine immediately terminates if that happens during the loading of either object type.

Type 1 Object structure: (3 bytes):

* Byte {{hex|3}}: Routine to use. If this byte is ≥ {{0x|F8}} and < {{0x|FC}}, then it is a subtype 3 object. If the index is ≥ {{hex|FC}}, it is a subtype 2 object. If not, it is a subtype 1 object.

* Subtype 1 Objects, first and second byte
** High Byte: {{brown|yyyy yy}}{{green|cc}}
** Low Byte: {{grey|xxxx xx}}{{red|aa}}
*** The {{red|a}} bits are stored to {{$|B2}}
*** The {{green|c}} bits are stored to {{$|B4}}
*** The {{grey|x}} and {{brown|y}} bits are transformed into: {{hex|000}}{{brown|y yyyy y}}{{grey|xxx xxx}}{{hex|0}} - This is a tilemap address that indexes into {{$|7E2000}} and / or {{$|7E4000}}

Use Byte {{hex|3}} * 2 as an index into the table at {{$|8200}}. This is the routine that is used to draw and otherwise handle the object. Subtype 1 objects have a maximum width and height of 4. Width and height are measured in terms of 32 {{x}} 32 pixels. (⟸ last part is questionable)

*Subtype 2 Objects, 1st, 2nd, & 3rd bytes:
** Byte {{hex|3}}: {{white|ff}}{{purple|dd dddd}}
** Byte {{hex|2}}: {{pink|eeee}} {{green|cccc}}
** Byte {{hex|1}}: {{red|aaaa aa}}{{blue|bb}}
***The {{red|a}} bits are unused, but after all they are the marker for this type of object subtype.
***The {{blue|b}}, {{green|c}}, {{pink|e}}, and {{white|f}} bits are transformed into a VRAM tilemap address: {{hex|000}}{{green|c ccc}}{{white|f}} {{white|f}}{{blue|bb}}{{pink|e eee}}{{hex|0}}

Might I add this is one messed up format? The {{purple|d}} bits are used as an index into the table at {{$|8470}}. Since such indices are going to be even, the {{purple|d}} bits are transformed into: {{hex|0000 0000 0}}{{purple|ddd ddd}}{{hex|0}}.

*Subtype 3 Objects
**Similar to Subtype 1, with a few small exceptions.
**The vram address is calculated the same way. However, {{$|B2}} and {{$|B4}} are not used as length or width dimensions here. The routine that is used is determined as follows:
**Take the original index (times two) that a Subtype 1 would have used. AND that with {{0x|000E}}. Then shift left 3 times to produce {{hex|0000 0000 0}}{{pink|eee}} {{hex|0000}}. Then, OR in {{$|B2}} and {{$|B4}} and shift left once, so the final result is: {{hex|0000 0000}} {{pink|eee}}{{red|a a}}{{blue|bb}}{{hex|0}}.
**Also, this value indexes into {{$|85F0}} instead of {{$|8200}}.

Type 2 Object Structure: (2 bytes)
*High Byte: {{green|cccc cccc}}
*Low Byte: {{blue|bbbb}} {{purple|dd}}{{red|aa}}
**The {{red|a}} bits form a 2-bit value ({{hex|0000 0}}{{red|aa}}{{hex|0}}) that determines the routine to use for the object. In Hyrule Magic, corresponds to the "direction" of the door.
**The {{blue|b}} bits are transformed into {{hex|000}}{{blue|b bbb}}{{hex|0}} and stored to {{$|02}} ⟹ X. Corresponds to "Pos" of door objects in the Hyrule Magic. Note that these range from {{0x|00}} to {{0x|16}} (always even) which if you halve those values is 0 - 11 in decimal. This is easily verifiable in Hyrule Magic.
**The {{green|c}} bits are shifted into the lower byte and stored to {{$|04}} ⟹ A and {{$|0A}}. This is later used to grab the tiles used to draw the door and the area below it. In Hyrule Magic, corresponds to "type". Note the type is 1/2 of the number listed here. This is because to avoid using an ASL A command, the {{green|c}} bits are always even.
**The {{purple|d}} bits are unused.

Next I'll go into the nitty gritty of the various types (the value of {{$|04}}). Again note that we'll only be dealing with even values {{blue|b}}/{{green|c}} that's what you'll see in the code. To convert between here [as well as the code] and Hyrule Magic, take the hex value here and divide by two. Convert to decimal and that's your Hyrule Magic "type."

*Types:
{|{{Prettytable}}
! ID
! Description
|-
|{{0x|00}}
|Basic door. Index = {{$|0460}}
|-
|{{0x|02}}
|Normal door?
|-
|{{0x|04}}
|???
|-
|{{0x|06}}
|???
|-
|{{0x|08}}
|Waterfall door (only used in Swamp palace; in one room at that!)
|-
|{{0x|0A}}
|???
|-
|{{0x|0C}}
|Trap door (probably other types but this seems to be most common)
|-
|{{0x|12}}
|Adds a property to some doors allowing you to exit to the overworld (this is accomplished by writing to the tile attribute map)
|-
|{{0x|14}}
|Transition to dark room?
|-
|{{0x|16}}
|Toggles the target BG Link will emerge on. '''Ex.''' if Link starts on BG0 in the next room he'll be on BG1.
|-
|{{0x|20}}
| rowspan="2"|Locked door specifically for BG0.
|-
|{{0x|22}}
|-
|{{0x|24}}
| rowspan="2"|Locked door for either BG0 or BG1
|-
|{{0x|26}}
|-
|{{0x|30}}
|Large exploded pathway resulting from a switch being pulled (unusual to have as a door as it's huge)
|-
|{{0x|32}}
|Sword activated door. '''Ex.''' Agahnim's room with the curtain door you have to slash.
|-
|{{0x|46}}
|warp door?
|}
</blockquote>

===Dungeon Secrets Data===
* {{$|00DB69}} to {{$|00DDE8}} = Pointer Table, 2 byte local addresses, indexed by room ID.
* {{$|00DDE9}} to {{$|00E6B1}} = Data
<blockquote>
Data comes in 3 byte chunks and is terminated by an instance of {{$|FFFF}}

* Bytes {{hex|0}}, {{hex|1}}: A word that denotes the VRAM address that the item is found at. This identifies the item as belonging to that part of the screen.
* Byte {{hex|2}}: Identifies the type of item that is hiding there. E.g. {{$|08}} is a key
</blockquote>

===Push Block Data===
* {{$|0271DE}} to {{$|027369}} = Data
<Blockquote>
4 bytes per entry:
{{red|a a }}{{blue|x }} {{green|y}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the block (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the block (expressed as tilemap coordinate)
</blockquote>

===(Inter Room) Torch Data===
* {{$|02736A}} to {{$|027489}} = Data
<Blockquote>
Consists of variable length segments consisting of:

{{red|a a }}{{blue|x }}{{green|y }}{{blue|x }}{{green|y }}{{hex|... }}{{$|FFFF}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the torch (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the torch (expressed as tilemap coordinate)
*{{$|FFFF}}: Delimeter
</blockquote>

===Chest Contents===
*{{$|00E96E}} to {{$|00EB65}} = Data
<blockquote>
Array of chest information in 3 byte chunks. 168 entries in all ({{0x|A8}})

*First word - Room number it is located in. MSB determines whether it is a big chest or not. (big chest if set)
*Last byte - index of the type of item contained in the chest.
</blockquote>

==Room layout==
In Hyrule Magic, there's a label and textbox for room layouts. The layout value goes from {{$|0}} to {{$|7}}

The location:

{|{{prettytable}}
!USA
!JP
|-
|{{0x|26F2F}}
|{{0x|26C0F}}
|}

In the aforementioned location, there are 8 long pointers (Lo-Hi-Bank).

==Entrance Data==
There are {{$|85}} (Decimal: 133) normal entrances to the underworld from the overworld, and {{$|7}} (Decimal: 7) starting locations.
Normal entrances and starting locations use mostly the same types of data formatted the same, however they are located in different places in the ROM.
They are located and formatted thus:

===Entrance Room===
*{{$|014813}} to {{$|01491C}} = Normal Entrance Data
*{{$|015B6E}} to {{$|015B7B}} = Starting Location Data
<blockquote>
Each entry is a 2 byte Room ID where the player is placed after using an entrance.
</blockquote>

===Scroll Edges===
*{{$|01491D}} to {{$|014D44}} = Normal Entrance Data
*{{$|015B7C}} to {{$|015BB3}} = Starting Location Data
<blockquote>
Unsure about what these do exactly.
Each entry is 8 bytes long.
*Format: 1 byte each. Corresponds to hyrule magic values in the "More" a.k.a. Entrance Properties dialog box.
**HU -
**FU -
**HD -
**FD -
**HL -
**FL -
**HR -
**FR -
</blockquote>

===X Scroll===
*{{$|014D45}} to {{$|014E4E}} = Normal Entrance Data
*{{$|015BB4}} to {{$|015BC1}} = Starting Location Data
<blockquote>

</blockquote>

===Y Scroll===
*{{$|014E4F}} to {{$|014F58}} = Normal Entrance Data
*{{$|015BC2}} to {{$|015BCF}} = Starting Location Data
<blockquote>

</blockquote>

===X Coordinate===
*{{$|014F59}} to {{$|015062}} = Normal Entrance Data
*{{$|015BD0}} to {{$|015BDD}} = Starting Location Data
<blockquote>
Each entry is a 2 byte X coordinate where the player starts after using the corresponding entrance.
</blockquote>

===Y Coordinate===
*{{$|015063}} to {{$|01516C}} = Normal Entrance Data
*{{$|015BDE}} to {{$|015BEB}} = Starting Location Data
<blockquote>
Each entry is a 2 byte y coordinate where the player starts after using the corresponding entrance.
</blockquote>

===X Camera Coordinate===
*{{$|01516D}} to {{$|015276}} = Normal Entrance Data
*{{$|015BEC}} to {{$|015BF9}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

===Y Camera Coordinate===
*{{$|015277}} to {{$|015380}} = Normal Entrance Data
*{{$|015BFA}} to {{$|015C07}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

===Entrance Blockset===
*{{$|015381}} to {{$|015405}} = Normal Entrance Data
*{{$|015C08}} to {{$|015C0E}} = Starting Location Data
<blockquote>
1 byte each. This blockset affects walls and a few other things and persists through all rooms the player accesses from this entrance.
</blockquote>

===Floor Values===
*{{$|015406}} to {{$|01548A}} = Normal Entrance Data
*{{$|015C0F}} to {{$|015C15}} = Starting Location Data
<blockquote>
This tells us what kind of properties the floor has. 1 byte each:
*If 1, then it has floors that you can fall through to the next level
*If 0, I think it means it can be fallen down to
*If -1, has no pits
*If -2, ????
</blockquote>

===Dungeon Values===
*{{$|01548B}} to {{$|01550F}} = Normal Entrance Data
*{{$|015C16}} to {{$|015C1C}} = Starting Location Data
<blockquote>
1 Byte each.
Dungeons actually in the game are numbered like so {{$|00}}, {{$|02}}, {{$|04}}, ..., {{$|18}}, {{$|1A}}.
{{$|1C}} and {{$|1E}} are unused (and hence could potentially be added.) Notice they are all even numbers.
In asm routines these values are divided by two sometimes to provide an index into other arrays.
That's why. The definition of a "dungeon" is something with a key, compass, and map.

A value of {{$|FF}} (-1) denotes it doesn't belong to a dungeon.
</blockquote>

===Doorway Type===
*{{$|015510}} to {{$|015594}} = Normal Entrance Data
*{{$|015C2B}} to {{$|015C31}} = Starting Location Data
<blockquote>
This is used only when you exit the given room. For example, let's say you enter through a skull doorway in Skullwoods.
But that's not really a door way, it's just a set of tiles that are no different from a hole you might create after picking
up a big rock. But if you entered from a building door, the game has to know whether to put the door frame when you exit.
*1 byte:
**{{hex|0}} = no doorway when exiting
**{{hex|1}} = draws a door frame upon exiting
**{{hex|2}} = ???? HM says vertical doorframe. But in the original game, no doorway is vertical.

</blockquote>

===Ladder And BG Settings===
*{{$|015595}} to {{$|015619}} = Normal Entrance Data
*{{$|015C1D}} to {{$|015C23}} = Starting Location Data
<blockquote>
*1 byte each, with the following 2 bit layout: {{hex|xxx}}{{red|a}}{{pink|xxx}}{{blue|b}}
**{{hex|x}} - unimportant
**{{red|a}} - if set, then Link enters on the lower level (BG2)
**{{blue|b}} - if set... not sure what happens exactly. Check the game engine to be sure.
</blockquote>

===Horizontal And Vertical Scroll Properties===
*{{$|01561A}} to {{$|01569E}} = Normal Entrance Data
*{{$|015C24}} to {{$|015C2A}} = Starting Location Data
<blockquote>
For these, I guess if the flags in the appropriate places are set, then the room will be able to scroll in those directions.

*1 byte each, with the following layout: {{hex|xx}}{{red|a}}{{hex|xxx}}{{blue|b}}{{hex|x}}
**{{red|a}} - Horizontal flag
**{{blue|b}} - Vertical flag
</blockquote>

===Scroll Quadrant===
*{{$|01569F}} to {{$|015723}} = Normal Entrance Data
<blockquote>
*1 byte each, has four different expected values:
**0h, 2h, 10h, 12h
</blockquote>

===Exit Door Location===
*{{$|015724}} to {{$|01582D}} = Normal Entrance Data
*{{$|015C32}} to {{$|015C3F}} = Starting Location Data
<blockquote>
1 word each. Denotes X and Y coordinates for overworld?
</blockquote>

===Music===
*{{$|01582E}} to {{$|0158B2}} = Normal Entrance Data (JP: 15592 - 15616)
*{{$|015C4E}} to {{$|015C54}} = Starting Location Data
<blockquote>
1 byte each. A value of {{$|FF}} plays the same music as the overworld screen from which the player entered.
</blockquote>

===Entrance Values===
*{{$|015C40}} to {{$|015C4D}} = Starting Location Data
<blockquote>
1 word each. Since the starting locations have to reference an entrance, this is necessary.
</blockquote>

{{toc}}

Underworld

2017-12-23T22:07:50Z

Tatters: Replaced content with "The underworld refers to all indoor locations; including dungeons, caves, and houses. {{box|Important Hex Addresses}} {{box|Unde..."

The underworld refers to all indoor locations; including dungeons, caves, and houses.

{{box|[[Underworld:Important Hex Addresses|Important Hex Addresses]]}}

{{box|[[Underworld:Rooms|Rooms]]}}

{{toc}}

Underworld:Important Hex Addresses

2017-12-23T22:07:38Z

Tatters: Created page with "{{subpage|Underworld}} ===Room Data=== ====Room Headers==== *{{$|027502}} to {{$|027781}} = Pointer Table, {{hex|2}} byte local addresses, indexed by room ID. *{{$|027781}}..."

{{subpage|Underworld}}

===Room Data===
====Room Headers====
*{{$|027502}} to {{$|027781}} = Pointer Table, {{hex|2}} byte local addresses, indexed by room ID.
*{{$|027781}} to {{$|027FEF}} = Data

<blockquote>
Headers are {{$|0E}} (Decimal: 14) bytes formatted thusly:
*Byte {{hex|0}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
**The {{red|a}} bits are transformed into {{hex|0000 0}}{{red|aaa}} and stored to {{$|0414}} ("BG2" in Hyrule Magic)
**The {{blue|b}} bits are transformed into {{hex|0000 0}}{{blue|bbb}} and stored to {{$|046C}} ("Collision" in Hyrule Magic)
**The {{green|c}} bit is unused
**The {{purple|d}} bit is stored to {{$|7EC005}} (If set, use a lights out routine in the room transition)

*Byte {{hex|1}}: {{red|aa}}{{blue|bb bbbb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{blue|bbbb bb}}{{hex|00}}, thus making them a multiple of 4.
This value is used to load 4 different palettes for the dungeon, and corresponds to, you guessed it, Palette # in Hyrule Magic!

The resulting index is used to load values for {{$|0AB6}}, {{$|0AAC}}, {{$|0AAD}}, and {{$|0AAE}}

*Byte {{hex|2}}: gets stored to {{$|0AA2}} (GFX # in Hyrule Magic)
*Byte {{hex|3}}: value + #$40 gets stored to {{$|0AA3}} (Sprite GFX # in Hyrule Magic)
*Byte {{hex|4}}: gets stored to {{$|00AD}} ("[[Room Effects|Effect]]" in Hyrule Magic)
*Byte {{hex|5}}: {{red|aa}}{{blue|bb bbbb}}
**{{red|a}} = ?
**The {{blue|b}} bits are "[[Room Tags|Tag1]]" in Hyrule Magic and gets stored to {{$|00AE}}.
*Byte {{hex|6}}: {{red|aa}}{{blue|bb bbbb}}
**{{red|a}} = ?
**The {{blue|b}} bits are "[[Room Tags|Tag2]]" in Hyrule Magic and get stored to {{$|00AF}}

These are the planes to use for bytes {{hex|9}} through {{hex|D}}. This determines which
BG you appear on, and possibly more.

*Byte {{hex|7}}: {{red|aa}}{{blue|bb}} {{green|cc}}{{purple|dd}}
**The {{red|a}} bits are transformed into {{hex|0000 00}}{{red|aa}} and stored to {{$|063F}}
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|063E}}
**The {{green|c}} bits are transformed into {{hex|0000 00}}{{green|cc}} and stored to {{$|063D}}
**The {{purple|d}} bits are transformed into {{hex|0000 00}}{{purple|dd}} and stored to {{$|063C}}

Note, the only safe values for a plane seem to be {{hex|0}},{{hex|1}}, or {{hex|2}}. Hyrule Magic
appears to violate this rule by letting you put {{hex|3}} down, but nothing higher.

*Byte {{hex|8}}: {{red|aaaa aa}}{{blue|bb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|0640}}

*Byte {{hex|9}}: stored to {{$|7EC000}} These are all room numbers that you could possibly exit to.
*Byte {{hex|A}}: stored to {{$|7EC001}}
*Byte {{hex|B}}: stored to {{$|7EC002}}
*Byte {{hex|C}}: stored to {{$|7EC003}}
*Byte {{hex|D}}: stored to {{$|7EC004}}
</blockquote>

====Sprite Data====
* {{$|04D62E}} to {{$|04D92E}} = Pointer Table, 2 byte local addresses, indexed by room.
* {{$|04D92E}} to {{$|04EC9D}} = Data

<blockquote>
Sprite data is formatted thusly:
*Byte {{hex|0}}: Stored to {{$|0FB3}}. Corresponds with "Sort Spr" in Hyrule Magic. In a layered room this indicates sprites in the foreground are to be drawn on top of sprites in the background.
**Bit {{hex|0}} - If {{hex|0}}, sprites will sort
**Bits {{hex|7,6,5,4,3,2,1}} - Unknown, should all be {{hex|1}}
After the byte {{hex|0}}, you will see 3 byte clusters that break down thus:

*Byte {{hex|0}}:
**Bits {{hex|4,3,2,1,0}} - Y coordinate (in pixels from the top, starting at {{hex|0}}) of the sprite divided by 16.
**Bits {{hex|6,5}} - If these are set, they will be used to generate a subtype, stored to {{$|0E30}}, X.
**Bit {{hex|7}} - If set, the sprite is on BG2, if not it's on BG1
* Byte {{hex|1}}:
** Bits {{hex|4,3,2,1,0}} - X coordinate (in pixels from the far left, starting at {{hex|0}}) of the sprite divided by 16.
** Bits {{hex|7,6,5}} - If all these bits are set then this is an Overlord, otherwise it's a normal sprite. If only some of them are set they can be used to generate a subtype, stored at {{$|0E30}}, X
* Byte {{hex|2}}: Sprite or Overlord type. If a sprite, this will get loaded into a slot at {{$|0E20}}, X. If an Overlord, will get loaded to {{$|0B00}}, X.

The array is terminated with a byte of {{$|FF}}.
</blockquote>

====Object Data====
* {{$|0F8000}} to {{$|0F83BF}} = Pointer Table, 3 byte long addresses, indexed by room ID.
* {{$|01EBA0}} to {{$|01FFF4}} = Data
* {{$|050000}} to {{$|053729}} = Data
* {{$|0F8780}} to {{$|0FFF4D}} = Data
<blockquote>
Byte layout:

* Byte 0: {{red|aaaa}} {{blue|bbbb}}.
**The a bits are transformed to {{red|aaaa}}{{hex|0000}} and select the type of empty space to fill in. Hyrule Magic calls this 'Floor 1' - Gets stored to {{$|7E0490}}
**The b bits are transformed to {{blue|bbbb}}{{hex|0000}} and are the what Hyrule Magic calls 'Floor 2' - Gets stored to {{$|7E046A}}

* Byte {{hex|1}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
** The {{red|a}} bits are unused and should not be used
** The {{blue|b}} bits determine the room's layout type, ranging from {{hex|0}} to {{hex|7}}.
** The {{green|c}} and {{purple|d}} bits are unknown, but I have a feeling it's related to {{$|AA}} and {{$|A9}}

After that the bytes come in {{hex|3}} or {{hex|2}} byte object structures, used by routine {{$|01:88E4}}. Objects are loaded until an object with value {{0x|FFFF}} occurs. If a value {{0x|FFF0}} is loaded, the game will start loading Type 2 objects and will not go back to loading Type 1 objects until it is time to load the next layer. (Layer as in HM, not to be confused with the SNES' Backgrounds.) A value of {{0x|FFFF}} will also terminate the loading of Type 2 objects. The routine immediately terminates if that happens during the loading of either object type.

Type 1 Object structure: (3 bytes):

* Byte {{hex|3}}: Routine to use. If this byte is ≥ {{0x|F8}} and < {{0x|FC}}, then it is a subtype 3 object. If the index is ≥ {{hex|FC}}, it is a subtype 2 object. If not, it is a subtype 1 object.

* Subtype 1 Objects, first and second byte
** High Byte: {{brown|yyyy yy}}{{green|cc}}
** Low Byte: {{grey|xxxx xx}}{{red|aa}}
*** The {{red|a}} bits are stored to {{$|B2}}
*** The {{green|c}} bits are stored to {{$|B4}}
*** The {{grey|x}} and {{brown|y}} bits are transformed into: {{hex|000}}{{brown|y yyyy y}}{{grey|xxx xxx}}{{hex|0}} - This is a tilemap address that indexes into {{$|7E2000}} and / or {{$|7E4000}}

Use Byte {{hex|3}} * 2 as an index into the table at {{$|8200}}. This is the routine that is used to draw and otherwise handle the object. Subtype 1 objects have a maximum width and height of 4. Width and height are measured in terms of 32 {{x}} 32 pixels. (⟸ last part is questionable)

*Subtype 2 Objects, 1st, 2nd, & 3rd bytes:
** Byte {{hex|3}}: {{white|ff}}{{purple|dd dddd}}
** Byte {{hex|2}}: {{pink|eeee}} {{green|cccc}}
** Byte {{hex|1}}: {{red|aaaa aa}}{{blue|bb}}
***The {{red|a}} bits are unused, but after all they are the marker for this type of object subtype.
***The {{blue|b}}, {{green|c}}, {{pink|e}}, and {{white|f}} bits are transformed into a VRAM tilemap address: {{hex|000}}{{green|c ccc}}{{white|f}} {{white|f}}{{blue|bb}}{{pink|e eee}}{{hex|0}}

Might I add this is one messed up format? The {{purple|d}} bits are used as an index into the table at {{$|8470}}. Since such indices are going to be even, the {{purple|d}} bits are transformed into: {{hex|0000 0000 0}}{{purple|ddd ddd}}{{hex|0}}.

*Subtype 3 Objects
**Similar to Subtype 1, with a few small exceptions.
**The vram address is calculated the same way. However, {{$|B2}} and {{$|B4}} are not used as length or width dimensions here. The routine that is used is determined as follows:
**Take the original index (times two) that a Subtype 1 would have used. AND that with {{0x|000E}}. Then shift left 3 times to produce {{hex|0000 0000 0}}{{pink|eee}} {{hex|0000}}. Then, OR in {{$|B2}} and {{$|B4}} and shift left once, so the final result is: {{hex|0000 0000}} {{pink|eee}}{{red|a a}}{{blue|bb}}{{hex|0}}.
**Also, this value indexes into {{$|85F0}} instead of {{$|8200}}.

Type 2 Object Structure: (2 bytes)
*High Byte: {{green|cccc cccc}}
*Low Byte: {{blue|bbbb}} {{purple|dd}}{{red|aa}}
**The {{red|a}} bits form a 2-bit value ({{hex|0000 0}}{{red|aa}}{{hex|0}}) that determines the routine to use for the object. In Hyrule Magic, corresponds to the "direction" of the door.
**The {{blue|b}} bits are transformed into {{hex|000}}{{blue|b bbb}}{{hex|0}} and stored to {{$|02}} ⟹ X. Corresponds to "Pos" of door objects in the Hyrule Magic. Note that these range from {{0x|00}} to {{0x|16}} (always even) which if you halve those values is 0 - 11 in decimal. This is easily verifiable in Hyrule Magic.
**The {{green|c}} bits are shifted into the lower byte and stored to {{$|04}} ⟹ A and {{$|0A}}. This is later used to grab the tiles used to draw the door and the area below it. In Hyrule Magic, corresponds to "type". Note the type is 1/2 of the number listed here. This is because to avoid using an ASL A command, the {{green|c}} bits are always even.
**The {{purple|d}} bits are unused.

Next I'll go into the nitty gritty of the various types (the value of {{$|04}}). Again note that we'll only be dealing with even values {{blue|b}}/{{green|c}} that's what you'll see in the code. To convert between here [as well as the code] and Hyrule Magic, take the hex value here and divide by two. Convert to decimal and that's your Hyrule Magic "type."

*Types:
{|{{Prettytable}}
! ID
! Description
|-
|{{0x|00}}
|Basic door. Index = {{$|0460}}
|-
|{{0x|02}}
|Normal door?
|-
|{{0x|04}}
|???
|-
|{{0x|06}}
|???
|-
|{{0x|08}}
|Waterfall door (only used in Swamp palace; in one room at that!)
|-
|{{0x|0A}}
|???
|-
|{{0x|0C}}
|Trap door (probably other types but this seems to be most common)
|-
|{{0x|12}}
|Adds a property to some doors allowing you to exit to the overworld (this is accomplished by writing to the tile attribute map)
|-
|{{0x|14}}
|Transition to dark room?
|-
|{{0x|16}}
|Toggles the target BG Link will emerge on. '''Ex.''' if Link starts on BG0 in the next room he'll be on BG1.
|-
|{{0x|20}}
| rowspan="2"|Locked door specifically for BG0.
|-
|{{0x|22}}
|-
|{{0x|24}}
| rowspan="2"|Locked door for either BG0 or BG1
|-
|{{0x|26}}
|-
|{{0x|30}}
|Large exploded pathway resulting from a switch being pulled (unusual to have as a door as it's huge)
|-
|{{0x|32}}
|Sword activated door. '''Ex.''' Agahnim's room with the curtain door you have to slash.
|-
|{{0x|46}}
|warp door?
|}
</blockquote>

====Dungeon Secrets Data====
* {{$|00DB69}} to {{$|00DDE8}} = Pointer Table, 2 byte local addresses, indexed by room ID.
* {{$|00DDE9}} to {{$|00E6B1}} = Data
<blockquote>
Data comes in 3 byte chunks and is terminated by an instance of {{$|FFFF}}

* Bytes {{hex|0}}, {{hex|1}}: A word that denotes the VRAM address that the item is found at. This identifies the item as belonging to that part of the screen.
* Byte {{hex|2}}: Identifies the type of item that is hiding there. E.g. {{$|08}} is a key
</blockquote>

====Push Block Data====
* {{$|0271DE}} to {{$|027369}} = Data
<Blockquote>
4 bytes per entry:
{{red|a a }}{{blue|x }} {{green|y}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the block (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the block (expressed as tilemap coordinate)
</blockquote>

====(Inter Room) Torch Data====
* {{$|02736A}} to {{$|027489}} = Data
<Blockquote>
Consists of variable length segments consisting of:

{{red|a a }}{{blue|x }}{{green|y }}{{blue|x }}{{green|y }}{{hex|... }}{{$|FFFF}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the torch (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the torch (expressed as tilemap coordinate)
*{{$|FFFF}}: Delimeter
</blockquote>

====Chest Contents====
*{{$|00E96E}} to {{$|00EB65}} = Data
<blockquote>
Array of chest information in 3 byte chunks. 168 entries in all ({{0x|A8}})

*First word - Room number it is located in. MSB determines whether it is a big chest or not. (big chest if set)
*Last byte - index of the type of item contained in the chest.
</blockquote>

===Room layout===
In Hyrule Magic, there's a label and textbox for room layouts. The layout value goes from {{$|0}} to {{$|7}}

The location:

{|{{prettytable}}
!USA
!JP
|-
|{{0x|26F2F}}
|{{0x|26C0F}}
|}

In the aforementioned location, there are 8 long pointers (Lo-Hi-Bank).

===Entrance Data===
There are {{$|85}} (Decimal: 133) normal entrances to the underworld from the overworld, and {{$|7}} (Decimal: 7) starting locations.
Normal entrances and starting locations use mostly the same types of data formatted the same, however they are located in different places in the ROM.
They are located and formatted thus:

====Entrance Room====
*{{$|014813}} to {{$|01491C}} = Normal Entrance Data
*{{$|015B6E}} to {{$|015B7B}} = Starting Location Data
<blockquote>
Each entry is a 2 byte Room ID where the player is placed after using an entrance.
</blockquote>

====Scroll Edges====
*{{$|01491D}} to {{$|014D44}} = Normal Entrance Data
*{{$|015B7C}} to {{$|015BB3}} = Starting Location Data
<blockquote>
Unsure about what these do exactly.
Each entry is 8 bytes long.
*Format: 1 byte each. Corresponds to hyrule magic values in the "More" a.k.a. Entrance Properties dialog box.
**HU -
**FU -
**HD -
**FD -
**HL -
**FL -
**HR -
**FR -
</blockquote>

====X Scroll====
*{{$|014D45}} to {{$|014E4E}} = Normal Entrance Data
*{{$|015BB4}} to {{$|015BC1}} = Starting Location Data
<blockquote>

</blockquote>

====Y Scroll====
*{{$|014E4F}} to {{$|014F58}} = Normal Entrance Data
*{{$|015BC2}} to {{$|015BCF}} = Starting Location Data
<blockquote>

</blockquote>

====X Coordinate====
*{{$|014F59}} to {{$|015062}} = Normal Entrance Data
*{{$|015BD0}} to {{$|015BDD}} = Starting Location Data
<blockquote>
Each entry is a 2 byte X coordinate where the player starts after using the corresponding entrance.
</blockquote>

====Y Coordinate====
*{{$|015063}} to {{$|01516C}} = Normal Entrance Data
*{{$|015BDE}} to {{$|015BEB}} = Starting Location Data
<blockquote>
Each entry is a 2 byte y coordinate where the player starts after using the corresponding entrance.
</blockquote>

====X Camera Coordinate====
*{{$|01516D}} to {{$|015276}} = Normal Entrance Data
*{{$|015BEC}} to {{$|015BF9}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

====Y Camera Coordinate====
*{{$|015277}} to {{$|015380}} = Normal Entrance Data
*{{$|015BFA}} to {{$|015C07}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

====Entrance Blockset====
*{{$|015381}} to {{$|015405}} = Normal Entrance Data
*{{$|015C08}} to {{$|015C0E}} = Starting Location Data
<blockquote>
1 byte each. This blockset affects walls and a few other things and persists through all rooms the player accesses from this entrance.
</blockquote>

====Floor Values====
*{{$|015406}} to {{$|01548A}} = Normal Entrance Data
*{{$|015C0F}} to {{$|015C15}} = Starting Location Data
<blockquote>
This tells us what kind of properties the floor has. 1 byte each:
*If 1, then it has floors that you can fall through to the next level
*If 0, I think it means it can be fallen down to
*If -1, has no pits
*If -2, ????
</blockquote>

====Dungeon Values====
*{{$|01548B}} to {{$|01550F}} = Normal Entrance Data
*{{$|015C16}} to {{$|015C1C}} = Starting Location Data
<blockquote>
1 Byte each.
Dungeons actually in the game are numbered like so {{$|00}}, {{$|02}}, {{$|04}}, ..., {{$|18}}, {{$|1A}}.
{{$|1C}} and {{$|1E}} are unused (and hence could potentially be added.) Notice they are all even numbers.
In asm routines these values are divided by two sometimes to provide an index into other arrays.
That's why. The definition of a "dungeon" is something with a key, compass, and map.

A value of {{$|FF}} (-1) denotes it doesn't belong to a dungeon.
</blockquote>

====Doorway Type====
*{{$|015510}} to {{$|015594}} = Normal Entrance Data
*{{$|015C2B}} to {{$|015C31}} = Starting Location Data
<blockquote>
This is used only when you exit the given room. For example, let's say you enter through a skull doorway in Skullwoods.
But that's not really a door way, it's just a set of tiles that are no different from a hole you might create after picking
up a big rock. But if you entered from a building door, the game has to know whether to put the door frame when you exit.
*1 byte:
**{{hex|0}} = no doorway when exiting
**{{hex|1}} = draws a door frame upon exiting
**{{hex|2}} = ???? HM says vertical doorframe. But in the original game, no doorway is vertical.

</blockquote>

====Ladder And BG Settings====
*{{$|015595}} to {{$|015619}} = Normal Entrance Data
*{{$|015C1D}} to {{$|015C23}} = Starting Location Data
<blockquote>
*1 byte each, with the following 2 bit layout: {{hex|xxx}}{{red|a}}{{pink|xxx}}{{blue|b}}
**{{hex|x}} - unimportant
**{{red|a}} - if set, then Link enters on the lower level (BG2)
**{{blue|b}} - if set... not sure what happens exactly. Check the game engine to be sure.
</blockquote>

====Horizontal And Vertical Scroll Properties====
*{{$|01561A}} to {{$|01569E}} = Normal Entrance Data
*{{$|015C24}} to {{$|015C2A}} = Starting Location Data
<blockquote>
For these, I guess if the flags in the appropriate places are set, then the room will be able to scroll in those directions.

*1 byte each, with the following layout: {{hex|xx}}{{red|a}}{{hex|xxx}}{{blue|b}}{{hex|x}}
**{{red|a}} - Horizontal flag
**{{blue|b}} - Vertical flag
</blockquote>

====Scroll Quadrant====
*{{$|01569F}} to {{$|015723}} = Normal Entrance Data
<blockquote>
*1 byte each, has four different expected values:
**0h, 2h, 10h, 12h
</blockquote>

====Exit Door Location====
*{{$|015724}} to {{$|01582D}} = Normal Entrance Data
*{{$|015C32}} to {{$|015C3F}} = Starting Location Data
<blockquote>
1 word each. Denotes X and Y coordinates for overworld?
</blockquote>

====Music====
*{{$|01582E}} to {{$|0158B2}} = Normal Entrance Data (JP: 15592 - 15616)
*{{$|015C4E}} to {{$|015C54}} = Starting Location Data
<blockquote>
1 byte each. A value of {{$|FF}} plays the same music as the overworld screen from which the player entered.
</blockquote>

====Entrance Values====
*{{$|015C40}} to {{$|015C4D}} = Starting Location Data
<blockquote>
1 word each. Since the starting locations have to reference an entrance, this is necessary.
</blockquote>

{{toc}}

Underworld:Rooms

2017-12-23T22:07:30Z

Tatters: Created page with "{{subpage|Underworld}} Tiles on the underworld maps are referred to as "super-rooms" and can contain 1-4 "sub-rooms." ==Primary Map== The primary underworld map consists of..."

{{subpage|Underworld}}

Tiles on the underworld maps are referred to as "super-rooms" and can contain 1-4 "sub-rooms."

==Primary Map==
The primary underworld map consists of {{$|FF}} (decimal: 256) super-rooms arranged in a {{$|10}} {{x}} {{$|10}} (decimal: 16 {{x}} 16) square.

{|{{Prettytable}}
! ID
! Description
|-
|[[Room $00|Room {{$|00}}]]
|Ganon
|-
|[[Room $01|Room {{$|01}}]]
|Hyrule Castle (North Corridor)
|-
|[[Room $02|Room {{$|02}}]]
|Hyrule Castle (Switch Room)
|-
|[[Room $03|Room {{$|03}}]]
|Houlihan Room
|-
|[[Room $04|Room {{$|04}}]]
|Turtle Rock (Crysta-roller Room)
|-
|[[Room $05|Room {{$|05}}]]
|Empty Clone Room
|-
|[[Room $06|Room {{$|06}}]]
|Swamp Palace (Arrghus[Boss])
|-
|[[Room $07|Room {{$|07}}]]
|Tower of Hera (Moldorm[Boss])
|-
|[[Room $08|Room {{$|08}}]]
|Cave (Healing Fairy)
|-
|[[Room $09|Room {{$|09}}]]
|Palace of Darkness
|-
|[[Room $0A|Room {{$|0A}}]]
|Palace of Darkness (Stalfos Trap Room)
|-
|[[Room $0B|Room {{$|0B}}]]
|Palace of Darkness (Turtle Room)
|-
|[[Room $0C|Room {{$|0C}}]]
|Ganon's Tower (Entrance Room)
|-
|[[Room $0D|Room {{$|0D}}]]
|Ganon's Tower (Agahnim2[Boss])
|-
|[[Room $0E|Room {{$|0E}}]]
|Ice Palace (Entrance Room)
|-
|[[Room $0F|Room {{$|0F}}]]
|Empty Clone Room
|-
|[[Room $10|Room {{$|10}}]]
|Ganon Evacuation Route
|-
|[[Room $11|Room {{$|11}}]]
|Hyrule Castle (Bombable Stock Room)
|-
|[[Room $12|Room {{$|12}}]]
|Sanctuary
|-
|[[Room $13|Room {{$|13}}]]
|Turtle Rock (Hokku-Bokku Key Room 2)
|-
|[[Room $14|Room {{$|14}}]]
|Turtle Rock (Big Key Room)
|-
|[[Room $15|Room {{$|15}}]]
|Turtle Rock
|-
|[[Room $16|Room {{$|16}}]]
|Swamp Palace (Swimming Treadmill)
|-
|[[Room $17|Room {{$|17}}]]
|Tower of Hera (Moldorm Fall Room)
|-
|[[Room $18|Room {{$|18}}]]
|Cave
|-
|[[Room $19|Room {{$|19}}]]
|Palace of Darkness (Dark Maze)
|-
|[[Room $1A|Room {{$|1A}}]]
|Palace of Darkness (Big Chest Room)
|-
|[[Room $1B|Room {{$|1B}}]]
|Palace of Darkness (Mimics / Moving Wall Room)
|-
|[[Room $1C|Room {{$|1C}}]]
|Ganon's Tower (Ice Armos)
|-
|[[Room $1D|Room {{$|1D}}]]
|Ganon's Tower (Final Hallway)
|-
|[[Room $1E|Room {{$|1E}}]]
|Ice Palace (Bomb Floor / Bari Room)
|-
|[[Room $1F|Room {{$|1F}}]]
|Ice Palace (Pengator / Big Key Room)
|-
|[[Room $20|Room {{$|20}}]]
|Agahnim's Tower (Agahnim[Boss])
|-
|[[Room $21|Room {{$|21}}]]
|Hyrule Castle (Key-rat Room)
|-
|[[Room $22|Room {{$|22}}]]
|Hyrule Castle (Sewer Text Trigger Room)
|-
|[[Room $23|Room {{$|23}}]]
|Turtle Rock (West Exit to Balcony)
|-
|[[Room $24|Room {{$|24}}]]
|Turtle Rock (Double Hokku-Bokku / Big chest Room)
|-
|[[Room $25|Room {{$|25}}]]
|Empty Clone Room
|-
|[[Room $26|Room {{$|26}}]]
|Swamp Palace (Statue Room)
|-
|[[Room $27|Room {{$|27}}]]
|Tower of Hera (Big Chest)
|-
|[[Room $28|Room {{$|28}}]]
|Swamp Palace (Entrance Room)
|-
|[[Room $29|Room {{$|29}}]]
|Skull Woods (Mothula[Boss])
|-
|[[Room $2A|Room {{$|2A}}]]
|Palace of Darkness (Big Hub Room)
|-
|[[Room $2B|Room {{$|2B}}]]
|Palace of Darkness (Map Chest / Fairy Room)
|-
|[[Room $2C|Room {{$|2C}}]]
|Cave
|-
|[[Room $2D|Room {{$|2D}}]]
|Empty Clone Room
|-
|[[Room $2E|Room {{$|2E}}]]
|Ice Palace (Compass Room)
|-
|[[Room $2F|Room {{$|2F}}]]
|Cave (Kakariko Well HP)
|-
|[[Room $30|Room {{$|30}}]]
|Agahnim's Tower (Maiden Sacrifice Chamber)
|-
|[[Room $31|Room {{$|31}}]]
|Tower of Hera (Hardhat Beetles Room)
|-
|[[Room $32|Room {{$|32}}]]
|Hyrule Castle (Sewer Key Chest Room)
|-
|[[Room $33|Room {{$|33}}]]
|Desert Palace (Lanmolas[Boss])
|-
|[[Room $34|Room {{$|34}}]]
|Swamp Palace (Push Block Puzzle / Pre-Big Key Room)
|-
|[[Room $35|Room {{$|35}}]]
|Swamp Palace (Big Key / BS Room)
|-
|[[Room $36|Room {{$|36}}]]
|Swamp Palace (Big Chest Room)
|-
|[[Room $37|Room {{$|37}}]]
|Swamp Palace (Map Chest / Water Fill Room)
|-
|[[Room $38|Room {{$|38}}]]
|Swamp Palace (Key Pot Room)
|-
|[[Room $39|Room {{$|39}}]]
|Skull Woods (Gibdo Key / Mothula Hole Room)
|-
|[[Room $3A|Room {{$|3A}}]]
|Palace of Darkness (Bombable Floor Room)
|-
|[[Room $3B|Room {{$|3B}}]]
|Palace of Darkness (Spike Block / Conveyor Room)
|-
|[[Room $3C|Room {{$|3C}}]]
|Cave
|-
|[[Room $3D|Room {{$|3D}}]]
|Ganon's Tower (Torch Room 2)
|-
|[[Room $3E|Room {{$|3E}}]]
|Ice Palace (Stalfos Knights / Conveyor Hellway)
|-
|[[Room $3F|Room {{$|3F}}]]
|Ice Palace (Map Chest Room)
|-
|[[Room $40|Room {{$|40}}]]
|Agahnim's Tower (Final Bridge Room)
|-
|[[Room $41|Room {{$|41}}]]
|Hyrule Castle (First Dark Room)
|-
|[[Room $42]]
|Hyrule Castle (6 Ropes Room)
|-
|[[Room $43]]
|Desert Palace (Torch Puzzle / Moving Wall Room)
|-
|[[Room $44]]
|Thieves Town (Big Chest Room)
|-
|[[Room $45]]
|Thieves Town (Jail Cells Room)
|-
|[[Room $46]]
|Swamp Palace (Compass Chest Room)
|-
|[[Room $47]]
|Empty Clone Room
|-
|[[Room $48]]
|Empty Clone Room
|-
|[[Room $49]]
|Skull Woods (Gibdo Torch Puzzle Room)
|-
|[[Room $4A]]
|Palace of Darkness (Entrance Room)
|-
|[[Room $4B]]
|Palace of Darkness (Warps / South Mimics Room)
|-
|[[Room $4C]]
|Ganon's Tower (Mini-Helmasaur Conveyor Room)
|-
|[[Room $4D]]
|Ganon's Tower (Moldorm Room)
|-
|[[Room $4E]]
|Ice Palace (Bomb-Jump Room)
|-
|[[Room $4F]]
|Ice Palace Clone Room (Fairy Room)
|-
|[[Room $50]]
|Hyrule Castle (West Corridor)
|-
|[[Room $51]]
|Hyrule Castle (Throne Room)
|-
|[[Room $52]]
|Hyrule Castle (East Corridor)
|-
|[[Room $53]]
|Desert Palace (Popos 2 / Beamos Hellway Room)
|-
|[[Room $54]]
|Swamp Palace (Upstairs Pits Room)
|-
|[[Room $55]]
|Castle Secret Entrance / Uncle Death Room
|-
|[[Room $56]]
|Skull Woods (Key Pot / Trap Room)
|-
|[[Room $57]]
|Skull Woods (Big Key Room)
|-
|[[Room $58]]
|Skull Woods (Big Chest Room)
|-
|[[Room $59]]
|Skull Woods (Final Section Entrance Room)
|-
|[[Room $5A]]
|Palace of Darkness (Helmasaur King[Boss])
|-
|[[Room $5B]]
|Ganon's Tower (Spike Pit Room)
|-
|[[Room $5C]]
|Ganon's Tower (Ganon-Ball Z)
|-
|[[Room $5D]]
|Ganon's Tower (Gauntlet 1/2/3)
|-
|[[Room $5E]]
|Ice Palace (Lonely Firebar)
|-
|[[Room $5F]]
|Ice Palace (Hidden Chest / Spike Floor Room)
|-
|[[Room $60]]
|Hyrule Castle (West Entrance Room)
|-
|[[Room $61]]
|Hyrule Castle (Main Entrance Room)
|-
|[[Room $62]]
|Hyrule Castle (East Entrance Room)
|-
|[[Room $63]]
|Desert Palace (Final Section Entrance Room)
|-
|[[Room $64]]
|Thieves Town (West Attic Room)
|-
|[[Room $65]]
|Thieves Town (East Attic Room)
|-
|[[Room $66]]
|Swamp Palace (Hidden Chest / Hidden Door Room)
|-
|[[Room $67]]
|Skull Woods (Compass Chest Room)
|-
|[[Room $68]]
|Skull Woods (Key Chest / Trap Room)
|-
|[[Room $69]]
|Empty Clone Room
|-
|[[Room $6A]]
|Palace of Darkness (Rupee Room)
|-
|[[Room $6B]]
|Ganon's Tower (Mimics Rooms)
|-
|[[Room $6C]]
|Ganon's Tower (Lanmolas Room)
|-
|[[Room $6D]]
|Ganon's Tower (Gauntlet 4/5)
|-
|[[Room $6E]]
|Ice Palace (Pengators Room)
|-
|[[Room $6F]]
|Empty Clone Room
|-
|[[Room $70]]
|Hyrule Castle (Small Corridor to Jail Cells)
|-
|[[Room $71]]
|Hyrule Castle (Boomerang Chest Room)
|-
|[[Room $72]]
|Hyrule Castle (Map Chest Room)
|-
|[[Room $73]]
|Desert Palace (Big Chest Room)
|-
|[[Room $74]]
|Desert Palace (Map Chest Room)
|-
|[[Room $75]]
|Desert Palace (Big Key Chest Room)
|-
|[[Room $76]]
|Swamp Palace (Water Drain Room)
|-
|[[Room $77]]
|Tower of Hera (Entrance Room)
|-
|[[Room $78]]
|Empty Clone Room
|-
|[[Room $79]]
|Empty Clone Room
|-
|[[Room $7A]]
|Empty Clone Room
|-
|[[Room $7B]]
|Ganon's Tower
|-
|[[Room $7C]]
|Ganon's Tower (East Side Collapsing Bridge / Exploding Wall Room)
|-
|[[Room $7D]]
|Ganon's Tower (Winder / Warp Maze Room)
|-
|[[Room $7E]]
|Ice Palace (Hidden Chest / Bombable Floor Room)
|-
|[[Room $7F]]
|Ice Palace ( Big Spike Traps Room)
|-
|[[Room $80]]
|Hyrule Castle (Jail Cell Room)
|-
|[[Room $81]]
|Hyrule Castle
|-
|[[Room $82]]
|Hyrule Castle (Basement Chasm Room)
|-
|[[Room $83]]
|Desert Palace (West Entrance Room)
|-
|[[Room $84]]
|Desert Palace (Main Entrance Room)
|-
|[[Room $85]]
|Desert Palace (East Entrance Room)
|-
|[[Room $86]]
|Empty Clone Room
|-
|[[Room $87]]
|Tower of Hera (Tile Room)
|-
|[[Room $88]]
|Empty Clone Room
|-
|[[Room $89]]
|Eastern Palace (Fairy Room)
|-
|[[Room $8A]]
|Empty Clone Room
|-
|[[Room $8B]]
|Ganon's Tower (Block Puzzle / Spike Skip / Map Chest Room)
|-
|[[Room $8C]]
|Ganon's Tower (East and West Downstairs / Big Chest Room)
|-
|[[Room $8D]]
|Ganon's Tower (Tile / Torch Puzzle Room)
|-
|[[Room $8E]]
|Ice Palace
|-
|[[Room $8F]]
|Empty Clone Room
|-
|[[Room $90]]
|Misery Mire (Vitreous[Boss])
|-
|[[Room $91]]
|Misery Mire (Final Switch Room)
|-
|[[Room $92]]
|Misery Mire (Dark Bomb Wall / Switches Room)
|-
|[[Room $93]]
|Misery Mire (Dark Cane Floor Switch Puzzle Room)
|-
|[[Room $94]]
|Empty Clone Room
|-
|[[Room $95]]
|Ganon's Tower (Final Collapsing Bridge Room)
|-
|[[Room $96]]
|Ganon's Tower (Torches 1 Room)
|-
|[[Room $97]]
|Misery Mire (Torch Puzzle / Moving Wall Room)
|-
|[[Room $98]]
|Misery Mire (Entrance Room)
|-
|[[Room $99]]
|Eastern Palace (Eyegore Key Room)
|-
|[[Room $9A]]
|Empty Clone Room
|-
|[[Room $9B]]
|Ganon's Tower (Many Spikes / Warp Maze Room)
|-
|[[Room $9C]]
|Ganon's Tower (Invisible Floor Maze Room)
|-
|[[Room $9D]]
|Ganon's Tower (Compass Chest / Invisible Floor Room)
|-
|[[Room $9E]]
|Ice Palace (Big Chest Room)
|-
|[[Room $9F]]
|Ice Palace
|-
|[[Room $A0]]
|Misery Mire (Pre-Vitreous Room)
|-
|[[Room $A1]]
|Misery Mire (Fish Room)
|-
|[[Room $A2]]
|Misery Mire (Bridge Key Chest Room)
|-
|[[Room $A3]]
|Misery Mire
|-
|[[Room $A4]]
|Turtle Rock (Trinexx[Boss])
|-
|[[Room $A5]]
|Ganon's Tower (Wizzrobes Rooms)
|-
|[[Room $A6]]
|Ganon's Tower (Moldorm Fall Room)
|-
|[[Room $A7]]
|Tower of Hera (Fairy Room)
|-
|[[Room $A8]]
|Eastern Palace (Stalfos Spawn Room)
|-
|[[Room $A9]]
|Eastern Palace (Big Chest Room)
|-
|[[Room $AA]]
|Eastern Palace (Map Chest Room)
|-
|[[Room $AB]]
|Thieves Town (Moving Spikes / Key Pot Room)
|-
|[[Room $AC]]
|Thieves Town (Blind The Thief[Boss])
|-
|[[Room $AD]]
|Empty Clone Room
|-
|[[Room $AE]]
|Ice Palace
|-
|[[Room $AF]]
|Ice Palace (Ice Bridge Room)
|-
|[[Room $B0]]
|Agahnim's Tower (Circle of Pots)
|-
|[[Room $B1]]
|Misery Mire (Hourglass Room)
|-
|[[Room $B2]]
|Misery Mire (Slug Room)
|-
|[[Room $B3]]
|Misery Mire (Spike Key Chest Room)
|-
|[[Room $B4]]
|Turtle Rock (Pre-Trinexx Room)
|-
|[[Room $B5]]
|Turtle Rock (Dark Maze)
|-
|[[Room $B6]]
|Turtle Rock (Chain Chomps Room)
|-
|[[Room $B7]]
|Turtle Rock (Map Chest / Key Chest / Roller Room)
|-
|[[Room $B8]]
|Eastern Palace (Big Key Room)
|-
|[[Room $B9]]
|Eastern Palace (Lobby Cannonballs Room)
|-
|[[Room $BA]]
|Eastern Palace (Dark Antifairy / Key Pot Room)
|-
|[[Room $BB]]
|Thieves Town (Hellway)
|-
|[[Room $BC]]
|Thieves Town (Conveyor Toilet)
|-
|[[Room $BD]]
|Empty Clone Room
|-
|[[Room $BE]]
|Ice Palace (Block Puzzle Room)
|-
|[[Room $BF]]
|Ice Palace Clone Room (Switch Room)
|-
|[[Room $C0]]
|Agahnim's Tower (Dark Bridge Room)
|-
|[[Room $C1]]
|Misery Mire (Compass Chest / Tile Room)
|-
|[[Room $C2]]
|Misery Mire (Big Hub Room)
|-
|[[Room $C3]]
|Misery Mire (Big Chest Room)
|-
|[[Room $C4]]
|Turtle Rock (Final Crystal Switch Puzzle Room)
|-
|[[Room $C5]]
|Turtle Rock (Laser Bridge)
|-
|[[Room $C6]]
|Turtle Rock
|-
|[[Room $C7]]
|Turtle Rock (Torch Puzzle)
|-
|[[Room $C8]]
|Eastern Palace (Armos Knights[Boss])
|-
|[[Room $C9]]
|Eastern Palace (Entrance Room)
|-
|[[Room $CA]]
|??
|-
|[[Room $CB]]
|Thieves Town (North West Entrance Room)
|-
|[[Room $CC]]
|Thieves Town (North East Entrance Room)
|-
|[[Room $CD]]
|Empty Clone Room
|-
|[[Room $CE]]
|Ice Palace (Hole to Kholdstare Room)
|-
|[[Room $CF]]
|Empty Clone Room
|-
|[[Room $D0]]
|Agahnim's Tower (Dark Maze)
|-
|[[Room $D1]]
|Misery Mire (Conveyor Slug / Big Key Room)
|-
|[[Room $D2]]
|Misery Mire (Mire02 / Wizzrobes Room)
|-
|[[Room $D3]]
|Empty Clone Room
|-
|[[Room $D4]]
|Empty Clone Room
|-
|[[Room $D5]]
|Turtle Rock (Laser Key Room)
|-
|[[Room $D6]]
|Turtle Rock (Entrance Room)
|-
|[[Room $D7]]
|Empty Clone Room
|-
|[[Room $D8]]
|Eastern Palace ("Zeldagamer Room" / Pre-Armos Knights Room)
|-
|[[Room $D9]]
|Eastern Palace (Canonball Room)
|-
|[[Room $DA]]
|Eastern Palace
|-
|[[Room $DB]]
|Thieves Town (Main (South West) Entrance Room)
|-
|[[Room $DC]]
|Thieves Town (South East Entrance Room)
|-
|[[Room $DD]]
|Empty Clone Room
|-
|[[Room $DE]]
|Ice Palace (Kholdstare[Boss])
|-
|[[Room $DF]]
|Cave
|-
|[[Room $E0]]
|Agahnim's Tower (Entrance Room)
|-
|[[Room $E1]]
|Cave (Lost Woods HP)
|-
|[[Room $E2]]
|Cave (Lumberjack's Tree HP)
|-
|[[Room $E3]]
|Cave (1/2 Magic)
|-
|[[Room $E4]]
|Cave (Lost Old Man Final Cave)
|-
|[[Room $E5]]
|Cave (Lost Old Man Final Cave)
|-
|[[Room $E6]]
|Cave
|-
|[[Room $E7]]
|Cave
|-
|[[Room $E8]]
|Cave
|-
|[[Room $E9]]
|Empty Clone Room
|-
|[[Room $EA]]
|Cave (Spectacle Rock HP)
|-
|[[Room $EB]]
|Cave
|-
|[[Room $EC]]
|Empty Clone Room
|-
|[[Room $ED]]
|Cave
|-
|[[Room $EE]]
|Cave (Spiral Cave)
|-
|[[Room $EF]]
|Cave (Crystal Switch / 5 Chests Room)
|-
|[[Room $F0]]
|Cave (Lost Old Man Starting Cave)
|-
|[[Room $F1]]
|Cave (Lost Old Man Starting Cave)
|-
|[[Room $F2]]
|House
|-
|[[Room $F3]]
|House (Old Woman (Sahasrahla's Wife?))
|-
|[[Room $F4]]
|House (Angry Brothers)
|-
|[[Room $F5]]
|House (Angry Brothers)
|-
|[[Room $F6]]
|Empty Clone Room
|-
|[[Room $F7]]
|Empty Clone Room
|-
|[[Room $F8]]
|Cave
|-
|[[Room $F9]]
|Cave
|-
|[[Room $FA]]
|Cave
|-
|[[Room $FB]]
|Cave
|-
|[[Room $FC]]
|Empty Clone Room
|-
|[[Room $FD]]
|Cave
|-
|[[Room $FE]]
|Cave
|-
|[[Room $FF]]
|Cave
|}

==Secondary Map==

{{note|Todo}}

{{toc}}

Underworld

2017-12-23T22:02:11Z

Tatters: /* Scroll Edges */

The underworld refers to all indoor locations; including dungeons, caves, and houses.

==Important Hex Addresses==
===Room Data===
====Room Headers====
*{{$|027502}} to {{$|027781}} = Pointer Table, {{hex|2}} byte local addresses, indexed by room ID.
*{{$|027781}} to {{$|027FEF}} = Data

<blockquote>
Headers are {{$|0E}} (Decimal: 14) bytes formatted thusly:
*Byte {{hex|0}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
**The {{red|a}} bits are transformed into {{hex|0000 0}}{{red|aaa}} and stored to {{$|0414}} ("BG2" in Hyrule Magic)
**The {{blue|b}} bits are transformed into {{hex|0000 0}}{{blue|bbb}} and stored to {{$|046C}} ("Collision" in Hyrule Magic)
**The {{green|c}} bit is unused
**The {{purple|d}} bit is stored to {{$|7EC005}} (If set, use a lights out routine in the room transition)

*Byte {{hex|1}}: {{red|aa}}{{blue|bb bbbb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{blue|bbbb bb}}{{hex|00}}, thus making them a multiple of 4.
This value is used to load 4 different palettes for the dungeon, and corresponds to, you guessed it, Palette # in Hyrule Magic!

The resulting index is used to load values for {{$|0AB6}}, {{$|0AAC}}, {{$|0AAD}}, and {{$|0AAE}}

*Byte {{hex|2}}: gets stored to {{$|0AA2}} (GFX # in Hyrule Magic)
*Byte {{hex|3}}: value + #$40 gets stored to {{$|0AA3}} (Sprite GFX # in Hyrule Magic)
*Byte {{hex|4}}: gets stored to {{$|00AD}} ("[[Room Effects|Effect]]" in Hyrule Magic)
*Byte {{hex|5}}: {{red|aa}}{{blue|bb bbbb}}
**{{red|a}} = ?
**The {{blue|b}} bits are "[[Room Tags|Tag1]]" in Hyrule Magic and gets stored to {{$|00AE}}.
*Byte {{hex|6}}: {{red|aa}}{{blue|bb bbbb}}
**{{red|a}} = ?
**The {{blue|b}} bits are "[[Room Tags|Tag2]]" in Hyrule Magic and get stored to {{$|00AF}}

These are the planes to use for bytes {{hex|9}} through {{hex|D}}. This determines which
BG you appear on, and possibly more.

*Byte {{hex|7}}: {{red|aa}}{{blue|bb}} {{green|cc}}{{purple|dd}}
**The {{red|a}} bits are transformed into {{hex|0000 00}}{{red|aa}} and stored to {{$|063F}}
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|063E}}
**The {{green|c}} bits are transformed into {{hex|0000 00}}{{green|cc}} and stored to {{$|063D}}
**The {{purple|d}} bits are transformed into {{hex|0000 00}}{{purple|dd}} and stored to {{$|063C}}

Note, the only safe values for a plane seem to be {{hex|0}},{{hex|1}}, or {{hex|2}}. Hyrule Magic
appears to violate this rule by letting you put {{hex|3}} down, but nothing higher.

*Byte {{hex|8}}: {{red|aaaa aa}}{{blue|bb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|0640}}

*Byte {{hex|9}}: stored to {{$|7EC000}} These are all room numbers that you could possibly exit to.
*Byte {{hex|A}}: stored to {{$|7EC001}}
*Byte {{hex|B}}: stored to {{$|7EC002}}
*Byte {{hex|C}}: stored to {{$|7EC003}}
*Byte {{hex|D}}: stored to {{$|7EC004}}
</blockquote>

====Sprite Data====
* {{$|04D62E}} to {{$|04D92E}} = Pointer Table, 2 byte local addresses, indexed by room.
* {{$|04D92E}} to {{$|04EC9D}} = Data

<blockquote>
Sprite data is formatted thusly:
*Byte {{hex|0}}: Stored to {{$|0FB3}}. Corresponds with "Sort Spr" in Hyrule Magic. In a layered room this indicates sprites in the foreground are to be drawn on top of sprites in the background.
**Bit {{hex|0}} - If {{hex|0}}, sprites will sort
**Bits {{hex|7,6,5,4,3,2,1}} - Unknown, should all be {{hex|1}}
After the byte {{hex|0}}, you will see 3 byte clusters that break down thus:

*Byte {{hex|0}}:
**Bits {{hex|4,3,2,1,0}} - Y coordinate (in pixels from the top, starting at {{hex|0}}) of the sprite divided by 16.
**Bits {{hex|6,5}} - If these are set, they will be used to generate a subtype, stored to {{$|0E30}}, X.
**Bit {{hex|7}} - If set, the sprite is on BG2, if not it's on BG1
* Byte {{hex|1}}:
** Bits {{hex|4,3,2,1,0}} - X coordinate (in pixels from the far left, starting at {{hex|0}}) of the sprite divided by 16.
** Bits {{hex|7,6,5}} - If all these bits are set then this is an Overlord, otherwise it's a normal sprite. If only some of them are set they can be used to generate a subtype, stored at {{$|0E30}}, X
* Byte {{hex|2}}: Sprite or Overlord type. If a sprite, this will get loaded into a slot at {{$|0E20}}, X. If an Overlord, will get loaded to {{$|0B00}}, X.

The array is terminated with a byte of {{$|FF}}.
</blockquote>

====Object Data====
* {{$|0F8000}} to {{$|0F83BF}} = Pointer Table, 3 byte long addresses, indexed by room ID.
* {{$|01EBA0}} to {{$|01FFF4}} = Data
* {{$|050000}} to {{$|053729}} = Data
* {{$|0F8780}} to {{$|0FFF4D}} = Data
<blockquote>
Byte layout:

* Byte 0: {{red|aaaa}} {{blue|bbbb}}.
**The a bits are transformed to {{red|aaaa}}{{hex|0000}} and select the type of empty space to fill in. Hyrule Magic calls this 'Floor 1' - Gets stored to {{$|7E0490}}
**The b bits are transformed to {{blue|bbbb}}{{hex|0000}} and are the what Hyrule Magic calls 'Floor 2' - Gets stored to {{$|7E046A}}

* Byte {{hex|1}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
** The {{red|a}} bits are unused and should not be used
** The {{blue|b}} bits determine the room's layout type, ranging from {{hex|0}} to {{hex|7}}.
** The {{green|c}} and {{purple|d}} bits are unknown, but I have a feeling it's related to {{$|AA}} and {{$|A9}}

After that the bytes come in {{hex|3}} or {{hex|2}} byte object structures, used by routine {{$|01:88E4}}. Objects are loaded until an object with value {{0x|FFFF}} occurs. If a value {{0x|FFF0}} is loaded, the game will start loading Type 2 objects and will not go back to loading Type 1 objects until it is time to load the next layer. (Layer as in HM, not to be confused with the SNES' Backgrounds.) A value of {{0x|FFFF}} will also terminate the loading of Type 2 objects. The routine immediately terminates if that happens during the loading of either object type.

Type 1 Object structure: (3 bytes):

* Byte {{hex|3}}: Routine to use. If this byte is ≥ {{0x|F8}} and < {{0x|FC}}, then it is a subtype 3 object. If the index is ≥ {{hex|FC}}, it is a subtype 2 object. If not, it is a subtype 1 object.

* Subtype 1 Objects, first and second byte
** High Byte: {{brown|yyyy yy}}{{green|cc}}
** Low Byte: {{grey|xxxx xx}}{{red|aa}}
*** The {{red|a}} bits are stored to {{$|B2}}
*** The {{green|c}} bits are stored to {{$|B4}}
*** The {{grey|x}} and {{brown|y}} bits are transformed into: {{hex|000}}{{brown|y yyyy y}}{{grey|xxx xxx}}{{hex|0}} - This is a tilemap address that indexes into {{$|7E2000}} and / or {{$|7E4000}}

Use Byte {{hex|3}} * 2 as an index into the table at {{$|8200}}. This is the routine that is used to draw and otherwise handle the object. Subtype 1 objects have a maximum width and height of 4. Width and height are measured in terms of 32 {{x}} 32 pixels. (⟸ last part is questionable)

*Subtype 2 Objects, 1st, 2nd, & 3rd bytes:
** Byte {{hex|3}}: {{white|ff}}{{purple|dd dddd}}
** Byte {{hex|2}}: {{pink|eeee}} {{green|cccc}}
** Byte {{hex|1}}: {{red|aaaa aa}}{{blue|bb}}
***The {{red|a}} bits are unused, but after all they are the marker for this type of object subtype.
***The {{blue|b}}, {{green|c}}, {{pink|e}}, and {{white|f}} bits are transformed into a VRAM tilemap address: {{hex|000}}{{green|c ccc}}{{white|f}} {{white|f}}{{blue|bb}}{{pink|e eee}}{{hex|0}}

Might I add this is one messed up format? The {{purple|d}} bits are used as an index into the table at {{$|8470}}. Since such indices are going to be even, the {{purple|d}} bits are transformed into: {{hex|0000 0000 0}}{{purple|ddd ddd}}{{hex|0}}.

*Subtype 3 Objects
**Similar to Subtype 1, with a few small exceptions.
**The vram address is calculated the same way. However, {{$|B2}} and {{$|B4}} are not used as length or width dimensions here. The routine that is used is determined as follows:
**Take the original index (times two) that a Subtype 1 would have used. AND that with {{0x|000E}}. Then shift left 3 times to produce {{hex|0000 0000 0}}{{pink|eee}} {{hex|0000}}. Then, OR in {{$|B2}} and {{$|B4}} and shift left once, so the final result is: {{hex|0000 0000}} {{pink|eee}}{{red|a a}}{{blue|bb}}{{hex|0}}.
**Also, this value indexes into {{$|85F0}} instead of {{$|8200}}.

Type 2 Object Structure: (2 bytes)
*High Byte: {{green|cccc cccc}}
*Low Byte: {{blue|bbbb}} {{purple|dd}}{{red|aa}}
**The {{red|a}} bits form a 2-bit value ({{hex|0000 0}}{{red|aa}}{{hex|0}}) that determines the routine to use for the object. In Hyrule Magic, corresponds to the "direction" of the door.
**The {{blue|b}} bits are transformed into {{hex|000}}{{blue|b bbb}}{{hex|0}} and stored to {{$|02}} ⟹ X. Corresponds to "Pos" of door objects in the Hyrule Magic. Note that these range from {{0x|00}} to {{0x|16}} (always even) which if you halve those values is 0 - 11 in decimal. This is easily verifiable in Hyrule Magic.
**The {{green|c}} bits are shifted into the lower byte and stored to {{$|04}} ⟹ A and {{$|0A}}. This is later used to grab the tiles used to draw the door and the area below it. In Hyrule Magic, corresponds to "type". Note the type is 1/2 of the number listed here. This is because to avoid using an ASL A command, the {{green|c}} bits are always even.
**The {{purple|d}} bits are unused.

Next I'll go into the nitty gritty of the various types (the value of {{$|04}}). Again note that we'll only be dealing with even values {{blue|b}}/{{green|c}} that's what you'll see in the code. To convert between here [as well as the code] and Hyrule Magic, take the hex value here and divide by two. Convert to decimal and that's your Hyrule Magic "type."

*Types:
{|{{Prettytable}}
! ID
! Description
|-
|{{0x|00}}
|Basic door. Index = {{$|0460}}
|-
|{{0x|02}}
|Normal door?
|-
|{{0x|04}}
|???
|-
|{{0x|06}}
|???
|-
|{{0x|08}}
|Waterfall door (only used in Swamp palace; in one room at that!)
|-
|{{0x|0A}}
|???
|-
|{{0x|0C}}
|Trap door (probably other types but this seems to be most common)
|-
|{{0x|12}}
|Adds a property to some doors allowing you to exit to the overworld (this is accomplished by writing to the tile attribute map)
|-
|{{0x|14}}
|Transition to dark room?
|-
|{{0x|16}}
|Toggles the target BG Link will emerge on. '''Ex.''' if Link starts on BG0 in the next room he'll be on BG1.
|-
|{{0x|20}}
| rowspan="2"|Locked door specifically for BG0.
|-
|{{0x|22}}
|-
|{{0x|24}}
| rowspan="2"|Locked door for either BG0 or BG1
|-
|{{0x|26}}
|-
|{{0x|30}}
|Large exploded pathway resulting from a switch being pulled (unusual to have as a door as it's huge)
|-
|{{0x|32}}
|Sword activated door. '''Ex.''' Agahnim's room with the curtain door you have to slash.
|-
|{{0x|46}}
|warp door?
|}
</blockquote>

====Dungeon Secrets Data====
* {{$|00DB69}} to {{$|00DDE8}} = Pointer Table, 2 byte local addresses, indexed by room ID.
* {{$|00DDE9}} to {{$|00E6B1}} = Data
<blockquote>
Data comes in 3 byte chunks and is terminated by an instance of {{$|FFFF}}

* Bytes {{hex|0}}, {{hex|1}}: A word that denotes the VRAM address that the item is found at. This identifies the item as belonging to that part of the screen.
* Byte {{hex|2}}: Identifies the type of item that is hiding there. E.g. {{$|08}} is a key
</blockquote>

====Push Block Data====
* {{$|0271DE}} to {{$|027369}} = Data
<Blockquote>
4 bytes per entry:
{{red|a a }}{{blue|x }} {{green|y}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the block (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the block (expressed as tilemap coordinate)
</blockquote>

====(Inter Room) Torch Data====
* {{$|02736A}} to {{$|027489}} = Data
<Blockquote>
Consists of variable length segments consisting of:

{{red|a a }}{{blue|x }}{{green|y }}{{blue|x }}{{green|y }}{{hex|... }}{{$|FFFF}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the torch (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the torch (expressed as tilemap coordinate)
*{{$|FFFF}}: Delimeter
</blockquote>

====Chest Contents====
*{{$|00E96E}} to {{$|00EB65}} = Data
<blockquote>
Array of chest information in 3 byte chunks. 168 entries in all ({{0x|A8}})

*First word - Room number it is located in. MSB determines whether it is a big chest or not. (big chest if set)
*Last byte - index of the type of item contained in the chest.
</blockquote>

===Room layout===
In Hyrule Magic, there's a label and textbox for room layouts. The layout value goes from {{$|0}} to {{$|7}}

The location:

{|{{prettytable}}
!USA
!JP
|-
|{{0x|26F2F}}
|{{0x|26C0F}}
|}

In the aforementioned location, there are 8 long pointers (Lo-Hi-Bank).

===Entrance Data===
There are {{$|85}} (Decimal: 133) normal entrances to the underworld from the overworld, and {{$|7}} (Decimal: 7) starting locations.
Normal entrances and starting locations use mostly the same types of data formatted the same, however they are located in different places in the ROM.
They are located and formatted thus:

====Entrance Room====
*{{$|014813}} to {{$|01491C}} = Normal Entrance Data
*{{$|015B6E}} to {{$|015B7B}} = Starting Location Data
<blockquote>
Each entry is a 2 byte Room ID where the player is placed after using an entrance.
</blockquote>

====Scroll Edges====
*{{$|01491D}} to {{$|014D44}} = Normal Entrance Data
*{{$|015B7C}} to {{$|015BB3}} = Starting Location Data
<blockquote>
Unsure about what these do exactly.
Each entry is 8 bytes long.
*Format: 1 byte each. Corresponds to hyrule magic values in the "More" a.k.a. Entrance Properties dialog box.
**HU -
**FU -
**HD -
**FD -
**HL -
**FL -
**HR -
**FR -
</blockquote>

====X Scroll====
*{{$|014D45}} to {{$|014E4E}} = Normal Entrance Data
*{{$|015BB4}} to {{$|015BC1}} = Starting Location Data
<blockquote>

</blockquote>

====Y Scroll====
*{{$|014E4F}} to {{$|014F58}} = Normal Entrance Data
*{{$|015BC2}} to {{$|015BCF}} = Starting Location Data
<blockquote>

</blockquote>

====X Coordinate====
*{{$|014F59}} to {{$|015062}} = Normal Entrance Data
*{{$|015BD0}} to {{$|015BDD}} = Starting Location Data
<blockquote>
Each entry is a 2 byte X coordinate where the player starts after using the corresponding entrance.
</blockquote>

====Y Coordinate====
*{{$|015063}} to {{$|01516C}} = Normal Entrance Data
*{{$|015BDE}} to {{$|015BEB}} = Starting Location Data
<blockquote>
Each entry is a 2 byte y coordinate where the player starts after using the corresponding entrance.
</blockquote>

====X Camera Coordinate====
*{{$|01516D}} to {{$|015276}} = Normal Entrance Data
*{{$|015BEC}} to {{$|015BF9}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

====Y Camera Coordinate====
*{{$|015277}} to {{$|015380}} = Normal Entrance Data
*{{$|015BFA}} to {{$|015C07}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

====Entrance Blockset====
*{{$|015381}} to {{$|015405}} = Normal Entrance Data
*{{$|015C08}} to {{$|015C0E}} = Starting Location Data
<blockquote>
1 byte each. This blockset affects walls and a few other things and persists through all rooms the player accesses from this entrance.
</blockquote>

====Floor Values====
*{{$|015406}} to {{$|01548A}} = Normal Entrance Data
*{{$|015C0F}} to {{$|015C15}} = Starting Location Data
<blockquote>
This tells us what kind of properties the floor has. 1 byte each:
*If 1, then it has floors that you can fall through to the next level
*If 0, I think it means it can be fallen down to
*If -1, has no pits
*If -2, ????
</blockquote>

====Dungeon Values====
*{{$|01548B}} to {{$|01550F}} = Normal Entrance Data
*{{$|015C16}} to {{$|015C1C}} = Starting Location Data
<blockquote>
1 Byte each.
Dungeons actually in the game are numbered like so {{$|00}}, {{$|02}}, {{$|04}}, ..., {{$|18}}, {{$|1A}}.
{{$|1C}} and {{$|1E}} are unused (and hence could potentially be added.) Notice they are all even numbers.
In asm routines these values are divided by two sometimes to provide an index into other arrays.
That's why. The definition of a "dungeon" is something with a key, compass, and map.

A value of {{$|FF}} (-1) denotes it doesn't belong to a dungeon.
</blockquote>

====Doorway Type====
*{{$|015510}} to {{$|015594}} = Normal Entrance Data
*{{$|015C2B}} to {{$|015C31}} = Starting Location Data
<blockquote>
This is used only when you exit the given room. For example, let's say you enter through a skull doorway in Skullwoods.
But that's not really a door way, it's just a set of tiles that are no different from a hole you might create after picking
up a big rock. But if you entered from a building door, the game has to know whether to put the door frame when you exit.
*1 byte:
**{{hex|0}} = no doorway when exiting
**{{hex|1}} = draws a door frame upon exiting
**{{hex|2}} = ???? HM says vertical doorframe. But in the original game, no doorway is vertical.

</blockquote>

====Ladder And BG Settings====
*{{$|015595}} to {{$|015619}} = Normal Entrance Data
*{{$|015C1D}} to {{$|015C23}} = Starting Location Data
<blockquote>
*1 byte each, with the following 2 bit layout: {{hex|xxx}}{{red|a}}{{pink|xxx}}{{blue|b}}
**{{hex|x}} - unimportant
**{{red|a}} - if set, then Link enters on the lower level (BG2)
**{{blue|b}} - if set... not sure what happens exactly. Check the game engine to be sure.
</blockquote>

====Horizontal And Vertical Scroll Properties====
*{{$|01561A}} to {{$|01569E}} = Normal Entrance Data
*{{$|015C24}} to {{$|015C2A}} = Starting Location Data
<blockquote>
For these, I guess if the flags in the appropriate places are set, then the room will be able to scroll in those directions.

*1 byte each, with the following layout: {{hex|xx}}{{red|a}}{{hex|xxx}}{{blue|b}}{{hex|x}}
**{{red|a}} - Horizontal flag
**{{blue|b}} - Vertical flag
</blockquote>

====Scroll Quadrant====
*{{$|01569F}} to {{$|015723}} = Normal Entrance Data
<blockquote>
*1 byte each, has four different expected values:
**0h, 2h, 10h, 12h
</blockquote>

====Exit Door Location====
*{{$|015724}} to {{$|01582D}} = Normal Entrance Data
*{{$|015C32}} to {{$|015C3F}} = Starting Location Data
<blockquote>
1 word each. Denotes X and Y coordinates for overworld?
</blockquote>

====Music====
*{{$|01582E}} to {{$|0158B2}} = Normal Entrance Data (JP: 15592 - 15616)
*{{$|015C4E}} to {{$|015C54}} = Starting Location Data
<blockquote>
1 byte each. A value of {{$|FF}} plays the same music as the overworld screen from which the player entered.
</blockquote>

====Entrance Values====
*{{$|015C40}} to {{$|015C4D}} = Starting Location Data
<blockquote>
1 word each. Since the starting locations have to reference an entrance, this is necessary.
</blockquote>

==Rooms==
Tiles on the underworld maps are referred to as "super-rooms" and can contain 1-4 "sub-rooms."

===Primary Map===
The primary underworld map consists of {{$|FF}} (decimal: 256) super-rooms arranged in a {{$|10}} {{x}} {{$|10}} (decimal: 16 {{x}} 16) square.

{|{{Prettytable}}
! ID
! Description
|-
|[[Room $00|Room {{$|00}}]]
|Ganon
|-
|[[Room $01|Room {{$|01}}]]
|Hyrule Castle (North Corridor)
|-
|[[Room $02|Room {{$|02}}]]
|Hyrule Castle (Switch Room)
|-
|[[Room $03|Room {{$|03}}]]
|Houlihan Room
|-
|[[Room $04|Room {{$|04}}]]
|Turtle Rock (Crysta-roller Room)
|-
|[[Room $05|Room {{$|05}}]]
|Empty Clone Room
|-
|[[Room $06|Room {{$|06}}]]
|Swamp Palace (Arrghus[Boss])
|-
|[[Room $07|Room {{$|07}}]]
|Tower of Hera (Moldorm[Boss])
|-
|[[Room $08|Room {{$|08}}]]
|Cave (Healing Fairy)
|-
|[[Room $09|Room {{$|09}}]]
|Palace of Darkness
|-
|[[Room $0A|Room {{$|0A}}]]
|Palace of Darkness (Stalfos Trap Room)
|-
|[[Room $0B|Room {{$|0B}}]]
|Palace of Darkness (Turtle Room)
|-
|[[Room $0C|Room {{$|0C}}]]
|Ganon's Tower (Entrance Room)
|-
|[[Room $0D|Room {{$|0D}}]]
|Ganon's Tower (Agahnim2[Boss])
|-
|[[Room $0E|Room {{$|0E}}]]
|Ice Palace (Entrance Room)
|-
|[[Room $0F|Room {{$|0F}}]]
|Empty Clone Room
|-
|[[Room $10|Room {{$|10}}]]
|Ganon Evacuation Route
|-
|[[Room $11|Room {{$|11}}]]
|Hyrule Castle (Bombable Stock Room)
|-
|[[Room $12|Room {{$|12}}]]
|Sanctuary
|-
|[[Room $13|Room {{$|13}}]]
|Turtle Rock (Hokku-Bokku Key Room 2)
|-
|[[Room $14|Room {{$|14}}]]
|Turtle Rock (Big Key Room)
|-
|[[Room $15|Room {{$|15}}]]
|Turtle Rock
|-
|[[Room $16|Room {{$|16}}]]
|Swamp Palace (Swimming Treadmill)
|-
|[[Room $17|Room {{$|17}}]]
|Tower of Hera (Moldorm Fall Room)
|-
|[[Room $18|Room {{$|18}}]]
|Cave
|-
|[[Room $19|Room {{$|19}}]]
|Palace of Darkness (Dark Maze)
|-
|[[Room $1A|Room {{$|1A}}]]
|Palace of Darkness (Big Chest Room)
|-
|[[Room $1B|Room {{$|1B}}]]
|Palace of Darkness (Mimics / Moving Wall Room)
|-
|[[Room $1C|Room {{$|1C}}]]
|Ganon's Tower (Ice Armos)
|-
|[[Room $1D|Room {{$|1D}}]]
|Ganon's Tower (Final Hallway)
|-
|[[Room $1E|Room {{$|1E}}]]
|Ice Palace (Bomb Floor / Bari Room)
|-
|[[Room $1F|Room {{$|1F}}]]
|Ice Palace (Pengator / Big Key Room)
|-
|[[Room $20|Room {{$|20}}]]
|Agahnim's Tower (Agahnim[Boss])
|-
|[[Room $21|Room {{$|21}}]]
|Hyrule Castle (Key-rat Room)
|-
|[[Room $22|Room {{$|22}}]]
|Hyrule Castle (Sewer Text Trigger Room)
|-
|[[Room $23|Room {{$|23}}]]
|Turtle Rock (West Exit to Balcony)
|-
|[[Room $24|Room {{$|24}}]]
|Turtle Rock (Double Hokku-Bokku / Big chest Room)
|-
|[[Room $25|Room {{$|25}}]]
|Empty Clone Room
|-
|[[Room $26|Room {{$|26}}]]
|Swamp Palace (Statue Room)
|-
|[[Room $27|Room {{$|27}}]]
|Tower of Hera (Big Chest)
|-
|[[Room $28|Room {{$|28}}]]
|Swamp Palace (Entrance Room)
|-
|[[Room $29|Room {{$|29}}]]
|Skull Woods (Mothula[Boss])
|-
|[[Room $2A|Room {{$|2A}}]]
|Palace of Darkness (Big Hub Room)
|-
|[[Room $2B|Room {{$|2B}}]]
|Palace of Darkness (Map Chest / Fairy Room)
|-
|[[Room $2C|Room {{$|2C}}]]
|Cave
|-
|[[Room $2D|Room {{$|2D}}]]
|Empty Clone Room
|-
|[[Room $2E|Room {{$|2E}}]]
|Ice Palace (Compass Room)
|-
|[[Room $2F|Room {{$|2F}}]]
|Cave (Kakariko Well HP)
|-
|[[Room $30|Room {{$|30}}]]
|Agahnim's Tower (Maiden Sacrifice Chamber)
|-
|[[Room $31|Room {{$|31}}]]
|Tower of Hera (Hardhat Beetles Room)
|-
|[[Room $32|Room {{$|32}}]]
|Hyrule Castle (Sewer Key Chest Room)
|-
|[[Room $33|Room {{$|33}}]]
|Desert Palace (Lanmolas[Boss])
|-
|[[Room $34|Room {{$|34}}]]
|Swamp Palace (Push Block Puzzle / Pre-Big Key Room)
|-
|[[Room $35|Room {{$|35}}]]
|Swamp Palace (Big Key / BS Room)
|-
|[[Room $36|Room {{$|36}}]]
|Swamp Palace (Big Chest Room)
|-
|[[Room $37|Room {{$|37}}]]
|Swamp Palace (Map Chest / Water Fill Room)
|-
|[[Room $38|Room {{$|38}}]]
|Swamp Palace (Key Pot Room)
|-
|[[Room $39|Room {{$|39}}]]
|Skull Woods (Gibdo Key / Mothula Hole Room)
|-
|[[Room $3A|Room {{$|3A}}]]
|Palace of Darkness (Bombable Floor Room)
|-
|[[Room $3B|Room {{$|3B}}]]
|Palace of Darkness (Spike Block / Conveyor Room)
|-
|[[Room $3C|Room {{$|3C}}]]
|Cave
|-
|[[Room $3D|Room {{$|3D}}]]
|Ganon's Tower (Torch Room 2)
|-
|[[Room $3E|Room {{$|3E}}]]
|Ice Palace (Stalfos Knights / Conveyor Hellway)
|-
|[[Room $3F|Room {{$|3F}}]]
|Ice Palace (Map Chest Room)
|-
|[[Room $40|Room {{$|40}}]]
|Agahnim's Tower (Final Bridge Room)
|-
|[[Room $41|Room {{$|41}}]]
|Hyrule Castle (First Dark Room)
|-
|[[Room $42]]
|Hyrule Castle (6 Ropes Room)
|-
|[[Room $43]]
|Desert Palace (Torch Puzzle / Moving Wall Room)
|-
|[[Room $44]]
|Thieves Town (Big Chest Room)
|-
|[[Room $45]]
|Thieves Town (Jail Cells Room)
|-
|[[Room $46]]
|Swamp Palace (Compass Chest Room)
|-
|[[Room $47]]
|Empty Clone Room
|-
|[[Room $48]]
|Empty Clone Room
|-
|[[Room $49]]
|Skull Woods (Gibdo Torch Puzzle Room)
|-
|[[Room $4A]]
|Palace of Darkness (Entrance Room)
|-
|[[Room $4B]]
|Palace of Darkness (Warps / South Mimics Room)
|-
|[[Room $4C]]
|Ganon's Tower (Mini-Helmasaur Conveyor Room)
|-
|[[Room $4D]]
|Ganon's Tower (Moldorm Room)
|-
|[[Room $4E]]
|Ice Palace (Bomb-Jump Room)
|-
|[[Room $4F]]
|Ice Palace Clone Room (Fairy Room)
|-
|[[Room $50]]
|Hyrule Castle (West Corridor)
|-
|[[Room $51]]
|Hyrule Castle (Throne Room)
|-
|[[Room $52]]
|Hyrule Castle (East Corridor)
|-
|[[Room $53]]
|Desert Palace (Popos 2 / Beamos Hellway Room)
|-
|[[Room $54]]
|Swamp Palace (Upstairs Pits Room)
|-
|[[Room $55]]
|Castle Secret Entrance / Uncle Death Room
|-
|[[Room $56]]
|Skull Woods (Key Pot / Trap Room)
|-
|[[Room $57]]
|Skull Woods (Big Key Room)
|-
|[[Room $58]]
|Skull Woods (Big Chest Room)
|-
|[[Room $59]]
|Skull Woods (Final Section Entrance Room)
|-
|[[Room $5A]]
|Palace of Darkness (Helmasaur King[Boss])
|-
|[[Room $5B]]
|Ganon's Tower (Spike Pit Room)
|-
|[[Room $5C]]
|Ganon's Tower (Ganon-Ball Z)
|-
|[[Room $5D]]
|Ganon's Tower (Gauntlet 1/2/3)
|-
|[[Room $5E]]
|Ice Palace (Lonely Firebar)
|-
|[[Room $5F]]
|Ice Palace (Hidden Chest / Spike Floor Room)
|-
|[[Room $60]]
|Hyrule Castle (West Entrance Room)
|-
|[[Room $61]]
|Hyrule Castle (Main Entrance Room)
|-
|[[Room $62]]
|Hyrule Castle (East Entrance Room)
|-
|[[Room $63]]
|Desert Palace (Final Section Entrance Room)
|-
|[[Room $64]]
|Thieves Town (West Attic Room)
|-
|[[Room $65]]
|Thieves Town (East Attic Room)
|-
|[[Room $66]]
|Swamp Palace (Hidden Chest / Hidden Door Room)
|-
|[[Room $67]]
|Skull Woods (Compass Chest Room)
|-
|[[Room $68]]
|Skull Woods (Key Chest / Trap Room)
|-
|[[Room $69]]
|Empty Clone Room
|-
|[[Room $6A]]
|Palace of Darkness (Rupee Room)
|-
|[[Room $6B]]
|Ganon's Tower (Mimics Rooms)
|-
|[[Room $6C]]
|Ganon's Tower (Lanmolas Room)
|-
|[[Room $6D]]
|Ganon's Tower (Gauntlet 4/5)
|-
|[[Room $6E]]
|Ice Palace (Pengators Room)
|-
|[[Room $6F]]
|Empty Clone Room
|-
|[[Room $70]]
|Hyrule Castle (Small Corridor to Jail Cells)
|-
|[[Room $71]]
|Hyrule Castle (Boomerang Chest Room)
|-
|[[Room $72]]
|Hyrule Castle (Map Chest Room)
|-
|[[Room $73]]
|Desert Palace (Big Chest Room)
|-
|[[Room $74]]
|Desert Palace (Map Chest Room)
|-
|[[Room $75]]
|Desert Palace (Big Key Chest Room)
|-
|[[Room $76]]
|Swamp Palace (Water Drain Room)
|-
|[[Room $77]]
|Tower of Hera (Entrance Room)
|-
|[[Room $78]]
|Empty Clone Room
|-
|[[Room $79]]
|Empty Clone Room
|-
|[[Room $7A]]
|Empty Clone Room
|-
|[[Room $7B]]
|Ganon's Tower
|-
|[[Room $7C]]
|Ganon's Tower (East Side Collapsing Bridge / Exploding Wall Room)
|-
|[[Room $7D]]
|Ganon's Tower (Winder / Warp Maze Room)
|-
|[[Room $7E]]
|Ice Palace (Hidden Chest / Bombable Floor Room)
|-
|[[Room $7F]]
|Ice Palace ( Big Spike Traps Room)
|-
|[[Room $80]]
|Hyrule Castle (Jail Cell Room)
|-
|[[Room $81]]
|Hyrule Castle
|-
|[[Room $82]]
|Hyrule Castle (Basement Chasm Room)
|-
|[[Room $83]]
|Desert Palace (West Entrance Room)
|-
|[[Room $84]]
|Desert Palace (Main Entrance Room)
|-
|[[Room $85]]
|Desert Palace (East Entrance Room)
|-
|[[Room $86]]
|Empty Clone Room
|-
|[[Room $87]]
|Tower of Hera (Tile Room)
|-
|[[Room $88]]
|Empty Clone Room
|-
|[[Room $89]]
|Eastern Palace (Fairy Room)
|-
|[[Room $8A]]
|Empty Clone Room
|-
|[[Room $8B]]
|Ganon's Tower (Block Puzzle / Spike Skip / Map Chest Room)
|-
|[[Room $8C]]
|Ganon's Tower (East and West Downstairs / Big Chest Room)
|-
|[[Room $8D]]
|Ganon's Tower (Tile / Torch Puzzle Room)
|-
|[[Room $8E]]
|Ice Palace
|-
|[[Room $8F]]
|Empty Clone Room
|-
|[[Room $90]]
|Misery Mire (Vitreous[Boss])
|-
|[[Room $91]]
|Misery Mire (Final Switch Room)
|-
|[[Room $92]]
|Misery Mire (Dark Bomb Wall / Switches Room)
|-
|[[Room $93]]
|Misery Mire (Dark Cane Floor Switch Puzzle Room)
|-
|[[Room $94]]
|Empty Clone Room
|-
|[[Room $95]]
|Ganon's Tower (Final Collapsing Bridge Room)
|-
|[[Room $96]]
|Ganon's Tower (Torches 1 Room)
|-
|[[Room $97]]
|Misery Mire (Torch Puzzle / Moving Wall Room)
|-
|[[Room $98]]
|Misery Mire (Entrance Room)
|-
|[[Room $99]]
|Eastern Palace (Eyegore Key Room)
|-
|[[Room $9A]]
|Empty Clone Room
|-
|[[Room $9B]]
|Ganon's Tower (Many Spikes / Warp Maze Room)
|-
|[[Room $9C]]
|Ganon's Tower (Invisible Floor Maze Room)
|-
|[[Room $9D]]
|Ganon's Tower (Compass Chest / Invisible Floor Room)
|-
|[[Room $9E]]
|Ice Palace (Big Chest Room)
|-
|[[Room $9F]]
|Ice Palace
|-
|[[Room $A0]]
|Misery Mire (Pre-Vitreous Room)
|-
|[[Room $A1]]
|Misery Mire (Fish Room)
|-
|[[Room $A2]]
|Misery Mire (Bridge Key Chest Room)
|-
|[[Room $A3]]
|Misery Mire
|-
|[[Room $A4]]
|Turtle Rock (Trinexx[Boss])
|-
|[[Room $A5]]
|Ganon's Tower (Wizzrobes Rooms)
|-
|[[Room $A6]]
|Ganon's Tower (Moldorm Fall Room)
|-
|[[Room $A7]]
|Tower of Hera (Fairy Room)
|-
|[[Room $A8]]
|Eastern Palace (Stalfos Spawn Room)
|-
|[[Room $A9]]
|Eastern Palace (Big Chest Room)
|-
|[[Room $AA]]
|Eastern Palace (Map Chest Room)
|-
|[[Room $AB]]
|Thieves Town (Moving Spikes / Key Pot Room)
|-
|[[Room $AC]]
|Thieves Town (Blind The Thief[Boss])
|-
|[[Room $AD]]
|Empty Clone Room
|-
|[[Room $AE]]
|Ice Palace
|-
|[[Room $AF]]
|Ice Palace (Ice Bridge Room)
|-
|[[Room $B0]]
|Agahnim's Tower (Circle of Pots)
|-
|[[Room $B1]]
|Misery Mire (Hourglass Room)
|-
|[[Room $B2]]
|Misery Mire (Slug Room)
|-
|[[Room $B3]]
|Misery Mire (Spike Key Chest Room)
|-
|[[Room $B4]]
|Turtle Rock (Pre-Trinexx Room)
|-
|[[Room $B5]]
|Turtle Rock (Dark Maze)
|-
|[[Room $B6]]
|Turtle Rock (Chain Chomps Room)
|-
|[[Room $B7]]
|Turtle Rock (Map Chest / Key Chest / Roller Room)
|-
|[[Room $B8]]
|Eastern Palace (Big Key Room)
|-
|[[Room $B9]]
|Eastern Palace (Lobby Cannonballs Room)
|-
|[[Room $BA]]
|Eastern Palace (Dark Antifairy / Key Pot Room)
|-
|[[Room $BB]]
|Thieves Town (Hellway)
|-
|[[Room $BC]]
|Thieves Town (Conveyor Toilet)
|-
|[[Room $BD]]
|Empty Clone Room
|-
|[[Room $BE]]
|Ice Palace (Block Puzzle Room)
|-
|[[Room $BF]]
|Ice Palace Clone Room (Switch Room)
|-
|[[Room $C0]]
|Agahnim's Tower (Dark Bridge Room)
|-
|[[Room $C1]]
|Misery Mire (Compass Chest / Tile Room)
|-
|[[Room $C2]]
|Misery Mire (Big Hub Room)
|-
|[[Room $C3]]
|Misery Mire (Big Chest Room)
|-
|[[Room $C4]]
|Turtle Rock (Final Crystal Switch Puzzle Room)
|-
|[[Room $C5]]
|Turtle Rock (Laser Bridge)
|-
|[[Room $C6]]
|Turtle Rock
|-
|[[Room $C7]]
|Turtle Rock (Torch Puzzle)
|-
|[[Room $C8]]
|Eastern Palace (Armos Knights[Boss])
|-
|[[Room $C9]]
|Eastern Palace (Entrance Room)
|-
|[[Room $CA]]
|??
|-
|[[Room $CB]]
|Thieves Town (North West Entrance Room)
|-
|[[Room $CC]]
|Thieves Town (North East Entrance Room)
|-
|[[Room $CD]]
|Empty Clone Room
|-
|[[Room $CE]]
|Ice Palace (Hole to Kholdstare Room)
|-
|[[Room $CF]]
|Empty Clone Room
|-
|[[Room $D0]]
|Agahnim's Tower (Dark Maze)
|-
|[[Room $D1]]
|Misery Mire (Conveyor Slug / Big Key Room)
|-
|[[Room $D2]]
|Misery Mire (Mire02 / Wizzrobes Room)
|-
|[[Room $D3]]
|Empty Clone Room
|-
|[[Room $D4]]
|Empty Clone Room
|-
|[[Room $D5]]
|Turtle Rock (Laser Key Room)
|-
|[[Room $D6]]
|Turtle Rock (Entrance Room)
|-
|[[Room $D7]]
|Empty Clone Room
|-
|[[Room $D8]]
|Eastern Palace ("Zeldagamer Room" / Pre-Armos Knights Room)
|-
|[[Room $D9]]
|Eastern Palace (Canonball Room)
|-
|[[Room $DA]]
|Eastern Palace
|-
|[[Room $DB]]
|Thieves Town (Main (South West) Entrance Room)
|-
|[[Room $DC]]
|Thieves Town (South East Entrance Room)
|-
|[[Room $DD]]
|Empty Clone Room
|-
|[[Room $DE]]
|Ice Palace (Kholdstare[Boss])
|-
|[[Room $DF]]
|Cave
|-
|[[Room $E0]]
|Agahnim's Tower (Entrance Room)
|-
|[[Room $E1]]
|Cave (Lost Woods HP)
|-
|[[Room $E2]]
|Cave (Lumberjack's Tree HP)
|-
|[[Room $E3]]
|Cave (1/2 Magic)
|-
|[[Room $E4]]
|Cave (Lost Old Man Final Cave)
|-
|[[Room $E5]]
|Cave (Lost Old Man Final Cave)
|-
|[[Room $E6]]
|Cave
|-
|[[Room $E7]]
|Cave
|-
|[[Room $E8]]
|Cave
|-
|[[Room $E9]]
|Empty Clone Room
|-
|[[Room $EA]]
|Cave (Spectacle Rock HP)
|-
|[[Room $EB]]
|Cave
|-
|[[Room $EC]]
|Empty Clone Room
|-
|[[Room $ED]]
|Cave
|-
|[[Room $EE]]
|Cave (Spiral Cave)
|-
|[[Room $EF]]
|Cave (Crystal Switch / 5 Chests Room)
|-
|[[Room $F0]]
|Cave (Lost Old Man Starting Cave)
|-
|[[Room $F1]]
|Cave (Lost Old Man Starting Cave)
|-
|[[Room $F2]]
|House
|-
|[[Room $F3]]
|House (Old Woman (Sahasrahla's Wife?))
|-
|[[Room $F4]]
|House (Angry Brothers)
|-
|[[Room $F5]]
|House (Angry Brothers)
|-
|[[Room $F6]]
|Empty Clone Room
|-
|[[Room $F7]]
|Empty Clone Room
|-
|[[Room $F8]]
|Cave
|-
|[[Room $F9]]
|Cave
|-
|[[Room $FA]]
|Cave
|-
|[[Room $FB]]
|Cave
|-
|[[Room $FC]]
|Empty Clone Room
|-
|[[Room $FD]]
|Cave
|-
|[[Room $FE]]
|Cave
|-
|[[Room $FF]]
|Cave
|}

===Secondary Map===

{{toc}}

Underworld

2017-12-23T21:54:25Z

Tatters: /* Chest Contents */

The underworld refers to all indoor locations; including dungeons, caves, and houses.

==Important Hex Addresses==
===Room Data===
====Room Headers====
*{{$|027502}} to {{$|027781}} = Pointer Table, {{hex|2}} byte local addresses, indexed by room ID.
*{{$|027781}} to {{$|027FEF}} = Data

<blockquote>
Headers are {{$|0E}} (Decimal: 14) bytes formatted thusly:
*Byte {{hex|0}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
**The {{red|a}} bits are transformed into {{hex|0000 0}}{{red|aaa}} and stored to {{$|0414}} ("BG2" in Hyrule Magic)
**The {{blue|b}} bits are transformed into {{hex|0000 0}}{{blue|bbb}} and stored to {{$|046C}} ("Collision" in Hyrule Magic)
**The {{green|c}} bit is unused
**The {{purple|d}} bit is stored to {{$|7EC005}} (If set, use a lights out routine in the room transition)

*Byte {{hex|1}}: {{red|aa}}{{blue|bb bbbb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{blue|bbbb bb}}{{hex|00}}, thus making them a multiple of 4.
This value is used to load 4 different palettes for the dungeon, and corresponds to, you guessed it, Palette # in Hyrule Magic!

The resulting index is used to load values for {{$|0AB6}}, {{$|0AAC}}, {{$|0AAD}}, and {{$|0AAE}}

*Byte {{hex|2}}: gets stored to {{$|0AA2}} (GFX # in Hyrule Magic)
*Byte {{hex|3}}: value + #$40 gets stored to {{$|0AA3}} (Sprite GFX # in Hyrule Magic)
*Byte {{hex|4}}: gets stored to {{$|00AD}} ("[[Room Effects|Effect]]" in Hyrule Magic)
*Byte {{hex|5}}: {{red|aa}}{{blue|bb bbbb}}
**{{red|a}} = ?
**The {{blue|b}} bits are "[[Room Tags|Tag1]]" in Hyrule Magic and gets stored to {{$|00AE}}.
*Byte {{hex|6}}: {{red|aa}}{{blue|bb bbbb}}
**{{red|a}} = ?
**The {{blue|b}} bits are "[[Room Tags|Tag2]]" in Hyrule Magic and get stored to {{$|00AF}}

These are the planes to use for bytes {{hex|9}} through {{hex|D}}. This determines which
BG you appear on, and possibly more.

*Byte {{hex|7}}: {{red|aa}}{{blue|bb}} {{green|cc}}{{purple|dd}}
**The {{red|a}} bits are transformed into {{hex|0000 00}}{{red|aa}} and stored to {{$|063F}}
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|063E}}
**The {{green|c}} bits are transformed into {{hex|0000 00}}{{green|cc}} and stored to {{$|063D}}
**The {{purple|d}} bits are transformed into {{hex|0000 00}}{{purple|dd}} and stored to {{$|063C}}

Note, the only safe values for a plane seem to be {{hex|0}},{{hex|1}}, or {{hex|2}}. Hyrule Magic
appears to violate this rule by letting you put {{hex|3}} down, but nothing higher.

*Byte {{hex|8}}: {{red|aaaa aa}}{{blue|bb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|0640}}

*Byte {{hex|9}}: stored to {{$|7EC000}} These are all room numbers that you could possibly exit to.
*Byte {{hex|A}}: stored to {{$|7EC001}}
*Byte {{hex|B}}: stored to {{$|7EC002}}
*Byte {{hex|C}}: stored to {{$|7EC003}}
*Byte {{hex|D}}: stored to {{$|7EC004}}
</blockquote>

====Sprite Data====
* {{$|04D62E}} to {{$|04D92E}} = Pointer Table, 2 byte local addresses, indexed by room.
* {{$|04D92E}} to {{$|04EC9D}} = Data

<blockquote>
Sprite data is formatted thusly:
*Byte {{hex|0}}: Stored to {{$|0FB3}}. Corresponds with "Sort Spr" in Hyrule Magic. In a layered room this indicates sprites in the foreground are to be drawn on top of sprites in the background.
**Bit {{hex|0}} - If {{hex|0}}, sprites will sort
**Bits {{hex|7,6,5,4,3,2,1}} - Unknown, should all be {{hex|1}}
After the byte {{hex|0}}, you will see 3 byte clusters that break down thus:

*Byte {{hex|0}}:
**Bits {{hex|4,3,2,1,0}} - Y coordinate (in pixels from the top, starting at {{hex|0}}) of the sprite divided by 16.
**Bits {{hex|6,5}} - If these are set, they will be used to generate a subtype, stored to {{$|0E30}}, X.
**Bit {{hex|7}} - If set, the sprite is on BG2, if not it's on BG1
* Byte {{hex|1}}:
** Bits {{hex|4,3,2,1,0}} - X coordinate (in pixels from the far left, starting at {{hex|0}}) of the sprite divided by 16.
** Bits {{hex|7,6,5}} - If all these bits are set then this is an Overlord, otherwise it's a normal sprite. If only some of them are set they can be used to generate a subtype, stored at {{$|0E30}}, X
* Byte {{hex|2}}: Sprite or Overlord type. If a sprite, this will get loaded into a slot at {{$|0E20}}, X. If an Overlord, will get loaded to {{$|0B00}}, X.

The array is terminated with a byte of {{$|FF}}.
</blockquote>

====Object Data====
* {{$|0F8000}} to {{$|0F83BF}} = Pointer Table, 3 byte long addresses, indexed by room ID.
* {{$|01EBA0}} to {{$|01FFF4}} = Data
* {{$|050000}} to {{$|053729}} = Data
* {{$|0F8780}} to {{$|0FFF4D}} = Data
<blockquote>
Byte layout:

* Byte 0: {{red|aaaa}} {{blue|bbbb}}.
**The a bits are transformed to {{red|aaaa}}{{hex|0000}} and select the type of empty space to fill in. Hyrule Magic calls this 'Floor 1' - Gets stored to {{$|7E0490}}
**The b bits are transformed to {{blue|bbbb}}{{hex|0000}} and are the what Hyrule Magic calls 'Floor 2' - Gets stored to {{$|7E046A}}

* Byte {{hex|1}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
** The {{red|a}} bits are unused and should not be used
** The {{blue|b}} bits determine the room's layout type, ranging from {{hex|0}} to {{hex|7}}.
** The {{green|c}} and {{purple|d}} bits are unknown, but I have a feeling it's related to {{$|AA}} and {{$|A9}}

After that the bytes come in {{hex|3}} or {{hex|2}} byte object structures, used by routine {{$|01:88E4}}. Objects are loaded until an object with value {{0x|FFFF}} occurs. If a value {{0x|FFF0}} is loaded, the game will start loading Type 2 objects and will not go back to loading Type 1 objects until it is time to load the next layer. (Layer as in HM, not to be confused with the SNES' Backgrounds.) A value of {{0x|FFFF}} will also terminate the loading of Type 2 objects. The routine immediately terminates if that happens during the loading of either object type.

Type 1 Object structure: (3 bytes):

* Byte {{hex|3}}: Routine to use. If this byte is ≥ {{0x|F8}} and < {{0x|FC}}, then it is a subtype 3 object. If the index is ≥ {{hex|FC}}, it is a subtype 2 object. If not, it is a subtype 1 object.

* Subtype 1 Objects, first and second byte
** High Byte: {{brown|yyyy yy}}{{green|cc}}
** Low Byte: {{grey|xxxx xx}}{{red|aa}}
*** The {{red|a}} bits are stored to {{$|B2}}
*** The {{green|c}} bits are stored to {{$|B4}}
*** The {{grey|x}} and {{brown|y}} bits are transformed into: {{hex|000}}{{brown|y yyyy y}}{{grey|xxx xxx}}{{hex|0}} - This is a tilemap address that indexes into {{$|7E2000}} and / or {{$|7E4000}}

Use Byte {{hex|3}} * 2 as an index into the table at {{$|8200}}. This is the routine that is used to draw and otherwise handle the object. Subtype 1 objects have a maximum width and height of 4. Width and height are measured in terms of 32 {{x}} 32 pixels. (⟸ last part is questionable)

*Subtype 2 Objects, 1st, 2nd, & 3rd bytes:
** Byte {{hex|3}}: {{white|ff}}{{purple|dd dddd}}
** Byte {{hex|2}}: {{pink|eeee}} {{green|cccc}}
** Byte {{hex|1}}: {{red|aaaa aa}}{{blue|bb}}
***The {{red|a}} bits are unused, but after all they are the marker for this type of object subtype.
***The {{blue|b}}, {{green|c}}, {{pink|e}}, and {{white|f}} bits are transformed into a VRAM tilemap address: {{hex|000}}{{green|c ccc}}{{white|f}} {{white|f}}{{blue|bb}}{{pink|e eee}}{{hex|0}}

Might I add this is one messed up format? The {{purple|d}} bits are used as an index into the table at {{$|8470}}. Since such indices are going to be even, the {{purple|d}} bits are transformed into: {{hex|0000 0000 0}}{{purple|ddd ddd}}{{hex|0}}.

*Subtype 3 Objects
**Similar to Subtype 1, with a few small exceptions.
**The vram address is calculated the same way. However, {{$|B2}} and {{$|B4}} are not used as length or width dimensions here. The routine that is used is determined as follows:
**Take the original index (times two) that a Subtype 1 would have used. AND that with {{0x|000E}}. Then shift left 3 times to produce {{hex|0000 0000 0}}{{pink|eee}} {{hex|0000}}. Then, OR in {{$|B2}} and {{$|B4}} and shift left once, so the final result is: {{hex|0000 0000}} {{pink|eee}}{{red|a a}}{{blue|bb}}{{hex|0}}.
**Also, this value indexes into {{$|85F0}} instead of {{$|8200}}.

Type 2 Object Structure: (2 bytes)
*High Byte: {{green|cccc cccc}}
*Low Byte: {{blue|bbbb}} {{purple|dd}}{{red|aa}}
**The {{red|a}} bits form a 2-bit value ({{hex|0000 0}}{{red|aa}}{{hex|0}}) that determines the routine to use for the object. In Hyrule Magic, corresponds to the "direction" of the door.
**The {{blue|b}} bits are transformed into {{hex|000}}{{blue|b bbb}}{{hex|0}} and stored to {{$|02}} ⟹ X. Corresponds to "Pos" of door objects in the Hyrule Magic. Note that these range from {{0x|00}} to {{0x|16}} (always even) which if you halve those values is 0 - 11 in decimal. This is easily verifiable in Hyrule Magic.
**The {{green|c}} bits are shifted into the lower byte and stored to {{$|04}} ⟹ A and {{$|0A}}. This is later used to grab the tiles used to draw the door and the area below it. In Hyrule Magic, corresponds to "type". Note the type is 1/2 of the number listed here. This is because to avoid using an ASL A command, the {{green|c}} bits are always even.
**The {{purple|d}} bits are unused.

Next I'll go into the nitty gritty of the various types (the value of {{$|04}}). Again note that we'll only be dealing with even values {{blue|b}}/{{green|c}} that's what you'll see in the code. To convert between here [as well as the code] and Hyrule Magic, take the hex value here and divide by two. Convert to decimal and that's your Hyrule Magic "type."

*Types:
{|{{Prettytable}}
! ID
! Description
|-
|{{0x|00}}
|Basic door. Index = {{$|0460}}
|-
|{{0x|02}}
|Normal door?
|-
|{{0x|04}}
|???
|-
|{{0x|06}}
|???
|-
|{{0x|08}}
|Waterfall door (only used in Swamp palace; in one room at that!)
|-
|{{0x|0A}}
|???
|-
|{{0x|0C}}
|Trap door (probably other types but this seems to be most common)
|-
|{{0x|12}}
|Adds a property to some doors allowing you to exit to the overworld (this is accomplished by writing to the tile attribute map)
|-
|{{0x|14}}
|Transition to dark room?
|-
|{{0x|16}}
|Toggles the target BG Link will emerge on. '''Ex.''' if Link starts on BG0 in the next room he'll be on BG1.
|-
|{{0x|20}}
| rowspan="2"|Locked door specifically for BG0.
|-
|{{0x|22}}
|-
|{{0x|24}}
| rowspan="2"|Locked door for either BG0 or BG1
|-
|{{0x|26}}
|-
|{{0x|30}}
|Large exploded pathway resulting from a switch being pulled (unusual to have as a door as it's huge)
|-
|{{0x|32}}
|Sword activated door. '''Ex.''' Agahnim's room with the curtain door you have to slash.
|-
|{{0x|46}}
|warp door?
|}
</blockquote>

====Dungeon Secrets Data====
* {{$|00DB69}} to {{$|00DDE8}} = Pointer Table, 2 byte local addresses, indexed by room ID.
* {{$|00DDE9}} to {{$|00E6B1}} = Data
<blockquote>
Data comes in 3 byte chunks and is terminated by an instance of {{$|FFFF}}

* Bytes {{hex|0}}, {{hex|1}}: A word that denotes the VRAM address that the item is found at. This identifies the item as belonging to that part of the screen.
* Byte {{hex|2}}: Identifies the type of item that is hiding there. E.g. {{$|08}} is a key
</blockquote>

====Push Block Data====
* {{$|0271DE}} to {{$|027369}} = Data
<Blockquote>
4 bytes per entry:
{{red|a a }}{{blue|x }} {{green|y}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the block (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the block (expressed as tilemap coordinate)
</blockquote>

====(Inter Room) Torch Data====
* {{$|02736A}} to {{$|027489}} = Data
<Blockquote>
Consists of variable length segments consisting of:

{{red|a a }}{{blue|x }}{{green|y }}{{blue|x }}{{green|y }}{{hex|... }}{{$|FFFF}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the torch (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the torch (expressed as tilemap coordinate)
*{{$|FFFF}}: Delimeter
</blockquote>

====Chest Contents====
*{{$|00E96E}} to {{$|00EB65}} = Data
<blockquote>
Array of chest information in 3 byte chunks. 168 entries in all ({{0x|A8}})

*First word - Room number it is located in. MSB determines whether it is a big chest or not. (big chest if set)
*Last byte - index of the type of item contained in the chest.
</blockquote>

===Room layout===
In Hyrule Magic, there's a label and textbox for room layouts. The layout value goes from {{$|0}} to {{$|7}}

The location:

{|{{prettytable}}
!USA
!JP
|-
|{{0x|26F2F}}
|{{0x|26C0F}}
|}

In the aforementioned location, there are 8 long pointers (Lo-Hi-Bank).

===Entrance Data===
There are {{$|85}} (Decimal: 133) normal entrances to the underworld from the overworld, and {{$|7}} (Decimal: 7) starting locations.
Normal entrances and starting locations use mostly the same types of data formatted the same, however they are located in different places in the ROM.
They are located and formatted thus:

====Entrance Room====
*{{$|014813}} to {{$|01491C}} = Normal Entrance Data
*{{$|015B6E}} to {{$|015B7B}} = Starting Location Data
<blockquote>
Each entry is a 2 byte Room ID where the player is placed after using an entrance.
</blockquote>

====Scroll Edges====
*{{$|01491D}} to {{$|014D44}} = Normal Entrance Data
*{{$|015B7C}} to {{$|015BB3}} = Starting Location Data
<blockquote>
Unsure about what these do exactly.
Each entry is 8 bytes long.
*Format: 1 byte each. Corresponds to hyrule magic values in the "More" aka Entrance Properties dialog box.
**HU -
**FU -
**HD -
**FD -
**HL -
**FL -
**HR -
**FR -
</blockquote>

====X Scroll====
*{{$|014D45}} to {{$|014E4E}} = Normal Entrance Data
*{{$|015BB4}} to {{$|015BC1}} = Starting Location Data
<blockquote>

</blockquote>

====Y Scroll====
*{{$|014E4F}} to {{$|014F58}} = Normal Entrance Data
*{{$|015BC2}} to {{$|015BCF}} = Starting Location Data
<blockquote>

</blockquote>

====X Coordinate====
*{{$|014F59}} to {{$|015062}} = Normal Entrance Data
*{{$|015BD0}} to {{$|015BDD}} = Starting Location Data
<blockquote>
Each entry is a 2 byte X coordinate where the player starts after using the corresponding entrance.
</blockquote>

====Y Coordinate====
*{{$|015063}} to {{$|01516C}} = Normal Entrance Data
*{{$|015BDE}} to {{$|015BEB}} = Starting Location Data
<blockquote>
Each entry is a 2 byte y coordinate where the player starts after using the corresponding entrance.
</blockquote>

====X Camera Coordinate====
*{{$|01516D}} to {{$|015276}} = Normal Entrance Data
*{{$|015BEC}} to {{$|015BF9}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

====Y Camera Coordinate====
*{{$|015277}} to {{$|015380}} = Normal Entrance Data
*{{$|015BFA}} to {{$|015C07}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

====Entrance Blockset====
*{{$|015381}} to {{$|015405}} = Normal Entrance Data
*{{$|015C08}} to {{$|015C0E}} = Starting Location Data
<blockquote>
1 byte each. This blockset affects walls and a few other things and persists through all rooms the player accesses from this entrance.
</blockquote>

====Floor Values====
*{{$|015406}} to {{$|01548A}} = Normal Entrance Data
*{{$|015C0F}} to {{$|015C15}} = Starting Location Data
<blockquote>
This tells us what kind of properties the floor has. 1 byte each:
*If 1, then it has floors that you can fall through to the next level
*If 0, I think it means it can be fallen down to
*If -1, has no pits
*If -2, ????
</blockquote>

====Dungeon Values====
*{{$|01548B}} to {{$|01550F}} = Normal Entrance Data
*{{$|015C16}} to {{$|015C1C}} = Starting Location Data
<blockquote>
1 Byte each.
Dungeons actually in the game are numbered like so {{$|00}}, {{$|02}}, {{$|04}}, ..., {{$|18}}, {{$|1A}}.
{{$|1C}} and {{$|1E}} are unused (and hence could potentially be added.) Notice they are all even numbers.
In asm routines these values are divided by two sometimes to provide an index into other arrays.
That's why. The definition of a "dungeon" is something with a key, compass, and map.

A value of {{$|FF}} (-1) denotes it doesn't belong to a dungeon.
</blockquote>

====Doorway Type====
*{{$|015510}} to {{$|015594}} = Normal Entrance Data
*{{$|015C2B}} to {{$|015C31}} = Starting Location Data
<blockquote>
This is used only when you exit the given room. For example, let's say you enter through a skull doorway in Skullwoods.
But that's not really a door way, it's just a set of tiles that are no different from a hole you might create after picking
up a big rock. But if you entered from a building door, the game has to know whether to put the door frame when you exit.
*1 byte:
**{{hex|0}} = no doorway when exiting
**{{hex|1}} = draws a door frame upon exiting
**{{hex|2}} = ???? HM says vertical doorframe. But in the original game, no doorway is vertical.

</blockquote>

====Ladder And BG Settings====
*{{$|015595}} to {{$|015619}} = Normal Entrance Data
*{{$|015C1D}} to {{$|015C23}} = Starting Location Data
<blockquote>
*1 byte each, with the following 2 bit layout: {{hex|xxx}}{{red|a}}{{pink|xxx}}{{blue|b}}
**{{hex|x}} - unimportant
**{{red|a}} - if set, then Link enters on the lower level (BG2)
**{{blue|b}} - if set... not sure what happens exactly. Check the game engine to be sure.
</blockquote>

====Horizontal And Vertical Scroll Properties====
*{{$|01561A}} to {{$|01569E}} = Normal Entrance Data
*{{$|015C24}} to {{$|015C2A}} = Starting Location Data
<blockquote>
For these, I guess if the flags in the appropriate places are set, then the room will be able to scroll in those directions.

*1 byte each, with the following layout: {{hex|xx}}{{red|a}}{{hex|xxx}}{{blue|b}}{{hex|x}}
**{{red|a}} - Horizontal flag
**{{blue|b}} - Vertical flag
</blockquote>

====Scroll Quadrant====
*{{$|01569F}} to {{$|015723}} = Normal Entrance Data
<blockquote>
*1 byte each, has four different expected values:
**0h, 2h, 10h, 12h
</blockquote>

====Exit Door Location====
*{{$|015724}} to {{$|01582D}} = Normal Entrance Data
*{{$|015C32}} to {{$|015C3F}} = Starting Location Data
<blockquote>
1 word each. Denotes X and Y coordinates for overworld?
</blockquote>

====Music====
*{{$|01582E}} to {{$|0158B2}} = Normal Entrance Data (JP: 15592 - 15616)
*{{$|015C4E}} to {{$|015C54}} = Starting Location Data
<blockquote>
1 byte each. A value of {{$|FF}} plays the same music as the overworld screen from which the player entered.
</blockquote>

====Entrance Values====
*{{$|015C40}} to {{$|015C4D}} = Starting Location Data
<blockquote>
1 word each. Since the starting locations have to reference an entrance, this is necessary.
</blockquote>

==Rooms==
Tiles on the underworld maps are referred to as "super-rooms" and can contain 1-4 "sub-rooms."

===Primary Map===
The primary underworld map consists of {{$|FF}} (decimal: 256) super-rooms arranged in a {{$|10}} {{x}} {{$|10}} (decimal: 16 {{x}} 16) square.

{|{{Prettytable}}
! ID
! Description
|-
|[[Room $00|Room {{$|00}}]]
|Ganon
|-
|[[Room $01|Room {{$|01}}]]
|Hyrule Castle (North Corridor)
|-
|[[Room $02|Room {{$|02}}]]
|Hyrule Castle (Switch Room)
|-
|[[Room $03|Room {{$|03}}]]
|Houlihan Room
|-
|[[Room $04|Room {{$|04}}]]
|Turtle Rock (Crysta-roller Room)
|-
|[[Room $05|Room {{$|05}}]]
|Empty Clone Room
|-
|[[Room $06|Room {{$|06}}]]
|Swamp Palace (Arrghus[Boss])
|-
|[[Room $07|Room {{$|07}}]]
|Tower of Hera (Moldorm[Boss])
|-
|[[Room $08|Room {{$|08}}]]
|Cave (Healing Fairy)
|-
|[[Room $09|Room {{$|09}}]]
|Palace of Darkness
|-
|[[Room $0A|Room {{$|0A}}]]
|Palace of Darkness (Stalfos Trap Room)
|-
|[[Room $0B|Room {{$|0B}}]]
|Palace of Darkness (Turtle Room)
|-
|[[Room $0C|Room {{$|0C}}]]
|Ganon's Tower (Entrance Room)
|-
|[[Room $0D|Room {{$|0D}}]]
|Ganon's Tower (Agahnim2[Boss])
|-
|[[Room $0E|Room {{$|0E}}]]
|Ice Palace (Entrance Room)
|-
|[[Room $0F|Room {{$|0F}}]]
|Empty Clone Room
|-
|[[Room $10|Room {{$|10}}]]
|Ganon Evacuation Route
|-
|[[Room $11|Room {{$|11}}]]
|Hyrule Castle (Bombable Stock Room)
|-
|[[Room $12|Room {{$|12}}]]
|Sanctuary
|-
|[[Room $13|Room {{$|13}}]]
|Turtle Rock (Hokku-Bokku Key Room 2)
|-
|[[Room $14|Room {{$|14}}]]
|Turtle Rock (Big Key Room)
|-
|[[Room $15|Room {{$|15}}]]
|Turtle Rock
|-
|[[Room $16|Room {{$|16}}]]
|Swamp Palace (Swimming Treadmill)
|-
|[[Room $17|Room {{$|17}}]]
|Tower of Hera (Moldorm Fall Room)
|-
|[[Room $18|Room {{$|18}}]]
|Cave
|-
|[[Room $19|Room {{$|19}}]]
|Palace of Darkness (Dark Maze)
|-
|[[Room $1A|Room {{$|1A}}]]
|Palace of Darkness (Big Chest Room)
|-
|[[Room $1B|Room {{$|1B}}]]
|Palace of Darkness (Mimics / Moving Wall Room)
|-
|[[Room $1C|Room {{$|1C}}]]
|Ganon's Tower (Ice Armos)
|-
|[[Room $1D|Room {{$|1D}}]]
|Ganon's Tower (Final Hallway)
|-
|[[Room $1E|Room {{$|1E}}]]
|Ice Palace (Bomb Floor / Bari Room)
|-
|[[Room $1F|Room {{$|1F}}]]
|Ice Palace (Pengator / Big Key Room)
|-
|[[Room $20|Room {{$|20}}]]
|Agahnim's Tower (Agahnim[Boss])
|-
|[[Room $21|Room {{$|21}}]]
|Hyrule Castle (Key-rat Room)
|-
|[[Room $22|Room {{$|22}}]]
|Hyrule Castle (Sewer Text Trigger Room)
|-
|[[Room $23|Room {{$|23}}]]
|Turtle Rock (West Exit to Balcony)
|-
|[[Room $24|Room {{$|24}}]]
|Turtle Rock (Double Hokku-Bokku / Big chest Room)
|-
|[[Room $25|Room {{$|25}}]]
|Empty Clone Room
|-
|[[Room $26|Room {{$|26}}]]
|Swamp Palace (Statue Room)
|-
|[[Room $27|Room {{$|27}}]]
|Tower of Hera (Big Chest)
|-
|[[Room $28|Room {{$|28}}]]
|Swamp Palace (Entrance Room)
|-
|[[Room $29|Room {{$|29}}]]
|Skull Woods (Mothula[Boss])
|-
|[[Room $2A|Room {{$|2A}}]]
|Palace of Darkness (Big Hub Room)
|-
|[[Room $2B|Room {{$|2B}}]]
|Palace of Darkness (Map Chest / Fairy Room)
|-
|[[Room $2C|Room {{$|2C}}]]
|Cave
|-
|[[Room $2D|Room {{$|2D}}]]
|Empty Clone Room
|-
|[[Room $2E|Room {{$|2E}}]]
|Ice Palace (Compass Room)
|-
|[[Room $2F|Room {{$|2F}}]]
|Cave (Kakariko Well HP)
|-
|[[Room $30|Room {{$|30}}]]
|Agahnim's Tower (Maiden Sacrifice Chamber)
|-
|[[Room $31|Room {{$|31}}]]
|Tower of Hera (Hardhat Beetles Room)
|-
|[[Room $32|Room {{$|32}}]]
|Hyrule Castle (Sewer Key Chest Room)
|-
|[[Room $33|Room {{$|33}}]]
|Desert Palace (Lanmolas[Boss])
|-
|[[Room $34|Room {{$|34}}]]
|Swamp Palace (Push Block Puzzle / Pre-Big Key Room)
|-
|[[Room $35|Room {{$|35}}]]
|Swamp Palace (Big Key / BS Room)
|-
|[[Room $36|Room {{$|36}}]]
|Swamp Palace (Big Chest Room)
|-
|[[Room $37|Room {{$|37}}]]
|Swamp Palace (Map Chest / Water Fill Room)
|-
|[[Room $38|Room {{$|38}}]]
|Swamp Palace (Key Pot Room)
|-
|[[Room $39|Room {{$|39}}]]
|Skull Woods (Gibdo Key / Mothula Hole Room)
|-
|[[Room $3A|Room {{$|3A}}]]
|Palace of Darkness (Bombable Floor Room)
|-
|[[Room $3B|Room {{$|3B}}]]
|Palace of Darkness (Spike Block / Conveyor Room)
|-
|[[Room $3C|Room {{$|3C}}]]
|Cave
|-
|[[Room $3D|Room {{$|3D}}]]
|Ganon's Tower (Torch Room 2)
|-
|[[Room $3E|Room {{$|3E}}]]
|Ice Palace (Stalfos Knights / Conveyor Hellway)
|-
|[[Room $3F|Room {{$|3F}}]]
|Ice Palace (Map Chest Room)
|-
|[[Room $40|Room {{$|40}}]]
|Agahnim's Tower (Final Bridge Room)
|-
|[[Room $41|Room {{$|41}}]]
|Hyrule Castle (First Dark Room)
|-
|[[Room $42]]
|Hyrule Castle (6 Ropes Room)
|-
|[[Room $43]]
|Desert Palace (Torch Puzzle / Moving Wall Room)
|-
|[[Room $44]]
|Thieves Town (Big Chest Room)
|-
|[[Room $45]]
|Thieves Town (Jail Cells Room)
|-
|[[Room $46]]
|Swamp Palace (Compass Chest Room)
|-
|[[Room $47]]
|Empty Clone Room
|-
|[[Room $48]]
|Empty Clone Room
|-
|[[Room $49]]
|Skull Woods (Gibdo Torch Puzzle Room)
|-
|[[Room $4A]]
|Palace of Darkness (Entrance Room)
|-
|[[Room $4B]]
|Palace of Darkness (Warps / South Mimics Room)
|-
|[[Room $4C]]
|Ganon's Tower (Mini-Helmasaur Conveyor Room)
|-
|[[Room $4D]]
|Ganon's Tower (Moldorm Room)
|-
|[[Room $4E]]
|Ice Palace (Bomb-Jump Room)
|-
|[[Room $4F]]
|Ice Palace Clone Room (Fairy Room)
|-
|[[Room $50]]
|Hyrule Castle (West Corridor)
|-
|[[Room $51]]
|Hyrule Castle (Throne Room)
|-
|[[Room $52]]
|Hyrule Castle (East Corridor)
|-
|[[Room $53]]
|Desert Palace (Popos 2 / Beamos Hellway Room)
|-
|[[Room $54]]
|Swamp Palace (Upstairs Pits Room)
|-
|[[Room $55]]
|Castle Secret Entrance / Uncle Death Room
|-
|[[Room $56]]
|Skull Woods (Key Pot / Trap Room)
|-
|[[Room $57]]
|Skull Woods (Big Key Room)
|-
|[[Room $58]]
|Skull Woods (Big Chest Room)
|-
|[[Room $59]]
|Skull Woods (Final Section Entrance Room)
|-
|[[Room $5A]]
|Palace of Darkness (Helmasaur King[Boss])
|-
|[[Room $5B]]
|Ganon's Tower (Spike Pit Room)
|-
|[[Room $5C]]
|Ganon's Tower (Ganon-Ball Z)
|-
|[[Room $5D]]
|Ganon's Tower (Gauntlet 1/2/3)
|-
|[[Room $5E]]
|Ice Palace (Lonely Firebar)
|-
|[[Room $5F]]
|Ice Palace (Hidden Chest / Spike Floor Room)
|-
|[[Room $60]]
|Hyrule Castle (West Entrance Room)
|-
|[[Room $61]]
|Hyrule Castle (Main Entrance Room)
|-
|[[Room $62]]
|Hyrule Castle (East Entrance Room)
|-
|[[Room $63]]
|Desert Palace (Final Section Entrance Room)
|-
|[[Room $64]]
|Thieves Town (West Attic Room)
|-
|[[Room $65]]
|Thieves Town (East Attic Room)
|-
|[[Room $66]]
|Swamp Palace (Hidden Chest / Hidden Door Room)
|-
|[[Room $67]]
|Skull Woods (Compass Chest Room)
|-
|[[Room $68]]
|Skull Woods (Key Chest / Trap Room)
|-
|[[Room $69]]
|Empty Clone Room
|-
|[[Room $6A]]
|Palace of Darkness (Rupee Room)
|-
|[[Room $6B]]
|Ganon's Tower (Mimics Rooms)
|-
|[[Room $6C]]
|Ganon's Tower (Lanmolas Room)
|-
|[[Room $6D]]
|Ganon's Tower (Gauntlet 4/5)
|-
|[[Room $6E]]
|Ice Palace (Pengators Room)
|-
|[[Room $6F]]
|Empty Clone Room
|-
|[[Room $70]]
|Hyrule Castle (Small Corridor to Jail Cells)
|-
|[[Room $71]]
|Hyrule Castle (Boomerang Chest Room)
|-
|[[Room $72]]
|Hyrule Castle (Map Chest Room)
|-
|[[Room $73]]
|Desert Palace (Big Chest Room)
|-
|[[Room $74]]
|Desert Palace (Map Chest Room)
|-
|[[Room $75]]
|Desert Palace (Big Key Chest Room)
|-
|[[Room $76]]
|Swamp Palace (Water Drain Room)
|-
|[[Room $77]]
|Tower of Hera (Entrance Room)
|-
|[[Room $78]]
|Empty Clone Room
|-
|[[Room $79]]
|Empty Clone Room
|-
|[[Room $7A]]
|Empty Clone Room
|-
|[[Room $7B]]
|Ganon's Tower
|-
|[[Room $7C]]
|Ganon's Tower (East Side Collapsing Bridge / Exploding Wall Room)
|-
|[[Room $7D]]
|Ganon's Tower (Winder / Warp Maze Room)
|-
|[[Room $7E]]
|Ice Palace (Hidden Chest / Bombable Floor Room)
|-
|[[Room $7F]]
|Ice Palace ( Big Spike Traps Room)
|-
|[[Room $80]]
|Hyrule Castle (Jail Cell Room)
|-
|[[Room $81]]
|Hyrule Castle
|-
|[[Room $82]]
|Hyrule Castle (Basement Chasm Room)
|-
|[[Room $83]]
|Desert Palace (West Entrance Room)
|-
|[[Room $84]]
|Desert Palace (Main Entrance Room)
|-
|[[Room $85]]
|Desert Palace (East Entrance Room)
|-
|[[Room $86]]
|Empty Clone Room
|-
|[[Room $87]]
|Tower of Hera (Tile Room)
|-
|[[Room $88]]
|Empty Clone Room
|-
|[[Room $89]]
|Eastern Palace (Fairy Room)
|-
|[[Room $8A]]
|Empty Clone Room
|-
|[[Room $8B]]
|Ganon's Tower (Block Puzzle / Spike Skip / Map Chest Room)
|-
|[[Room $8C]]
|Ganon's Tower (East and West Downstairs / Big Chest Room)
|-
|[[Room $8D]]
|Ganon's Tower (Tile / Torch Puzzle Room)
|-
|[[Room $8E]]
|Ice Palace
|-
|[[Room $8F]]
|Empty Clone Room
|-
|[[Room $90]]
|Misery Mire (Vitreous[Boss])
|-
|[[Room $91]]
|Misery Mire (Final Switch Room)
|-
|[[Room $92]]
|Misery Mire (Dark Bomb Wall / Switches Room)
|-
|[[Room $93]]
|Misery Mire (Dark Cane Floor Switch Puzzle Room)
|-
|[[Room $94]]
|Empty Clone Room
|-
|[[Room $95]]
|Ganon's Tower (Final Collapsing Bridge Room)
|-
|[[Room $96]]
|Ganon's Tower (Torches 1 Room)
|-
|[[Room $97]]
|Misery Mire (Torch Puzzle / Moving Wall Room)
|-
|[[Room $98]]
|Misery Mire (Entrance Room)
|-
|[[Room $99]]
|Eastern Palace (Eyegore Key Room)
|-
|[[Room $9A]]
|Empty Clone Room
|-
|[[Room $9B]]
|Ganon's Tower (Many Spikes / Warp Maze Room)
|-
|[[Room $9C]]
|Ganon's Tower (Invisible Floor Maze Room)
|-
|[[Room $9D]]
|Ganon's Tower (Compass Chest / Invisible Floor Room)
|-
|[[Room $9E]]
|Ice Palace (Big Chest Room)
|-
|[[Room $9F]]
|Ice Palace
|-
|[[Room $A0]]
|Misery Mire (Pre-Vitreous Room)
|-
|[[Room $A1]]
|Misery Mire (Fish Room)
|-
|[[Room $A2]]
|Misery Mire (Bridge Key Chest Room)
|-
|[[Room $A3]]
|Misery Mire
|-
|[[Room $A4]]
|Turtle Rock (Trinexx[Boss])
|-
|[[Room $A5]]
|Ganon's Tower (Wizzrobes Rooms)
|-
|[[Room $A6]]
|Ganon's Tower (Moldorm Fall Room)
|-
|[[Room $A7]]
|Tower of Hera (Fairy Room)
|-
|[[Room $A8]]
|Eastern Palace (Stalfos Spawn Room)
|-
|[[Room $A9]]
|Eastern Palace (Big Chest Room)
|-
|[[Room $AA]]
|Eastern Palace (Map Chest Room)
|-
|[[Room $AB]]
|Thieves Town (Moving Spikes / Key Pot Room)
|-
|[[Room $AC]]
|Thieves Town (Blind The Thief[Boss])
|-
|[[Room $AD]]
|Empty Clone Room
|-
|[[Room $AE]]
|Ice Palace
|-
|[[Room $AF]]
|Ice Palace (Ice Bridge Room)
|-
|[[Room $B0]]
|Agahnim's Tower (Circle of Pots)
|-
|[[Room $B1]]
|Misery Mire (Hourglass Room)
|-
|[[Room $B2]]
|Misery Mire (Slug Room)
|-
|[[Room $B3]]
|Misery Mire (Spike Key Chest Room)
|-
|[[Room $B4]]
|Turtle Rock (Pre-Trinexx Room)
|-
|[[Room $B5]]
|Turtle Rock (Dark Maze)
|-
|[[Room $B6]]
|Turtle Rock (Chain Chomps Room)
|-
|[[Room $B7]]
|Turtle Rock (Map Chest / Key Chest / Roller Room)
|-
|[[Room $B8]]
|Eastern Palace (Big Key Room)
|-
|[[Room $B9]]
|Eastern Palace (Lobby Cannonballs Room)
|-
|[[Room $BA]]
|Eastern Palace (Dark Antifairy / Key Pot Room)
|-
|[[Room $BB]]
|Thieves Town (Hellway)
|-
|[[Room $BC]]
|Thieves Town (Conveyor Toilet)
|-
|[[Room $BD]]
|Empty Clone Room
|-
|[[Room $BE]]
|Ice Palace (Block Puzzle Room)
|-
|[[Room $BF]]
|Ice Palace Clone Room (Switch Room)
|-
|[[Room $C0]]
|Agahnim's Tower (Dark Bridge Room)
|-
|[[Room $C1]]
|Misery Mire (Compass Chest / Tile Room)
|-
|[[Room $C2]]
|Misery Mire (Big Hub Room)
|-
|[[Room $C3]]
|Misery Mire (Big Chest Room)
|-
|[[Room $C4]]
|Turtle Rock (Final Crystal Switch Puzzle Room)
|-
|[[Room $C5]]
|Turtle Rock (Laser Bridge)
|-
|[[Room $C6]]
|Turtle Rock
|-
|[[Room $C7]]
|Turtle Rock (Torch Puzzle)
|-
|[[Room $C8]]
|Eastern Palace (Armos Knights[Boss])
|-
|[[Room $C9]]
|Eastern Palace (Entrance Room)
|-
|[[Room $CA]]
|??
|-
|[[Room $CB]]
|Thieves Town (North West Entrance Room)
|-
|[[Room $CC]]
|Thieves Town (North East Entrance Room)
|-
|[[Room $CD]]
|Empty Clone Room
|-
|[[Room $CE]]
|Ice Palace (Hole to Kholdstare Room)
|-
|[[Room $CF]]
|Empty Clone Room
|-
|[[Room $D0]]
|Agahnim's Tower (Dark Maze)
|-
|[[Room $D1]]
|Misery Mire (Conveyor Slug / Big Key Room)
|-
|[[Room $D2]]
|Misery Mire (Mire02 / Wizzrobes Room)
|-
|[[Room $D3]]
|Empty Clone Room
|-
|[[Room $D4]]
|Empty Clone Room
|-
|[[Room $D5]]
|Turtle Rock (Laser Key Room)
|-
|[[Room $D6]]
|Turtle Rock (Entrance Room)
|-
|[[Room $D7]]
|Empty Clone Room
|-
|[[Room $D8]]
|Eastern Palace ("Zeldagamer Room" / Pre-Armos Knights Room)
|-
|[[Room $D9]]
|Eastern Palace (Canonball Room)
|-
|[[Room $DA]]
|Eastern Palace
|-
|[[Room $DB]]
|Thieves Town (Main (South West) Entrance Room)
|-
|[[Room $DC]]
|Thieves Town (South East Entrance Room)
|-
|[[Room $DD]]
|Empty Clone Room
|-
|[[Room $DE]]
|Ice Palace (Kholdstare[Boss])
|-
|[[Room $DF]]
|Cave
|-
|[[Room $E0]]
|Agahnim's Tower (Entrance Room)
|-
|[[Room $E1]]
|Cave (Lost Woods HP)
|-
|[[Room $E2]]
|Cave (Lumberjack's Tree HP)
|-
|[[Room $E3]]
|Cave (1/2 Magic)
|-
|[[Room $E4]]
|Cave (Lost Old Man Final Cave)
|-
|[[Room $E5]]
|Cave (Lost Old Man Final Cave)
|-
|[[Room $E6]]
|Cave
|-
|[[Room $E7]]
|Cave
|-
|[[Room $E8]]
|Cave
|-
|[[Room $E9]]
|Empty Clone Room
|-
|[[Room $EA]]
|Cave (Spectacle Rock HP)
|-
|[[Room $EB]]
|Cave
|-
|[[Room $EC]]
|Empty Clone Room
|-
|[[Room $ED]]
|Cave
|-
|[[Room $EE]]
|Cave (Spiral Cave)
|-
|[[Room $EF]]
|Cave (Crystal Switch / 5 Chests Room)
|-
|[[Room $F0]]
|Cave (Lost Old Man Starting Cave)
|-
|[[Room $F1]]
|Cave (Lost Old Man Starting Cave)
|-
|[[Room $F2]]
|House
|-
|[[Room $F3]]
|House (Old Woman (Sahasrahla's Wife?))
|-
|[[Room $F4]]
|House (Angry Brothers)
|-
|[[Room $F5]]
|House (Angry Brothers)
|-
|[[Room $F6]]
|Empty Clone Room
|-
|[[Room $F7]]
|Empty Clone Room
|-
|[[Room $F8]]
|Cave
|-
|[[Room $F9]]
|Cave
|-
|[[Room $FA]]
|Cave
|-
|[[Room $FB]]
|Cave
|-
|[[Room $FC]]
|Empty Clone Room
|-
|[[Room $FD]]
|Cave
|-
|[[Room $FE]]
|Cave
|-
|[[Room $FF]]
|Cave
|}

===Secondary Map===

{{toc}}

Octorok (Four Way)

2017-08-04T22:43:12Z

Tatters: /* Code */

{{subpage|Sprites}}

Sprite {{$|0A}}: Octorok (Four Way)
== Octorok (Four Way) ==
=== Description ===
An octorok who stops, fires in all four cardinal directions, then begins moving again.

=== Combat Strategy ===
Very weak enemy. They fire and move only in lateral directions, so staying in their diagonal range is a safe way to approach them.

== Stats And Properties ==
See [[Sprite Properties]]

'''{{$|06B08A}}'''
{|{{Prettytable}}
!Bit(s)
!Info
!Value
|-
| {{Hex|7}}
| Harmless
| {{Hex|0}}
|-
| {{Hex|6}}
| ?
| {{Hex|0}}
|-
| {{Hex|5}}
| ?
| {{Hex|0}}
|-
| {{Hex|4-0}}
| OAM Slots
| {{Hex|00010}} ({{$|02}})
|}

'''{{$|06B17D}}'''
{|{{Prettytable}}
! Bit(s)
! Info
! Value
|-
| {{Hex|7-0}}
| HP
| {{Hex|0000 0100}} ({{$|04}})
|}

'''{{$|06B270}}'''
{|{{Prettytable}}
! Bit(s)
! Info
! Value
|-
| {{Hex|7-4}}
| ?
| {{Hex|0000}} ({{$|00}})
|-
| {{Hex|3-0}}
| [[Damage Types|Damage Type]]
| {{Hex|0001}} ({{$|01}})
|}

'''{{$|06B363}}'''
{|{{Prettytable}}
! Bit(s)
! Info
! Value
|-
| {{Hex|7}}
| No Death Animation
| {{Hex|0}}
|-
| {{Hex|6}}
| Invincible
| {{Hex|0}}
|-
| {{Hex|5}}
| Adjust Child coordinates
| {{Hex|0}}
|-
| {{Hex|4}}
| Draw Shadow
| {{Hex|1}}
|-
| {{Hex|3-1}}
| Palette
| {{Hex|110}} ({{$|06}})
|-
| {{Hex|0}}
| ?
| {{Hex|1}}
|}

'''{{$|06B456}}'''
{|{{Prettytable}}
! Bit(s)
! Info
! Value
|-
| {{Hex|7}}
| Ignore Collision Settings
| {{Hex|0}}
|-
| {{Hex|6}}
| Statis
| {{Hex|0}}
|-
| {{Hex|5}}
| Persist
| {{Hex|0}}
|-
| {{Hex|4-0}}
| Hit Box Dimensions
| {{Hex|00000}} ({{$|00}})
|}

'''{{$|06B549}}'''
{|{{Prettytable}}
! Bit(s)
! Info
! Value
|-
| {{Hex|7-4}}
| Tile Interaction Hit Box
| {{Hex|0000}} ({{$|00}})
|-
| {{Hex|3}}
| ?
| {{Hex|0}}
|-
| {{Hex|2}}
| ?
| {{Hex|0}}
|-
| {{Hex|1}}
| Dies Like A Boss
| {{Hex|0}}
|-
| {{Hex|0}}
| Falls In Holes
| {{Hex|0}}
|}

'''{{$|06B63C}}'''
{|{{Prettytable}}
! Bit(s)
! Info
! Value
|-
| {{Hex|7}}
| Disable Tile Interactions
| {{Hex|0}}
|-
| {{Hex|6}}
| ?
| {{Hex|0}}
|-
| {{Hex|5}}
| Is shield Blockable
| {{Hex|0}}
|-
| {{Hex|4}}
| Alternate Damage Sound
| {{Hex|0}}
|-
| {{Hex|3-0}}
| Prize Pack
| {{Hex|0010}} ({{$|02}})
|}

'''{{$|06B72F}}'''
{|{{Prettytable}}
! Bit(s)
! Info
! Value
|-
| {{Hex|7}}
| ?
| {{Hex|0}}
|-
| {{Hex|6}}
| ?
| {{Hex|0}}
|-
| {{Hex|5}}
| Is Interactive
| {{Hex|0}}
|-
| {{Hex|4}}
| Deflect Projectiles
| {{Hex|0}}
|-
| {{Hex|3}}
| Collide With Less Tiles
| {{Hex|0}}
|-
| {{Hex|2}}
| Impervious To Sword/Hammer
| {{Hex|0}}
|-
| {{Hex|1}}
| Impervious To Arrows?
| {{Hex|0}}
|-
| {{Hex|0}}
| ?
| {{Hex|0}}
|}

== Code ==
<code><pre> ; $35363-$35376 DATA
pool Sprite_Octorock:
{
.next_direction
db 3, 2, 0, 1

.x_speed
db 24, -24, 0, 0

.y_speed
db 0, 0, 24, -24

.unused
; Unused?
db 1, 2, 4, 8

.delays
; Unused?
db 60, -128, -96, -128
}

; ==============================================================================

!ai_state = $0D80
!graphic = $0DC0
!direction = $0DE0
!type = $0E20
!oam_4 = $0F50

; *$35377-$35450 JUMP LOCATION
Sprite_Octorock:
{
!force_hflip = $00
!gfx_vert = $00

; ------------------------------

; Octorock Routine (Sprites 0x08 and 0x0A)
LDY !direction, X : PHY

LDA !timer_1, X : BEQ .timer_1_elapsed

LDA .next_direction, Y : STA !direction, X

.timer_1_elapsed

STZ $00

LDA !graphic, X : CMP.b #$07 : BNE .no_forced_hflip

LDA.b #$40 : STA !force_hflip

.no_forced_hflip

LDA !oam_4, X : AND.b #$BF

ORA $D2AE, Y : ORA !force_hflip : STA !oam_4, X

JSR Octorock_Draw

PLA : STA !direction, X

JSR Sprite_CheckIfActive
JSR Sprite_CheckIfRecoiling
JSR Sprite_Move
JSR Sprite_CheckDamage

LDA !ai_state, X : AND.b #$01 : BNE .stop_and_spit_maybe

LDA !direction, X : AND.b #$02 : ASL A : STA !gfx_vert

INC $0E80, X

LDA $0E80, X : LSR #3 : AND.b #$03 : ORA !gfx_vert : STA !graphic, X

LDA !timer_0, X : BNE .wait_1

; Switch to the other main AI state.
INC !ai_state, X

LDY !type, X

LDA .delays-8, Y : STA !timer_0, X

RTS

.wait_1

LDY !direction, X

; Make this little bugger move.
LDA .x_speed, Y : STA $0D50, X
LDA .y_speed, Y : STA $0D40, X

JSR Sprite_CheckTileCollision

LDA $0E70, X : BEQ .epsilon

LDA !direction, X : EOR.b #$01 : STA !direction, X

BRA .return_2

.epsilon

RTS

.stop_and_spit_maybe

JSR Sprite_Zero_XY_Velocity

LDA !timer_0, X : BNE .wait_2

INC !ai_state, X

LDA !direction, X : PHA

; Set a new countdown timer and direction slightly at random.
JSL GetRandomInt : AND.b #$3F : ADC.b #$30 : STA !timer_0, X

AND.b #$03 : STA !direction, X

; Note this odd... certainty that both outcomes result in the same
; branch location.
PLA : CMP !direction, X : BEQ .same_direction
EOR !direction, X : BNE .different_direction

; Thus, this line of code is not reachable, as far as I can tell.
LDA.b #$08 : STA !timer_1, X

.same_direction
.different_direction
.return_2

RTS

.wait_2

LDA !type, X : SUB.b #$08 : REP #$30 : AND.w #$00FF : ASL A : TAY

; Hidden Jump table, Argghghh!
LDA Octorock_AI_Table, Y : DEC A : PHA

SEP #$30

RTS

.handlers

!nullptr = 0

dw Octorock_Normal
dw !nullptr
dw Octorock_FourShooter
}

; ==============================================================================

; $35451-$3546E DATA
pool Octorock_Normal:
{

.unknown
db 0, 2, 2, 2, 1, 1, 1, 0
db 0, 0, 0, 0, 2, 2, 2, 2
db 2, 1, 1 0
}

; ==============================================================================

; $35465-$3546E DATA
pool Octorock_FourShooter:
{

.unknown
db 2, 2, 2, 2 2, 2, 2, 2, 1, 0
}

; ==============================================================================

; $3546F-$35485 JUMP LOCATION (LOCAL)
Octorock_Normal:
{
LDA !timer_0, X : CMP.b #$1C : BNE .dont_spit_rock

PHA

JSR Octorock_SpitOutRock

PLA

.dont_spit_rock

LSR #3 : TAY

LDA .unknown, Y : STA $0DB0, X

RTS
}

; ==============================================================================

; $35486-$35489 DATA
pool Octorock_FourShooter:
{

.next_direction
db 2, 3, 1, 0
}

; ==============================================================================

; $3548A-$354B4 JUMP LOCATION (LOCAL)
Octorock_FourShooter:
{
LDA !timer_0, X : PHA

CMP.b #$80 : BCS .just_animate
AND.b #$0F : BNE .dont_rotate

PHA

LDY !direction, X

LDA .next_direction, Y : STA !direction, X

PLA

.dont_rotate

CMP.b #$08 : BNE .dont_shoot

JSR Octorock_SpitOutRock

.dont_shoot
.just_animate

PLA : LSR #4 : TAY

LDA .unknown, Y : STA $0DB0, X

RTS
}

; ==============================================================================

; $354B5-$354CC DATA
pool Octorock_SpitOutRock:
{

; \task Label these sublabels.

db 12, -12, 0, 0

; $354B9
db 0, -1, 0, 0

; $354BD
db 4, 4, 12, -12

; $354C1
db 0, 0, 0, -1

; $354C5
db 44, -44, 0, 0

; $354C9
db 0, 0, 44, -44
}

; ==============================================================================

; $354CD-$35513 LOCAL
Octorock_SpitOutRock:
{
LDA.b #$07 : JSL Sound_SetSfx2PanLong

LDA.b #$0C

JSL Sprite_SpawnDynamically : BMI .spawn_failed

PHX

; The position and velocity of the newly created rock depends on the
; direction that the Octorok is currently facing.
LDA !direction, X : TAX

LDA $00 : ADD $D4B5, X : STA $0D10, Y
LDA $01 : ADC $D4B9, X : STA $0D30, Y

LDA $02 : ADD $D4BD, X : STA $0D00, Y
LDA $03 : ADC $D4C1, X : STA $0D20, Y

LDA !direction, Y : TAX

LDA $D4C5, X : STA $0D50, Y
LDA $D4C9, X : STA $0D40, Y

PLX

.spawn_failed

RTS
}

; ==============================================================================

; $35514-$35549 Contains data related to face drawing
pool Octorock_Draw:
{

.x_offsets
dw 8, 0, 4, 8, 0, 4, 9, -1, 4

.y_offsets
dw 6, 6, 9, 6, 6, 9, 6, 6, 9

.chr
db $BB, $BB, $BA, $AB, $AB, $AA, $A9, $A9, $B9

.properties
db $65, $25, $25, $65, $25, $25, $65, $25, $25
}

; ==============================================================================

; *$3554A-$355B8 LOCAL
Octorock_Draw:
{
!top_x_bit_low = $0E
!top_x_bit_high = $0F

JSR Sprite_PrepOamCoord

; perhaps this draws the octorock's snout?
LDA !direction, X : CMP.b #$03 : BEQ .dont_draw_this_part

; $07 = [3 * $0DB0, X] + !direction
LDA $0DB0, X : ASL A : ADC $0DB0, X : ADC !direction, X : STA $07

PHX : PHA

ASL A : TAX

REP #$20

LDA $00 : ADD .x_offsets, X : STA ($90), Y

AND.w #$0100 : STA !top_x_bit_low

LDA $02 : ADD .y_offsets, X : INY : STA ($90), Y

ADD.w #$0010 : CMP.w #$0100 : SEP #$20 : BCC .not_off_screen

LDA.b #$F0 : STA ($90), Y

.not_off_screen

PLX

LDA .chr, X : INY : STA ($90), Y

LDA .properties, X : INY : ORA $05 : STA ($90), Y

LDA !top_x_bit_high : STA ($92)

PLX

.dont_draw_this_part

REP #$20

LDA $90 : ADD.w #$0004 : STA $90

INC $92

SEP #$20

DEC $0E40, X

LDY.b #$00

JSR Sprite_PrepAndDrawSingleLarge.just_draw

INC $0E40, X

RTS
}</pre></code>

Octorok (Four Way)

2017-08-04T22:41:35Z

Tatters: /* Code */

{{subpage|Sprites}}

Sprite {{$|0A}}: Octorok (Four Way)
== Octorok (Four Way) ==
=== Description ===
An octorok who stops, fires in all four cardinal directions, then begins moving again.

=== Combat Strategy ===
Very weak enemy. They fire and move only in lateral directions, so staying in their diagonal range is a safe way to approach them.

== Stats And Properties ==
See [[Sprite Properties]]

'''{{$|06B08A}}'''
{|{{Prettytable}}
!Bit(s)
!Info
!Value
|-
| {{Hex|7}}
| Harmless
| {{Hex|0}}
|-
| {{Hex|6}}
| ?
| {{Hex|0}}
|-
| {{Hex|5}}
| ?
| {{Hex|0}}
|-
| {{Hex|4-0}}
| OAM Slots
| {{Hex|00010}} ({{$|02}})
|}

'''{{$|06B17D}}'''
{|{{Prettytable}}
! Bit(s)
! Info
! Value
|-
| {{Hex|7-0}}
| HP
| {{Hex|0000 0100}} ({{$|04}})
|}

'''{{$|06B270}}'''
{|{{Prettytable}}
! Bit(s)
! Info
! Value
|-
| {{Hex|7-4}}
| ?
| {{Hex|0000}} ({{$|00}})
|-
| {{Hex|3-0}}
| [[Damage Types|Damage Type]]
| {{Hex|0001}} ({{$|01}})
|}

'''{{$|06B363}}'''
{|{{Prettytable}}
! Bit(s)
! Info
! Value
|-
| {{Hex|7}}
| No Death Animation
| {{Hex|0}}
|-
| {{Hex|6}}
| Invincible
| {{Hex|0}}
|-
| {{Hex|5}}
| Adjust Child coordinates
| {{Hex|0}}
|-
| {{Hex|4}}
| Draw Shadow
| {{Hex|1}}
|-
| {{Hex|3-1}}
| Palette
| {{Hex|110}} ({{$|06}})
|-
| {{Hex|0}}
| ?
| {{Hex|1}}
|}

'''{{$|06B456}}'''
{|{{Prettytable}}
! Bit(s)
! Info
! Value
|-
| {{Hex|7}}
| Ignore Collision Settings
| {{Hex|0}}
|-
| {{Hex|6}}
| Statis
| {{Hex|0}}
|-
| {{Hex|5}}
| Persist
| {{Hex|0}}
|-
| {{Hex|4-0}}
| Hit Box Dimensions
| {{Hex|00000}} ({{$|00}})
|}

'''{{$|06B549}}'''
{|{{Prettytable}}
! Bit(s)
! Info
! Value
|-
| {{Hex|7-4}}
| Tile Interaction Hit Box
| {{Hex|0000}} ({{$|00}})
|-
| {{Hex|3}}
| ?
| {{Hex|0}}
|-
| {{Hex|2}}
| ?
| {{Hex|0}}
|-
| {{Hex|1}}
| Dies Like A Boss
| {{Hex|0}}
|-
| {{Hex|0}}
| Falls In Holes
| {{Hex|0}}
|}

'''{{$|06B63C}}'''
{|{{Prettytable}}
! Bit(s)
! Info
! Value
|-
| {{Hex|7}}
| Disable Tile Interactions
| {{Hex|0}}
|-
| {{Hex|6}}
| ?
| {{Hex|0}}
|-
| {{Hex|5}}
| Is shield Blockable
| {{Hex|0}}
|-
| {{Hex|4}}
| Alternate Damage Sound
| {{Hex|0}}
|-
| {{Hex|3-0}}
| Prize Pack
| {{Hex|0010}} ({{$|02}})
|}

'''{{$|06B72F}}'''
{|{{Prettytable}}
! Bit(s)
! Info
! Value
|-
| {{Hex|7}}
| ?
| {{Hex|0}}
|-
| {{Hex|6}}
| ?
| {{Hex|0}}
|-
| {{Hex|5}}
| Is Interactive
| {{Hex|0}}
|-
| {{Hex|4}}
| Deflect Projectiles
| {{Hex|0}}
|-
| {{Hex|3}}
| Collide With Less Tiles
| {{Hex|0}}
|-
| {{Hex|2}}
| Impervious To Sword/Hammer
| {{Hex|0}}
|-
| {{Hex|1}}
| Impervious To Arrows?
| {{Hex|0}}
|-
| {{Hex|0}}
| ?
| {{Hex|0}}
|}

== Code ==
<code><pre> ; $35363-$35376 DATA
pool Sprite_Octorock:
{
.next_direction
db 3, 2, 0, 1

.x_speed
db 24, -24, 0, 0

.y_speed
db 0, 0, 24, -24

.unused
; Unused?
db 1, 2, 4, 8

.delays
; Unused?
db 60, -128, -96, -128
}

; ==============================================================================

!ai_state = $0D80
!graphic = $0DC0
!direction = $0DE0
!type = $0E20
!oam_4 = $0F50

; *$35377-$35450 JUMP LOCATION
Sprite_Octorock:
{
!force_hflip = $00
!gfx_vert = $00

; ------------------------------

; Octorock Routine (Sprites 0x08 and 0x0A)
LDY !direction, X : PHY

LDA !timer_1, X : BEQ .timer_1_elapsed

LDA .next_direction, Y : STA !direction, X

.timer_1_elapsed

STZ $00

LDA !graphic, X : CMP.b #$07 : BNE .no_forced_hflip

LDA.b #$40 : STA !force_hflip

.no_forced_hflip

LDA !oam_4, X : AND.b #$BF

ORA $D2AE, Y : ORA !force_hflip : STA !oam_4, X

JSR Octorock_Draw

PLA : STA !direction, X

JSR Sprite_CheckIfActive
JSR Sprite_CheckIfRecoiling
JSR Sprite_Move
JSR Sprite_CheckDamage

LDA !ai_state, X : AND.b #$01 : BNE .stop_and_spit_maybe

LDA !direction, X : AND.b #$02 : ASL A : STA !gfx_vert

INC $0E80, X

LDA $0E80, X : LSR #3 : AND.b #$03 : ORA !gfx_vert : STA !graphic, X

LDA !timer_0, X : BNE .wait_1

; Switch to the other main AI state.
INC !ai_state, X

LDY !type, X

LDA .delays-8, Y : STA !timer_0, X

RTS

.wait_1

LDY !direction, X

; Make this little bugger move.
LDA .x_speed, Y : STA $0D50, X
LDA .y_speed, Y : STA $0D40, X

JSR Sprite_CheckTileCollision

LDA $0E70, X : BEQ .epsilon

LDA !direction, X : EOR.b #$01 : STA !direction, X

BRA .return_2

.epsilon

RTS

.stop_and_spit_maybe

JSR Sprite_Zero_XY_Velocity

LDA !timer_0, X : BNE .wait_2

INC !ai_state, X

LDA !direction, X : PHA

; Set a new countdown timer and direction slightly at random.
JSL GetRandomInt : AND.b #$3F : ADC.b #$30 : STA !timer_0, X

AND.b #$03 : STA !direction, X

; Note this odd... certainty that both outcomes result in the same
; branch location.
PLA : CMP !direction, X : BEQ .same_direction
EOR !direction, X : BNE .different_direction

; Thus, this line of code is not reachable, as far as I can tell.
LDA.b #$08 : STA !timer_1, X

.same_direction
.different_direction
.return_2

RTS

.wait_2

LDA !type, X : SUB.b #$08 : REP #$30 : AND.w #$00FF : ASL A : TAY

; Hidden Jump table, Argghghh!
LDA Octorock_AI_Table, Y : DEC A : PHA

SEP #$30

RTS

.handlers

!nullptr = 0

dw Octorock_Normal
dw !nullptr
dw Octorock_FourShooter
}

; ==============================================================================

; $35451-$3546E DATA
pool Octorock_Normal:
{

.unknown
db 0, 2, 2, 2, 1, 1, 1, 0
db 0, 0, 0, 0, 2, 2, 2, 2
db 2, 1, 1 0
}

; ==============================================================================

; $35465-$3546E DATA
pool Octorock_FourShooter:
{

.unknown
db 2, 2, 2, 2 2, 2, 2, 2, 1, 0
}

; ==============================================================================

; $3546F-$35485 JUMP LOCATION (LOCAL)
Octorock_Normal:
{
LDA !timer_0, X : CMP.b #$1C : BNE .dont_spit_rock

PHA

JSR Octorock_SpitOutRock

PLA

.dont_spit_rock

LSR #3 : TAY

LDA .unknown, Y : STA $0DB0, X

RTS
}

; ==============================================================================

; $35486-$35489 DATA
pool Octorock_FourShooter:
{

.next_direction
db 2, 3, 1, 0
}

; ==============================================================================

; $3548A-$354B4 JUMP LOCATION (LOCAL)
Octorock_FourShooter:
{
LDA !timer_0, X : PHA

CMP.b #$80 : BCS .just_animate
AND.b #$0F : BNE .dont_rotate

PHA

LDY !direction, X

LDA .next_direction, Y : STA !direction, X

PLA

.dont_rotate

CMP.b #$08 : BNE .dont_shoot

JSR Octorock_SpitOutRock

.dont_shoot
.just_animate

PLA : LSR #4 : TAY

LDA .unknown, Y : STA $0DB0, X

RTS
}

; ==============================================================================

; $354B5-$354CC DATA
pool Octorock_SpitOutRock:
{

; \task Label these sublabels.

db 12, -12, 0, 0

; $354B9
db 0, -1, 0, 0

; $354BD
db 4, 4, 12, -12

; $354C1
db 0, 0, 0, -1

; $354C5
db 44, -44, 0, 0

; $354C9
db 0, 0, 44, -44
}

; ==============================================================================

; $354CD-$35513 LOCAL
Octorock_SpitOutRock:
{
LDA.b #$07 : JSL Sound_SetSfx2PanLong

LDA.b #$0C

JSL Sprite_SpawnDynamically : BMI .spawn_failed

PHX

; The position and velocity of the newly created rock depends on the
; direction that the Octorok is currently facing.
LDA !direction, X : TAX

LDA $00 : ADD $D4B5, X : STA $0D10, Y
LDA $01 : ADC $D4B9, X : STA $0D30, Y

LDA $02 : ADD $D4BD, X : STA $0D00, Y
LDA $03 : ADC $D4C1, X : STA $0D20, Y

LDA !direction, Y : TAX

LDA $D4C5, X : STA $0D50, Y
LDA $D4C9, X : STA $0D40, Y

PLX

.spawn_failed

RTS
}

; ==============================================================================

; $35514-$35549 DATA
pool Octorock_Draw:
{

.x_offsets
dw 8, 0, 4, 8, 0, 4, 9, -1, 4

.y_offsets
dw 6, 6, 9, 6, 6, 9, 6, 6, 9

.chr
db $BB, $BB, $BA, $AB, $AB, $AA, $A9, $A9, $B9

.properties
db $65, $25, $25, $65, $25, $25, $65, $25, $25
}

; ==============================================================================

; *$3554A-$355B8 LOCAL
Octorock_Draw:
{
!top_x_bit_low = $0E
!top_x_bit_high = $0F

JSR Sprite_PrepOamCoord

; perhaps this draws the octorock's snout?
LDA !direction, X : CMP.b #$03 : BEQ .dont_draw_this_part

; $07 = [3 * $0DB0, X] + !direction
LDA $0DB0, X : ASL A : ADC $0DB0, X : ADC !direction, X : STA $07

PHX : PHA

ASL A : TAX

REP #$20

LDA $00 : ADD .x_offsets, X : STA ($90), Y

AND.w #$0100 : STA !top_x_bit_low

LDA $02 : ADD .y_offsets, X : INY : STA ($90), Y

ADD.w #$0010 : CMP.w #$0100 : SEP #$20 : BCC .not_off_screen

LDA.b #$F0 : STA ($90), Y

.not_off_screen

PLX

LDA .chr, X : INY : STA ($90), Y

LDA .properties, X : INY : ORA $05 : STA ($90), Y

LDA !top_x_bit_high : STA ($92)

PLX

.dont_draw_this_part

REP #$20

LDA $90 : ADD.w #$0004 : STA $90

INC $92

SEP #$20

DEC $0E40, X

LDY.b #$00

JSR Sprite_PrepAndDrawSingleLarge.just_draw

INC $0E40, X

RTS
}</pre></code>

Sprites

2017-08-04T22:39:08Z

Tatters:

== Drawing ==
Sprites vary on how they are drawn to the screen. 8{{x}}8 and 16{{x}}16 sprites tend to use {{hex|Sprite_PrepAndDrawSingleLarge}} to draw. Larger sprites uses their custom OAM.

==Important Hex Addresses==
===Sprite Stats And Properties===
{{See|Sprite Properties}}

===Dungeon Sprite Data===
* {{$|04D62E}} = Pointer Table, 2 byte local addresses, indexed by room ID
* {{$|04D92E}} = Data

===Overworld Sprite Data===
There are separate pointer tables for each phase of the game. The "phase of the game" refers to the byte located at {{$|7EF3C5}}.

====Phase 0/1====
* {{$|04C881}} = Pointer Table, 2 byte local addresses, indexed by screen ID
*This is the stage of the game whilst rain still falls
*Only has values only for the light world screens, thus dark world screens will roll over to the light world data from the following table and of course be incorrect.

====Phase 2====
* {{$|04C901}} = Pointer Table, 2 byte local addresses, indexed by screen ID
*Phase 2 begins when Zelda is rescued and given protection by the Sage in the Sanctuary
====Phase 3====
* {{$|04CA21}} = Pointer Table, 2 byte local addresses, indexed by screen ID
*Phase 3 begins after the player has defeated Agahnim for the first time.

===Sprite Data Format===
*First Byte: Stored to {{$|FB3}}. Not sure what the purpose of that is yet.
After the first byte, you will see 3 byte clusters that break down thus:

{|{{Prettytable}}
! scope="col"| Bit
! scope="col"| First Byte
! scope="col"| Second Byte
! scope="col"| Third Byte
|-
! scope="row"| 7
| If set, the sprite is on BG2, if not it's on BG1
|rowspan="3"| If all these bits are set then this is an Overlord, otherwise it's a normal sprite. If only some of them are set they can be used to generate a subtype, stored at {{$|E30}}, X.
| rowspan="8"|Sprite or Overlord type. If a sprite, this will get loaded into a slot at {{$|E20}}, X. If an Overlord, will get loaded to {{$|B00}}, X.
|-
! scope="row"| 6
| rowspan="2"| If these are set, they will be used to generate a subtype, stored to {{$|E30}}, X.
|-
! scope="row"| 5
|-
! scope="row"| 4
| rowspan="5"| X coordinate (in pixels from the far left, starting at 0) of the sprite divided by 16.
| rowspan="5"| Y coordinate (in pixels from the top, starting at 0) of the sprite divided by 16.
|-
! scope="row"| 3
|-
! scope="row"| 2
|-
! scope="row"| 1
|-
! scope="row"| 0
|}

==Sprites==
{|{{Prettytable}}
!Value
!Description
|-
|{{$|00}}
|[[Raven]]
|-
|{{$|01}}
|[[Vulture]]
|-
|{{$|02}}
|[[Flying Stalfos Head]]
|-
|{{$|03}}
|[[Sprite $03|Empty]]
|-
|{{$|04}}
|[[Pull Switch (Good)]]
|-
|{{$|05}}
|[[Sprite $05|Pull Switch (Unused)]]
|-
|{{$|06}}
|[[Pull Switch (Bad)]]
|-
|{{$|07}}
|[[Sprite $07|Pull Switch (Unused)]]
|-
|{{$|08}}
|[[Octorok (One Way)]]
|-
|{{$|09}}
|[[Moldorm (Boss)]]
|-
|{{$|0A}}
|[[Octorok (Four Way)]]
|-
|{{$|0B}}
|[[Chicken]]
|-
|{{$|0C}}
|[[Octorok (?)]]
|-
|{{$|0D}}
|[[Buzzblob]]
|-
|{{$|0E}}
|[[Snapdragon]]
|-
|{{$|0F}}
|[[Octoballoon]]
|-
|{{$|10}}
|[[Octoballoon Hatchlings]]
|-
|{{$|11}}
|[[Hinox]]
|-
|{{$|12}}
|[[Moblin]]
|-
|{{$|13}}
|[[Mini Helmasaur]]
|-
|{{$|14}}
|[[Gargoyle's Domain Gate]]
|-
|{{$|15}}
|[[Antifairy]]
|-
|{{$|16}}
|[[Sahasrahla / Aginah]]
|-
|{{$|17}}
|[[Bush Hoarder]]
|-
|{{$|18}}
|[[Mini Moldorm]]
|-
|{{$|19}}
|[[Poe]]
|-
|{{$|1A}}
|[[Dwarves]]
|-
|{{$|1B}}
|Arrow in wall?
|-
|{{$|1C}}
|[[Statue (Sprite)|Statue]]
|-
|{{$|1D}}
|[[Weathervane]]
|-
|{{$|1E}}
|[[Crystal Switch]]
|-
|{{$|1F}}
|[[Bug-Catching Kid]]
|-
|{{$|20}}
|[[Sluggula]]
|-
|{{$|21}}
|[[Push Switch]]
|-
|{{$|22}}
|[[Ropa]]
|-
|{{$|23}}
|[[Red Bari]]
|-
|{{$|24}}
|[[Blue Bari]]
|-
|{{$|25}}
|[[Talking Tree]]
|-
|{{$|26}}
|[[Hardhat Beetle]]
|-
|{{$|27}}
|[[Deadrock]]
|-
|{{$|28}}
|[[Storytellers]]
|-
|{{$|29}}
|Blind Hideout attendant
|-
|{{$|2A}}
|[[Sweeping Lady]]
|-
|{{$|2B}}
|[[Sprite $2B|Multipurpose Sprite]]
|-
|{{$|2C}}
|[[Lumberjacks]]
|-
|{{$|2D}}
|Telepathic stones? (No idea what this actually is, likely unused)
|-
|{{$|2E}}
|Flute Boy's Notes
|-
|{{$|2F}}
|[[Race HP NPCs]]
|-
|{{$|30}}
|Person?
|-
|{{$|31}}
|[[Fortune Teller]]
|-
|{{$|32}}
|[[Angry Brothers]]
|-
|{{$|33}}
|[[Pull For Rupees Sprite]]
|-
|{{$|34}}
|[[Scared Girl 2]]
|-
|{{$|35}}
|[[Innkeeper]]
|-
|{{$|36}}
|[[Witch]]
|-
|{{$|37}}
|[[Waterfall]]
|-
|{{$|38}}
|[[Arrow Target]]
|-
|{{$|39}}
|[[Average Middle-Aged Man]]
|-
|{{$|3A}}
|[[Half Magic Bat]]
|-
|{{$|3B}}
|[[Dash Item]]
|-
|{{$|3C}}
|[[Village Kid]]
|-
|{{$|3D}}
|Signs? Chicken lady also showed up / Scared ladies outside houses.
|-
|{{$|3E}}
|[[Rock Hoarder]]
|-
|{{$|3F}}
|[[Tutorial Soldier]]
|-
|{{$|40}}
|[[Lightning Lock]]
|-
|{{$|41}}
|[[Blue Sword Soldier]] / Used by guards to detect player
|-
|{{$|42}}
|[[Green Sword Soldier]]
|-
|{{$|43}}
|[[Red Spear Soldier]]
|-
|{{$|44}}
|[[Assault Sword Soldier]]
|-
|{{$|45}}
|[[Green Spear Soldier]]
|-
|{{$|46}}
|[[Blue Archer]]
|-
|{{$|47}}
|[[Green Archer]]
|-
|{{$|48}}
|[[Red Javelin Soldier]]
|-
|{{$|49}}
|[[Red Javelin Soldier 2]]
|-
|{{$|4A}}
|[[Red Bomb Soldiers]]
|-
|{{$|4B}}
|[[Green Soldier Recruits]]
|-
|{{$|4C}}
|[[Geldman]]
|-
|{{$|4D}}
|[[Rabbit]]
|-
|{{$|4E}}
|[[Popo]]
|-
|{{$|4F}}
|[[Popo 2]]
|-
|{{$|50}}
|[[Cannon Balls]]
|-
|{{$|51}}
|[[Armos]]
|-
|{{$|52}}
|[[Giant Zora]]
|-
|{{$|53}}
|[[Armos Knights (Boss)]]
|-
|{{$|54}}
|[[Lanmolas (Boss)]]
|-
|{{$|55}}
|[[Fireball Zora]]
|-
|{{$|56}}
|[[Walking Zora]]
|-
|{{$|57}}
|[[Desert Palace Barriers]]
|-
|{{$|58}}
|[[Crab]]
|-
|{{$|59}}
|[[Bird]]
|-
|{{$|5A}}
|[[Squirrel]]
|-
|{{$|5B}}
|[[Spark (Left to Right)]]
|-
|{{$|5C}}
|[[Spark (Right to Left)]]
|-
|{{$|5D}}
|Roller (vertical moving)
|-
|{{$|5E}}
|Roller (vertical moving)
|-
|{{$|5F}}
|Roller
|-
|{{$|60}}
|Roller (horizontal moving)
|-
|{{$|61}}
|[[Beamos]]
|-
|{{$|62}}
|[[Master Sword]]
|-
|{{$|63}}
|[[Devalant (Non-shooter)]]
|-
|{{$|64}}
|[[Devalant (Shooter)]]
|-
|{{$|65}}
|[[Shooting Gallery Proprietor]]
|-
|{{$|66}}
|[[Moving Cannon Ball Shooters (Right)]]
|-
|{{$|67}}
|[[Moving Cannon Ball Shooters (Left)]]
|-
|{{$|68}}
|[[Moving Cannon Ball Shooters (Down)]]
|-
|{{$|69}}
|[[Moving Cannon Ball Shooters (Up)]]
|-
|{{$|6A}}
|[[Ball N' Chain Trooper]]
|-
|{{$|6B}}
|[[Cannon Soldier]]
|-
|{{$|6C}}
|[[Mirror Portal]]
|-
|{{$|6D}}
|[[Rat]]
|-
|{{$|6E}}
|[[Rope]]
|-
|{{$|6F}}
|[[Keese]]
|-
|{{$|70}}
|[[Helmasaur King Fireball]]
|-
|{{$|71}}
|[[Leever]]
|-
|{{$|72}}
|Activator for the ponds (where you throw in items)
|-
|{{$|73}}
|[[Uncle / Priest]]
|-
|{{$|74}}
|[[Running Man]]
|-
|{{$|75}}
|[[Bottle Salesman]]
|-
|{{$|76}}
|[[Princess Zelda]]
|-
|{{$|77}}
|[[Antifairy (Alternate)]]
|-
|{{$|78}}
|[[Village Elder]]
|-
|{{$|79}}
|[[Bee]]
|-
|{{$|7A}}
|[[Agahnim]]
|-
|{{$|7B}}
|[[Agahnim Energy Ball]]
|-
|{{$|7C}}
|[[Hyu]]
|-
|{{$|7D}}
|[[Big Spike Trap]]
|-
|{{$|7E}}
|[[Guruguru Bar (Clockwise)]]
|-
|{{$|7F}}
|[[Guruguru Bar (Counter Clockwise)]]
|-
|{{$|80}}
|[[Winder]]
|-
|{{$|81}}
|[[Water Tektite]]
|-
|{{$|82}}
|[[Antifairy Circle]]
|-
|{{$|83}}
|[[Green Eyegore]]
|-
|{{$|84}}
|[[Red Eyegore]]
|-
|{{$|85}}
|[[Yellow Stalfos]]
|-
|{{$|86}}
|[[Kodongos]]
|-
|{{$|87}}
|[[Flames]]
|-
|{{$|88}}
|[[Mothula (Boss)]]
|-
|{{$|89}}
|[[Mothula's Beam]]
|-
|{{$|8A}}
|[[Spike Trap]]
|-
|{{$|8B}}
|[[Gibdo]]
|-
|{{$|8C}}
|[[Arrghus (Boss)]]
|-
|{{$|8D}}
|Arrghus spawn
|-
|{{$|8E}}
|[[Terrorpin]]
|-
|{{$|8F}}
|[[Slime]]
|-
|{{$|90}}
|[[Wallmaster]]
|-
|{{$|91}}
|[[Stalfos Knight]]
|-
|{{$|92}}
|[[Helmasaur King]]
|-
|{{$|93}}
|[[Bumper]]
|-
|{{$|94}}
|Swimmers
|-
|{{$|95}}
|[[Eye Laser (Right)]]
|-
|{{$|96}}
|[[Eye Laser (Left)]]
|-
|{{$|97}}
|[[Eye Laser (Down)]]
|-
|{{$|98}}
|[[Eye Laser (Up)]]
|-
|{{$|99}}
|[[Pengator]]
|-
|{{$|9A}}
|[[Kyameron]]
|-
|{{$|9B}}
|[[Wizzrobe]]
|-
|{{$|9C}}
|Tadpoles
|-
|{{$|9D}}
|Tadpoles
|-
|{{$|9E}}
|[[Ostrich (Haunted Grove)]]
|-
|{{$|9F}}
|[[Flute]]
|-
|{{$|A0}}
|[[Birds (Haunted Grove)]]
|-
|{{$|A1}}
|[[Freezor]]
|-
|{{$|A2}}
|[[Kholdstare (Boss)]]
|-
|{{$|A3}}
|[[Kholdstare's Shell]]
|-
|{{$|A4}}
|[[Falling Ice]]
|-
|{{$|A5}}
|[[Zazak Fireball]]
|-
|{{$|A6}}
|[[Red Zazak]]
|-
|{{$|A7}}
|[[Stalfos]]
|-
|{{$|A8}}
|Bomber Flying Creatures from Darkworld
|-
|{{$|A9}}
|Bomber Flying Creatures from Darkworld
|-
|{{$|AA}}
|[[Pikit]]
|-
|{{$|AB}}
|[[Maiden]]
|-
|{{$|AC}}
|[[Apple]]
|-
|{{$|AD}}
|[[Lost Old Man]]
|-
|{{$|AE}}
|Down Pipe
|-
|{{$|AF}}
|Up Pipe
|-
|{{$|B0}}
|Right Pip
|-
|{{$|B1}}
|Left Pipe
|-
|{{$|B2}}
|Good bee again?
|-
|{{$|B3}}
|[[Hylian Inscription]]
|-
|{{$|B4}}
|Thief's chest (not the one that follows you, the one that you grab from the DW smithy house)
|-
|{{$|B5}}
|[[Bomb Salesman]]
|-
|{{$|B6}}
|[[Kiki]]
|-
|{{$|B7}}
|Maiden following you in Blind Dungeon
|-
|{{$|B8}}
|[[Monologue Testing Sprite]]
|-
|{{$|B9}}
|Feuding Friends on Death Mountain
|-
|{{$|BA}}
|[[Whirlpool]]
|-
|{{$|BB}}
|Salesman / chestgame guy / 300 rupee giver guy / Chest game thief
|-
|{{$|BC}}
|Drunk in the inn
|-
|{{$|BD}}
|[[Vitreous (Large Eyeball)]]
|-
|{{$|BE}}
|[[Vitreous (Small Eyeball)]]
|-
|{{$|BF}}
|[[Vitreous' Lightning]]
|-
|{{$|C0}}
|Monster in Lake of Ill Omen / Quake Medallion
|-
|{{$|C1}}
|Agahnim teleporting Zelda to dark world
|-
|{{$|C2}}
|[[Boulders]]
|-
|{{$|C3}}
|[[Gibo]]
|-
|{{$|C4}}
|[[Thief]]
|-
|{{$|C5}}
|[[Medusa]]
|-
|{{$|C6}}
|Four Way Fireball Spitters (spit when you use your sword)
|-
|{{$|C7}}
|[[Hokku-Bokku]]
|-
|{{$|C8}}
|Big Fairy who heals you
|-
|{{$|C9}}
|[[Tektite]]
|-
|{{$|CA}}
|[[Chain Chomp]]
|-
|{{$|CB}}
|[[Trinexx]]
|-
|{{$|CC}}
|Another part of trinexx
|-
|{{$|CD}}
|Yet another part of trinexx
|-
|{{$|CE}}
|[[Blind The Thief (Boss)]]
|-
|{{$|CF}}
|[[Swamola]]
|-
|{{$|D0}}
|[[Lynel]]
|-
|{{$|D1}}
|[[Bunny Beam]]
|-
|{{$|D2}}
|Flopping fish
|-
|{{$|D3}}
|[[Stal]]
|-
|{{$|D4}}
|[[Landmine]]
|-
|{{$|D5}}
|[[Digging Game Proprietor]]
|-
|{{$|D6}}
|[[Ganon]]
|-
|{{$|D7}}
|Copy of Ganon, except invincible?
|-
|{{$|D8}}
|[[Heart]]
|-
|{{$|D9}}
|[[Green Rupee]]
|-
|{{$|DA}}
|[[Blue Rupee]]
|-
|{{$|DB}}
|[[Red Rupee]]
|-
|{{$|DC}}
|[[Bomb Refill (1)]]
|-
|{{$|DD}}
|[[Bomb Refill (4)]]
|-
|{{$|DE}}
|[[Bomb Refill (8)]]
|-
|{{$|DF}}
|[[Small Magic Refill]]
|-
|{{$|E0}}
|[[Full Magic Refill]]
|-
|{{$|E1}}
|[[Arrow Refill (5)]]
|-
|{{$|E2}}
|[[Arrow Refill (10)]]
|-
|{{$|E3}}
|[[Fairy]]
|-
|{{$|E4}}
|[[Key]]
|-
|{{$|E5}}
|[[Big Key]]
|-
|{{$|E6}}
|[[Shield]]
|-
|{{$|E7}}
|[[Mushroom]]
|-
|{{$|E8}}
|[[Fake Master Sword]]
|-
|{{$|E9}}
|Magic Shop dude / His items, including the magic powder
|-
|{{$|EA}}
|[[Heart Container]]
|-
|{{$|EB}}
|[[Heart Piece]]
|-
|{{$|EC}}
|Bushes
|-
|{{$|ED}}
|[[Cane Of Somaria Platform]]
|-
|{{$|EE}}
|[[Mantle]]
|-
|{{$|EF}}
|[[Sprite $EF|Cane of Somaria Platform (Unused)]]
|-
|{{$|F0}}
|[[Sprite $F0|Cane of Somaria Platform (Unused)]]
|-
|{{$|F1}}
|[[Sprite $F1|Cane of Somaria Platform (Unused)]]
|-
|{{$|F2}}
|[[Medallion Tablet]]
|}

{{toc}}

Underworld

2017-07-28T16:35:41Z

Tatters: /* Room Headers */

The underworld refers to all indoor locations; including dungeons, caves, and houses.

==Important Hex Addresses==
===Room Data===
====Room Headers====
*{{$|027502}} to {{$|027781}} = Pointer Table, {{hex|2}} byte local addresses, indexed by room ID.
*{{$|027781}} to {{$|027FEF}} = Data

<blockquote>
Headers are {{$|0E}} (Decimal: 14) bytes formatted thusly:
*Byte {{hex|0}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
**The {{red|a}} bits are transformed into {{hex|0000 0}}{{red|aaa}} and stored to {{$|0414}} ("BG2" in Hyrule Magic)
**The {{blue|b}} bits are transformed into {{hex|0000 0}}{{blue|bbb}} and stored to {{$|046C}} ("Collision" in Hyrule Magic)
**The {{green|c}} bit is unused
**The {{purple|d}} bit is stored to {{$|7EC005}} (If set, use a lights out routine in the room transition)

*Byte {{hex|1}}: {{red|aa}}{{blue|bb bbbb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{blue|bbbb bb}}{{hex|00}}, thus making them a multiple of 4.
This value is used to load 4 different palettes for the dungeon, and corresponds to, you guessed it, Palette # in Hyrule Magic!

The resulting index is used to load values for {{$|0AB6}}, {{$|0AAC}}, {{$|0AAD}}, and {{$|0AAE}}

*Byte {{hex|2}}: gets stored to {{$|0AA2}} (GFX # in Hyrule Magic)
*Byte {{hex|3}}: value + #$40 gets stored to {{$|0AA3}} (Sprite GFX # in Hyrule Magic)
*Byte {{hex|4}}: gets stored to {{$|00AD}} ("[[Room Effects|Effect]]" in Hyrule Magic)
*Byte {{hex|5}}: {{red|aa}}{{blue|bb bbbb}}
**{{red|a}} = ?
**The {{blue|b}} bits are "[[Room Tags|Tag1]]" in Hyrule Magic and gets stored to {{$|00AE}}.
*Byte {{hex|6}}: {{red|aa}}{{blue|bb bbbb}}
**{{red|a}} = ?
**The {{blue|b}} bits are "[[Room Tags|Tag2]]" in Hyrule Magic and get stored to {{$|00AF}}

These are the planes to use for bytes {{hex|9}} through {{hex|D}}. This determines which
BG you appear on, and possibly more.

*Byte {{hex|7}}: {{red|aa}}{{blue|bb}} {{green|cc}}{{purple|dd}}
**The {{red|a}} bits are transformed into {{hex|0000 00}}{{red|aa}} and stored to {{$|063F}}
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|063E}}
**The {{green|c}} bits are transformed into {{hex|0000 00}}{{green|cc}} and stored to {{$|063D}}
**The {{purple|d}} bits are transformed into {{hex|0000 00}}{{purple|dd}} and stored to {{$|063C}}

Note, the only safe values for a plane seem to be {{hex|0}},{{hex|1}}, or {{hex|2}}. Hyrule Magic
appears to violate this rule by letting you put {{hex|3}} down, but nothing higher.

*Byte {{hex|8}}: {{red|aaaa aa}}{{blue|bb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|0640}}

*Byte {{hex|9}}: stored to {{$|7EC000}} These are all room numbers that you could possibly exit to.
*Byte {{hex|A}}: stored to {{$|7EC001}}
*Byte {{hex|B}}: stored to {{$|7EC002}}
*Byte {{hex|C}}: stored to {{$|7EC003}}
*Byte {{hex|D}}: stored to {{$|7EC004}}
</blockquote>

====Sprite Data====
* {{$|04D62E}} to {{$|04D92E}} = Pointer Table, 2 byte local addresses, indexed by room.
* {{$|04D92E}} to {{$|04EC9D}} = Data

<blockquote>
Sprite data is formatted thusly:
*Byte {{hex|0}}: Stored to {{$|0FB3}}. Corresponds with "Sort Spr" in Hyrule Magic. In a layered room this indicates sprites in the foreground are to be drawn on top of sprites in the background.
**Bit {{hex|0}} - If {{hex|0}}, sprites will sort
**Bits {{hex|7,6,5,4,3,2,1}} - Unknown, should all be {{hex|1}}
After the byte {{hex|0}}, you will see 3 byte clusters that break down thus:

*Byte {{hex|0}}:
**Bits {{hex|4,3,2,1,0}} - Y coordinate (in pixels from the top, starting at {{hex|0}}) of the sprite divided by 16.
**Bits {{hex|6,5}} - If these are set, they will be used to generate a subtype, stored to {{$|0E30}}, X.
**Bit {{hex|7}} - If set, the sprite is on BG2, if not it's on BG1
* Byte {{hex|1}}:
** Bits {{hex|4,3,2,1,0}} - X coordinate (in pixels from the far left, starting at {{hex|0}}) of the sprite divided by 16.
** Bits {{hex|7,6,5}} - If all these bits are set then this is an Overlord, otherwise it's a normal sprite. If only some of them are set they can be used to generate a subtype, stored at {{$|0E30}}, X
* Byte {{hex|2}}: Sprite or Overlord type. If a sprite, this will get loaded into a slot at {{$|0E20}}, X. If an Overlord, will get loaded to {{$|0B00}}, X.

The array is terminated with a byte of {{$|FF}}.
</blockquote>

====Object Data====
* {{$|0F8000}} to {{$|0F83BF}} = Pointer Table, 3 byte long addresses, indexed by room ID.
* {{$|01EBA0}} to {{$|01FFF4}} = Data
* {{$|050000}} to {{$|053729}} = Data
* {{$|0F8780}} to {{$|0FFF4D}} = Data
<blockquote>
Byte layout:

* Byte 0: {{red|aaaa}} {{blue|bbbb}}.
**The a bits are transformed to {{red|aaaa}}{{hex|0000}} and select the type of empty space to fill in. Hyrule Magic calls this 'Floor 1' - Gets stored to {{$|7E0490}}
**The b bits are transformed to {{blue|bbbb}}{{hex|0000}} and are the what Hyrule Magic calls 'Floor 2' - Gets stored to {{$|7E046A}}

* Byte {{hex|1}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
** The {{red|a}} bits are unused and should not be used
** The {{blue|b}} bits determine the room's layout type, ranging from {{hex|0}} to {{hex|7}}.
** The {{green|c}} and {{purple|d}} bits are unknown, but I have a feeling it's related to {{$|AA}} and {{$|A9}}

After that the bytes come in {{hex|3}} or {{hex|2}} byte object structures, used by routine {{$|01:88E4}}. Objects are loaded until an object with value {{0x|FFFF}} occurs. If a value {{0x|FFF0}} is loaded, the game will start loading Type 2 objects and will not go back to loading Type 1 objects until it is time to load the next layer. (Layer as in HM, not to be confused with the SNES' Backgrounds.) A value of {{0x|FFFF}} will also terminate the loading of Type 2 objects. The routine immediately terminates if that happens during the loading of either object type.

Type 1 Object structure: (3 bytes):

* Byte {{hex|3}}: Routine to use. If this byte is ≥ {{0x|F8}} and < {{0x|FC}}, then it is a subtype 3 object. If the index is ≥ {{hex|FC}}, it is a subtype 2 object. If not, it is a subtype 1 object.

* Subtype 1 Objects, first and second byte
** High Byte: {{brown|yyyy yy}}{{green|cc}}
** Low Byte: {{grey|xxxx xx}}{{red|aa}}
*** The {{red|a}} bits are stored to {{$|B2}}
*** The {{green|c}} bits are stored to {{$|B4}}
*** The {{grey|x}} and {{brown|y}} bits are transformed into: {{hex|000}}{{brown|y yyyy y}}{{grey|xxx xxx}}{{hex|0}} - This is a tilemap address that indexes into {{$|7E2000}} and / or {{$|7E4000}}

Use Byte {{hex|3}} * 2 as an index into the table at {{$|8200}}. This is the routine that is used to draw and otherwise handle the object. Subtype 1 objects have a maximum width and height of 4. Width and height are measured in terms of 32 {{x}} 32 pixels. (⟸ last part is questionable)

*Subtype 2 Objects, 1st, 2nd, & 3rd bytes:
** Byte {{hex|3}}: {{white|ff}}{{purple|dd dddd}}
** Byte {{hex|2}}: {{pink|eeee}} {{green|cccc}}
** Byte {{hex|1}}: {{red|aaaa aa}}{{blue|bb}}
***The {{red|a}} bits are unused, but after all they are the marker for this type of object subtype.
***The {{blue|b}}, {{green|c}}, {{pink|e}}, and {{white|f}} bits are transformed into a VRAM tilemap address: {{hex|000}}{{green|c ccc}}{{white|f}} {{white|f}}{{blue|bb}}{{pink|e eee}}{{hex|0}}

Might I add this is one messed up format? The {{purple|d}} bits are used as an index into the table at {{$|8470}}. Since such indices are going to be even, the {{purple|d}} bits are transformed into: {{hex|0000 0000 0}}{{purple|ddd ddd}}{{hex|0}}.

*Subtype 3 Objects
**Similar to Subtype 1, with a few small exceptions.
**The vram address is calculated the same way. However, {{$|B2}} and {{$|B4}} are not used as length or width dimensions here. The routine that is used is determined as follows:
**Take the original index (times two) that a Subtype 1 would have used. AND that with {{0x|000E}}. Then shift left 3 times to produce {{hex|0000 0000 0}}{{pink|eee}} {{hex|0000}}. Then, OR in {{$|B2}} and {{$|B4}} and shift left once, so the final result is: {{hex|0000 0000}} {{pink|eee}}{{red|a a}}{{blue|bb}}{{hex|0}}.
**Also, this value indexes into {{$|85F0}} instead of {{$|8200}}.

Type 2 Object Structure: (2 bytes)
*High Byte: {{green|cccc cccc}}
*Low Byte: {{blue|bbbb}} {{purple|dd}}{{red|aa}}
**The {{red|a}} bits form a 2-bit value ({{hex|0000 0}}{{red|aa}}{{hex|0}}) that determines the routine to use for the object. In Hyrule Magic, corresponds to the "direction" of the door.
**The {{blue|b}} bits are transformed into {{hex|000}}{{blue|b bbb}}{{hex|0}} and stored to {{$|02}} ⟹ X. Corresponds to "Pos" of door objects in the Hyrule Magic. Note that these range from {{0x|00}} to {{0x|16}} (always even) which if you halve those values is 0 - 11 in decimal. This is easily verifiable in Hyrule Magic.
**The {{green|c}} bits are shifted into the lower byte and stored to {{$|04}} ⟹ A and {{$|0A}}. This is later used to grab the tiles used to draw the door and the area below it. In Hyrule Magic, corresponds to "type". Note the type is 1/2 of the number listed here. This is because to avoid using an ASL A command, the {{green|c}} bits are always even.
**The {{purple|d}} bits are unused.

Next I'll go into the nitty gritty of the various types (the value of {{$|04}}). Again note that we'll only be dealing with even values {{blue|b}}/{{green|c}} that's what you'll see in the code. To convert between here [as well as the code] and Hyrule Magic, take the hex value here and divide by two. Convert to decimal and that's your Hyrule Magic "type."

*Types:
{|{{Prettytable}}
! ID
! Description
|-
|{{0x|00}}
|Basic door. Index = {{$|0460}}
|-
|{{0x|02}}
|Normal door?
|-
|{{0x|04}}
|???
|-
|{{0x|06}}
|???
|-
|{{0x|08}}
|Waterfall door (only used in Swamp palace; in one room at that!)
|-
|{{0x|0A}}
|???
|-
|{{0x|0C}}
|Trap door (probably other types but this seems to be most common)
|-
|{{0x|12}}
|Adds a property to some doors allowing you to exit to the overworld (this is accomplished by writing to the tile attribute map)
|-
|{{0x|14}}
|Transition to dark room?
|-
|{{0x|16}}
|Toggles the target BG Link will emerge on. '''Ex.''' if Link starts on BG0 in the next room he'll be on BG1.
|-
|{{0x|20}}
| rowspan="2"|Locked door specifically for BG0.
|-
|{{0x|22}}
|-
|{{0x|24}}
| rowspan="2"|Locked door for either BG0 or BG1
|-
|{{0x|26}}
|-
|{{0x|30}}
|Large exploded pathway resulting from a switch being pulled (unusual to have as a door as it's huge)
|-
|{{0x|32}}
|Sword activated door. '''Ex.''' Agahnim's room with the curtain door you have to slash.
|-
|{{0x|46}}
|warp door?
|}
</blockquote>

====Dungeon Secrets Data====
* {{$|00DB69}} to {{$|00DDE8}} = Pointer Table, 2 byte local addresses, indexed by room ID.
* {{$|00DDE9}} to {{$|00E6B1}} = Data
<blockquote>
Data comes in 3 byte chunks and is terminated by an instance of {{$|FFFF}}

* Bytes {{hex|0}}, {{hex|1}}: A word that denotes the VRAM address that the item is found at. This identifies the item as belonging to that part of the screen.
* Byte {{hex|2}}: Identifies the type of item that is hiding there. E.g. {{$|08}} is a key
</blockquote>

====Push Block Data====
* {{$|0271DE}} to {{$|027369}} = Data
<Blockquote>
4 bytes per entry:
{{red|a a }}{{blue|x }} {{green|y}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the block (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the block (expressed as tilemap coordinate)
</blockquote>

====(Inter Room) Torch Data====
* {{$|02736A}} to {{$|027489}} = Data
<Blockquote>
Consists of variable length segments consisting of:

{{red|a a }}{{blue|x }}{{green|y }}{{blue|x }}{{green|y }}{{hex|... }}{{$|FFFF}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the torch (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the torch (expressed as tilemap coordinate)
*{{$|FFFF}}: Delimeter
</blockquote>

====Chest Contents====
*{{$|00E96E}} to {{$|00EB65}} = Data
<blockquote>
Array of chest information in 3 byte chunks. 168 entries in all ({{0x|A8}})

*First word - Room number it is located in. MSB determines whether it is a big chest or not. (big chest if set)
*Last byte - index of the type of item contained in the chest.
</blockquote>

===Entrance Data===
There are {{$|85}} (Decimal: 133) normal entrances to the underworld from the overworld, and {{$|7}} (Decimal: 7) starting locations.
Normal entrances and starting locations use mostly the same types of data formatted the same, however they are located in different places in the ROM.
They are located and formatted thus:

====Entrance Room====
*{{$|014813}} to {{$|01491C}} = Normal Entrance Data
*{{$|015B6E}} to {{$|015B7B}} = Starting Location Data
<blockquote>
Each entry is a 2 byte Room ID where the player is placed after using an entrance.
</blockquote>

====Scroll Edges====
*{{$|01491D}} to {{$|014D44}} = Normal Entrance Data
*{{$|015B7C}} to {{$|015BB3}} = Starting Location Data
<blockquote>
Unsure about what these do exactly.
Each entry is 8 bytes long.
*Format: 1 byte each. Corresponds to hyrule magic values in the "More" aka Entrance Properties dialog box.
**HU -
**FU -
**HD -
**FD -
**HL -
**FL -
**HR -
**FR -
</blockquote>

====X Scroll====
*{{$|014D45}} to {{$|014E4E}} = Normal Entrance Data
*{{$|015BB4}} to {{$|015BC1}} = Starting Location Data
<blockquote>

</blockquote>

====Y Scroll====
*{{$|014E4F}} to {{$|014F58}} = Normal Entrance Data
*{{$|015BC2}} to {{$|015BCF}} = Starting Location Data
<blockquote>

</blockquote>

====X Coordinate====
*{{$|014F59}} to {{$|015062}} = Normal Entrance Data
*{{$|015BD0}} to {{$|015BDD}} = Starting Location Data
<blockquote>
Each entry is a 2 byte X coordinate where the player starts after using the corresponding entrance.
</blockquote>

====Y Coordinate====
*{{$|015063}} to {{$|01516C}} = Normal Entrance Data
*{{$|015BDE}} to {{$|015BEB}} = Starting Location Data
<blockquote>
Each entry is a 2 byte y coordinate where the player starts after using the corresponding entrance.
</blockquote>

====X Camera Coordinate====
*{{$|01516D}} to {{$|015276}} = Normal Entrance Data
*{{$|015BEC}} to {{$|015BF9}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

====Y Camera Coordinate====
*{{$|015277}} to {{$|015380}} = Normal Entrance Data
*{{$|015BFA}} to {{$|015C07}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

====Entrance Blockset====
*{{$|015381}} to {{$|015405}} = Normal Entrance Data
*{{$|015C08}} to {{$|015C0E}} = Starting Location Data
<blockquote>
1 byte each. This blockset affects walls and a few other things and persists through all rooms the player accesses from this entrance.
</blockquote>

====Floor Values====
*{{$|015406}} to {{$|01548A}} = Normal Entrance Data
*{{$|015C0F}} to {{$|015C15}} = Starting Location Data
<blockquote>
This tells us what kind of properties the floor has. 1 byte each:
*If 1, then it has floors that you can fall through to the next level
*If 0, I think it means it can be fallen down to
*If -1, has no pits
*If -2, ????
</blockquote>

====Dungeon Values====
*{{$|01548B}} to {{$|01550F}} = Normal Entrance Data
*{{$|015C16}} to {{$|015C1C}} = Starting Location Data
<blockquote>
1 Byte each.
Dungeons actually in the game are numbered like so {{$|00}}, {{$|02}}, {{$|04}}, ..., {{$|18}}, {{$|1A}}.
{{$|1C}} and {{$|1E}} are unused (and hence could potentially be added.) Notice they are all even numbers.
In asm routines these values are divided by two sometimes to provide an index into other arrays.
That's why. The definition of a "dungeon" is something with a key, compass, and map.

A value of {{$|FF}} (-1) denotes it doesn't belong to a dungeon.
</blockquote>

====Doorway Type====
*{{$|015510}} to {{$|015594}} = Normal Entrance Data
*{{$|015C2B}} to {{$|015C31}} = Starting Location Data
<blockquote>
This is used only when you exit the given room. For example, let's say you enter through a skull doorway in Skullwoods.
But that's not really a door way, it's just a set of tiles that are no different from a hole you might create after picking
up a big rock. But if you entered from a building door, the game has to know whether to put the door frame when you exit.
*1 byte:
**{{hex|0}} = no doorway when exiting
**{{hex|1}} = draws a door frame upon exiting
**{{hex|2}} = ???? HM says vertical doorframe. But in the original game, no doorway is vertical.

</blockquote>

====Ladder And BG Settings====
*{{$|015595}} to {{$|015619}} = Normal Entrance Data
*{{$|015C1D}} to {{$|015C23}} = Starting Location Data
<blockquote>
*1 byte each, with the following 2 bit layout: {{hex|xxx}}{{red|a}}{{pink|xxx}}{{blue|b}}
**{{hex|x}} - unimportant
**{{red|a}} - if set, then Link enters on the lower level (BG2)
**{{blue|b}} - if set... not sure what happens exactly. Check the game engine to be sure.
</blockquote>

====Horizontal And Vertical Scroll Properties====
*{{$|01561A}} to {{$|01569E}} = Normal Entrance Data
*{{$|015C24}} to {{$|015C2A}} = Starting Location Data
<blockquote>
For these, I guess if the flags in the appropriate places are set, then the room will be able to scroll in those directions.

*1 byte each, with the following layout: {{hex|xx}}{{red|a}}{{hex|xxx}}{{blue|b}}{{hex|x}}
**{{red|a}} - Horizontal flag
**{{blue|b}} - Vertical flag
</blockquote>

====Scroll Quadrant====
*{{$|01569F}} to {{$|015723}} = Normal Entrance Data
<blockquote>
*1 byte each, has four different expected values:
**0h, 2h, 10h, 12h
</blockquote>

====Exit Door Location====
*{{$|015724}} to {{$|01582D}} = Normal Entrance Data
*{{$|015C32}} to {{$|015C3F}} = Starting Location Data
<blockquote>
1 word each. Denotes X and Y coordinates for overworld?
</blockquote>

====Music====
*{{$|01582E}} to {{$|0158B2}} = Normal Entrance Data (JP: 15592 - 15616)
*{{$|015C4E}} to {{$|015C54}} = Starting Location Data
<blockquote>
1 byte each. A value of {{$|FF}} plays the same music as the overworld screen from which the player entered.
</blockquote>

====Entrance Values====
*{{$|015C40}} to {{$|015C4D}} = Starting Location Data
<blockquote>
1 word each. Since the starting locations have to reference an entrance, this is necessary.
</blockquote>

==Rooms==
Tiles on the underworld maps are referred to as "super-rooms" and can contain 1-4 "sub-rooms."

===Primary Map===
The primary underworld map consists of {{$|FF}} (decimal: 256) super-rooms arranged in a {{$|10}} {{x}} {{$|10}} (decimal: 16 {{x}} 16) square.

{|{{Prettytable}}
! ID
! Description
|-
|[[Room $00|Room {{$|00}}]]
|Ganon
|-
|[[Room $01|Room {{$|01}}]]
|Hyrule Castle (North Corridor)
|-
|[[Room $02|Room {{$|02}}]]
|Hyrule Castle (Switch Room)
|-
|[[Room $03|Room {{$|03}}]]
|Houlihan Room
|-
|[[Room $04|Room {{$|04}}]]
|Turtle Rock (Crysta-roller Room)
|-
|[[Room $05|Room {{$|05}}]]
|Empty Clone Room
|-
|[[Room $06|Room {{$|06}}]]
|Swamp Palace (Arrghus[Boss])
|-
|[[Room $07|Room {{$|07}}]]
|Tower of Hera (Moldorm[Boss])
|-
|[[Room $08|Room {{$|08}}]]
|Cave (Healing Fairy)
|-
|[[Room $09|Room {{$|09}}]]
|Palace of Darkness
|-
|[[Room $0A|Room {{$|0A}}]]
|Palace of Darkness (Stalfos Trap Room)
|-
|[[Room $0B|Room {{$|0B}}]]
|Palace of Darkness (Turtle Room)
|-
|[[Room $0C|Room {{$|0C}}]]
|Ganon's Tower (Entrance Room)
|-
|[[Room $0D|Room {{$|0D}}]]
|Ganon's Tower (Agahnim2[Boss])
|-
|[[Room $0E|Room {{$|0E}}]]
|Ice Palace (Entrance Room)
|-
|[[Room $0F|Room {{$|0F}}]]
|Empty Clone Room
|-
|[[Room $10|Room {{$|10}}]]
|Ganon Evacuation Route
|-
|[[Room $11|Room {{$|11}}]]
|Hyrule Castle (Bombable Stock Room)
|-
|[[Room $12|Room {{$|12}}]]
|Sanctuary
|-
|[[Room $13|Room {{$|13}}]]
|Turtle Rock (Hokku-Bokku Key Room 2)
|-
|[[Room $14|Room {{$|14}}]]
|Turtle Rock (Big Key Room)
|-
|[[Room $15|Room {{$|15}}]]
|Turtle Rock
|-
|[[Room $16|Room {{$|16}}]]
|Swamp Palace (Swimming Treadmill)
|-
|[[Room $17|Room {{$|17}}]]
|Tower of Hera (Moldorm Fall Room)
|-
|[[Room $18|Room {{$|18}}]]
|Cave
|-
|[[Room $19|Room {{$|19}}]]
|Palace of Darkness (Dark Maze)
|-
|[[Room $1A|Room {{$|1A}}]]
|Palace of Darkness (Big Chest Room)
|-
|[[Room $1B|Room {{$|1B}}]]
|Palace of Darkness (Mimics / Moving Wall Room)
|-
|[[Room $1C|Room {{$|1C}}]]
|Ganon's Tower (Ice Armos)
|-
|[[Room $1D|Room {{$|1D}}]]
|Ganon's Tower (Final Hallway)
|-
|[[Room $1E|Room {{$|1E}}]]
|Ice Palace (Bomb Floor / Bari Room)
|-
|[[Room $1F|Room {{$|1F}}]]
|Ice Palace (Pengator / Big Key Room)
|-
|[[Room $20|Room {{$|20}}]]
|Agahnim's Tower (Agahnim[Boss])
|-
|[[Room $21|Room {{$|21}}]]
|Hyrule Castle (Key-rat Room)
|-
|[[Room $22|Room {{$|22}}]]
|Hyrule Castle (Sewer Text Trigger Room)
|-
|[[Room $23|Room {{$|23}}]]
|Turtle Rock (West Exit to Balcony)
|-
|[[Room $24|Room {{$|24}}]]
|Turtle Rock (Double Hokku-Bokku / Big chest Room)
|-
|[[Room $25|Room {{$|25}}]]
|Empty Clone Room
|-
|[[Room $26|Room {{$|26}}]]
|Swamp Palace (Statue Room)
|-
|[[Room $27|Room {{$|27}}]]
|Tower of Hera (Big Chest)
|-
|[[Room $28|Room {{$|28}}]]
|Swamp Palace (Entrance Room)
|-
|[[Room $29|Room {{$|29}}]]
|Skull Woods (Mothula[Boss])
|-
|[[Room $2A|Room {{$|2A}}]]
|Palace of Darkness (Big Hub Room)
|-
|[[Room $2B|Room {{$|2B}}]]
|Palace of Darkness (Map Chest / Fairy Room)
|-
|[[Room $2C|Room {{$|2C}}]]
|Cave
|-
|[[Room $2D|Room {{$|2D}}]]
|Empty Clone Room
|-
|[[Room $2E|Room {{$|2E}}]]
|Ice Palace (Compass Room)
|-
|[[Room $2F|Room {{$|2F}}]]
|Cave (Kakariko Well HP)
|-
|[[Room $30|Room {{$|30}}]]
|Agahnim's Tower (Maiden Sacrifice Chamber)
|-
|[[Room $31|Room {{$|31}}]]
|Tower of Hera (Hardhat Beetles Room)
|-
|[[Room $32|Room {{$|32}}]]
|Hyrule Castle (Sewer Key Chest Room)
|-
|[[Room $33|Room {{$|33}}]]
|Desert Palace (Lanmolas[Boss])
|-
|[[Room $34|Room {{$|34}}]]
|Swamp Palace (Push Block Puzzle / Pre-Big Key Room)
|-
|[[Room $35|Room {{$|35}}]]
|Swamp Palace (Big Key / BS Room)
|-
|[[Room $36|Room {{$|36}}]]
|Swamp Palace (Big Chest Room)
|-
|[[Room $37|Room {{$|37}}]]
|Swamp Palace (Map Chest / Water Fill Room)
|-
|[[Room $38|Room {{$|38}}]]
|Swamp Palace (Key Pot Room)
|-
|[[Room $39|Room {{$|39}}]]
|Skull Woods (Gibdo Key / Mothula Hole Room)
|-
|[[Room $3A|Room {{$|3A}}]]
|Palace of Darkness (Bombable Floor Room)
|-
|[[Room $3B|Room {{$|3B}}]]
|Palace of Darkness (Spike Block / Conveyor Room)
|-
|[[Room $3C|Room {{$|3C}}]]
|Cave
|-
|[[Room $3D|Room {{$|3D}}]]
|Ganon's Tower (Torch Room 2)
|-
|[[Room $3E|Room {{$|3E}}]]
|Ice Palace (Stalfos Knights / Conveyor Hellway)
|-
|[[Room $3F|Room {{$|3F}}]]
|Ice Palace (Map Chest Room)
|-
|[[Room $40|Room {{$|40}}]]
|Agahnim's Tower (Final Bridge Room)
|-
|[[Room $41|Room {{$|41}}]]
|Hyrule Castle (First Dark Room)
|-
|[[Room $42]]
|Hyrule Castle (6 Ropes Room)
|-
|[[Room $43]]
|Desert Palace (Torch Puzzle / Moving Wall Room)
|-
|[[Room $44]]
|Thieves Town (Big Chest Room)
|-
|[[Room $45]]
|Thieves Town (Jail Cells Room)
|-
|[[Room $46]]
|Swamp Palace (Compass Chest Room)
|-
|[[Room $47]]
|Empty Clone Room
|-
|[[Room $48]]
|Empty Clone Room
|-
|[[Room $49]]
|Skull Woods (Gibdo Torch Puzzle Room)
|-
|[[Room $4A]]
|Palace of Darkness (Entrance Room)
|-
|[[Room $4B]]
|Palace of Darkness (Warps / South Mimics Room)
|-
|[[Room $4C]]
|Ganon's Tower (Mini-Helmasaur Conveyor Room)
|-
|[[Room $4D]]
|Ganon's Tower (Moldorm Room)
|-
|[[Room $4E]]
|Ice Palace (Bomb-Jump Room)
|-
|[[Room $4F]]
|Ice Palace Clone Room (Fairy Room)
|-
|[[Room $50]]
|Hyrule Castle (West Corridor)
|-
|[[Room $51]]
|Hyrule Castle (Throne Room)
|-
|[[Room $52]]
|Hyrule Castle (East Corridor)
|-
|[[Room $53]]
|Desert Palace (Popos 2 / Beamos Hellway Room)
|-
|[[Room $54]]
|Swamp Palace (Upstairs Pits Room)
|-
|[[Room $55]]
|Castle Secret Entrance / Uncle Death Room
|-
|[[Room $56]]
|Skull Woods (Key Pot / Trap Room)
|-
|[[Room $57]]
|Skull Woods (Big Key Room)
|-
|[[Room $58]]
|Skull Woods (Big Chest Room)
|-
|[[Room $59]]
|Skull Woods (Final Section Entrance Room)
|-
|[[Room $5A]]
|Palace of Darkness (Helmasaur King[Boss])
|-
|[[Room $5B]]
|Ganon's Tower (Spike Pit Room)
|-
|[[Room $5C]]
|Ganon's Tower (Ganon-Ball Z)
|-
|[[Room $5D]]
|Ganon's Tower (Gauntlet 1/2/3)
|-
|[[Room $5E]]
|Ice Palace (Lonely Firebar)
|-
|[[Room $5F]]
|Ice Palace (Hidden Chest / Spike Floor Room)
|-
|[[Room $60]]
|Hyrule Castle (West Entrance Room)
|-
|[[Room $61]]
|Hyrule Castle (Main Entrance Room)
|-
|[[Room $62]]
|Hyrule Castle (East Entrance Room)
|-
|[[Room $63]]
|Desert Palace (Final Section Entrance Room)
|-
|[[Room $64]]
|Thieves Town (West Attic Room)
|-
|[[Room $65]]
|Thieves Town (East Attic Room)
|-
|[[Room $66]]
|Swamp Palace (Hidden Chest / Hidden Door Room)
|-
|[[Room $67]]
|Skull Woods (Compass Chest Room)
|-
|[[Room $68]]
|Skull Woods (Key Chest / Trap Room)
|-
|[[Room $69]]
|Empty Clone Room
|-
|[[Room $6A]]
|Palace of Darkness (Rupee Room)
|-
|[[Room $6B]]
|Ganon's Tower (Mimics Rooms)
|-
|[[Room $6C]]
|Ganon's Tower (Lanmolas Room)
|-
|[[Room $6D]]
|Ganon's Tower (Gauntlet 4/5)
|-
|[[Room $6E]]
|Ice Palace (Pengators Room)
|-
|[[Room $6F]]
|Empty Clone Room
|-
|[[Room $70]]
|Hyrule Castle (Small Corridor to Jail Cells)
|-
|[[Room $71]]
|Hyrule Castle (Boomerang Chest Room)
|-
|[[Room $72]]
|Hyrule Castle (Map Chest Room)
|-
|[[Room $73]]
|Desert Palace (Big Chest Room)
|-
|[[Room $74]]
|Desert Palace (Map Chest Room)
|-
|[[Room $75]]
|Desert Palace (Big Key Chest Room)
|-
|[[Room $76]]
|Swamp Palace (Water Drain Room)
|-
|[[Room $77]]
|Tower of Hera (Entrance Room)
|-
|[[Room $78]]
|Empty Clone Room
|-
|[[Room $79]]
|Empty Clone Room
|-
|[[Room $7A]]
|Empty Clone Room
|-
|[[Room $7B]]
|Ganon's Tower
|-
|[[Room $7C]]
|Ganon's Tower (East Side Collapsing Bridge / Exploding Wall Room)
|-
|[[Room $7D]]
|Ganon's Tower (Winder / Warp Maze Room)
|-
|[[Room $7E]]
|Ice Palace (Hidden Chest / Bombable Floor Room)
|-
|[[Room $7F]]
|Ice Palace ( Big Spike Traps Room)
|-
|[[Room $80]]
|Hyrule Castle (Jail Cell Room)
|-
|[[Room $81]]
|Hyrule Castle
|-
|[[Room $82]]
|Hyrule Castle (Basement Chasm Room)
|-
|[[Room $83]]
|Desert Palace (West Entrance Room)
|-
|[[Room $84]]
|Desert Palace (Main Entrance Room)
|-
|[[Room $85]]
|Desert Palace (East Entrance Room)
|-
|[[Room $86]]
|Empty Clone Room
|-
|[[Room $87]]
|Tower of Hera (Tile Room)
|-
|[[Room $88]]
|Empty Clone Room
|-
|[[Room $89]]
|Eastern Palace (Fairy Room)
|-
|[[Room $8A]]
|Empty Clone Room
|-
|[[Room $8B]]
|Ganon's Tower (Block Puzzle / Spike Skip / Map Chest Room)
|-
|[[Room $8C]]
|Ganon's Tower (East and West Downstairs / Big Chest Room)
|-
|[[Room $8D]]
|Ganon's Tower (Tile / Torch Puzzle Room)
|-
|[[Room $8E]]
|Ice Palace
|-
|[[Room $8F]]
|Empty Clone Room
|-
|[[Room $90]]
|Misery Mire (Vitreous[Boss])
|-
|[[Room $91]]
|Misery Mire (Final Switch Room)
|-
|[[Room $92]]
|Misery Mire (Dark Bomb Wall / Switches Room)
|-
|[[Room $93]]
|Misery Mire (Dark Cane Floor Switch Puzzle Room)
|-
|[[Room $94]]
|Empty Clone Room
|-
|[[Room $95]]
|Ganon's Tower (Final Collapsing Bridge Room)
|-
|[[Room $96]]
|Ganon's Tower (Torches 1 Room)
|-
|[[Room $97]]
|Misery Mire (Torch Puzzle / Moving Wall Room)
|-
|[[Room $98]]
|Misery Mire (Entrance Room)
|-
|[[Room $99]]
|Eastern Palace (Eyegore Key Room)
|-
|[[Room $9A]]
|Empty Clone Room
|-
|[[Room $9B]]
|Ganon's Tower (Many Spikes / Warp Maze Room)
|-
|[[Room $9C]]
|Ganon's Tower (Invisible Floor Maze Room)
|-
|[[Room $9D]]
|Ganon's Tower (Compass Chest / Invisible Floor Room)
|-
|[[Room $9E]]
|Ice Palace (Big Chest Room)
|-
|[[Room $9F]]
|Ice Palace
|-
|[[Room $A0]]
|Misery Mire (Pre-Vitreous Room)
|-
|[[Room $A1]]
|Misery Mire (Fish Room)
|-
|[[Room $A2]]
|Misery Mire (Bridge Key Chest Room)
|-
|[[Room $A3]]
|Misery Mire
|-
|[[Room $A4]]
|Turtle Rock (Trinexx[Boss])
|-
|[[Room $A5]]
|Ganon's Tower (Wizzrobes Rooms)
|-
|[[Room $A6]]
|Ganon's Tower (Moldorm Fall Room)
|-
|[[Room $A7]]
|Tower of Hera (Fairy Room)
|-
|[[Room $A8]]
|Eastern Palace (Stalfos Spawn Room)
|-
|[[Room $A9]]
|Eastern Palace (Big Chest Room)
|-
|[[Room $AA]]
|Eastern Palace (Map Chest Room)
|-
|[[Room $AB]]
|Thieves Town (Moving Spikes / Key Pot Room)
|-
|[[Room $AC]]
|Thieves Town (Blind The Thief[Boss])
|-
|[[Room $AD]]
|Empty Clone Room
|-
|[[Room $AE]]
|Ice Palace
|-
|[[Room $AF]]
|Ice Palace (Ice Bridge Room)
|-
|[[Room $B0]]
|Agahnim's Tower (Circle of Pots)
|-
|[[Room $B1]]
|Misery Mire (Hourglass Room)
|-
|[[Room $B2]]
|Misery Mire (Slug Room)
|-
|[[Room $B3]]
|Misery Mire (Spike Key Chest Room)
|-
|[[Room $B4]]
|Turtle Rock (Pre-Trinexx Room)
|-
|[[Room $B5]]
|Turtle Rock (Dark Maze)
|-
|[[Room $B6]]
|Turtle Rock (Chain Chomps Room)
|-
|[[Room $B7]]
|Turtle Rock (Map Chest / Key Chest / Roller Room)
|-
|[[Room $B8]]
|Eastern Palace (Big Key Room)
|-
|[[Room $B9]]
|Eastern Palace (Lobby Cannonballs Room)
|-
|[[Room $BA]]
|Eastern Palace (Dark Antifairy / Key Pot Room)
|-
|[[Room $BB]]
|Thieves Town (Hellway)
|-
|[[Room $BC]]
|Thieves Town (Conveyor Toilet)
|-
|[[Room $BD]]
|Empty Clone Room
|-
|[[Room $BE]]
|Ice Palace (Block Puzzle Room)
|-
|[[Room $BF]]
|Ice Palace Clone Room (Switch Room)
|-
|[[Room $C0]]
|Agahnim's Tower (Dark Bridge Room)
|-
|[[Room $C1]]
|Misery Mire (Compass Chest / Tile Room)
|-
|[[Room $C2]]
|Misery Mire (Big Hub Room)
|-
|[[Room $C3]]
|Misery Mire (Big Chest Room)
|-
|[[Room $C4]]
|Turtle Rock (Final Crystal Switch Puzzle Room)
|-
|[[Room $C5]]
|Turtle Rock (Laser Bridge)
|-
|[[Room $C6]]
|Turtle Rock
|-
|[[Room $C7]]
|Turtle Rock (Torch Puzzle)
|-
|[[Room $C8]]
|Eastern Palace (Armos Knights[Boss])
|-
|[[Room $C9]]
|Eastern Palace (Entrance Room)
|-
|[[Room $CA]]
|??
|-
|[[Room $CB]]
|Thieves Town (North West Entrance Room)
|-
|[[Room $CC]]
|Thieves Town (North East Entrance Room)
|-
|[[Room $CD]]
|Empty Clone Room
|-
|[[Room $CE]]
|Ice Palace (Hole to Kholdstare Room)
|-
|[[Room $CF]]
|Empty Clone Room
|-
|[[Room $D0]]
|Agahnim's Tower (Dark Maze)
|-
|[[Room $D1]]
|Misery Mire (Conveyor Slug / Big Key Room)
|-
|[[Room $D2]]
|Misery Mire (Mire02 / Wizzrobes Room)
|-
|[[Room $D3]]
|Empty Clone Room
|-
|[[Room $D4]]
|Empty Clone Room
|-
|[[Room $D5]]
|Turtle Rock (Laser Key Room)
|-
|[[Room $D6]]
|Turtle Rock (Entrance Room)
|-
|[[Room $D7]]
|Empty Clone Room
|-
|[[Room $D8]]
|Eastern Palace ("Zeldagamer Room" / Pre-Armos Knights Room)
|-
|[[Room $D9]]
|Eastern Palace (Canonball Room)
|-
|[[Room $DA]]
|Eastern Palace
|-
|[[Room $DB]]
|Thieves Town (Main (South West) Entrance Room)
|-
|[[Room $DC]]
|Thieves Town (South East Entrance Room)
|-
|[[Room $DD]]
|Empty Clone Room
|-
|[[Room $DE]]
|Ice Palace (Kholdstare[Boss])
|-
|[[Room $DF]]
|Cave
|-
|[[Room $E0]]
|Agahnim's Tower (Entrance Room)
|-
|[[Room $E1]]
|Cave (Lost Woods HP)
|-
|[[Room $E2]]
|Cave (Lumberjack's Tree HP)
|-
|[[Room $E3]]
|Cave (1/2 Magic)
|-
|[[Room $E4]]
|Cave (Lost Old Man Final Cave)
|-
|[[Room $E5]]
|Cave (Lost Old Man Final Cave)
|-
|[[Room $E6]]
|Cave
|-
|[[Room $E7]]
|Cave
|-
|[[Room $E8]]
|Cave
|-
|[[Room $E9]]
|Empty Clone Room
|-
|[[Room $EA]]
|Cave (Spectacle Rock HP)
|-
|[[Room $EB]]
|Cave
|-
|[[Room $EC]]
|Empty Clone Room
|-
|[[Room $ED]]
|Cave
|-
|[[Room $EE]]
|Cave (Spiral Cave)
|-
|[[Room $EF]]
|Cave (Crystal Switch / 5 Chests Room)
|-
|[[Room $F0]]
|Cave (Lost Old Man Starting Cave)
|-
|[[Room $F1]]
|Cave (Lost Old Man Starting Cave)
|-
|[[Room $F2]]
|House
|-
|[[Room $F3]]
|House (Old Woman (Sahasrahla's Wife?))
|-
|[[Room $F4]]
|House (Angry Brothers)
|-
|[[Room $F5]]
|House (Angry Brothers)
|-
|[[Room $F6]]
|Empty Clone Room
|-
|[[Room $F7]]
|Empty Clone Room
|-
|[[Room $F8]]
|Cave
|-
|[[Room $F9]]
|Cave
|-
|[[Room $FA]]
|Cave
|-
|[[Room $FB]]
|Cave
|-
|[[Room $FC]]
|Empty Clone Room
|-
|[[Room $FD]]
|Cave
|-
|[[Room $FE]]
|Cave
|-
|[[Room $FF]]
|Cave
|}

===Secondary Map===

{{toc}}

Underworld

2017-07-28T16:31:02Z

Tatters: /* Room Headers */

The underworld refers to all indoor locations; including dungeons, caves, and houses.

==Important Hex Addresses==
===Room Data===
====Room Headers====
*{{$|027502}} to {{$|027781}} = Pointer Table, {{hex|2}} byte local addresses, indexed by room ID.
*{{$|027781}} to {{$|027FEF}} = Data

<blockquote>
Headers are {{$|0E}} (Decimal: 14) bytes formatted thusly:
*Byte {{hex|0}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
**The {{red|a}} bits are transformed into {{hex|0000 0}}{{red|aaa}} and stored to {{$|0414}} ("BG2" in Hyrule Magic)
**The {{blue|b}} bits are transformed into {{hex|0000 0}}{{blue|bbb}} and stored to {{$|046C}} ("Collision" in Hyrule Magic)
**The {{green|c}} bit is unused
**The {{purple|d}} bit is stored to {{$|7EC005}} (If set, use a lights out routine in the room transition)

*Byte {{hex|1}}: {{red|aa}}{{blue|bb bbbb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{blue|bbbb bb}}{{hex|00}}, thus making them a multiple of 4.
This value is used to load 4 different palettes for the dungeon, and corresponds to, you guessed it, Palette # in Hyrule Magic!

The resulting index is used to load values for {{$|0AB6}}, {{$|0AAC}}, {{$|0AAD}}, and {{$|0AAE}}

*Byte {{hex|2}}: gets stored to {{$|0AA2}} (GFX # in Hyrule Magic)
*Byte {{hex|3}}: value + #$40 gets stored to {{$|0AA3}} (Sprite GFX # in Hyrule Magic)
*Byte {{hex|4}}: gets stored to {{$|00AD}} ("[[Room Effects|Effect]]" in Hyrule Magic)
*Byte {{hex|5}}: {{red|aa}}{{blue|bb bbbb}}
**{{red|a}} = ?
**The {{blue|b}} bits are "[[Room Tags|Tag1]]" in Hyrule Magic and gets stored to {{$|00AE}}.
*Byte {{hex|6}}: {{red|aa}}{{blue|bb bbbb}}
**{{red|a}} = ?
**The {{blue|b}} bits are "Tag2" in Hyrule Magic and get stored to {{$|00AF}}

These are the planes to use for bytes {{hex|9}} through {{hex|D}}. This determines which
BG you appear on, and possibly more.

*Byte {{hex|7}}: {{red|aa}}{{blue|bb}} {{green|cc}}{{purple|dd}}
**The {{red|a}} bits are transformed into {{hex|0000 00}}{{red|aa}} and stored to {{$|063F}}
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|063E}}
**The {{green|c}} bits are transformed into {{hex|0000 00}}{{green|cc}} and stored to {{$|063D}}
**The {{purple|d}} bits are transformed into {{hex|0000 00}}{{purple|dd}} and stored to {{$|063C}}

Note, the only safe values for a plane seem to be {{hex|0}},{{hex|1}}, or {{hex|2}}. Hyrule Magic
appears to violate this rule by letting you put {{hex|3}} down, but nothing higher.

*Byte {{hex|8}}: {{red|aaaa aa}}{{blue|bb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|0640}}

*Byte {{hex|9}}: stored to {{$|7EC000}} These are all room numbers that you could possibly exit to.
*Byte {{hex|A}}: stored to {{$|7EC001}}
*Byte {{hex|B}}: stored to {{$|7EC002}}
*Byte {{hex|C}}: stored to {{$|7EC003}}
*Byte {{hex|D}}: stored to {{$|7EC004}}
</blockquote>

====Sprite Data====
* {{$|04D62E}} to {{$|04D92E}} = Pointer Table, 2 byte local addresses, indexed by room.
* {{$|04D92E}} to {{$|04EC9D}} = Data

<blockquote>
Sprite data is formatted thusly:
*Byte {{hex|0}}: Stored to {{$|0FB3}}. Corresponds with "Sort Spr" in Hyrule Magic. In a layered room this indicates sprites in the foreground are to be drawn on top of sprites in the background.
**Bit {{hex|0}} - If {{hex|0}}, sprites will sort
**Bits {{hex|7,6,5,4,3,2,1}} - Unknown, should all be {{hex|1}}
After the byte {{hex|0}}, you will see 3 byte clusters that break down thus:

*Byte {{hex|0}}:
**Bits {{hex|4,3,2,1,0}} - Y coordinate (in pixels from the top, starting at {{hex|0}}) of the sprite divided by 16.
**Bits {{hex|6,5}} - If these are set, they will be used to generate a subtype, stored to {{$|0E30}}, X.
**Bit {{hex|7}} - If set, the sprite is on BG2, if not it's on BG1
* Byte {{hex|1}}:
** Bits {{hex|4,3,2,1,0}} - X coordinate (in pixels from the far left, starting at {{hex|0}}) of the sprite divided by 16.
** Bits {{hex|7,6,5}} - If all these bits are set then this is an Overlord, otherwise it's a normal sprite. If only some of them are set they can be used to generate a subtype, stored at {{$|0E30}}, X
* Byte {{hex|2}}: Sprite or Overlord type. If a sprite, this will get loaded into a slot at {{$|0E20}}, X. If an Overlord, will get loaded to {{$|0B00}}, X.

The array is terminated with a byte of {{$|FF}}.
</blockquote>

====Object Data====
* {{$|0F8000}} to {{$|0F83BF}} = Pointer Table, 3 byte long addresses, indexed by room ID.
* {{$|01EBA0}} to {{$|01FFF4}} = Data
* {{$|050000}} to {{$|053729}} = Data
* {{$|0F8780}} to {{$|0FFF4D}} = Data
<blockquote>
Byte layout:

* Byte 0: {{red|aaaa}} {{blue|bbbb}}.
**The a bits are transformed to {{red|aaaa}}{{hex|0000}} and select the type of empty space to fill in. Hyrule Magic calls this 'Floor 1' - Gets stored to {{$|7E0490}}
**The b bits are transformed to {{blue|bbbb}}{{hex|0000}} and are the what Hyrule Magic calls 'Floor 2' - Gets stored to {{$|7E046A}}

* Byte {{hex|1}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
** The {{red|a}} bits are unused and should not be used
** The {{blue|b}} bits determine the room's layout type, ranging from {{hex|0}} to {{hex|7}}.
** The {{green|c}} and {{purple|d}} bits are unknown, but I have a feeling it's related to {{$|AA}} and {{$|A9}}

After that the bytes come in {{hex|3}} or {{hex|2}} byte object structures, used by routine {{$|01:88E4}}. Objects are loaded until an object with value {{0x|FFFF}} occurs. If a value {{0x|FFF0}} is loaded, the game will start loading Type 2 objects and will not go back to loading Type 1 objects until it is time to load the next layer. (Layer as in HM, not to be confused with the SNES' Backgrounds.) A value of {{0x|FFFF}} will also terminate the loading of Type 2 objects. The routine immediately terminates if that happens during the loading of either object type.

Type 1 Object structure: (3 bytes):

* Byte {{hex|3}}: Routine to use. If this byte is ≥ {{0x|F8}} and < {{0x|FC}}, then it is a subtype 3 object. If the index is ≥ {{hex|FC}}, it is a subtype 2 object. If not, it is a subtype 1 object.

* Subtype 1 Objects, first and second byte
** High Byte: {{brown|yyyy yy}}{{green|cc}}
** Low Byte: {{grey|xxxx xx}}{{red|aa}}
*** The {{red|a}} bits are stored to {{$|B2}}
*** The {{green|c}} bits are stored to {{$|B4}}
*** The {{grey|x}} and {{brown|y}} bits are transformed into: {{hex|000}}{{brown|y yyyy y}}{{grey|xxx xxx}}{{hex|0}} - This is a tilemap address that indexes into {{$|7E2000}} and / or {{$|7E4000}}

Use Byte {{hex|3}} * 2 as an index into the table at {{$|8200}}. This is the routine that is used to draw and otherwise handle the object. Subtype 1 objects have a maximum width and height of 4. Width and height are measured in terms of 32 {{x}} 32 pixels. (⟸ last part is questionable)

*Subtype 2 Objects, 1st, 2nd, & 3rd bytes:
** Byte {{hex|3}}: {{white|ff}}{{purple|dd dddd}}
** Byte {{hex|2}}: {{pink|eeee}} {{green|cccc}}
** Byte {{hex|1}}: {{red|aaaa aa}}{{blue|bb}}
***The {{red|a}} bits are unused, but after all they are the marker for this type of object subtype.
***The {{blue|b}}, {{green|c}}, {{pink|e}}, and {{white|f}} bits are transformed into a VRAM tilemap address: {{hex|000}}{{green|c ccc}}{{white|f}} {{white|f}}{{blue|bb}}{{pink|e eee}}{{hex|0}}

Might I add this is one messed up format? The {{purple|d}} bits are used as an index into the table at {{$|8470}}. Since such indices are going to be even, the {{purple|d}} bits are transformed into: {{hex|0000 0000 0}}{{purple|ddd ddd}}{{hex|0}}.

*Subtype 3 Objects
**Similar to Subtype 1, with a few small exceptions.
**The vram address is calculated the same way. However, {{$|B2}} and {{$|B4}} are not used as length or width dimensions here. The routine that is used is determined as follows:
**Take the original index (times two) that a Subtype 1 would have used. AND that with {{0x|000E}}. Then shift left 3 times to produce {{hex|0000 0000 0}}{{pink|eee}} {{hex|0000}}. Then, OR in {{$|B2}} and {{$|B4}} and shift left once, so the final result is: {{hex|0000 0000}} {{pink|eee}}{{red|a a}}{{blue|bb}}{{hex|0}}.
**Also, this value indexes into {{$|85F0}} instead of {{$|8200}}.

Type 2 Object Structure: (2 bytes)
*High Byte: {{green|cccc cccc}}
*Low Byte: {{blue|bbbb}} {{purple|dd}}{{red|aa}}
**The {{red|a}} bits form a 2-bit value ({{hex|0000 0}}{{red|aa}}{{hex|0}}) that determines the routine to use for the object. In Hyrule Magic, corresponds to the "direction" of the door.
**The {{blue|b}} bits are transformed into {{hex|000}}{{blue|b bbb}}{{hex|0}} and stored to {{$|02}} ⟹ X. Corresponds to "Pos" of door objects in the Hyrule Magic. Note that these range from {{0x|00}} to {{0x|16}} (always even) which if you halve those values is 0 - 11 in decimal. This is easily verifiable in Hyrule Magic.
**The {{green|c}} bits are shifted into the lower byte and stored to {{$|04}} ⟹ A and {{$|0A}}. This is later used to grab the tiles used to draw the door and the area below it. In Hyrule Magic, corresponds to "type". Note the type is 1/2 of the number listed here. This is because to avoid using an ASL A command, the {{green|c}} bits are always even.
**The {{purple|d}} bits are unused.

Next I'll go into the nitty gritty of the various types (the value of {{$|04}}). Again note that we'll only be dealing with even values {{blue|b}}/{{green|c}} that's what you'll see in the code. To convert between here [as well as the code] and Hyrule Magic, take the hex value here and divide by two. Convert to decimal and that's your Hyrule Magic "type."

*Types:
{|{{Prettytable}}
! ID
! Description
|-
|{{0x|00}}
|Basic door. Index = {{$|0460}}
|-
|{{0x|02}}
|Normal door?
|-
|{{0x|04}}
|???
|-
|{{0x|06}}
|???
|-
|{{0x|08}}
|Waterfall door (only used in Swamp palace; in one room at that!)
|-
|{{0x|0A}}
|???
|-
|{{0x|0C}}
|Trap door (probably other types but this seems to be most common)
|-
|{{0x|12}}
|Adds a property to some doors allowing you to exit to the overworld (this is accomplished by writing to the tile attribute map)
|-
|{{0x|14}}
|Transition to dark room?
|-
|{{0x|16}}
|Toggles the target BG Link will emerge on. '''Ex.''' if Link starts on BG0 in the next room he'll be on BG1.
|-
|{{0x|20}}
| rowspan="2"|Locked door specifically for BG0.
|-
|{{0x|22}}
|-
|{{0x|24}}
| rowspan="2"|Locked door for either BG0 or BG1
|-
|{{0x|26}}
|-
|{{0x|30}}
|Large exploded pathway resulting from a switch being pulled (unusual to have as a door as it's huge)
|-
|{{0x|32}}
|Sword activated door. '''Ex.''' Agahnim's room with the curtain door you have to slash.
|-
|{{0x|46}}
|warp door?
|}
</blockquote>

====Dungeon Secrets Data====
* {{$|00DB69}} to {{$|00DDE8}} = Pointer Table, 2 byte local addresses, indexed by room ID.
* {{$|00DDE9}} to {{$|00E6B1}} = Data
<blockquote>
Data comes in 3 byte chunks and is terminated by an instance of {{$|FFFF}}

* Bytes {{hex|0}}, {{hex|1}}: A word that denotes the VRAM address that the item is found at. This identifies the item as belonging to that part of the screen.
* Byte {{hex|2}}: Identifies the type of item that is hiding there. E.g. {{$|08}} is a key
</blockquote>

====Push Block Data====
* {{$|0271DE}} to {{$|027369}} = Data
<Blockquote>
4 bytes per entry:
{{red|a a }}{{blue|x }} {{green|y}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the block (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the block (expressed as tilemap coordinate)
</blockquote>

====(Inter Room) Torch Data====
* {{$|02736A}} to {{$|027489}} = Data
<Blockquote>
Consists of variable length segments consisting of:

{{red|a a }}{{blue|x }}{{green|y }}{{blue|x }}{{green|y }}{{hex|... }}{{$|FFFF}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the torch (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the torch (expressed as tilemap coordinate)
*{{$|FFFF}}: Delimeter
</blockquote>

====Chest Contents====
*{{$|00E96E}} to {{$|00EB65}} = Data
<blockquote>
Array of chest information in 3 byte chunks. 168 entries in all ({{0x|A8}})

*First word - Room number it is located in. MSB determines whether it is a big chest or not. (big chest if set)
*Last byte - index of the type of item contained in the chest.
</blockquote>

===Entrance Data===
There are {{$|85}} (Decimal: 133) normal entrances to the underworld from the overworld, and {{$|7}} (Decimal: 7) starting locations.
Normal entrances and starting locations use mostly the same types of data formatted the same, however they are located in different places in the ROM.
They are located and formatted thus:

====Entrance Room====
*{{$|014813}} to {{$|01491C}} = Normal Entrance Data
*{{$|015B6E}} to {{$|015B7B}} = Starting Location Data
<blockquote>
Each entry is a 2 byte Room ID where the player is placed after using an entrance.
</blockquote>

====Scroll Edges====
*{{$|01491D}} to {{$|014D44}} = Normal Entrance Data
*{{$|015B7C}} to {{$|015BB3}} = Starting Location Data
<blockquote>
Unsure about what these do exactly.
Each entry is 8 bytes long.
*Format: 1 byte each. Corresponds to hyrule magic values in the "More" aka Entrance Properties dialog box.
**HU -
**FU -
**HD -
**FD -
**HL -
**FL -
**HR -
**FR -
</blockquote>

====X Scroll====
*{{$|014D45}} to {{$|014E4E}} = Normal Entrance Data
*{{$|015BB4}} to {{$|015BC1}} = Starting Location Data
<blockquote>

</blockquote>

====Y Scroll====
*{{$|014E4F}} to {{$|014F58}} = Normal Entrance Data
*{{$|015BC2}} to {{$|015BCF}} = Starting Location Data
<blockquote>

</blockquote>

====X Coordinate====
*{{$|014F59}} to {{$|015062}} = Normal Entrance Data
*{{$|015BD0}} to {{$|015BDD}} = Starting Location Data
<blockquote>
Each entry is a 2 byte X coordinate where the player starts after using the corresponding entrance.
</blockquote>

====Y Coordinate====
*{{$|015063}} to {{$|01516C}} = Normal Entrance Data
*{{$|015BDE}} to {{$|015BEB}} = Starting Location Data
<blockquote>
Each entry is a 2 byte y coordinate where the player starts after using the corresponding entrance.
</blockquote>

====X Camera Coordinate====
*{{$|01516D}} to {{$|015276}} = Normal Entrance Data
*{{$|015BEC}} to {{$|015BF9}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

====Y Camera Coordinate====
*{{$|015277}} to {{$|015380}} = Normal Entrance Data
*{{$|015BFA}} to {{$|015C07}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

====Entrance Blockset====
*{{$|015381}} to {{$|015405}} = Normal Entrance Data
*{{$|015C08}} to {{$|015C0E}} = Starting Location Data
<blockquote>
1 byte each. This blockset affects walls and a few other things and persists through all rooms the player accesses from this entrance.
</blockquote>

====Floor Values====
*{{$|015406}} to {{$|01548A}} = Normal Entrance Data
*{{$|015C0F}} to {{$|015C15}} = Starting Location Data
<blockquote>
This tells us what kind of properties the floor has. 1 byte each:
*If 1, then it has floors that you can fall through to the next level
*If 0, I think it means it can be fallen down to
*If -1, has no pits
*If -2, ????
</blockquote>

====Dungeon Values====
*{{$|01548B}} to {{$|01550F}} = Normal Entrance Data
*{{$|015C16}} to {{$|015C1C}} = Starting Location Data
<blockquote>
1 Byte each.
Dungeons actually in the game are numbered like so {{$|00}}, {{$|02}}, {{$|04}}, ..., {{$|18}}, {{$|1A}}.
{{$|1C}} and {{$|1E}} are unused (and hence could potentially be added.) Notice they are all even numbers.
In asm routines these values are divided by two sometimes to provide an index into other arrays.
That's why. The definition of a "dungeon" is something with a key, compass, and map.

A value of {{$|FF}} (-1) denotes it doesn't belong to a dungeon.
</blockquote>

====Doorway Type====
*{{$|015510}} to {{$|015594}} = Normal Entrance Data
*{{$|015C2B}} to {{$|015C31}} = Starting Location Data
<blockquote>
This is used only when you exit the given room. For example, let's say you enter through a skull doorway in Skullwoods.
But that's not really a door way, it's just a set of tiles that are no different from a hole you might create after picking
up a big rock. But if you entered from a building door, the game has to know whether to put the door frame when you exit.
*1 byte:
**{{hex|0}} = no doorway when exiting
**{{hex|1}} = draws a door frame upon exiting
**{{hex|2}} = ???? HM says vertical doorframe. But in the original game, no doorway is vertical.

</blockquote>

====Ladder And BG Settings====
*{{$|015595}} to {{$|015619}} = Normal Entrance Data
*{{$|015C1D}} to {{$|015C23}} = Starting Location Data
<blockquote>
*1 byte each, with the following 2 bit layout: {{hex|xxx}}{{red|a}}{{pink|xxx}}{{blue|b}}
**{{hex|x}} - unimportant
**{{red|a}} - if set, then Link enters on the lower level (BG2)
**{{blue|b}} - if set... not sure what happens exactly. Check the game engine to be sure.
</blockquote>

====Horizontal And Vertical Scroll Properties====
*{{$|01561A}} to {{$|01569E}} = Normal Entrance Data
*{{$|015C24}} to {{$|015C2A}} = Starting Location Data
<blockquote>
For these, I guess if the flags in the appropriate places are set, then the room will be able to scroll in those directions.

*1 byte each, with the following layout: {{hex|xx}}{{red|a}}{{hex|xxx}}{{blue|b}}{{hex|x}}
**{{red|a}} - Horizontal flag
**{{blue|b}} - Vertical flag
</blockquote>

====Scroll Quadrant====
*{{$|01569F}} to {{$|015723}} = Normal Entrance Data
<blockquote>
*1 byte each, has four different expected values:
**0h, 2h, 10h, 12h
</blockquote>

====Exit Door Location====
*{{$|015724}} to {{$|01582D}} = Normal Entrance Data
*{{$|015C32}} to {{$|015C3F}} = Starting Location Data
<blockquote>
1 word each. Denotes X and Y coordinates for overworld?
</blockquote>

====Music====
*{{$|01582E}} to {{$|0158B2}} = Normal Entrance Data (JP: 15592 - 15616)
*{{$|015C4E}} to {{$|015C54}} = Starting Location Data
<blockquote>
1 byte each. A value of {{$|FF}} plays the same music as the overworld screen from which the player entered.
</blockquote>

====Entrance Values====
*{{$|015C40}} to {{$|015C4D}} = Starting Location Data
<blockquote>
1 word each. Since the starting locations have to reference an entrance, this is necessary.
</blockquote>

==Rooms==
Tiles on the underworld maps are referred to as "super-rooms" and can contain 1-4 "sub-rooms."

===Primary Map===
The primary underworld map consists of {{$|FF}} (decimal: 256) super-rooms arranged in a {{$|10}} {{x}} {{$|10}} (decimal: 16 {{x}} 16) square.

{|{{Prettytable}}
! ID
! Description
|-
|[[Room $00|Room {{$|00}}]]
|Ganon
|-
|[[Room $01|Room {{$|01}}]]
|Hyrule Castle (North Corridor)
|-
|[[Room $02|Room {{$|02}}]]
|Hyrule Castle (Switch Room)
|-
|[[Room $03|Room {{$|03}}]]
|Houlihan Room
|-
|[[Room $04|Room {{$|04}}]]
|Turtle Rock (Crysta-roller Room)
|-
|[[Room $05|Room {{$|05}}]]
|Empty Clone Room
|-
|[[Room $06|Room {{$|06}}]]
|Swamp Palace (Arrghus[Boss])
|-
|[[Room $07|Room {{$|07}}]]
|Tower of Hera (Moldorm[Boss])
|-
|[[Room $08|Room {{$|08}}]]
|Cave (Healing Fairy)
|-
|[[Room $09|Room {{$|09}}]]
|Palace of Darkness
|-
|[[Room $0A|Room {{$|0A}}]]
|Palace of Darkness (Stalfos Trap Room)
|-
|[[Room $0B|Room {{$|0B}}]]
|Palace of Darkness (Turtle Room)
|-
|[[Room $0C|Room {{$|0C}}]]
|Ganon's Tower (Entrance Room)
|-
|[[Room $0D|Room {{$|0D}}]]
|Ganon's Tower (Agahnim2[Boss])
|-
|[[Room $0E|Room {{$|0E}}]]
|Ice Palace (Entrance Room)
|-
|[[Room $0F|Room {{$|0F}}]]
|Empty Clone Room
|-
|[[Room $10|Room {{$|10}}]]
|Ganon Evacuation Route
|-
|[[Room $11|Room {{$|11}}]]
|Hyrule Castle (Bombable Stock Room)
|-
|[[Room $12|Room {{$|12}}]]
|Sanctuary
|-
|[[Room $13|Room {{$|13}}]]
|Turtle Rock (Hokku-Bokku Key Room 2)
|-
|[[Room $14|Room {{$|14}}]]
|Turtle Rock (Big Key Room)
|-
|[[Room $15|Room {{$|15}}]]
|Turtle Rock
|-
|[[Room $16|Room {{$|16}}]]
|Swamp Palace (Swimming Treadmill)
|-
|[[Room $17|Room {{$|17}}]]
|Tower of Hera (Moldorm Fall Room)
|-
|[[Room $18|Room {{$|18}}]]
|Cave
|-
|[[Room $19|Room {{$|19}}]]
|Palace of Darkness (Dark Maze)
|-
|[[Room $1A|Room {{$|1A}}]]
|Palace of Darkness (Big Chest Room)
|-
|[[Room $1B|Room {{$|1B}}]]
|Palace of Darkness (Mimics / Moving Wall Room)
|-
|[[Room $1C|Room {{$|1C}}]]
|Ganon's Tower (Ice Armos)
|-
|[[Room $1D|Room {{$|1D}}]]
|Ganon's Tower (Final Hallway)
|-
|[[Room $1E|Room {{$|1E}}]]
|Ice Palace (Bomb Floor / Bari Room)
|-
|[[Room $1F|Room {{$|1F}}]]
|Ice Palace (Pengator / Big Key Room)
|-
|[[Room $20|Room {{$|20}}]]
|Agahnim's Tower (Agahnim[Boss])
|-
|[[Room $21|Room {{$|21}}]]
|Hyrule Castle (Key-rat Room)
|-
|[[Room $22|Room {{$|22}}]]
|Hyrule Castle (Sewer Text Trigger Room)
|-
|[[Room $23|Room {{$|23}}]]
|Turtle Rock (West Exit to Balcony)
|-
|[[Room $24|Room {{$|24}}]]
|Turtle Rock (Double Hokku-Bokku / Big chest Room)
|-
|[[Room $25|Room {{$|25}}]]
|Empty Clone Room
|-
|[[Room $26|Room {{$|26}}]]
|Swamp Palace (Statue Room)
|-
|[[Room $27|Room {{$|27}}]]
|Tower of Hera (Big Chest)
|-
|[[Room $28|Room {{$|28}}]]
|Swamp Palace (Entrance Room)
|-
|[[Room $29|Room {{$|29}}]]
|Skull Woods (Mothula[Boss])
|-
|[[Room $2A|Room {{$|2A}}]]
|Palace of Darkness (Big Hub Room)
|-
|[[Room $2B|Room {{$|2B}}]]
|Palace of Darkness (Map Chest / Fairy Room)
|-
|[[Room $2C|Room {{$|2C}}]]
|Cave
|-
|[[Room $2D|Room {{$|2D}}]]
|Empty Clone Room
|-
|[[Room $2E|Room {{$|2E}}]]
|Ice Palace (Compass Room)
|-
|[[Room $2F|Room {{$|2F}}]]
|Cave (Kakariko Well HP)
|-
|[[Room $30|Room {{$|30}}]]
|Agahnim's Tower (Maiden Sacrifice Chamber)
|-
|[[Room $31|Room {{$|31}}]]
|Tower of Hera (Hardhat Beetles Room)
|-
|[[Room $32|Room {{$|32}}]]
|Hyrule Castle (Sewer Key Chest Room)
|-
|[[Room $33|Room {{$|33}}]]
|Desert Palace (Lanmolas[Boss])
|-
|[[Room $34|Room {{$|34}}]]
|Swamp Palace (Push Block Puzzle / Pre-Big Key Room)
|-
|[[Room $35|Room {{$|35}}]]
|Swamp Palace (Big Key / BS Room)
|-
|[[Room $36|Room {{$|36}}]]
|Swamp Palace (Big Chest Room)
|-
|[[Room $37|Room {{$|37}}]]
|Swamp Palace (Map Chest / Water Fill Room)
|-
|[[Room $38|Room {{$|38}}]]
|Swamp Palace (Key Pot Room)
|-
|[[Room $39|Room {{$|39}}]]
|Skull Woods (Gibdo Key / Mothula Hole Room)
|-
|[[Room $3A|Room {{$|3A}}]]
|Palace of Darkness (Bombable Floor Room)
|-
|[[Room $3B|Room {{$|3B}}]]
|Palace of Darkness (Spike Block / Conveyor Room)
|-
|[[Room $3C|Room {{$|3C}}]]
|Cave
|-
|[[Room $3D|Room {{$|3D}}]]
|Ganon's Tower (Torch Room 2)
|-
|[[Room $3E|Room {{$|3E}}]]
|Ice Palace (Stalfos Knights / Conveyor Hellway)
|-
|[[Room $3F|Room {{$|3F}}]]
|Ice Palace (Map Chest Room)
|-
|[[Room $40|Room {{$|40}}]]
|Agahnim's Tower (Final Bridge Room)
|-
|[[Room $41|Room {{$|41}}]]
|Hyrule Castle (First Dark Room)
|-
|[[Room $42]]
|Hyrule Castle (6 Ropes Room)
|-
|[[Room $43]]
|Desert Palace (Torch Puzzle / Moving Wall Room)
|-
|[[Room $44]]
|Thieves Town (Big Chest Room)
|-
|[[Room $45]]
|Thieves Town (Jail Cells Room)
|-
|[[Room $46]]
|Swamp Palace (Compass Chest Room)
|-
|[[Room $47]]
|Empty Clone Room
|-
|[[Room $48]]
|Empty Clone Room
|-
|[[Room $49]]
|Skull Woods (Gibdo Torch Puzzle Room)
|-
|[[Room $4A]]
|Palace of Darkness (Entrance Room)
|-
|[[Room $4B]]
|Palace of Darkness (Warps / South Mimics Room)
|-
|[[Room $4C]]
|Ganon's Tower (Mini-Helmasaur Conveyor Room)
|-
|[[Room $4D]]
|Ganon's Tower (Moldorm Room)
|-
|[[Room $4E]]
|Ice Palace (Bomb-Jump Room)
|-
|[[Room $4F]]
|Ice Palace Clone Room (Fairy Room)
|-
|[[Room $50]]
|Hyrule Castle (West Corridor)
|-
|[[Room $51]]
|Hyrule Castle (Throne Room)
|-
|[[Room $52]]
|Hyrule Castle (East Corridor)
|-
|[[Room $53]]
|Desert Palace (Popos 2 / Beamos Hellway Room)
|-
|[[Room $54]]
|Swamp Palace (Upstairs Pits Room)
|-
|[[Room $55]]
|Castle Secret Entrance / Uncle Death Room
|-
|[[Room $56]]
|Skull Woods (Key Pot / Trap Room)
|-
|[[Room $57]]
|Skull Woods (Big Key Room)
|-
|[[Room $58]]
|Skull Woods (Big Chest Room)
|-
|[[Room $59]]
|Skull Woods (Final Section Entrance Room)
|-
|[[Room $5A]]
|Palace of Darkness (Helmasaur King[Boss])
|-
|[[Room $5B]]
|Ganon's Tower (Spike Pit Room)
|-
|[[Room $5C]]
|Ganon's Tower (Ganon-Ball Z)
|-
|[[Room $5D]]
|Ganon's Tower (Gauntlet 1/2/3)
|-
|[[Room $5E]]
|Ice Palace (Lonely Firebar)
|-
|[[Room $5F]]
|Ice Palace (Hidden Chest / Spike Floor Room)
|-
|[[Room $60]]
|Hyrule Castle (West Entrance Room)
|-
|[[Room $61]]
|Hyrule Castle (Main Entrance Room)
|-
|[[Room $62]]
|Hyrule Castle (East Entrance Room)
|-
|[[Room $63]]
|Desert Palace (Final Section Entrance Room)
|-
|[[Room $64]]
|Thieves Town (West Attic Room)
|-
|[[Room $65]]
|Thieves Town (East Attic Room)
|-
|[[Room $66]]
|Swamp Palace (Hidden Chest / Hidden Door Room)
|-
|[[Room $67]]
|Skull Woods (Compass Chest Room)
|-
|[[Room $68]]
|Skull Woods (Key Chest / Trap Room)
|-
|[[Room $69]]
|Empty Clone Room
|-
|[[Room $6A]]
|Palace of Darkness (Rupee Room)
|-
|[[Room $6B]]
|Ganon's Tower (Mimics Rooms)
|-
|[[Room $6C]]
|Ganon's Tower (Lanmolas Room)
|-
|[[Room $6D]]
|Ganon's Tower (Gauntlet 4/5)
|-
|[[Room $6E]]
|Ice Palace (Pengators Room)
|-
|[[Room $6F]]
|Empty Clone Room
|-
|[[Room $70]]
|Hyrule Castle (Small Corridor to Jail Cells)
|-
|[[Room $71]]
|Hyrule Castle (Boomerang Chest Room)
|-
|[[Room $72]]
|Hyrule Castle (Map Chest Room)
|-
|[[Room $73]]
|Desert Palace (Big Chest Room)
|-
|[[Room $74]]
|Desert Palace (Map Chest Room)
|-
|[[Room $75]]
|Desert Palace (Big Key Chest Room)
|-
|[[Room $76]]
|Swamp Palace (Water Drain Room)
|-
|[[Room $77]]
|Tower of Hera (Entrance Room)
|-
|[[Room $78]]
|Empty Clone Room
|-
|[[Room $79]]
|Empty Clone Room
|-
|[[Room $7A]]
|Empty Clone Room
|-
|[[Room $7B]]
|Ganon's Tower
|-
|[[Room $7C]]
|Ganon's Tower (East Side Collapsing Bridge / Exploding Wall Room)
|-
|[[Room $7D]]
|Ganon's Tower (Winder / Warp Maze Room)
|-
|[[Room $7E]]
|Ice Palace (Hidden Chest / Bombable Floor Room)
|-
|[[Room $7F]]
|Ice Palace ( Big Spike Traps Room)
|-
|[[Room $80]]
|Hyrule Castle (Jail Cell Room)
|-
|[[Room $81]]
|Hyrule Castle
|-
|[[Room $82]]
|Hyrule Castle (Basement Chasm Room)
|-
|[[Room $83]]
|Desert Palace (West Entrance Room)
|-
|[[Room $84]]
|Desert Palace (Main Entrance Room)
|-
|[[Room $85]]
|Desert Palace (East Entrance Room)
|-
|[[Room $86]]
|Empty Clone Room
|-
|[[Room $87]]
|Tower of Hera (Tile Room)
|-
|[[Room $88]]
|Empty Clone Room
|-
|[[Room $89]]
|Eastern Palace (Fairy Room)
|-
|[[Room $8A]]
|Empty Clone Room
|-
|[[Room $8B]]
|Ganon's Tower (Block Puzzle / Spike Skip / Map Chest Room)
|-
|[[Room $8C]]
|Ganon's Tower (East and West Downstairs / Big Chest Room)
|-
|[[Room $8D]]
|Ganon's Tower (Tile / Torch Puzzle Room)
|-
|[[Room $8E]]
|Ice Palace
|-
|[[Room $8F]]
|Empty Clone Room
|-
|[[Room $90]]
|Misery Mire (Vitreous[Boss])
|-
|[[Room $91]]
|Misery Mire (Final Switch Room)
|-
|[[Room $92]]
|Misery Mire (Dark Bomb Wall / Switches Room)
|-
|[[Room $93]]
|Misery Mire (Dark Cane Floor Switch Puzzle Room)
|-
|[[Room $94]]
|Empty Clone Room
|-
|[[Room $95]]
|Ganon's Tower (Final Collapsing Bridge Room)
|-
|[[Room $96]]
|Ganon's Tower (Torches 1 Room)
|-
|[[Room $97]]
|Misery Mire (Torch Puzzle / Moving Wall Room)
|-
|[[Room $98]]
|Misery Mire (Entrance Room)
|-
|[[Room $99]]
|Eastern Palace (Eyegore Key Room)
|-
|[[Room $9A]]
|Empty Clone Room
|-
|[[Room $9B]]
|Ganon's Tower (Many Spikes / Warp Maze Room)
|-
|[[Room $9C]]
|Ganon's Tower (Invisible Floor Maze Room)
|-
|[[Room $9D]]
|Ganon's Tower (Compass Chest / Invisible Floor Room)
|-
|[[Room $9E]]
|Ice Palace (Big Chest Room)
|-
|[[Room $9F]]
|Ice Palace
|-
|[[Room $A0]]
|Misery Mire (Pre-Vitreous Room)
|-
|[[Room $A1]]
|Misery Mire (Fish Room)
|-
|[[Room $A2]]
|Misery Mire (Bridge Key Chest Room)
|-
|[[Room $A3]]
|Misery Mire
|-
|[[Room $A4]]
|Turtle Rock (Trinexx[Boss])
|-
|[[Room $A5]]
|Ganon's Tower (Wizzrobes Rooms)
|-
|[[Room $A6]]
|Ganon's Tower (Moldorm Fall Room)
|-
|[[Room $A7]]
|Tower of Hera (Fairy Room)
|-
|[[Room $A8]]
|Eastern Palace (Stalfos Spawn Room)
|-
|[[Room $A9]]
|Eastern Palace (Big Chest Room)
|-
|[[Room $AA]]
|Eastern Palace (Map Chest Room)
|-
|[[Room $AB]]
|Thieves Town (Moving Spikes / Key Pot Room)
|-
|[[Room $AC]]
|Thieves Town (Blind The Thief[Boss])
|-
|[[Room $AD]]
|Empty Clone Room
|-
|[[Room $AE]]
|Ice Palace
|-
|[[Room $AF]]
|Ice Palace (Ice Bridge Room)
|-
|[[Room $B0]]
|Agahnim's Tower (Circle of Pots)
|-
|[[Room $B1]]
|Misery Mire (Hourglass Room)
|-
|[[Room $B2]]
|Misery Mire (Slug Room)
|-
|[[Room $B3]]
|Misery Mire (Spike Key Chest Room)
|-
|[[Room $B4]]
|Turtle Rock (Pre-Trinexx Room)
|-
|[[Room $B5]]
|Turtle Rock (Dark Maze)
|-
|[[Room $B6]]
|Turtle Rock (Chain Chomps Room)
|-
|[[Room $B7]]
|Turtle Rock (Map Chest / Key Chest / Roller Room)
|-
|[[Room $B8]]
|Eastern Palace (Big Key Room)
|-
|[[Room $B9]]
|Eastern Palace (Lobby Cannonballs Room)
|-
|[[Room $BA]]
|Eastern Palace (Dark Antifairy / Key Pot Room)
|-
|[[Room $BB]]
|Thieves Town (Hellway)
|-
|[[Room $BC]]
|Thieves Town (Conveyor Toilet)
|-
|[[Room $BD]]
|Empty Clone Room
|-
|[[Room $BE]]
|Ice Palace (Block Puzzle Room)
|-
|[[Room $BF]]
|Ice Palace Clone Room (Switch Room)
|-
|[[Room $C0]]
|Agahnim's Tower (Dark Bridge Room)
|-
|[[Room $C1]]
|Misery Mire (Compass Chest / Tile Room)
|-
|[[Room $C2]]
|Misery Mire (Big Hub Room)
|-
|[[Room $C3]]
|Misery Mire (Big Chest Room)
|-
|[[Room $C4]]
|Turtle Rock (Final Crystal Switch Puzzle Room)
|-
|[[Room $C5]]
|Turtle Rock (Laser Bridge)
|-
|[[Room $C6]]
|Turtle Rock
|-
|[[Room $C7]]
|Turtle Rock (Torch Puzzle)
|-
|[[Room $C8]]
|Eastern Palace (Armos Knights[Boss])
|-
|[[Room $C9]]
|Eastern Palace (Entrance Room)
|-
|[[Room $CA]]
|??
|-
|[[Room $CB]]
|Thieves Town (North West Entrance Room)
|-
|[[Room $CC]]
|Thieves Town (North East Entrance Room)
|-
|[[Room $CD]]
|Empty Clone Room
|-
|[[Room $CE]]
|Ice Palace (Hole to Kholdstare Room)
|-
|[[Room $CF]]
|Empty Clone Room
|-
|[[Room $D0]]
|Agahnim's Tower (Dark Maze)
|-
|[[Room $D1]]
|Misery Mire (Conveyor Slug / Big Key Room)
|-
|[[Room $D2]]
|Misery Mire (Mire02 / Wizzrobes Room)
|-
|[[Room $D3]]
|Empty Clone Room
|-
|[[Room $D4]]
|Empty Clone Room
|-
|[[Room $D5]]
|Turtle Rock (Laser Key Room)
|-
|[[Room $D6]]
|Turtle Rock (Entrance Room)
|-
|[[Room $D7]]
|Empty Clone Room
|-
|[[Room $D8]]
|Eastern Palace ("Zeldagamer Room" / Pre-Armos Knights Room)
|-
|[[Room $D9]]
|Eastern Palace (Canonball Room)
|-
|[[Room $DA]]
|Eastern Palace
|-
|[[Room $DB]]
|Thieves Town (Main (South West) Entrance Room)
|-
|[[Room $DC]]
|Thieves Town (South East Entrance Room)
|-
|[[Room $DD]]
|Empty Clone Room
|-
|[[Room $DE]]
|Ice Palace (Kholdstare[Boss])
|-
|[[Room $DF]]
|Cave
|-
|[[Room $E0]]
|Agahnim's Tower (Entrance Room)
|-
|[[Room $E1]]
|Cave (Lost Woods HP)
|-
|[[Room $E2]]
|Cave (Lumberjack's Tree HP)
|-
|[[Room $E3]]
|Cave (1/2 Magic)
|-
|[[Room $E4]]
|Cave (Lost Old Man Final Cave)
|-
|[[Room $E5]]
|Cave (Lost Old Man Final Cave)
|-
|[[Room $E6]]
|Cave
|-
|[[Room $E7]]
|Cave
|-
|[[Room $E8]]
|Cave
|-
|[[Room $E9]]
|Empty Clone Room
|-
|[[Room $EA]]
|Cave (Spectacle Rock HP)
|-
|[[Room $EB]]
|Cave
|-
|[[Room $EC]]
|Empty Clone Room
|-
|[[Room $ED]]
|Cave
|-
|[[Room $EE]]
|Cave (Spiral Cave)
|-
|[[Room $EF]]
|Cave (Crystal Switch / 5 Chests Room)
|-
|[[Room $F0]]
|Cave (Lost Old Man Starting Cave)
|-
|[[Room $F1]]
|Cave (Lost Old Man Starting Cave)
|-
|[[Room $F2]]
|House
|-
|[[Room $F3]]
|House (Old Woman (Sahasrahla's Wife?))
|-
|[[Room $F4]]
|House (Angry Brothers)
|-
|[[Room $F5]]
|House (Angry Brothers)
|-
|[[Room $F6]]
|Empty Clone Room
|-
|[[Room $F7]]
|Empty Clone Room
|-
|[[Room $F8]]
|Cave
|-
|[[Room $F9]]
|Cave
|-
|[[Room $FA]]
|Cave
|-
|[[Room $FB]]
|Cave
|-
|[[Room $FC]]
|Empty Clone Room
|-
|[[Room $FD]]
|Cave
|-
|[[Room $FE]]
|Cave
|-
|[[Room $FF]]
|Cave
|}

===Secondary Map===

{{toc}}

Underworld

2017-07-22T22:22:26Z

Tatters: /* (Inter Room) Torch Data */

The underworld refers to all indoor locations; including dungeons, caves, and houses.

==Important Hex Addresses==
===Room Data===
====Room Headers====
*{{$|027502}} to {{$|027781}} = Pointer Table, {{hex|2}} byte local addresses, indexed by room ID.
*{{$|027781}} to {{$|027FEF}} = Data

<blockquote>
Headers are {{$|0E}} (Decimal: 14) bytes formatted thusly:
*Byte {{hex|0}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
**The {{red|a}} bits are transformed into {{hex|0000 0}}{{red|aaa}} and stored to {{$|0414}} ("BG2" in Hyrule Magic)
**The {{blue|b}} bits are transformed into {{hex|0000 0}}{{blue|bbb}} and stored to {{$|046C}} ("Collision" in Hyrule Magic)
**The {{green|c}} bit is unused
**The {{purple|d}} bit is stored to {{$|7EC005}} (If set, use a lights out routine in the room transition)

*Byte {{hex|1}}: {{red|aa}}{{blue|bb bbbb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{blue|bbbb bb}}{{hex|00}}, thus making them a multiple of 4.
This value is used to load 4 different palettes for the dungeon, and corresponds to, you guessed it, Palette # in Hyrule Magic!

The resulting index is used to load values for {{$|0AB6}}, {{$|0AAC}}, {{$|0AAD}}, and {{$|0AAE}}

*Byte {{hex|2}}: gets stored to {{$|0AA2}} (GFX # in Hyrule Magic)
*Byte {{hex|3}}: value + #$40 gets stored to {{$|0AA3}} (Sprite GFX # in Hyrule Magic)
*Byte {{hex|4}}: gets stored to {{$|00AD}} ("[[Room Effects|Effect]]" in Hyrule Magic)
*Byte {{hex|5}}: gets stored to {{$|00AE}} ("[[Room Tags|Tag1]]" in Hyrule Magic)
*Byte {{hex|6}}: gets stored to {{$|00AF}} ("Tag2" in Hyrule Magic)

These are the planes to use for bytes {{hex|9}} through {{hex|D}}. This determines which
BG you appear on, and possibly more.

*Byte {{hex|7}}: {{red|aa}}{{blue|bb}} {{green|cc}}{{purple|dd}}
**The {{red|a}} bits are transformed into {{hex|0000 00}}{{red|aa}} and stored to {{$|063F}}
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|063E}}
**The {{green|c}} bits are transformed into {{hex|0000 00}}{{green|cc}} and stored to {{$|063D}}
**The {{purple|d}} bits are transformed into {{hex|0000 00}}{{purple|dd}} and stored to {{$|063C}}

Note, the only safe values for a plane seem to be {{hex|0}},{{hex|1}}, or {{hex|2}}. Hyrule Magic
appears to violate this rule by letting you put {{hex|3}} down, but nothing higher.

*Byte {{hex|8}}: {{red|aaaa aa}}{{blue|bb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|0640}}

*Byte {{hex|9}}: stored to {{$|7EC000}} These are all room numbers that you could possibly exit to.
*Byte {{hex|A}}: stored to {{$|7EC001}}
*Byte {{hex|B}}: stored to {{$|7EC002}}
*Byte {{hex|C}}: stored to {{$|7EC003}}
*Byte {{hex|D}}: stored to {{$|7EC004}}
</blockquote>

====Sprite Data====
* {{$|04D62E}} to {{$|04D92E}} = Pointer Table, 2 byte local addresses, indexed by room.
* {{$|04D92E}} to {{$|04EC9D}} = Data

<blockquote>
Sprite data is formatted thusly:
*Byte {{hex|0}}: Stored to {{$|0FB3}}. Corresponds with "Sort Spr" in Hyrule Magic. In a layered room this indicates sprites in the foreground are to be drawn on top of sprites in the background.
**Bit {{hex|0}} - If {{hex|0}}, sprites will sort
**Bits {{hex|7,6,5,4,3,2,1}} - Unknown, should all be {{hex|1}}
After the byte {{hex|0}}, you will see 3 byte clusters that break down thus:

*Byte {{hex|0}}:
**Bits {{hex|4,3,2,1,0}} - Y coordinate (in pixels from the top, starting at {{hex|0}}) of the sprite divided by 16.
**Bits {{hex|6,5}} - If these are set, they will be used to generate a subtype, stored to {{$|0E30}}, X.
**Bit {{hex|7}} - If set, the sprite is on BG2, if not it's on BG1
* Byte {{hex|1}}:
** Bits {{hex|4,3,2,1,0}} - X coordinate (in pixels from the far left, starting at {{hex|0}}) of the sprite divided by 16.
** Bits {{hex|7,6,5}} - If all these bits are set then this is an Overlord, otherwise it's a normal sprite. If only some of them are set they can be used to generate a subtype, stored at {{$|0E30}}, X
* Byte {{hex|2}}: Sprite or Overlord type. If a sprite, this will get loaded into a slot at {{$|0E20}}, X. If an Overlord, will get loaded to {{$|0B00}}, X.

The array is terminated with a byte of {{$|FF}}.
</blockquote>

====Object Data====
* {{$|0F8000}} to {{$|0F83BF}} = Pointer Table, 3 byte long addresses, indexed by room ID.
* {{$|01EBA0}} to {{$|01FFF4}} = Data
* {{$|050000}} to {{$|053729}} = Data
* {{$|0F8780}} to {{$|0FFF4D}} = Data
<blockquote>
Byte layout:

* Byte 0: {{red|aaaa}} {{blue|bbbb}}.
**The a bits are transformed to {{red|aaaa}}{{hex|0000}} and select the type of empty space to fill in. Hyrule Magic calls this 'Floor 1' - Gets stored to {{$|7E0490}}
**The b bits are transformed to {{blue|bbbb}}{{hex|0000}} and are the what Hyrule Magic calls 'Floor 2' - Gets stored to {{$|7E046A}}

* Byte {{hex|1}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
** The {{red|a}} bits are unused and should not be used
** The {{blue|b}} bits determine the room's layout type, ranging from {{hex|0}} to {{hex|7}}.
** The {{green|c}} and {{purple|d}} bits are unknown, but I have a feeling it's related to {{$|AA}} and {{$|A9}}

After that the bytes come in {{hex|3}} or {{hex|2}} byte object structures, used by routine {{$|01:88E4}}. Objects are loaded until an object with value {{0x|FFFF}} occurs. If a value {{0x|FFF0}} is loaded, the game will start loading Type 2 objects and will not go back to loading Type 1 objects until it is time to load the next layer. (Layer as in HM, not to be confused with the SNES' Backgrounds.) A value of {{0x|FFFF}} will also terminate the loading of Type 2 objects. The routine immediately terminates if that happens during the loading of either object type.

Type 1 Object structure: (3 bytes):

* Byte {{hex|3}}: Routine to use. If this byte is ≥ {{0x|F8}} and < {{0x|FC}}, then it is a subtype 3 object. If the index is ≥ {{hex|FC}}, it is a subtype 2 object. If not, it is a subtype 1 object.

* Subtype 1 Objects, first and second byte
** High Byte: {{brown|yyyy yy}}{{green|cc}}
** Low Byte: {{grey|xxxx xx}}{{red|aa}}
*** The {{red|a}} bits are stored to {{$|B2}}
*** The {{green|c}} bits are stored to {{$|B4}}
*** The {{grey|x}} and {{brown|y}} bits are transformed into: {{hex|000}}{{brown|y yyyy y}}{{grey|xxx xxx}}{{hex|0}} - This is a tilemap address that indexes into {{$|7E2000}} and / or {{$|7E4000}}

Use Byte {{hex|3}} * 2 as an index into the table at {{$|8200}}. This is the routine that is used to draw and otherwise handle the object. Subtype 1 objects have a maximum width and height of 4. Width and height are measured in terms of 32 {{x}} 32 pixels. (⟸ last part is questionable)

*Subtype 2 Objects, 1st, 2nd, & 3rd bytes:
** Byte {{hex|3}}: {{white|ff}}{{purple|dd dddd}}
** Byte {{hex|2}}: {{pink|eeee}} {{green|cccc}}
** Byte {{hex|1}}: {{red|aaaa aa}}{{blue|bb}}
***The {{red|a}} bits are unused, but after all they are the marker for this type of object subtype.
***The {{blue|b}}, {{green|c}}, {{pink|e}}, and {{white|f}} bits are transformed into a VRAM tilemap address: {{hex|000}}{{green|c ccc}}{{white|f}} {{white|f}}{{blue|bb}}{{pink|e eee}}{{hex|0}}

Might I add this is one messed up format? The {{purple|d}} bits are used as an index into the table at {{$|8470}}. Since such indices are going to be even, the {{purple|d}} bits are transformed into: {{hex|0000 0000 0}}{{purple|ddd ddd}}{{hex|0}}.

*Subtype 3 Objects
**Similar to Subtype 1, with a few small exceptions.
**The vram address is calculated the same way. However, {{$|B2}} and {{$|B4}} are not used as length or width dimensions here. The routine that is used is determined as follows:
**Take the original index (times two) that a Subtype 1 would have used. AND that with {{0x|000E}}. Then shift left 3 times to produce {{hex|0000 0000 0}}{{pink|eee}} {{hex|0000}}. Then, OR in {{$|B2}} and {{$|B4}} and shift left once, so the final result is: {{hex|0000 0000}} {{pink|eee}}{{red|a a}}{{blue|bb}}{{hex|0}}.
**Also, this value indexes into {{$|85F0}} instead of {{$|8200}}.

Type 2 Object Structure: (2 bytes)
*High Byte: {{green|cccc cccc}}
*Low Byte: {{blue|bbbb}} {{purple|dd}}{{red|aa}}
**The {{red|a}} bits form a 2-bit value ({{hex|0000 0}}{{red|aa}}{{hex|0}}) that determines the routine to use for the object. In Hyrule Magic, corresponds to the "direction" of the door.
**The {{blue|b}} bits are transformed into {{hex|000}}{{blue|b bbb}}{{hex|0}} and stored to {{$|02}} ⟹ X. Corresponds to "Pos" of door objects in the Hyrule Magic. Note that these range from {{0x|00}} to {{0x|16}} (always even) which if you halve those values is 0 - 11 in decimal. This is easily verifiable in Hyrule Magic.
**The {{green|c}} bits are shifted into the lower byte and stored to {{$|04}} ⟹ A and {{$|0A}}. This is later used to grab the tiles used to draw the door and the area below it. In Hyrule Magic, corresponds to "type". Note the type is 1/2 of the number listed here. This is because to avoid using an ASL A command, the {{green|c}} bits are always even.
**The {{purple|d}} bits are unused.

Next I'll go into the nitty gritty of the various types (the value of {{$|04}}). Again note that we'll only be dealing with even values {{blue|b}}/{{green|c}} that's what you'll see in the code. To convert between here [as well as the code] and Hyrule Magic, take the hex value here and divide by two. Convert to decimal and that's your Hyrule Magic "type."

*Types:
{|{{Prettytable}}
! ID
! Description
|-
|{{0x|00}}
|Basic door. Index = {{$|0460}}
|-
|{{0x|02}}
|Normal door?
|-
|{{0x|04}}
|???
|-
|{{0x|06}}
|???
|-
|{{0x|08}}
|Waterfall door (only used in Swamp palace; in one room at that!)
|-
|{{0x|0A}}
|???
|-
|{{0x|0C}}
|Trap door (probably other types but this seems to be most common)
|-
|{{0x|12}}
|Adds a property to some doors allowing you to exit to the overworld (this is accomplished by writing to the tile attribute map)
|-
|{{0x|14}}
|Transition to dark room?
|-
|{{0x|16}}
|Toggles the target BG Link will emerge on. '''Ex.''' if Link starts on BG0 in the next room he'll be on BG1.
|-
|{{0x|20}}
| rowspan="2"|Locked door specifically for BG0.
|-
|{{0x|22}}
|-
|{{0x|24}}
| rowspan="2"|Locked door for either BG0 or BG1
|-
|{{0x|26}}
|-
|{{0x|30}}
|Large exploded pathway resulting from a switch being pulled (unusual to have as a door as it's huge)
|-
|{{0x|32}}
|Sword activated door. '''Ex.''' Agahnim's room with the curtain door you have to slash.
|-
|{{0x|46}}
|warp door?
|}
</blockquote>

====Dungeon Secrets Data====
* {{$|00DB69}} to {{$|00DDE8}} = Pointer Table, 2 byte local addresses, indexed by room ID.
* {{$|00DDE9}} to {{$|00E6B1}} = Data
<blockquote>
Data comes in 3 byte chunks and is terminated by an instance of {{$|FFFF}}

* Bytes {{hex|0}}, {{hex|1}}: A word that denotes the VRAM address that the item is found at. This identifies the item as belonging to that part of the screen.
* Byte {{hex|2}}: Identifies the type of item that is hiding there. E.g. {{$|08}} is a key
</blockquote>

====Push Block Data====
* {{$|0271DE}} to {{$|027369}} = Data
<Blockquote>
4 bytes per entry:
{{red|a a }}{{blue|x }} {{green|y}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the block (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the block (expressed as tilemap coordinate)
</blockquote>

====(Inter Room) Torch Data====
* {{$|02736A}} to {{$|027489}} = Data
<Blockquote>
Consists of variable length segments consisting of:

{{red|a a }}{{blue|x }}{{green|y }}{{blue|x }}{{green|y }}{{hex|... }}{{$|FFFF}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the torch (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the torch (expressed as tilemap coordinate)
*{{$|FFFF}}: Delimeter
</blockquote>

====Chest Contents====
*{{$|00E96E}} to {{$|00EB65}} = Data
<blockquote>
Array of chest information in 3 byte chunks. 168 entries in all ({{0x|A8}})

*First word - Room number it is located in. MSB determines whether it is a big chest or not. (big chest if set)
*Last byte - index of the type of item contained in the chest.
</blockquote>

===Entrance Data===
There are {{$|85}} (Decimal: 133) normal entrances to the underworld from the overworld, and {{$|7}} (Decimal: 7) starting locations.
Normal entrances and starting locations use mostly the same types of data formatted the same, however they are located in different places in the ROM.
They are located and formatted thus:

====Entrance Room====
*{{$|014813}} to {{$|01491C}} = Normal Entrance Data
*{{$|015B6E}} to {{$|015B7B}} = Starting Location Data
<blockquote>
Each entry is a 2 byte Room ID where the player is placed after using an entrance.
</blockquote>

====Scroll Edges====
*{{$|01491D}} to {{$|014D44}} = Normal Entrance Data
*{{$|015B7C}} to {{$|015BB3}} = Starting Location Data
<blockquote>
Unsure about what these do exactly.
Each entry is 8 bytes long.
*Format: 1 byte each. Corresponds to hyrule magic values in the "More" aka Entrance Properties dialog box.
**HU -
**FU -
**HD -
**FD -
**HL -
**FL -
**HR -
**FR -
</blockquote>

====X Scroll====
*{{$|014D45}} to {{$|014E4E}} = Normal Entrance Data
*{{$|015BB4}} to {{$|015BC1}} = Starting Location Data
<blockquote>

</blockquote>

====Y Scroll====
*{{$|014E4F}} to {{$|014F58}} = Normal Entrance Data
*{{$|015BC2}} to {{$|015BCF}} = Starting Location Data
<blockquote>

</blockquote>

====X Coordinate====
*{{$|014F59}} to {{$|015062}} = Normal Entrance Data
*{{$|015BD0}} to {{$|015BDD}} = Starting Location Data
<blockquote>
Each entry is a 2 byte X coordinate where the player starts after using the corresponding entrance.
</blockquote>

====Y Coordinate====
*{{$|015063}} to {{$|01516C}} = Normal Entrance Data
*{{$|015BDE}} to {{$|015BEB}} = Starting Location Data
<blockquote>
Each entry is a 2 byte y coordinate where the player starts after using the corresponding entrance.
</blockquote>

====X Camera Coordinate====
*{{$|01516D}} to {{$|015276}} = Normal Entrance Data
*{{$|015BEC}} to {{$|015BF9}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

====Y Camera Coordinate====
*{{$|015277}} to {{$|015380}} = Normal Entrance Data
*{{$|015BFA}} to {{$|015C07}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

====Entrance Blockset====
*{{$|015381}} to {{$|015405}} = Normal Entrance Data
*{{$|015C08}} to {{$|015C0E}} = Starting Location Data
<blockquote>
1 byte each. This blockset affects walls and a few other things and persists through all rooms the player accesses from this entrance.
</blockquote>

====Floor Values====
*{{$|015406}} to {{$|01548A}} = Normal Entrance Data
*{{$|015C0F}} to {{$|015C15}} = Starting Location Data
<blockquote>
This tells us what kind of properties the floor has. 1 byte each:
*If 1, then it has floors that you can fall through to the next level
*If 0, I think it means it can be fallen down to
*If -1, has no pits
*If -2, ????
</blockquote>

====Dungeon Values====
*{{$|01548B}} to {{$|01550F}} = Normal Entrance Data
*{{$|015C16}} to {{$|015C1C}} = Starting Location Data
<blockquote>
1 Byte each.
Dungeons actually in the game are numbered like so {{$|00}}, {{$|02}}, {{$|04}}, ..., {{$|18}}, {{$|1A}}.
{{$|1C}} and {{$|1E}} are unused (and hence could potentially be added.) Notice they are all even numbers.
In asm routines these values are divided by two sometimes to provide an index into other arrays.
That's why. The definition of a "dungeon" is something with a key, compass, and map.

A value of {{$|FF}} (-1) denotes it doesn't belong to a dungeon.
</blockquote>

====Doorway Type====
*{{$|015510}} to {{$|015594}} = Normal Entrance Data
*{{$|015C2B}} to {{$|015C31}} = Starting Location Data
<blockquote>
This is used only when you exit the given room. For example, let's say you enter through a skull doorway in Skullwoods.
But that's not really a door way, it's just a set of tiles that are no different from a hole you might create after picking
up a big rock. But if you entered from a building door, the game has to know whether to put the door frame when you exit.
*1 byte:
**{{hex|0}} = no doorway when exiting
**{{hex|1}} = draws a door frame upon exiting
**{{hex|2}} = ???? HM says vertical doorframe. But in the original game, no doorway is vertical.

</blockquote>

====Ladder And BG Settings====
*{{$|015595}} to {{$|015619}} = Normal Entrance Data
*{{$|015C1D}} to {{$|015C23}} = Starting Location Data
<blockquote>
*1 byte each, with the following 2 bit layout: {{hex|xxx}}{{red|a}}{{pink|xxx}}{{blue|b}}
**{{hex|x}} - unimportant
**{{red|a}} - if set, then Link enters on the lower level (BG2)
**{{blue|b}} - if set... not sure what happens exactly. Check the game engine to be sure.
</blockquote>

====Horizontal And Vertical Scroll Properties====
*{{$|01561A}} to {{$|01569E}} = Normal Entrance Data
*{{$|015C24}} to {{$|015C2A}} = Starting Location Data
<blockquote>
For these, I guess if the flags in the appropriate places are set, then the room will be able to scroll in those directions.

*1 byte each, with the following layout: {{hex|xx}}{{red|a}}{{hex|xxx}}{{blue|b}}{{hex|x}}
**{{red|a}} - Horizontal flag
**{{blue|b}} - Vertical flag
</blockquote>

====Scroll Quadrant====
*{{$|01569F}} to {{$|015723}} = Normal Entrance Data
<blockquote>
*1 byte each, has four different expected values:
**0h, 2h, 10h, 12h
</blockquote>

====Exit Door Location====
*{{$|015724}} to {{$|01582D}} = Normal Entrance Data
*{{$|015C32}} to {{$|015C3F}} = Starting Location Data
<blockquote>
1 word each. Denotes X and Y coordinates for overworld?
</blockquote>

====Music====
*{{$|01582E}} to {{$|0158B2}} = Normal Entrance Data (JP: 15592 - 15616)
*{{$|015C4E}} to {{$|015C54}} = Starting Location Data
<blockquote>
1 byte each. A value of {{$|FF}} plays the same music as the overworld screen from which the player entered.
</blockquote>

====Entrance Values====
*{{$|015C40}} to {{$|015C4D}} = Starting Location Data
<blockquote>
1 word each. Since the starting locations have to reference an entrance, this is necessary.
</blockquote>

==Rooms==
Tiles on the underworld maps are referred to as "super-rooms" and can contain 1-4 "sub-rooms."

===Primary Map===
The primary underworld map consists of {{$|FF}} (decimal: 256) super-rooms arranged in a {{$|10}} {{x}} {{$|10}} (decimal: 16 {{x}} 16) square.

{|{{Prettytable}}
! ID
! Description
|-
|[[Room $00|Room {{$|00}}]]
|Ganon
|-
|[[Room $01|Room {{$|01}}]]
|Hyrule Castle (North Corridor)
|-
|[[Room $02|Room {{$|02}}]]
|Hyrule Castle (Switch Room)
|-
|[[Room $03|Room {{$|03}}]]
|Houlihan Room
|-
|[[Room $04|Room {{$|04}}]]
|Turtle Rock (Crysta-roller Room)
|-
|[[Room $05|Room {{$|05}}]]
|Empty Clone Room
|-
|[[Room $06|Room {{$|06}}]]
|Swamp Palace (Arrghus[Boss])
|-
|[[Room $07|Room {{$|07}}]]
|Tower of Hera (Moldorm[Boss])
|-
|[[Room $08|Room {{$|08}}]]
|Cave (Healing Fairy)
|-
|[[Room $09|Room {{$|09}}]]
|Palace of Darkness
|-
|[[Room $0A|Room {{$|0A}}]]
|Palace of Darkness (Stalfos Trap Room)
|-
|[[Room $0B|Room {{$|0B}}]]
|Palace of Darkness (Turtle Room)
|-
|[[Room $0C|Room {{$|0C}}]]
|Ganon's Tower (Entrance Room)
|-
|[[Room $0D|Room {{$|0D}}]]
|Ganon's Tower (Agahnim2[Boss])
|-
|[[Room $0E|Room {{$|0E}}]]
|Ice Palace (Entrance Room)
|-
|[[Room $0F|Room {{$|0F}}]]
|Empty Clone Room
|-
|[[Room $10|Room {{$|10}}]]
|Ganon Evacuation Route
|-
|[[Room $11|Room {{$|11}}]]
|Hyrule Castle (Bombable Stock Room)
|-
|[[Room $12|Room {{$|12}}]]
|Sanctuary
|-
|[[Room $13|Room {{$|13}}]]
|Turtle Rock (Hokku-Bokku Key Room 2)
|-
|[[Room $14|Room {{$|14}}]]
|Turtle Rock (Big Key Room)
|-
|[[Room $15|Room {{$|15}}]]
|Turtle Rock
|-
|[[Room $16|Room {{$|16}}]]
|Swamp Palace (Swimming Treadmill)
|-
|[[Room $17|Room {{$|17}}]]
|Tower of Hera (Moldorm Fall Room)
|-
|[[Room $18|Room {{$|18}}]]
|Cave
|-
|[[Room $19|Room {{$|19}}]]
|Palace of Darkness (Dark Maze)
|-
|[[Room $1A|Room {{$|1A}}]]
|Palace of Darkness (Big Chest Room)
|-
|[[Room $1B|Room {{$|1B}}]]
|Palace of Darkness (Mimics / Moving Wall Room)
|-
|[[Room $1C|Room {{$|1C}}]]
|Ganon's Tower (Ice Armos)
|-
|[[Room $1D|Room {{$|1D}}]]
|Ganon's Tower (Final Hallway)
|-
|[[Room $1E|Room {{$|1E}}]]
|Ice Palace (Bomb Floor / Bari Room)
|-
|[[Room $1F|Room {{$|1F}}]]
|Ice Palace (Pengator / Big Key Room)
|-
|[[Room $20|Room {{$|20}}]]
|Agahnim's Tower (Agahnim[Boss])
|-
|[[Room $21|Room {{$|21}}]]
|Hyrule Castle (Key-rat Room)
|-
|[[Room $22|Room {{$|22}}]]
|Hyrule Castle (Sewer Text Trigger Room)
|-
|[[Room $23|Room {{$|23}}]]
|Turtle Rock (West Exit to Balcony)
|-
|[[Room $24|Room {{$|24}}]]
|Turtle Rock (Double Hokku-Bokku / Big chest Room)
|-
|[[Room $25|Room {{$|25}}]]
|Empty Clone Room
|-
|[[Room $26|Room {{$|26}}]]
|Swamp Palace (Statue Room)
|-
|[[Room $27|Room {{$|27}}]]
|Tower of Hera (Big Chest)
|-
|[[Room $28|Room {{$|28}}]]
|Swamp Palace (Entrance Room)
|-
|[[Room $29|Room {{$|29}}]]
|Skull Woods (Mothula[Boss])
|-
|[[Room $2A|Room {{$|2A}}]]
|Palace of Darkness (Big Hub Room)
|-
|[[Room $2B|Room {{$|2B}}]]
|Palace of Darkness (Map Chest / Fairy Room)
|-
|[[Room $2C|Room {{$|2C}}]]
|Cave
|-
|[[Room $2D|Room {{$|2D}}]]
|Empty Clone Room
|-
|[[Room $2E|Room {{$|2E}}]]
|Ice Palace (Compass Room)
|-
|[[Room $2F|Room {{$|2F}}]]
|Cave (Kakariko Well HP)
|-
|[[Room $30|Room {{$|30}}]]
|Agahnim's Tower (Maiden Sacrifice Chamber)
|-
|[[Room $31|Room {{$|31}}]]
|Tower of Hera (Hardhat Beetles Room)
|-
|[[Room $32|Room {{$|32}}]]
|Hyrule Castle (Sewer Key Chest Room)
|-
|[[Room $33|Room {{$|33}}]]
|Desert Palace (Lanmolas[Boss])
|-
|[[Room $34|Room {{$|34}}]]
|Swamp Palace (Push Block Puzzle / Pre-Big Key Room)
|-
|[[Room $35|Room {{$|35}}]]
|Swamp Palace (Big Key / BS Room)
|-
|[[Room $36|Room {{$|36}}]]
|Swamp Palace (Big Chest Room)
|-
|[[Room $37|Room {{$|37}}]]
|Swamp Palace (Map Chest / Water Fill Room)
|-
|[[Room $38|Room {{$|38}}]]
|Swamp Palace (Key Pot Room)
|-
|[[Room $39|Room {{$|39}}]]
|Skull Woods (Gibdo Key / Mothula Hole Room)
|-
|[[Room $3A|Room {{$|3A}}]]
|Palace of Darkness (Bombable Floor Room)
|-
|[[Room $3B|Room {{$|3B}}]]
|Palace of Darkness (Spike Block / Conveyor Room)
|-
|[[Room $3C|Room {{$|3C}}]]
|Cave
|-
|[[Room $3D|Room {{$|3D}}]]
|Ganon's Tower (Torch Room 2)
|-
|[[Room $3E|Room {{$|3E}}]]
|Ice Palace (Stalfos Knights / Conveyor Hellway)
|-
|[[Room $3F|Room {{$|3F}}]]
|Ice Palace (Map Chest Room)
|-
|[[Room $40|Room {{$|40}}]]
|Agahnim's Tower (Final Bridge Room)
|-
|[[Room $41|Room {{$|41}}]]
|Hyrule Castle (First Dark Room)
|-
|[[Room $42]]
|Hyrule Castle (6 Ropes Room)
|-
|[[Room $43]]
|Desert Palace (Torch Puzzle / Moving Wall Room)
|-
|[[Room $44]]
|Thieves Town (Big Chest Room)
|-
|[[Room $45]]
|Thieves Town (Jail Cells Room)
|-
|[[Room $46]]
|Swamp Palace (Compass Chest Room)
|-
|[[Room $47]]
|Empty Clone Room
|-
|[[Room $48]]
|Empty Clone Room
|-
|[[Room $49]]
|Skull Woods (Gibdo Torch Puzzle Room)
|-
|[[Room $4A]]
|Palace of Darkness (Entrance Room)
|-
|[[Room $4B]]
|Palace of Darkness (Warps / South Mimics Room)
|-
|[[Room $4C]]
|Ganon's Tower (Mini-Helmasaur Conveyor Room)
|-
|[[Room $4D]]
|Ganon's Tower (Moldorm Room)
|-
|[[Room $4E]]
|Ice Palace (Bomb-Jump Room)
|-
|[[Room $4F]]
|Ice Palace Clone Room (Fairy Room)
|-
|[[Room $50]]
|Hyrule Castle (West Corridor)
|-
|[[Room $51]]
|Hyrule Castle (Throne Room)
|-
|[[Room $52]]
|Hyrule Castle (East Corridor)
|-
|[[Room $53]]
|Desert Palace (Popos 2 / Beamos Hellway Room)
|-
|[[Room $54]]
|Swamp Palace (Upstairs Pits Room)
|-
|[[Room $55]]
|Castle Secret Entrance / Uncle Death Room
|-
|[[Room $56]]
|Skull Woods (Key Pot / Trap Room)
|-
|[[Room $57]]
|Skull Woods (Big Key Room)
|-
|[[Room $58]]
|Skull Woods (Big Chest Room)
|-
|[[Room $59]]
|Skull Woods (Final Section Entrance Room)
|-
|[[Room $5A]]
|Palace of Darkness (Helmasaur King[Boss])
|-
|[[Room $5B]]
|Ganon's Tower (Spike Pit Room)
|-
|[[Room $5C]]
|Ganon's Tower (Ganon-Ball Z)
|-
|[[Room $5D]]
|Ganon's Tower (Gauntlet 1/2/3)
|-
|[[Room $5E]]
|Ice Palace (Lonely Firebar)
|-
|[[Room $5F]]
|Ice Palace (Hidden Chest / Spike Floor Room)
|-
|[[Room $60]]
|Hyrule Castle (West Entrance Room)
|-
|[[Room $61]]
|Hyrule Castle (Main Entrance Room)
|-
|[[Room $62]]
|Hyrule Castle (East Entrance Room)
|-
|[[Room $63]]
|Desert Palace (Final Section Entrance Room)
|-
|[[Room $64]]
|Thieves Town (West Attic Room)
|-
|[[Room $65]]
|Thieves Town (East Attic Room)
|-
|[[Room $66]]
|Swamp Palace (Hidden Chest / Hidden Door Room)
|-
|[[Room $67]]
|Skull Woods (Compass Chest Room)
|-
|[[Room $68]]
|Skull Woods (Key Chest / Trap Room)
|-
|[[Room $69]]
|Empty Clone Room
|-
|[[Room $6A]]
|Palace of Darkness (Rupee Room)
|-
|[[Room $6B]]
|Ganon's Tower (Mimics Rooms)
|-
|[[Room $6C]]
|Ganon's Tower (Lanmolas Room)
|-
|[[Room $6D]]
|Ganon's Tower (Gauntlet 4/5)
|-
|[[Room $6E]]
|Ice Palace (Pengators Room)
|-
|[[Room $6F]]
|Empty Clone Room
|-
|[[Room $70]]
|Hyrule Castle (Small Corridor to Jail Cells)
|-
|[[Room $71]]
|Hyrule Castle (Boomerang Chest Room)
|-
|[[Room $72]]
|Hyrule Castle (Map Chest Room)
|-
|[[Room $73]]
|Desert Palace (Big Chest Room)
|-
|[[Room $74]]
|Desert Palace (Map Chest Room)
|-
|[[Room $75]]
|Desert Palace (Big Key Chest Room)
|-
|[[Room $76]]
|Swamp Palace (Water Drain Room)
|-
|[[Room $77]]
|Tower of Hera (Entrance Room)
|-
|[[Room $78]]
|Empty Clone Room
|-
|[[Room $79]]
|Empty Clone Room
|-
|[[Room $7A]]
|Empty Clone Room
|-
|[[Room $7B]]
|Ganon's Tower
|-
|[[Room $7C]]
|Ganon's Tower (East Side Collapsing Bridge / Exploding Wall Room)
|-
|[[Room $7D]]
|Ganon's Tower (Winder / Warp Maze Room)
|-
|[[Room $7E]]
|Ice Palace (Hidden Chest / Bombable Floor Room)
|-
|[[Room $7F]]
|Ice Palace ( Big Spike Traps Room)
|-
|[[Room $80]]
|Hyrule Castle (Jail Cell Room)
|-
|[[Room $81]]
|Hyrule Castle
|-
|[[Room $82]]
|Hyrule Castle (Basement Chasm Room)
|-
|[[Room $83]]
|Desert Palace (West Entrance Room)
|-
|[[Room $84]]
|Desert Palace (Main Entrance Room)
|-
|[[Room $85]]
|Desert Palace (East Entrance Room)
|-
|[[Room $86]]
|Empty Clone Room
|-
|[[Room $87]]
|Tower of Hera (Tile Room)
|-
|[[Room $88]]
|Empty Clone Room
|-
|[[Room $89]]
|Eastern Palace (Fairy Room)
|-
|[[Room $8A]]
|Empty Clone Room
|-
|[[Room $8B]]
|Ganon's Tower (Block Puzzle / Spike Skip / Map Chest Room)
|-
|[[Room $8C]]
|Ganon's Tower (East and West Downstairs / Big Chest Room)
|-
|[[Room $8D]]
|Ganon's Tower (Tile / Torch Puzzle Room)
|-
|[[Room $8E]]
|Ice Palace
|-
|[[Room $8F]]
|Empty Clone Room
|-
|[[Room $90]]
|Misery Mire (Vitreous[Boss])
|-
|[[Room $91]]
|Misery Mire (Final Switch Room)
|-
|[[Room $92]]
|Misery Mire (Dark Bomb Wall / Switches Room)
|-
|[[Room $93]]
|Misery Mire (Dark Cane Floor Switch Puzzle Room)
|-
|[[Room $94]]
|Empty Clone Room
|-
|[[Room $95]]
|Ganon's Tower (Final Collapsing Bridge Room)
|-
|[[Room $96]]
|Ganon's Tower (Torches 1 Room)
|-
|[[Room $97]]
|Misery Mire (Torch Puzzle / Moving Wall Room)
|-
|[[Room $98]]
|Misery Mire (Entrance Room)
|-
|[[Room $99]]
|Eastern Palace (Eyegore Key Room)
|-
|[[Room $9A]]
|Empty Clone Room
|-
|[[Room $9B]]
|Ganon's Tower (Many Spikes / Warp Maze Room)
|-
|[[Room $9C]]
|Ganon's Tower (Invisible Floor Maze Room)
|-
|[[Room $9D]]
|Ganon's Tower (Compass Chest / Invisible Floor Room)
|-
|[[Room $9E]]
|Ice Palace (Big Chest Room)
|-
|[[Room $9F]]
|Ice Palace
|-
|[[Room $A0]]
|Misery Mire (Pre-Vitreous Room)
|-
|[[Room $A1]]
|Misery Mire (Fish Room)
|-
|[[Room $A2]]
|Misery Mire (Bridge Key Chest Room)
|-
|[[Room $A3]]
|Misery Mire
|-
|[[Room $A4]]
|Turtle Rock (Trinexx[Boss])
|-
|[[Room $A5]]
|Ganon's Tower (Wizzrobes Rooms)
|-
|[[Room $A6]]
|Ganon's Tower (Moldorm Fall Room)
|-
|[[Room $A7]]
|Tower of Hera (Fairy Room)
|-
|[[Room $A8]]
|Eastern Palace (Stalfos Spawn Room)
|-
|[[Room $A9]]
|Eastern Palace (Big Chest Room)
|-
|[[Room $AA]]
|Eastern Palace (Map Chest Room)
|-
|[[Room $AB]]
|Thieves Town (Moving Spikes / Key Pot Room)
|-
|[[Room $AC]]
|Thieves Town (Blind The Thief[Boss])
|-
|[[Room $AD]]
|Empty Clone Room
|-
|[[Room $AE]]
|Ice Palace
|-
|[[Room $AF]]
|Ice Palace (Ice Bridge Room)
|-
|[[Room $B0]]
|Agahnim's Tower (Circle of Pots)
|-
|[[Room $B1]]
|Misery Mire (Hourglass Room)
|-
|[[Room $B2]]
|Misery Mire (Slug Room)
|-
|[[Room $B3]]
|Misery Mire (Spike Key Chest Room)
|-
|[[Room $B4]]
|Turtle Rock (Pre-Trinexx Room)
|-
|[[Room $B5]]
|Turtle Rock (Dark Maze)
|-
|[[Room $B6]]
|Turtle Rock (Chain Chomps Room)
|-
|[[Room $B7]]
|Turtle Rock (Map Chest / Key Chest / Roller Room)
|-
|[[Room $B8]]
|Eastern Palace (Big Key Room)
|-
|[[Room $B9]]
|Eastern Palace (Lobby Cannonballs Room)
|-
|[[Room $BA]]
|Eastern Palace (Dark Antifairy / Key Pot Room)
|-
|[[Room $BB]]
|Thieves Town (Hellway)
|-
|[[Room $BC]]
|Thieves Town (Conveyor Toilet)
|-
|[[Room $BD]]
|Empty Clone Room
|-
|[[Room $BE]]
|Ice Palace (Block Puzzle Room)
|-
|[[Room $BF]]
|Ice Palace Clone Room (Switch Room)
|-
|[[Room $C0]]
|Agahnim's Tower (Dark Bridge Room)
|-
|[[Room $C1]]
|Misery Mire (Compass Chest / Tile Room)
|-
|[[Room $C2]]
|Misery Mire (Big Hub Room)
|-
|[[Room $C3]]
|Misery Mire (Big Chest Room)
|-
|[[Room $C4]]
|Turtle Rock (Final Crystal Switch Puzzle Room)
|-
|[[Room $C5]]
|Turtle Rock (Laser Bridge)
|-
|[[Room $C6]]
|Turtle Rock
|-
|[[Room $C7]]
|Turtle Rock (Torch Puzzle)
|-
|[[Room $C8]]
|Eastern Palace (Armos Knights[Boss])
|-
|[[Room $C9]]
|Eastern Palace (Entrance Room)
|-
|[[Room $CA]]
|??
|-
|[[Room $CB]]
|Thieves Town (North West Entrance Room)
|-
|[[Room $CC]]
|Thieves Town (North East Entrance Room)
|-
|[[Room $CD]]
|Empty Clone Room
|-
|[[Room $CE]]
|Ice Palace (Hole to Kholdstare Room)
|-
|[[Room $CF]]
|Empty Clone Room
|-
|[[Room $D0]]
|Agahnim's Tower (Dark Maze)
|-
|[[Room $D1]]
|Misery Mire (Conveyor Slug / Big Key Room)
|-
|[[Room $D2]]
|Misery Mire (Mire02 / Wizzrobes Room)
|-
|[[Room $D3]]
|Empty Clone Room
|-
|[[Room $D4]]
|Empty Clone Room
|-
|[[Room $D5]]
|Turtle Rock (Laser Key Room)
|-
|[[Room $D6]]
|Turtle Rock (Entrance Room)
|-
|[[Room $D7]]
|Empty Clone Room
|-
|[[Room $D8]]
|Eastern Palace ("Zeldagamer Room" / Pre-Armos Knights Room)
|-
|[[Room $D9]]
|Eastern Palace (Canonball Room)
|-
|[[Room $DA]]
|Eastern Palace
|-
|[[Room $DB]]
|Thieves Town (Main (South West) Entrance Room)
|-
|[[Room $DC]]
|Thieves Town (South East Entrance Room)
|-
|[[Room $DD]]
|Empty Clone Room
|-
|[[Room $DE]]
|Ice Palace (Kholdstare[Boss])
|-
|[[Room $DF]]
|Cave
|-
|[[Room $E0]]
|Agahnim's Tower (Entrance Room)
|-
|[[Room $E1]]
|Cave (Lost Woods HP)
|-
|[[Room $E2]]
|Cave (Lumberjack's Tree HP)
|-
|[[Room $E3]]
|Cave (1/2 Magic)
|-
|[[Room $E4]]
|Cave (Lost Old Man Final Cave)
|-
|[[Room $E5]]
|Cave (Lost Old Man Final Cave)
|-
|[[Room $E6]]
|Cave
|-
|[[Room $E7]]
|Cave
|-
|[[Room $E8]]
|Cave
|-
|[[Room $E9]]
|Empty Clone Room
|-
|[[Room $EA]]
|Cave (Spectacle Rock HP)
|-
|[[Room $EB]]
|Cave
|-
|[[Room $EC]]
|Empty Clone Room
|-
|[[Room $ED]]
|Cave
|-
|[[Room $EE]]
|Cave (Spiral Cave)
|-
|[[Room $EF]]
|Cave (Crystal Switch / 5 Chests Room)
|-
|[[Room $F0]]
|Cave (Lost Old Man Starting Cave)
|-
|[[Room $F1]]
|Cave (Lost Old Man Starting Cave)
|-
|[[Room $F2]]
|House
|-
|[[Room $F3]]
|House (Old Woman (Sahasrahla's Wife?))
|-
|[[Room $F4]]
|House (Angry Brothers)
|-
|[[Room $F5]]
|House (Angry Brothers)
|-
|[[Room $F6]]
|Empty Clone Room
|-
|[[Room $F7]]
|Empty Clone Room
|-
|[[Room $F8]]
|Cave
|-
|[[Room $F9]]
|Cave
|-
|[[Room $FA]]
|Cave
|-
|[[Room $FB]]
|Cave
|-
|[[Room $FC]]
|Empty Clone Room
|-
|[[Room $FD]]
|Cave
|-
|[[Room $FE]]
|Cave
|-
|[[Room $FF]]
|Cave
|}

===Secondary Map===

{{toc}}

Underworld

2017-07-22T22:22:07Z

Tatters: /* (Inter Room) Torch Data */

The underworld refers to all indoor locations; including dungeons, caves, and houses.

==Important Hex Addresses==
===Room Data===
====Room Headers====
*{{$|027502}} to {{$|027781}} = Pointer Table, {{hex|2}} byte local addresses, indexed by room ID.
*{{$|027781}} to {{$|027FEF}} = Data

<blockquote>
Headers are {{$|0E}} (Decimal: 14) bytes formatted thusly:
*Byte {{hex|0}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
**The {{red|a}} bits are transformed into {{hex|0000 0}}{{red|aaa}} and stored to {{$|0414}} ("BG2" in Hyrule Magic)
**The {{blue|b}} bits are transformed into {{hex|0000 0}}{{blue|bbb}} and stored to {{$|046C}} ("Collision" in Hyrule Magic)
**The {{green|c}} bit is unused
**The {{purple|d}} bit is stored to {{$|7EC005}} (If set, use a lights out routine in the room transition)

*Byte {{hex|1}}: {{red|aa}}{{blue|bb bbbb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{blue|bbbb bb}}{{hex|00}}, thus making them a multiple of 4.
This value is used to load 4 different palettes for the dungeon, and corresponds to, you guessed it, Palette # in Hyrule Magic!

The resulting index is used to load values for {{$|0AB6}}, {{$|0AAC}}, {{$|0AAD}}, and {{$|0AAE}}

*Byte {{hex|2}}: gets stored to {{$|0AA2}} (GFX # in Hyrule Magic)
*Byte {{hex|3}}: value + #$40 gets stored to {{$|0AA3}} (Sprite GFX # in Hyrule Magic)
*Byte {{hex|4}}: gets stored to {{$|00AD}} ("[[Room Effects|Effect]]" in Hyrule Magic)
*Byte {{hex|5}}: gets stored to {{$|00AE}} ("[[Room Tags|Tag1]]" in Hyrule Magic)
*Byte {{hex|6}}: gets stored to {{$|00AF}} ("Tag2" in Hyrule Magic)

These are the planes to use for bytes {{hex|9}} through {{hex|D}}. This determines which
BG you appear on, and possibly more.

*Byte {{hex|7}}: {{red|aa}}{{blue|bb}} {{green|cc}}{{purple|dd}}
**The {{red|a}} bits are transformed into {{hex|0000 00}}{{red|aa}} and stored to {{$|063F}}
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|063E}}
**The {{green|c}} bits are transformed into {{hex|0000 00}}{{green|cc}} and stored to {{$|063D}}
**The {{purple|d}} bits are transformed into {{hex|0000 00}}{{purple|dd}} and stored to {{$|063C}}

Note, the only safe values for a plane seem to be {{hex|0}},{{hex|1}}, or {{hex|2}}. Hyrule Magic
appears to violate this rule by letting you put {{hex|3}} down, but nothing higher.

*Byte {{hex|8}}: {{red|aaaa aa}}{{blue|bb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|0640}}

*Byte {{hex|9}}: stored to {{$|7EC000}} These are all room numbers that you could possibly exit to.
*Byte {{hex|A}}: stored to {{$|7EC001}}
*Byte {{hex|B}}: stored to {{$|7EC002}}
*Byte {{hex|C}}: stored to {{$|7EC003}}
*Byte {{hex|D}}: stored to {{$|7EC004}}
</blockquote>

====Sprite Data====
* {{$|04D62E}} to {{$|04D92E}} = Pointer Table, 2 byte local addresses, indexed by room.
* {{$|04D92E}} to {{$|04EC9D}} = Data

<blockquote>
Sprite data is formatted thusly:
*Byte {{hex|0}}: Stored to {{$|0FB3}}. Corresponds with "Sort Spr" in Hyrule Magic. In a layered room this indicates sprites in the foreground are to be drawn on top of sprites in the background.
**Bit {{hex|0}} - If {{hex|0}}, sprites will sort
**Bits {{hex|7,6,5,4,3,2,1}} - Unknown, should all be {{hex|1}}
After the byte {{hex|0}}, you will see 3 byte clusters that break down thus:

*Byte {{hex|0}}:
**Bits {{hex|4,3,2,1,0}} - Y coordinate (in pixels from the top, starting at {{hex|0}}) of the sprite divided by 16.
**Bits {{hex|6,5}} - If these are set, they will be used to generate a subtype, stored to {{$|0E30}}, X.
**Bit {{hex|7}} - If set, the sprite is on BG2, if not it's on BG1
* Byte {{hex|1}}:
** Bits {{hex|4,3,2,1,0}} - X coordinate (in pixels from the far left, starting at {{hex|0}}) of the sprite divided by 16.
** Bits {{hex|7,6,5}} - If all these bits are set then this is an Overlord, otherwise it's a normal sprite. If only some of them are set they can be used to generate a subtype, stored at {{$|0E30}}, X
* Byte {{hex|2}}: Sprite or Overlord type. If a sprite, this will get loaded into a slot at {{$|0E20}}, X. If an Overlord, will get loaded to {{$|0B00}}, X.

The array is terminated with a byte of {{$|FF}}.
</blockquote>

====Object Data====
* {{$|0F8000}} to {{$|0F83BF}} = Pointer Table, 3 byte long addresses, indexed by room ID.
* {{$|01EBA0}} to {{$|01FFF4}} = Data
* {{$|050000}} to {{$|053729}} = Data
* {{$|0F8780}} to {{$|0FFF4D}} = Data
<blockquote>
Byte layout:

* Byte 0: {{red|aaaa}} {{blue|bbbb}}.
**The a bits are transformed to {{red|aaaa}}{{hex|0000}} and select the type of empty space to fill in. Hyrule Magic calls this 'Floor 1' - Gets stored to {{$|7E0490}}
**The b bits are transformed to {{blue|bbbb}}{{hex|0000}} and are the what Hyrule Magic calls 'Floor 2' - Gets stored to {{$|7E046A}}

* Byte {{hex|1}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
** The {{red|a}} bits are unused and should not be used
** The {{blue|b}} bits determine the room's layout type, ranging from {{hex|0}} to {{hex|7}}.
** The {{green|c}} and {{purple|d}} bits are unknown, but I have a feeling it's related to {{$|AA}} and {{$|A9}}

After that the bytes come in {{hex|3}} or {{hex|2}} byte object structures, used by routine {{$|01:88E4}}. Objects are loaded until an object with value {{0x|FFFF}} occurs. If a value {{0x|FFF0}} is loaded, the game will start loading Type 2 objects and will not go back to loading Type 1 objects until it is time to load the next layer. (Layer as in HM, not to be confused with the SNES' Backgrounds.) A value of {{0x|FFFF}} will also terminate the loading of Type 2 objects. The routine immediately terminates if that happens during the loading of either object type.

Type 1 Object structure: (3 bytes):

* Byte {{hex|3}}: Routine to use. If this byte is ≥ {{0x|F8}} and < {{0x|FC}}, then it is a subtype 3 object. If the index is ≥ {{hex|FC}}, it is a subtype 2 object. If not, it is a subtype 1 object.

* Subtype 1 Objects, first and second byte
** High Byte: {{brown|yyyy yy}}{{green|cc}}
** Low Byte: {{grey|xxxx xx}}{{red|aa}}
*** The {{red|a}} bits are stored to {{$|B2}}
*** The {{green|c}} bits are stored to {{$|B4}}
*** The {{grey|x}} and {{brown|y}} bits are transformed into: {{hex|000}}{{brown|y yyyy y}}{{grey|xxx xxx}}{{hex|0}} - This is a tilemap address that indexes into {{$|7E2000}} and / or {{$|7E4000}}

Use Byte {{hex|3}} * 2 as an index into the table at {{$|8200}}. This is the routine that is used to draw and otherwise handle the object. Subtype 1 objects have a maximum width and height of 4. Width and height are measured in terms of 32 {{x}} 32 pixels. (⟸ last part is questionable)

*Subtype 2 Objects, 1st, 2nd, & 3rd bytes:
** Byte {{hex|3}}: {{white|ff}}{{purple|dd dddd}}
** Byte {{hex|2}}: {{pink|eeee}} {{green|cccc}}
** Byte {{hex|1}}: {{red|aaaa aa}}{{blue|bb}}
***The {{red|a}} bits are unused, but after all they are the marker for this type of object subtype.
***The {{blue|b}}, {{green|c}}, {{pink|e}}, and {{white|f}} bits are transformed into a VRAM tilemap address: {{hex|000}}{{green|c ccc}}{{white|f}} {{white|f}}{{blue|bb}}{{pink|e eee}}{{hex|0}}

Might I add this is one messed up format? The {{purple|d}} bits are used as an index into the table at {{$|8470}}. Since such indices are going to be even, the {{purple|d}} bits are transformed into: {{hex|0000 0000 0}}{{purple|ddd ddd}}{{hex|0}}.

*Subtype 3 Objects
**Similar to Subtype 1, with a few small exceptions.
**The vram address is calculated the same way. However, {{$|B2}} and {{$|B4}} are not used as length or width dimensions here. The routine that is used is determined as follows:
**Take the original index (times two) that a Subtype 1 would have used. AND that with {{0x|000E}}. Then shift left 3 times to produce {{hex|0000 0000 0}}{{pink|eee}} {{hex|0000}}. Then, OR in {{$|B2}} and {{$|B4}} and shift left once, so the final result is: {{hex|0000 0000}} {{pink|eee}}{{red|a a}}{{blue|bb}}{{hex|0}}.
**Also, this value indexes into {{$|85F0}} instead of {{$|8200}}.

Type 2 Object Structure: (2 bytes)
*High Byte: {{green|cccc cccc}}
*Low Byte: {{blue|bbbb}} {{purple|dd}}{{red|aa}}
**The {{red|a}} bits form a 2-bit value ({{hex|0000 0}}{{red|aa}}{{hex|0}}) that determines the routine to use for the object. In Hyrule Magic, corresponds to the "direction" of the door.
**The {{blue|b}} bits are transformed into {{hex|000}}{{blue|b bbb}}{{hex|0}} and stored to {{$|02}} ⟹ X. Corresponds to "Pos" of door objects in the Hyrule Magic. Note that these range from {{0x|00}} to {{0x|16}} (always even) which if you halve those values is 0 - 11 in decimal. This is easily verifiable in Hyrule Magic.
**The {{green|c}} bits are shifted into the lower byte and stored to {{$|04}} ⟹ A and {{$|0A}}. This is later used to grab the tiles used to draw the door and the area below it. In Hyrule Magic, corresponds to "type". Note the type is 1/2 of the number listed here. This is because to avoid using an ASL A command, the {{green|c}} bits are always even.
**The {{purple|d}} bits are unused.

Next I'll go into the nitty gritty of the various types (the value of {{$|04}}). Again note that we'll only be dealing with even values {{blue|b}}/{{green|c}} that's what you'll see in the code. To convert between here [as well as the code] and Hyrule Magic, take the hex value here and divide by two. Convert to decimal and that's your Hyrule Magic "type."

*Types:
{|{{Prettytable}}
! ID
! Description
|-
|{{0x|00}}
|Basic door. Index = {{$|0460}}
|-
|{{0x|02}}
|Normal door?
|-
|{{0x|04}}
|???
|-
|{{0x|06}}
|???
|-
|{{0x|08}}
|Waterfall door (only used in Swamp palace; in one room at that!)
|-
|{{0x|0A}}
|???
|-
|{{0x|0C}}
|Trap door (probably other types but this seems to be most common)
|-
|{{0x|12}}
|Adds a property to some doors allowing you to exit to the overworld (this is accomplished by writing to the tile attribute map)
|-
|{{0x|14}}
|Transition to dark room?
|-
|{{0x|16}}
|Toggles the target BG Link will emerge on. '''Ex.''' if Link starts on BG0 in the next room he'll be on BG1.
|-
|{{0x|20}}
| rowspan="2"|Locked door specifically for BG0.
|-
|{{0x|22}}
|-
|{{0x|24}}
| rowspan="2"|Locked door for either BG0 or BG1
|-
|{{0x|26}}
|-
|{{0x|30}}
|Large exploded pathway resulting from a switch being pulled (unusual to have as a door as it's huge)
|-
|{{0x|32}}
|Sword activated door. '''Ex.''' Agahnim's room with the curtain door you have to slash.
|-
|{{0x|46}}
|warp door?
|}
</blockquote>

====Dungeon Secrets Data====
* {{$|00DB69}} to {{$|00DDE8}} = Pointer Table, 2 byte local addresses, indexed by room ID.
* {{$|00DDE9}} to {{$|00E6B1}} = Data
<blockquote>
Data comes in 3 byte chunks and is terminated by an instance of {{$|FFFF}}

* Bytes {{hex|0}}, {{hex|1}}: A word that denotes the VRAM address that the item is found at. This identifies the item as belonging to that part of the screen.
* Byte {{hex|2}}: Identifies the type of item that is hiding there. E.g. {{$|08}} is a key
</blockquote>

====Push Block Data====
* {{$|0271DE}} to {{$|027369}} = Data
<Blockquote>
4 bytes per entry:
{{red|a a }}{{blue|x }} {{green|y}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the block (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the block (expressed as tilemap coordinate)
</blockquote>

====(Inter Room) Torch Data====
* {{$|02736A}} to {{$|027489}} = Data
<Blockquote>
Consists of variable length segments consisting of:
{{red|a a }}{{blue|x }}{{green|y }}{{blue|x }}{{green|y }}{{hex|... }}{{$|FFFF}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the torch (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the torch (expressed as tilemap coordinate)
*{{$|FFFF}}: Delimeter
</blockquote>

====Chest Contents====
*{{$|00E96E}} to {{$|00EB65}} = Data
<blockquote>
Array of chest information in 3 byte chunks. 168 entries in all ({{0x|A8}})

*First word - Room number it is located in. MSB determines whether it is a big chest or not. (big chest if set)
*Last byte - index of the type of item contained in the chest.
</blockquote>

===Entrance Data===
There are {{$|85}} (Decimal: 133) normal entrances to the underworld from the overworld, and {{$|7}} (Decimal: 7) starting locations.
Normal entrances and starting locations use mostly the same types of data formatted the same, however they are located in different places in the ROM.
They are located and formatted thus:

====Entrance Room====
*{{$|014813}} to {{$|01491C}} = Normal Entrance Data
*{{$|015B6E}} to {{$|015B7B}} = Starting Location Data
<blockquote>
Each entry is a 2 byte Room ID where the player is placed after using an entrance.
</blockquote>

====Scroll Edges====
*{{$|01491D}} to {{$|014D44}} = Normal Entrance Data
*{{$|015B7C}} to {{$|015BB3}} = Starting Location Data
<blockquote>
Unsure about what these do exactly.
Each entry is 8 bytes long.
*Format: 1 byte each. Corresponds to hyrule magic values in the "More" aka Entrance Properties dialog box.
**HU -
**FU -
**HD -
**FD -
**HL -
**FL -
**HR -
**FR -
</blockquote>

====X Scroll====
*{{$|014D45}} to {{$|014E4E}} = Normal Entrance Data
*{{$|015BB4}} to {{$|015BC1}} = Starting Location Data
<blockquote>

</blockquote>

====Y Scroll====
*{{$|014E4F}} to {{$|014F58}} = Normal Entrance Data
*{{$|015BC2}} to {{$|015BCF}} = Starting Location Data
<blockquote>

</blockquote>

====X Coordinate====
*{{$|014F59}} to {{$|015062}} = Normal Entrance Data
*{{$|015BD0}} to {{$|015BDD}} = Starting Location Data
<blockquote>
Each entry is a 2 byte X coordinate where the player starts after using the corresponding entrance.
</blockquote>

====Y Coordinate====
*{{$|015063}} to {{$|01516C}} = Normal Entrance Data
*{{$|015BDE}} to {{$|015BEB}} = Starting Location Data
<blockquote>
Each entry is a 2 byte y coordinate where the player starts after using the corresponding entrance.
</blockquote>

====X Camera Coordinate====
*{{$|01516D}} to {{$|015276}} = Normal Entrance Data
*{{$|015BEC}} to {{$|015BF9}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

====Y Camera Coordinate====
*{{$|015277}} to {{$|015380}} = Normal Entrance Data
*{{$|015BFA}} to {{$|015C07}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

====Entrance Blockset====
*{{$|015381}} to {{$|015405}} = Normal Entrance Data
*{{$|015C08}} to {{$|015C0E}} = Starting Location Data
<blockquote>
1 byte each. This blockset affects walls and a few other things and persists through all rooms the player accesses from this entrance.
</blockquote>

====Floor Values====
*{{$|015406}} to {{$|01548A}} = Normal Entrance Data
*{{$|015C0F}} to {{$|015C15}} = Starting Location Data
<blockquote>
This tells us what kind of properties the floor has. 1 byte each:
*If 1, then it has floors that you can fall through to the next level
*If 0, I think it means it can be fallen down to
*If -1, has no pits
*If -2, ????
</blockquote>

====Dungeon Values====
*{{$|01548B}} to {{$|01550F}} = Normal Entrance Data
*{{$|015C16}} to {{$|015C1C}} = Starting Location Data
<blockquote>
1 Byte each.
Dungeons actually in the game are numbered like so {{$|00}}, {{$|02}}, {{$|04}}, ..., {{$|18}}, {{$|1A}}.
{{$|1C}} and {{$|1E}} are unused (and hence could potentially be added.) Notice they are all even numbers.
In asm routines these values are divided by two sometimes to provide an index into other arrays.
That's why. The definition of a "dungeon" is something with a key, compass, and map.

A value of {{$|FF}} (-1) denotes it doesn't belong to a dungeon.
</blockquote>

====Doorway Type====
*{{$|015510}} to {{$|015594}} = Normal Entrance Data
*{{$|015C2B}} to {{$|015C31}} = Starting Location Data
<blockquote>
This is used only when you exit the given room. For example, let's say you enter through a skull doorway in Skullwoods.
But that's not really a door way, it's just a set of tiles that are no different from a hole you might create after picking
up a big rock. But if you entered from a building door, the game has to know whether to put the door frame when you exit.
*1 byte:
**{{hex|0}} = no doorway when exiting
**{{hex|1}} = draws a door frame upon exiting
**{{hex|2}} = ???? HM says vertical doorframe. But in the original game, no doorway is vertical.

</blockquote>

====Ladder And BG Settings====
*{{$|015595}} to {{$|015619}} = Normal Entrance Data
*{{$|015C1D}} to {{$|015C23}} = Starting Location Data
<blockquote>
*1 byte each, with the following 2 bit layout: {{hex|xxx}}{{red|a}}{{pink|xxx}}{{blue|b}}
**{{hex|x}} - unimportant
**{{red|a}} - if set, then Link enters on the lower level (BG2)
**{{blue|b}} - if set... not sure what happens exactly. Check the game engine to be sure.
</blockquote>

====Horizontal And Vertical Scroll Properties====
*{{$|01561A}} to {{$|01569E}} = Normal Entrance Data
*{{$|015C24}} to {{$|015C2A}} = Starting Location Data
<blockquote>
For these, I guess if the flags in the appropriate places are set, then the room will be able to scroll in those directions.

*1 byte each, with the following layout: {{hex|xx}}{{red|a}}{{hex|xxx}}{{blue|b}}{{hex|x}}
**{{red|a}} - Horizontal flag
**{{blue|b}} - Vertical flag
</blockquote>

====Scroll Quadrant====
*{{$|01569F}} to {{$|015723}} = Normal Entrance Data
<blockquote>
*1 byte each, has four different expected values:
**0h, 2h, 10h, 12h
</blockquote>

====Exit Door Location====
*{{$|015724}} to {{$|01582D}} = Normal Entrance Data
*{{$|015C32}} to {{$|015C3F}} = Starting Location Data
<blockquote>
1 word each. Denotes X and Y coordinates for overworld?
</blockquote>

====Music====
*{{$|01582E}} to {{$|0158B2}} = Normal Entrance Data (JP: 15592 - 15616)
*{{$|015C4E}} to {{$|015C54}} = Starting Location Data
<blockquote>
1 byte each. A value of {{$|FF}} plays the same music as the overworld screen from which the player entered.
</blockquote>

====Entrance Values====
*{{$|015C40}} to {{$|015C4D}} = Starting Location Data
<blockquote>
1 word each. Since the starting locations have to reference an entrance, this is necessary.
</blockquote>

==Rooms==
Tiles on the underworld maps are referred to as "super-rooms" and can contain 1-4 "sub-rooms."

===Primary Map===
The primary underworld map consists of {{$|FF}} (decimal: 256) super-rooms arranged in a {{$|10}} {{x}} {{$|10}} (decimal: 16 {{x}} 16) square.

{|{{Prettytable}}
! ID
! Description
|-
|[[Room $00|Room {{$|00}}]]
|Ganon
|-
|[[Room $01|Room {{$|01}}]]
|Hyrule Castle (North Corridor)
|-
|[[Room $02|Room {{$|02}}]]
|Hyrule Castle (Switch Room)
|-
|[[Room $03|Room {{$|03}}]]
|Houlihan Room
|-
|[[Room $04|Room {{$|04}}]]
|Turtle Rock (Crysta-roller Room)
|-
|[[Room $05|Room {{$|05}}]]
|Empty Clone Room
|-
|[[Room $06|Room {{$|06}}]]
|Swamp Palace (Arrghus[Boss])
|-
|[[Room $07|Room {{$|07}}]]
|Tower of Hera (Moldorm[Boss])
|-
|[[Room $08|Room {{$|08}}]]
|Cave (Healing Fairy)
|-
|[[Room $09|Room {{$|09}}]]
|Palace of Darkness
|-
|[[Room $0A|Room {{$|0A}}]]
|Palace of Darkness (Stalfos Trap Room)
|-
|[[Room $0B|Room {{$|0B}}]]
|Palace of Darkness (Turtle Room)
|-
|[[Room $0C|Room {{$|0C}}]]
|Ganon's Tower (Entrance Room)
|-
|[[Room $0D|Room {{$|0D}}]]
|Ganon's Tower (Agahnim2[Boss])
|-
|[[Room $0E|Room {{$|0E}}]]
|Ice Palace (Entrance Room)
|-
|[[Room $0F|Room {{$|0F}}]]
|Empty Clone Room
|-
|[[Room $10|Room {{$|10}}]]
|Ganon Evacuation Route
|-
|[[Room $11|Room {{$|11}}]]
|Hyrule Castle (Bombable Stock Room)
|-
|[[Room $12|Room {{$|12}}]]
|Sanctuary
|-
|[[Room $13|Room {{$|13}}]]
|Turtle Rock (Hokku-Bokku Key Room 2)
|-
|[[Room $14|Room {{$|14}}]]
|Turtle Rock (Big Key Room)
|-
|[[Room $15|Room {{$|15}}]]
|Turtle Rock
|-
|[[Room $16|Room {{$|16}}]]
|Swamp Palace (Swimming Treadmill)
|-
|[[Room $17|Room {{$|17}}]]
|Tower of Hera (Moldorm Fall Room)
|-
|[[Room $18|Room {{$|18}}]]
|Cave
|-
|[[Room $19|Room {{$|19}}]]
|Palace of Darkness (Dark Maze)
|-
|[[Room $1A|Room {{$|1A}}]]
|Palace of Darkness (Big Chest Room)
|-
|[[Room $1B|Room {{$|1B}}]]
|Palace of Darkness (Mimics / Moving Wall Room)
|-
|[[Room $1C|Room {{$|1C}}]]
|Ganon's Tower (Ice Armos)
|-
|[[Room $1D|Room {{$|1D}}]]
|Ganon's Tower (Final Hallway)
|-
|[[Room $1E|Room {{$|1E}}]]
|Ice Palace (Bomb Floor / Bari Room)
|-
|[[Room $1F|Room {{$|1F}}]]
|Ice Palace (Pengator / Big Key Room)
|-
|[[Room $20|Room {{$|20}}]]
|Agahnim's Tower (Agahnim[Boss])
|-
|[[Room $21|Room {{$|21}}]]
|Hyrule Castle (Key-rat Room)
|-
|[[Room $22|Room {{$|22}}]]
|Hyrule Castle (Sewer Text Trigger Room)
|-
|[[Room $23|Room {{$|23}}]]
|Turtle Rock (West Exit to Balcony)
|-
|[[Room $24|Room {{$|24}}]]
|Turtle Rock (Double Hokku-Bokku / Big chest Room)
|-
|[[Room $25|Room {{$|25}}]]
|Empty Clone Room
|-
|[[Room $26|Room {{$|26}}]]
|Swamp Palace (Statue Room)
|-
|[[Room $27|Room {{$|27}}]]
|Tower of Hera (Big Chest)
|-
|[[Room $28|Room {{$|28}}]]
|Swamp Palace (Entrance Room)
|-
|[[Room $29|Room {{$|29}}]]
|Skull Woods (Mothula[Boss])
|-
|[[Room $2A|Room {{$|2A}}]]
|Palace of Darkness (Big Hub Room)
|-
|[[Room $2B|Room {{$|2B}}]]
|Palace of Darkness (Map Chest / Fairy Room)
|-
|[[Room $2C|Room {{$|2C}}]]
|Cave
|-
|[[Room $2D|Room {{$|2D}}]]
|Empty Clone Room
|-
|[[Room $2E|Room {{$|2E}}]]
|Ice Palace (Compass Room)
|-
|[[Room $2F|Room {{$|2F}}]]
|Cave (Kakariko Well HP)
|-
|[[Room $30|Room {{$|30}}]]
|Agahnim's Tower (Maiden Sacrifice Chamber)
|-
|[[Room $31|Room {{$|31}}]]
|Tower of Hera (Hardhat Beetles Room)
|-
|[[Room $32|Room {{$|32}}]]
|Hyrule Castle (Sewer Key Chest Room)
|-
|[[Room $33|Room {{$|33}}]]
|Desert Palace (Lanmolas[Boss])
|-
|[[Room $34|Room {{$|34}}]]
|Swamp Palace (Push Block Puzzle / Pre-Big Key Room)
|-
|[[Room $35|Room {{$|35}}]]
|Swamp Palace (Big Key / BS Room)
|-
|[[Room $36|Room {{$|36}}]]
|Swamp Palace (Big Chest Room)
|-
|[[Room $37|Room {{$|37}}]]
|Swamp Palace (Map Chest / Water Fill Room)
|-
|[[Room $38|Room {{$|38}}]]
|Swamp Palace (Key Pot Room)
|-
|[[Room $39|Room {{$|39}}]]
|Skull Woods (Gibdo Key / Mothula Hole Room)
|-
|[[Room $3A|Room {{$|3A}}]]
|Palace of Darkness (Bombable Floor Room)
|-
|[[Room $3B|Room {{$|3B}}]]
|Palace of Darkness (Spike Block / Conveyor Room)
|-
|[[Room $3C|Room {{$|3C}}]]
|Cave
|-
|[[Room $3D|Room {{$|3D}}]]
|Ganon's Tower (Torch Room 2)
|-
|[[Room $3E|Room {{$|3E}}]]
|Ice Palace (Stalfos Knights / Conveyor Hellway)
|-
|[[Room $3F|Room {{$|3F}}]]
|Ice Palace (Map Chest Room)
|-
|[[Room $40|Room {{$|40}}]]
|Agahnim's Tower (Final Bridge Room)
|-
|[[Room $41|Room {{$|41}}]]
|Hyrule Castle (First Dark Room)
|-
|[[Room $42]]
|Hyrule Castle (6 Ropes Room)
|-
|[[Room $43]]
|Desert Palace (Torch Puzzle / Moving Wall Room)
|-
|[[Room $44]]
|Thieves Town (Big Chest Room)
|-
|[[Room $45]]
|Thieves Town (Jail Cells Room)
|-
|[[Room $46]]
|Swamp Palace (Compass Chest Room)
|-
|[[Room $47]]
|Empty Clone Room
|-
|[[Room $48]]
|Empty Clone Room
|-
|[[Room $49]]
|Skull Woods (Gibdo Torch Puzzle Room)
|-
|[[Room $4A]]
|Palace of Darkness (Entrance Room)
|-
|[[Room $4B]]
|Palace of Darkness (Warps / South Mimics Room)
|-
|[[Room $4C]]
|Ganon's Tower (Mini-Helmasaur Conveyor Room)
|-
|[[Room $4D]]
|Ganon's Tower (Moldorm Room)
|-
|[[Room $4E]]
|Ice Palace (Bomb-Jump Room)
|-
|[[Room $4F]]
|Ice Palace Clone Room (Fairy Room)
|-
|[[Room $50]]
|Hyrule Castle (West Corridor)
|-
|[[Room $51]]
|Hyrule Castle (Throne Room)
|-
|[[Room $52]]
|Hyrule Castle (East Corridor)
|-
|[[Room $53]]
|Desert Palace (Popos 2 / Beamos Hellway Room)
|-
|[[Room $54]]
|Swamp Palace (Upstairs Pits Room)
|-
|[[Room $55]]
|Castle Secret Entrance / Uncle Death Room
|-
|[[Room $56]]
|Skull Woods (Key Pot / Trap Room)
|-
|[[Room $57]]
|Skull Woods (Big Key Room)
|-
|[[Room $58]]
|Skull Woods (Big Chest Room)
|-
|[[Room $59]]
|Skull Woods (Final Section Entrance Room)
|-
|[[Room $5A]]
|Palace of Darkness (Helmasaur King[Boss])
|-
|[[Room $5B]]
|Ganon's Tower (Spike Pit Room)
|-
|[[Room $5C]]
|Ganon's Tower (Ganon-Ball Z)
|-
|[[Room $5D]]
|Ganon's Tower (Gauntlet 1/2/3)
|-
|[[Room $5E]]
|Ice Palace (Lonely Firebar)
|-
|[[Room $5F]]
|Ice Palace (Hidden Chest / Spike Floor Room)
|-
|[[Room $60]]
|Hyrule Castle (West Entrance Room)
|-
|[[Room $61]]
|Hyrule Castle (Main Entrance Room)
|-
|[[Room $62]]
|Hyrule Castle (East Entrance Room)
|-
|[[Room $63]]
|Desert Palace (Final Section Entrance Room)
|-
|[[Room $64]]
|Thieves Town (West Attic Room)
|-
|[[Room $65]]
|Thieves Town (East Attic Room)
|-
|[[Room $66]]
|Swamp Palace (Hidden Chest / Hidden Door Room)
|-
|[[Room $67]]
|Skull Woods (Compass Chest Room)
|-
|[[Room $68]]
|Skull Woods (Key Chest / Trap Room)
|-
|[[Room $69]]
|Empty Clone Room
|-
|[[Room $6A]]
|Palace of Darkness (Rupee Room)
|-
|[[Room $6B]]
|Ganon's Tower (Mimics Rooms)
|-
|[[Room $6C]]
|Ganon's Tower (Lanmolas Room)
|-
|[[Room $6D]]
|Ganon's Tower (Gauntlet 4/5)
|-
|[[Room $6E]]
|Ice Palace (Pengators Room)
|-
|[[Room $6F]]
|Empty Clone Room
|-
|[[Room $70]]
|Hyrule Castle (Small Corridor to Jail Cells)
|-
|[[Room $71]]
|Hyrule Castle (Boomerang Chest Room)
|-
|[[Room $72]]
|Hyrule Castle (Map Chest Room)
|-
|[[Room $73]]
|Desert Palace (Big Chest Room)
|-
|[[Room $74]]
|Desert Palace (Map Chest Room)
|-
|[[Room $75]]
|Desert Palace (Big Key Chest Room)
|-
|[[Room $76]]
|Swamp Palace (Water Drain Room)
|-
|[[Room $77]]
|Tower of Hera (Entrance Room)
|-
|[[Room $78]]
|Empty Clone Room
|-
|[[Room $79]]
|Empty Clone Room
|-
|[[Room $7A]]
|Empty Clone Room
|-
|[[Room $7B]]
|Ganon's Tower
|-
|[[Room $7C]]
|Ganon's Tower (East Side Collapsing Bridge / Exploding Wall Room)
|-
|[[Room $7D]]
|Ganon's Tower (Winder / Warp Maze Room)
|-
|[[Room $7E]]
|Ice Palace (Hidden Chest / Bombable Floor Room)
|-
|[[Room $7F]]
|Ice Palace ( Big Spike Traps Room)
|-
|[[Room $80]]
|Hyrule Castle (Jail Cell Room)
|-
|[[Room $81]]
|Hyrule Castle
|-
|[[Room $82]]
|Hyrule Castle (Basement Chasm Room)
|-
|[[Room $83]]
|Desert Palace (West Entrance Room)
|-
|[[Room $84]]
|Desert Palace (Main Entrance Room)
|-
|[[Room $85]]
|Desert Palace (East Entrance Room)
|-
|[[Room $86]]
|Empty Clone Room
|-
|[[Room $87]]
|Tower of Hera (Tile Room)
|-
|[[Room $88]]
|Empty Clone Room
|-
|[[Room $89]]
|Eastern Palace (Fairy Room)
|-
|[[Room $8A]]
|Empty Clone Room
|-
|[[Room $8B]]
|Ganon's Tower (Block Puzzle / Spike Skip / Map Chest Room)
|-
|[[Room $8C]]
|Ganon's Tower (East and West Downstairs / Big Chest Room)
|-
|[[Room $8D]]
|Ganon's Tower (Tile / Torch Puzzle Room)
|-
|[[Room $8E]]
|Ice Palace
|-
|[[Room $8F]]
|Empty Clone Room
|-
|[[Room $90]]
|Misery Mire (Vitreous[Boss])
|-
|[[Room $91]]
|Misery Mire (Final Switch Room)
|-
|[[Room $92]]
|Misery Mire (Dark Bomb Wall / Switches Room)
|-
|[[Room $93]]
|Misery Mire (Dark Cane Floor Switch Puzzle Room)
|-
|[[Room $94]]
|Empty Clone Room
|-
|[[Room $95]]
|Ganon's Tower (Final Collapsing Bridge Room)
|-
|[[Room $96]]
|Ganon's Tower (Torches 1 Room)
|-
|[[Room $97]]
|Misery Mire (Torch Puzzle / Moving Wall Room)
|-
|[[Room $98]]
|Misery Mire (Entrance Room)
|-
|[[Room $99]]
|Eastern Palace (Eyegore Key Room)
|-
|[[Room $9A]]
|Empty Clone Room
|-
|[[Room $9B]]
|Ganon's Tower (Many Spikes / Warp Maze Room)
|-
|[[Room $9C]]
|Ganon's Tower (Invisible Floor Maze Room)
|-
|[[Room $9D]]
|Ganon's Tower (Compass Chest / Invisible Floor Room)
|-
|[[Room $9E]]
|Ice Palace (Big Chest Room)
|-
|[[Room $9F]]
|Ice Palace
|-
|[[Room $A0]]
|Misery Mire (Pre-Vitreous Room)
|-
|[[Room $A1]]
|Misery Mire (Fish Room)
|-
|[[Room $A2]]
|Misery Mire (Bridge Key Chest Room)
|-
|[[Room $A3]]
|Misery Mire
|-
|[[Room $A4]]
|Turtle Rock (Trinexx[Boss])
|-
|[[Room $A5]]
|Ganon's Tower (Wizzrobes Rooms)
|-
|[[Room $A6]]
|Ganon's Tower (Moldorm Fall Room)
|-
|[[Room $A7]]
|Tower of Hera (Fairy Room)
|-
|[[Room $A8]]
|Eastern Palace (Stalfos Spawn Room)
|-
|[[Room $A9]]
|Eastern Palace (Big Chest Room)
|-
|[[Room $AA]]
|Eastern Palace (Map Chest Room)
|-
|[[Room $AB]]
|Thieves Town (Moving Spikes / Key Pot Room)
|-
|[[Room $AC]]
|Thieves Town (Blind The Thief[Boss])
|-
|[[Room $AD]]
|Empty Clone Room
|-
|[[Room $AE]]
|Ice Palace
|-
|[[Room $AF]]
|Ice Palace (Ice Bridge Room)
|-
|[[Room $B0]]
|Agahnim's Tower (Circle of Pots)
|-
|[[Room $B1]]
|Misery Mire (Hourglass Room)
|-
|[[Room $B2]]
|Misery Mire (Slug Room)
|-
|[[Room $B3]]
|Misery Mire (Spike Key Chest Room)
|-
|[[Room $B4]]
|Turtle Rock (Pre-Trinexx Room)
|-
|[[Room $B5]]
|Turtle Rock (Dark Maze)
|-
|[[Room $B6]]
|Turtle Rock (Chain Chomps Room)
|-
|[[Room $B7]]
|Turtle Rock (Map Chest / Key Chest / Roller Room)
|-
|[[Room $B8]]
|Eastern Palace (Big Key Room)
|-
|[[Room $B9]]
|Eastern Palace (Lobby Cannonballs Room)
|-
|[[Room $BA]]
|Eastern Palace (Dark Antifairy / Key Pot Room)
|-
|[[Room $BB]]
|Thieves Town (Hellway)
|-
|[[Room $BC]]
|Thieves Town (Conveyor Toilet)
|-
|[[Room $BD]]
|Empty Clone Room
|-
|[[Room $BE]]
|Ice Palace (Block Puzzle Room)
|-
|[[Room $BF]]
|Ice Palace Clone Room (Switch Room)
|-
|[[Room $C0]]
|Agahnim's Tower (Dark Bridge Room)
|-
|[[Room $C1]]
|Misery Mire (Compass Chest / Tile Room)
|-
|[[Room $C2]]
|Misery Mire (Big Hub Room)
|-
|[[Room $C3]]
|Misery Mire (Big Chest Room)
|-
|[[Room $C4]]
|Turtle Rock (Final Crystal Switch Puzzle Room)
|-
|[[Room $C5]]
|Turtle Rock (Laser Bridge)
|-
|[[Room $C6]]
|Turtle Rock
|-
|[[Room $C7]]
|Turtle Rock (Torch Puzzle)
|-
|[[Room $C8]]
|Eastern Palace (Armos Knights[Boss])
|-
|[[Room $C9]]
|Eastern Palace (Entrance Room)
|-
|[[Room $CA]]
|??
|-
|[[Room $CB]]
|Thieves Town (North West Entrance Room)
|-
|[[Room $CC]]
|Thieves Town (North East Entrance Room)
|-
|[[Room $CD]]
|Empty Clone Room
|-
|[[Room $CE]]
|Ice Palace (Hole to Kholdstare Room)
|-
|[[Room $CF]]
|Empty Clone Room
|-
|[[Room $D0]]
|Agahnim's Tower (Dark Maze)
|-
|[[Room $D1]]
|Misery Mire (Conveyor Slug / Big Key Room)
|-
|[[Room $D2]]
|Misery Mire (Mire02 / Wizzrobes Room)
|-
|[[Room $D3]]
|Empty Clone Room
|-
|[[Room $D4]]
|Empty Clone Room
|-
|[[Room $D5]]
|Turtle Rock (Laser Key Room)
|-
|[[Room $D6]]
|Turtle Rock (Entrance Room)
|-
|[[Room $D7]]
|Empty Clone Room
|-
|[[Room $D8]]
|Eastern Palace ("Zeldagamer Room" / Pre-Armos Knights Room)
|-
|[[Room $D9]]
|Eastern Palace (Canonball Room)
|-
|[[Room $DA]]
|Eastern Palace
|-
|[[Room $DB]]
|Thieves Town (Main (South West) Entrance Room)
|-
|[[Room $DC]]
|Thieves Town (South East Entrance Room)
|-
|[[Room $DD]]
|Empty Clone Room
|-
|[[Room $DE]]
|Ice Palace (Kholdstare[Boss])
|-
|[[Room $DF]]
|Cave
|-
|[[Room $E0]]
|Agahnim's Tower (Entrance Room)
|-
|[[Room $E1]]
|Cave (Lost Woods HP)
|-
|[[Room $E2]]
|Cave (Lumberjack's Tree HP)
|-
|[[Room $E3]]
|Cave (1/2 Magic)
|-
|[[Room $E4]]
|Cave (Lost Old Man Final Cave)
|-
|[[Room $E5]]
|Cave (Lost Old Man Final Cave)
|-
|[[Room $E6]]
|Cave
|-
|[[Room $E7]]
|Cave
|-
|[[Room $E8]]
|Cave
|-
|[[Room $E9]]
|Empty Clone Room
|-
|[[Room $EA]]
|Cave (Spectacle Rock HP)
|-
|[[Room $EB]]
|Cave
|-
|[[Room $EC]]
|Empty Clone Room
|-
|[[Room $ED]]
|Cave
|-
|[[Room $EE]]
|Cave (Spiral Cave)
|-
|[[Room $EF]]
|Cave (Crystal Switch / 5 Chests Room)
|-
|[[Room $F0]]
|Cave (Lost Old Man Starting Cave)
|-
|[[Room $F1]]
|Cave (Lost Old Man Starting Cave)
|-
|[[Room $F2]]
|House
|-
|[[Room $F3]]
|House (Old Woman (Sahasrahla's Wife?))
|-
|[[Room $F4]]
|House (Angry Brothers)
|-
|[[Room $F5]]
|House (Angry Brothers)
|-
|[[Room $F6]]
|Empty Clone Room
|-
|[[Room $F7]]
|Empty Clone Room
|-
|[[Room $F8]]
|Cave
|-
|[[Room $F9]]
|Cave
|-
|[[Room $FA]]
|Cave
|-
|[[Room $FB]]
|Cave
|-
|[[Room $FC]]
|Empty Clone Room
|-
|[[Room $FD]]
|Cave
|-
|[[Room $FE]]
|Cave
|-
|[[Room $FF]]
|Cave
|}

===Secondary Map===

{{toc}}

Underworld

2017-07-22T22:17:55Z

Tatters: /* Push Block Data */

The underworld refers to all indoor locations; including dungeons, caves, and houses.

==Important Hex Addresses==
===Room Data===
====Room Headers====
*{{$|027502}} to {{$|027781}} = Pointer Table, {{hex|2}} byte local addresses, indexed by room ID.
*{{$|027781}} to {{$|027FEF}} = Data

<blockquote>
Headers are {{$|0E}} (Decimal: 14) bytes formatted thusly:
*Byte {{hex|0}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
**The {{red|a}} bits are transformed into {{hex|0000 0}}{{red|aaa}} and stored to {{$|0414}} ("BG2" in Hyrule Magic)
**The {{blue|b}} bits are transformed into {{hex|0000 0}}{{blue|bbb}} and stored to {{$|046C}} ("Collision" in Hyrule Magic)
**The {{green|c}} bit is unused
**The {{purple|d}} bit is stored to {{$|7EC005}} (If set, use a lights out routine in the room transition)

*Byte {{hex|1}}: {{red|aa}}{{blue|bb bbbb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{blue|bbbb bb}}{{hex|00}}, thus making them a multiple of 4.
This value is used to load 4 different palettes for the dungeon, and corresponds to, you guessed it, Palette # in Hyrule Magic!

The resulting index is used to load values for {{$|0AB6}}, {{$|0AAC}}, {{$|0AAD}}, and {{$|0AAE}}

*Byte {{hex|2}}: gets stored to {{$|0AA2}} (GFX # in Hyrule Magic)
*Byte {{hex|3}}: value + #$40 gets stored to {{$|0AA3}} (Sprite GFX # in Hyrule Magic)
*Byte {{hex|4}}: gets stored to {{$|00AD}} ("[[Room Effects|Effect]]" in Hyrule Magic)
*Byte {{hex|5}}: gets stored to {{$|00AE}} ("[[Room Tags|Tag1]]" in Hyrule Magic)
*Byte {{hex|6}}: gets stored to {{$|00AF}} ("Tag2" in Hyrule Magic)

These are the planes to use for bytes {{hex|9}} through {{hex|D}}. This determines which
BG you appear on, and possibly more.

*Byte {{hex|7}}: {{red|aa}}{{blue|bb}} {{green|cc}}{{purple|dd}}
**The {{red|a}} bits are transformed into {{hex|0000 00}}{{red|aa}} and stored to {{$|063F}}
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|063E}}
**The {{green|c}} bits are transformed into {{hex|0000 00}}{{green|cc}} and stored to {{$|063D}}
**The {{purple|d}} bits are transformed into {{hex|0000 00}}{{purple|dd}} and stored to {{$|063C}}

Note, the only safe values for a plane seem to be {{hex|0}},{{hex|1}}, or {{hex|2}}. Hyrule Magic
appears to violate this rule by letting you put {{hex|3}} down, but nothing higher.

*Byte {{hex|8}}: {{red|aaaa aa}}{{blue|bb}}
**The {{red|a}} bits are unused
**The {{blue|b}} bits are transformed into {{hex|0000 00}}{{blue|bb}} and stored to {{$|0640}}

*Byte {{hex|9}}: stored to {{$|7EC000}} These are all room numbers that you could possibly exit to.
*Byte {{hex|A}}: stored to {{$|7EC001}}
*Byte {{hex|B}}: stored to {{$|7EC002}}
*Byte {{hex|C}}: stored to {{$|7EC003}}
*Byte {{hex|D}}: stored to {{$|7EC004}}
</blockquote>

====Sprite Data====
* {{$|04D62E}} to {{$|04D92E}} = Pointer Table, 2 byte local addresses, indexed by room.
* {{$|04D92E}} to {{$|04EC9D}} = Data

<blockquote>
Sprite data is formatted thusly:
*Byte {{hex|0}}: Stored to {{$|0FB3}}. Corresponds with "Sort Spr" in Hyrule Magic. In a layered room this indicates sprites in the foreground are to be drawn on top of sprites in the background.
**Bit {{hex|0}} - If {{hex|0}}, sprites will sort
**Bits {{hex|7,6,5,4,3,2,1}} - Unknown, should all be {{hex|1}}
After the byte {{hex|0}}, you will see 3 byte clusters that break down thus:

*Byte {{hex|0}}:
**Bits {{hex|4,3,2,1,0}} - Y coordinate (in pixels from the top, starting at {{hex|0}}) of the sprite divided by 16.
**Bits {{hex|6,5}} - If these are set, they will be used to generate a subtype, stored to {{$|0E30}}, X.
**Bit {{hex|7}} - If set, the sprite is on BG2, if not it's on BG1
* Byte {{hex|1}}:
** Bits {{hex|4,3,2,1,0}} - X coordinate (in pixels from the far left, starting at {{hex|0}}) of the sprite divided by 16.
** Bits {{hex|7,6,5}} - If all these bits are set then this is an Overlord, otherwise it's a normal sprite. If only some of them are set they can be used to generate a subtype, stored at {{$|0E30}}, X
* Byte {{hex|2}}: Sprite or Overlord type. If a sprite, this will get loaded into a slot at {{$|0E20}}, X. If an Overlord, will get loaded to {{$|0B00}}, X.

The array is terminated with a byte of {{$|FF}}.
</blockquote>

====Object Data====
* {{$|0F8000}} to {{$|0F83BF}} = Pointer Table, 3 byte long addresses, indexed by room ID.
* {{$|01EBA0}} to {{$|01FFF4}} = Data
* {{$|050000}} to {{$|053729}} = Data
* {{$|0F8780}} to {{$|0FFF4D}} = Data
<blockquote>
Byte layout:

* Byte 0: {{red|aaaa}} {{blue|bbbb}}.
**The a bits are transformed to {{red|aaaa}}{{hex|0000}} and select the type of empty space to fill in. Hyrule Magic calls this 'Floor 1' - Gets stored to {{$|7E0490}}
**The b bits are transformed to {{blue|bbbb}}{{hex|0000}} and are the what Hyrule Magic calls 'Floor 2' - Gets stored to {{$|7E046A}}

* Byte {{hex|1}}: {{red|aaa}}{{blue|b bb}}{{green|c}}{{purple|d}}
** The {{red|a}} bits are unused and should not be used
** The {{blue|b}} bits determine the room's layout type, ranging from {{hex|0}} to {{hex|7}}.
** The {{green|c}} and {{purple|d}} bits are unknown, but I have a feeling it's related to {{$|AA}} and {{$|A9}}

After that the bytes come in {{hex|3}} or {{hex|2}} byte object structures, used by routine {{$|01:88E4}}. Objects are loaded until an object with value {{0x|FFFF}} occurs. If a value {{0x|FFF0}} is loaded, the game will start loading Type 2 objects and will not go back to loading Type 1 objects until it is time to load the next layer. (Layer as in HM, not to be confused with the SNES' Backgrounds.) A value of {{0x|FFFF}} will also terminate the loading of Type 2 objects. The routine immediately terminates if that happens during the loading of either object type.

Type 1 Object structure: (3 bytes):

* Byte {{hex|3}}: Routine to use. If this byte is ≥ {{0x|F8}} and < {{0x|FC}}, then it is a subtype 3 object. If the index is ≥ {{hex|FC}}, it is a subtype 2 object. If not, it is a subtype 1 object.

* Subtype 1 Objects, first and second byte
** High Byte: {{brown|yyyy yy}}{{green|cc}}
** Low Byte: {{grey|xxxx xx}}{{red|aa}}
*** The {{red|a}} bits are stored to {{$|B2}}
*** The {{green|c}} bits are stored to {{$|B4}}
*** The {{grey|x}} and {{brown|y}} bits are transformed into: {{hex|000}}{{brown|y yyyy y}}{{grey|xxx xxx}}{{hex|0}} - This is a tilemap address that indexes into {{$|7E2000}} and / or {{$|7E4000}}

Use Byte {{hex|3}} * 2 as an index into the table at {{$|8200}}. This is the routine that is used to draw and otherwise handle the object. Subtype 1 objects have a maximum width and height of 4. Width and height are measured in terms of 32 {{x}} 32 pixels. (⟸ last part is questionable)

*Subtype 2 Objects, 1st, 2nd, & 3rd bytes:
** Byte {{hex|3}}: {{white|ff}}{{purple|dd dddd}}
** Byte {{hex|2}}: {{pink|eeee}} {{green|cccc}}
** Byte {{hex|1}}: {{red|aaaa aa}}{{blue|bb}}
***The {{red|a}} bits are unused, but after all they are the marker for this type of object subtype.
***The {{blue|b}}, {{green|c}}, {{pink|e}}, and {{white|f}} bits are transformed into a VRAM tilemap address: {{hex|000}}{{green|c ccc}}{{white|f}} {{white|f}}{{blue|bb}}{{pink|e eee}}{{hex|0}}

Might I add this is one messed up format? The {{purple|d}} bits are used as an index into the table at {{$|8470}}. Since such indices are going to be even, the {{purple|d}} bits are transformed into: {{hex|0000 0000 0}}{{purple|ddd ddd}}{{hex|0}}.

*Subtype 3 Objects
**Similar to Subtype 1, with a few small exceptions.
**The vram address is calculated the same way. However, {{$|B2}} and {{$|B4}} are not used as length or width dimensions here. The routine that is used is determined as follows:
**Take the original index (times two) that a Subtype 1 would have used. AND that with {{0x|000E}}. Then shift left 3 times to produce {{hex|0000 0000 0}}{{pink|eee}} {{hex|0000}}. Then, OR in {{$|B2}} and {{$|B4}} and shift left once, so the final result is: {{hex|0000 0000}} {{pink|eee}}{{red|a a}}{{blue|bb}}{{hex|0}}.
**Also, this value indexes into {{$|85F0}} instead of {{$|8200}}.

Type 2 Object Structure: (2 bytes)
*High Byte: {{green|cccc cccc}}
*Low Byte: {{blue|bbbb}} {{purple|dd}}{{red|aa}}
**The {{red|a}} bits form a 2-bit value ({{hex|0000 0}}{{red|aa}}{{hex|0}}) that determines the routine to use for the object. In Hyrule Magic, corresponds to the "direction" of the door.
**The {{blue|b}} bits are transformed into {{hex|000}}{{blue|b bbb}}{{hex|0}} and stored to {{$|02}} ⟹ X. Corresponds to "Pos" of door objects in the Hyrule Magic. Note that these range from {{0x|00}} to {{0x|16}} (always even) which if you halve those values is 0 - 11 in decimal. This is easily verifiable in Hyrule Magic.
**The {{green|c}} bits are shifted into the lower byte and stored to {{$|04}} ⟹ A and {{$|0A}}. This is later used to grab the tiles used to draw the door and the area below it. In Hyrule Magic, corresponds to "type". Note the type is 1/2 of the number listed here. This is because to avoid using an ASL A command, the {{green|c}} bits are always even.
**The {{purple|d}} bits are unused.

Next I'll go into the nitty gritty of the various types (the value of {{$|04}}). Again note that we'll only be dealing with even values {{blue|b}}/{{green|c}} that's what you'll see in the code. To convert between here [as well as the code] and Hyrule Magic, take the hex value here and divide by two. Convert to decimal and that's your Hyrule Magic "type."

*Types:
{|{{Prettytable}}
! ID
! Description
|-
|{{0x|00}}
|Basic door. Index = {{$|0460}}
|-
|{{0x|02}}
|Normal door?
|-
|{{0x|04}}
|???
|-
|{{0x|06}}
|???
|-
|{{0x|08}}
|Waterfall door (only used in Swamp palace; in one room at that!)
|-
|{{0x|0A}}
|???
|-
|{{0x|0C}}
|Trap door (probably other types but this seems to be most common)
|-
|{{0x|12}}
|Adds a property to some doors allowing you to exit to the overworld (this is accomplished by writing to the tile attribute map)
|-
|{{0x|14}}
|Transition to dark room?
|-
|{{0x|16}}
|Toggles the target BG Link will emerge on. '''Ex.''' if Link starts on BG0 in the next room he'll be on BG1.
|-
|{{0x|20}}
| rowspan="2"|Locked door specifically for BG0.
|-
|{{0x|22}}
|-
|{{0x|24}}
| rowspan="2"|Locked door for either BG0 or BG1
|-
|{{0x|26}}
|-
|{{0x|30}}
|Large exploded pathway resulting from a switch being pulled (unusual to have as a door as it's huge)
|-
|{{0x|32}}
|Sword activated door. '''Ex.''' Agahnim's room with the curtain door you have to slash.
|-
|{{0x|46}}
|warp door?
|}
</blockquote>

====Dungeon Secrets Data====
* {{$|00DB69}} to {{$|00DDE8}} = Pointer Table, 2 byte local addresses, indexed by room ID.
* {{$|00DDE9}} to {{$|00E6B1}} = Data
<blockquote>
Data comes in 3 byte chunks and is terminated by an instance of {{$|FFFF}}

* Bytes {{hex|0}}, {{hex|1}}: A word that denotes the VRAM address that the item is found at. This identifies the item as belonging to that part of the screen.
* Byte {{hex|2}}: Identifies the type of item that is hiding there. E.g. {{$|08}} is a key
</blockquote>

====Push Block Data====
* {{$|0271DE}} to {{$|027369}} = Data
<Blockquote>
4 bytes per entry:
{{red|a a }}{{blue|x }} {{green|y}}

*{{red|a}}: Room number (byte swapped)
*{{blue|x}}: X Position of the block (expressed as tilemap coordinate)
*{{green|y}}: Y Position of the block (expressed as tilemap coordinate)
</blockquote>

====(Inter Room) Torch Data====
* {{$|02736A}} to {{$|027489}} = Data
<blockquote>
Consists of variable length segments consisting of:

*1st word: Room that the torches belong in
*After this is a series of words, each one being a tilemap address for a torch.
This list of torches is terminated by the word value {{0x|FFFF}}
</blockquote>

====Chest Contents====
*{{$|00E96E}} to {{$|00EB65}} = Data
<blockquote>
Array of chest information in 3 byte chunks. 168 entries in all ({{0x|A8}})

*First word - Room number it is located in. MSB determines whether it is a big chest or not. (big chest if set)
*Last byte - index of the type of item contained in the chest.
</blockquote>

===Entrance Data===
There are {{$|85}} (Decimal: 133) normal entrances to the underworld from the overworld, and {{$|7}} (Decimal: 7) starting locations.
Normal entrances and starting locations use mostly the same types of data formatted the same, however they are located in different places in the ROM.
They are located and formatted thus:

====Entrance Room====
*{{$|014813}} to {{$|01491C}} = Normal Entrance Data
*{{$|015B6E}} to {{$|015B7B}} = Starting Location Data
<blockquote>
Each entry is a 2 byte Room ID where the player is placed after using an entrance.
</blockquote>

====Scroll Edges====
*{{$|01491D}} to {{$|014D44}} = Normal Entrance Data
*{{$|015B7C}} to {{$|015BB3}} = Starting Location Data
<blockquote>
Unsure about what these do exactly.
Each entry is 8 bytes long.
*Format: 1 byte each. Corresponds to hyrule magic values in the "More" aka Entrance Properties dialog box.
**HU -
**FU -
**HD -
**FD -
**HL -
**FL -
**HR -
**FR -
</blockquote>

====X Scroll====
*{{$|014D45}} to {{$|014E4E}} = Normal Entrance Data
*{{$|015BB4}} to {{$|015BC1}} = Starting Location Data
<blockquote>

</blockquote>

====Y Scroll====
*{{$|014E4F}} to {{$|014F58}} = Normal Entrance Data
*{{$|015BC2}} to {{$|015BCF}} = Starting Location Data
<blockquote>

</blockquote>

====X Coordinate====
*{{$|014F59}} to {{$|015062}} = Normal Entrance Data
*{{$|015BD0}} to {{$|015BDD}} = Starting Location Data
<blockquote>
Each entry is a 2 byte X coordinate where the player starts after using the corresponding entrance.
</blockquote>

====Y Coordinate====
*{{$|015063}} to {{$|01516C}} = Normal Entrance Data
*{{$|015BDE}} to {{$|015BEB}} = Starting Location Data
<blockquote>
Each entry is a 2 byte y coordinate where the player starts after using the corresponding entrance.
</blockquote>

====X Camera Coordinate====
*{{$|01516D}} to {{$|015276}} = Normal Entrance Data
*{{$|015BEC}} to {{$|015BF9}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

====Y Camera Coordinate====
*{{$|015277}} to {{$|015380}} = Normal Entrance Data
*{{$|015BFA}} to {{$|015C07}} = Starting Location Data
<blockquote>
Lower bounds for scrolling (upper bounds = this plus 2)
2 bytes each.
</blockquote>

====Entrance Blockset====
*{{$|015381}} to {{$|015405}} = Normal Entrance Data
*{{$|015C08}} to {{$|015C0E}} = Starting Location Data
<blockquote>
1 byte each. This blockset affects walls and a few other things and persists through all rooms the player accesses from this entrance.
</blockquote>

====Floor Values====
*{{$|015406}} to {{$|01548A}} = Normal Entrance Data
*{{$|015C0F}} to {{$|015C15}} = Starting Location Data
<blockquote>
This tells us what kind of properties the floor has. 1 byte each:
*If 1, then it has floors that you can fall through to the next level
*If 0, I think it means it can be fallen down to
*If -1, has no pits
*If -2, ????
</blockquote>

====Dungeon Values====
*{{$|01548B}} to {{$|01550F}} = Normal Entrance Data
*{{$|015C16}} to {{$|015C1C}} = Starting Location Data
<blockquote>
1 Byte each.
Dungeons actually in the game are numbered like so {{$|00}}, {{$|02}}, {{$|04}}, ..., {{$|18}}, {{$|1A}}.
{{$|1C}} and {{$|1E}} are unused (and hence could potentially be added.) Notice they are all even numbers.
In asm routines these values are divided by two sometimes to provide an index into other arrays.
That's why. The definition of a "dungeon" is something with a key, compass, and map.

A value of {{$|FF}} (-1) denotes it doesn't belong to a dungeon.
</blockquote>

====Doorway Type====
*{{$|015510}} to {{$|015594}} = Normal Entrance Data
*{{$|015C2B}} to {{$|015C31}} = Starting Location Data
<blockquote>
This is used only when you exit the given room. For example, let's say you enter through a skull doorway in Skullwoods.
But that's not really a door way, it's just a set of tiles that are no different from a hole you might create after picking
up a big rock. But if you entered from a building door, the game has to know whether to put the door frame when you exit.
*1 byte:
**{{hex|0}} = no doorway when exiting
**{{hex|1}} = draws a door frame upon exiting
**{{hex|2}} = ???? HM says vertical doorframe. But in the original game, no doorway is vertical.

</blockquote>

====Ladder And BG Settings====
*{{$|015595}} to {{$|015619}} = Normal Entrance Data
*{{$|015C1D}} to {{$|015C23}} = Starting Location Data
<blockquote>
*1 byte each, with the following 2 bit layout: {{hex|xxx}}{{red|a}}{{pink|xxx}}{{blue|b}}
**{{hex|x}} - unimportant
**{{red|a}} - if set, then Link enters on the lower level (BG2)
**{{blue|b}} - if set... not sure what happens exactly. Check the game engine to be sure.
</blockquote>

====Horizontal And Vertical Scroll Properties====
*{{$|01561A}} to {{$|01569E}} = Normal Entrance Data
*{{$|015C24}} to {{$|015C2A}} = Starting Location Data
<blockquote>
For these, I guess if the flags in the appropriate places are set, then the room will be able to scroll in those directions.

*1 byte each, with the following layout: {{hex|xx}}{{red|a}}{{hex|xxx}}{{blue|b}}{{hex|x}}
**{{red|a}} - Horizontal flag
**{{blue|b}} - Vertical flag
</blockquote>

====Scroll Quadrant====
*{{$|01569F}} to {{$|015723}} = Normal Entrance Data
<blockquote>
*1 byte each, has four different expected values:
**0h, 2h, 10h, 12h
</blockquote>

====Exit Door Location====
*{{$|015724}} to {{$|01582D}} = Normal Entrance Data
*{{$|015C32}} to {{$|015C3F}} = Starting Location Data
<blockquote>
1 word each. Denotes X and Y coordinates for overworld?
</blockquote>

====Music====
*{{$|01582E}} to {{$|0158B2}} = Normal Entrance Data (JP: 15592 - 15616)
*{{$|015C4E}} to {{$|015C54}} = Starting Location Data
<blockquote>
1 byte each. A value of {{$|FF}} plays the same music as the overworld screen from which the player entered.
</blockquote>

====Entrance Values====
*{{$|015C40}} to {{$|015C4D}} = Starting Location Data
<blockquote>
1 word each. Since the starting locations have to reference an entrance, this is necessary.
</blockquote>

==Rooms==
Tiles on the underworld maps are referred to as "super-rooms" and can contain 1-4 "sub-rooms."

===Primary Map===
The primary underworld map consists of {{$|FF}} (decimal: 256) super-rooms arranged in a {{$|10}} {{x}} {{$|10}} (decimal: 16 {{x}} 16) square.

{|{{Prettytable}}
! ID
! Description
|-
|[[Room $00|Room {{$|00}}]]
|Ganon
|-
|[[Room $01|Room {{$|01}}]]
|Hyrule Castle (North Corridor)
|-
|[[Room $02|Room {{$|02}}]]
|Hyrule Castle (Switch Room)
|-
|[[Room $03|Room {{$|03}}]]
|Houlihan Room
|-
|[[Room $04|Room {{$|04}}]]
|Turtle Rock (Crysta-roller Room)
|-
|[[Room $05|Room {{$|05}}]]
|Empty Clone Room
|-
|[[Room $06|Room {{$|06}}]]
|Swamp Palace (Arrghus[Boss])
|-
|[[Room $07|Room {{$|07}}]]
|Tower of Hera (Moldorm[Boss])
|-
|[[Room $08|Room {{$|08}}]]
|Cave (Healing Fairy)
|-
|[[Room $09|Room {{$|09}}]]
|Palace of Darkness
|-
|[[Room $0A|Room {{$|0A}}]]
|Palace of Darkness (Stalfos Trap Room)
|-
|[[Room $0B|Room {{$|0B}}]]
|Palace of Darkness (Turtle Room)
|-
|[[Room $0C|Room {{$|0C}}]]
|Ganon's Tower (Entrance Room)
|-
|[[Room $0D|Room {{$|0D}}]]
|Ganon's Tower (Agahnim2[Boss])
|-
|[[Room $0E|Room {{$|0E}}]]
|Ice Palace (Entrance Room)
|-
|[[Room $0F|Room {{$|0F}}]]
|Empty Clone Room
|-
|[[Room $10|Room {{$|10}}]]
|Ganon Evacuation Route
|-
|[[Room $11|Room {{$|11}}]]
|Hyrule Castle (Bombable Stock Room)
|-
|[[Room $12|Room {{$|12}}]]
|Sanctuary
|-
|[[Room $13|Room {{$|13}}]]
|Turtle Rock (Hokku-Bokku Key Room 2)
|-
|[[Room $14|Room {{$|14}}]]
|Turtle Rock (Big Key Room)
|-
|[[Room $15|Room {{$|15}}]]
|Turtle Rock
|-
|[[Room $16|Room {{$|16}}]]
|Swamp Palace (Swimming Treadmill)
|-
|[[Room $17|Room {{$|17}}]]
|Tower of Hera (Moldorm Fall Room)
|-
|[[Room $18|Room {{$|18}}]]
|Cave
|-
|[[Room $19|Room {{$|19}}]]
|Palace of Darkness (Dark Maze)
|-
|[[Room $1A|Room {{$|1A}}]]
|Palace of Darkness (Big Chest Room)
|-
|[[Room $1B|Room {{$|1B}}]]
|Palace of Darkness (Mimics / Moving Wall Room)
|-
|[[Room $1C|Room {{$|1C}}]]
|Ganon's Tower (Ice Armos)
|-
|[[Room $1D|Room {{$|1D}}]]
|Ganon's Tower (Final Hallway)
|-
|[[Room $1E|Room {{$|1E}}]]
|Ice Palace (Bomb Floor / Bari Room)
|-
|[[Room $1F|Room {{$|1F}}]]
|Ice Palace (Pengator / Big Key Room)
|-
|[[Room $20|Room {{$|20}}]]
|Agahnim's Tower (Agahnim[Boss])
|-
|[[Room $21|Room {{$|21}}]]
|Hyrule Castle (Key-rat Room)
|-
|[[Room $22|Room {{$|22}}]]
|Hyrule Castle (Sewer Text Trigger Room)
|-
|[[Room $23|Room {{$|23}}]]
|Turtle Rock (West Exit to Balcony)
|-
|[[Room $24|Room {{$|24}}]]
|Turtle Rock (Double Hokku-Bokku / Big chest Room)
|-
|[[Room $25|Room {{$|25}}]]
|Empty Clone Room
|-
|[[Room $26|Room {{$|26}}]]
|Swamp Palace (Statue Room)
|-
|[[Room $27|Room {{$|27}}]]
|Tower of Hera (Big Chest)
|-
|[[Room $28|Room {{$|28}}]]
|Swamp Palace (Entrance Room)
|-
|[[Room $29|Room {{$|29}}]]
|Skull Woods (Mothula[Boss])
|-
|[[Room $2A|Room {{$|2A}}]]
|Palace of Darkness (Big Hub Room)
|-
|[[Room $2B|Room {{$|2B}}]]
|Palace of Darkness (Map Chest / Fairy Room)
|-
|[[Room $2C|Room {{$|2C}}]]
|Cave
|-
|[[Room $2D|Room {{$|2D}}]]
|Empty Clone Room
|-
|[[Room $2E|Room {{$|2E}}]]
|Ice Palace (Compass Room)
|-
|[[Room $2F|Room {{$|2F}}]]
|Cave (Kakariko Well HP)
|-
|[[Room $30|Room {{$|30}}]]
|Agahnim's Tower (Maiden Sacrifice Chamber)
|-
|[[Room $31|Room {{$|31}}]]
|Tower of Hera (Hardhat Beetles Room)
|-
|[[Room $32|Room {{$|32}}]]
|Hyrule Castle (Sewer Key Chest Room)
|-
|[[Room $33|Room {{$|33}}]]
|Desert Palace (Lanmolas[Boss])
|-
|[[Room $34|Room {{$|34}}]]
|Swamp Palace (Push Block Puzzle / Pre-Big Key Room)
|-
|[[Room $35|Room {{$|35}}]]
|Swamp Palace (Big Key / BS Room)
|-
|[[Room $36|Room {{$|36}}]]
|Swamp Palace (Big Chest Room)
|-
|[[Room $37|Room {{$|37}}]]
|Swamp Palace (Map Chest / Water Fill Room)
|-
|[[Room $38|Room {{$|38}}]]
|Swamp Palace (Key Pot Room)
|-
|[[Room $39|Room {{$|39}}]]
|Skull Woods (Gibdo Key / Mothula Hole Room)
|-
|[[Room $3A|Room {{$|3A}}]]
|Palace of Darkness (Bombable Floor Room)
|-
|[[Room $3B|Room {{$|3B}}]]
|Palace of Darkness (Spike Block / Conveyor Room)
|-
|[[Room $3C|Room {{$|3C}}]]
|Cave
|-
|[[Room $3D|Room {{$|3D}}]]
|Ganon's Tower (Torch Room 2)
|-
|[[Room $3E|Room {{$|3E}}]]
|Ice Palace (Stalfos Knights / Conveyor Hellway)
|-
|[[Room $3F|Room {{$|3F}}]]
|Ice Palace (Map Chest Room)
|-
|[[Room $40|Room {{$|40}}]]
|Agahnim's Tower (Final Bridge Room)
|-
|[[Room $41|Room {{$|41}}]]
|Hyrule Castle (First Dark Room)
|-
|[[Room $42]]
|Hyrule Castle (6 Ropes Room)
|-
|[[Room $43]]
|Desert Palace (Torch Puzzle / Moving Wall Room)
|-
|[[Room $44]]
|Thieves Town (Big Chest Room)
|-
|[[Room $45]]
|Thieves Town (Jail Cells Room)
|-
|[[Room $46]]
|Swamp Palace (Compass Chest Room)
|-
|[[Room $47]]
|Empty Clone Room
|-
|[[Room $48]]
|Empty Clone Room
|-
|[[Room $49]]
|Skull Woods (Gibdo Torch Puzzle Room)
|-
|[[Room $4A]]
|Palace of Darkness (Entrance Room)
|-
|[[Room $4B]]
|Palace of Darkness (Warps / South Mimics Room)
|-
|[[Room $4C]]
|Ganon's Tower (Mini-Helmasaur Conveyor Room)
|-
|[[Room $4D]]
|Ganon's Tower (Moldorm Room)
|-
|[[Room $4E]]
|Ice Palace (Bomb-Jump Room)
|-
|[[Room $4F]]
|Ice Palace Clone Room (Fairy Room)
|-
|[[Room $50]]
|Hyrule Castle (West Corridor)
|-
|[[Room $51]]
|Hyrule Castle (Throne Room)
|-
|[[Room $52]]
|Hyrule Castle (East Corridor)
|-
|[[Room $53]]
|Desert Palace (Popos 2 / Beamos Hellway Room)
|-
|[[Room $54]]
|Swamp Palace (Upstairs Pits Room)
|-
|[[Room $55]]
|Castle Secret Entrance / Uncle Death Room
|-
|[[Room $56]]
|Skull Woods (Key Pot / Trap Room)
|-
|[[Room $57]]
|Skull Woods (Big Key Room)
|-
|[[Room $58]]
|Skull Woods (Big Chest Room)
|-
|[[Room $59]]
|Skull Woods (Final Section Entrance Room)
|-
|[[Room $5A]]
|Palace of Darkness (Helmasaur King[Boss])
|-
|[[Room $5B]]
|Ganon's Tower (Spike Pit Room)
|-
|[[Room $5C]]
|Ganon's Tower (Ganon-Ball Z)
|-
|[[Room $5D]]
|Ganon's Tower (Gauntlet 1/2/3)
|-
|[[Room $5E]]
|Ice Palace (Lonely Firebar)
|-
|[[Room $5F]]
|Ice Palace (Hidden Chest / Spike Floor Room)
|-
|[[Room $60]]
|Hyrule Castle (West Entrance Room)
|-
|[[Room $61]]
|Hyrule Castle (Main Entrance Room)
|-
|[[Room $62]]
|Hyrule Castle (East Entrance Room)
|-
|[[Room $63]]
|Desert Palace (Final Section Entrance Room)
|-
|[[Room $64]]
|Thieves Town (West Attic Room)
|-
|[[Room $65]]
|Thieves Town (East Attic Room)
|-
|[[Room $66]]
|Swamp Palace (Hidden Chest / Hidden Door Room)
|-
|[[Room $67]]
|Skull Woods (Compass Chest Room)
|-
|[[Room $68]]
|Skull Woods (Key Chest / Trap Room)
|-
|[[Room $69]]
|Empty Clone Room
|-
|[[Room $6A]]
|Palace of Darkness (Rupee Room)
|-
|[[Room $6B]]
|Ganon's Tower (Mimics Rooms)
|-
|[[Room $6C]]
|Ganon's Tower (Lanmolas Room)
|-
|[[Room $6D]]
|Ganon's Tower (Gauntlet 4/5)
|-
|[[Room $6E]]
|Ice Palace (Pengators Room)
|-
|[[Room $6F]]
|Empty Clone Room
|-
|[[Room $70]]
|Hyrule Castle (Small Corridor to Jail Cells)
|-
|[[Room $71]]
|Hyrule Castle (Boomerang Chest Room)
|-
|[[Room $72]]
|Hyrule Castle (Map Chest Room)
|-
|[[Room $73]]
|Desert Palace (Big Chest Room)
|-
|[[Room $74]]
|Desert Palace (Map Chest Room)
|-
|[[Room $75]]
|Desert Palace (Big Key Chest Room)
|-
|[[Room $76]]
|Swamp Palace (Water Drain Room)
|-
|[[Room $77]]
|Tower of Hera (Entrance Room)
|-
|[[Room $78]]
|Empty Clone Room
|-
|[[Room $79]]
|Empty Clone Room
|-
|[[Room $7A]]
|Empty Clone Room
|-
|[[Room $7B]]
|Ganon's Tower
|-
|[[Room $7C]]
|Ganon's Tower (East Side Collapsing Bridge / Exploding Wall Room)
|-
|[[Room $7D]]
|Ganon's Tower (Winder / Warp Maze Room)
|-
|[[Room $7E]]
|Ice Palace (Hidden Chest / Bombable Floor Room)
|-
|[[Room $7F]]
|Ice Palace ( Big Spike Traps Room)
|-
|[[Room $80]]
|Hyrule Castle (Jail Cell Room)
|-
|[[Room $81]]
|Hyrule Castle
|-
|[[Room $82]]
|Hyrule Castle (Basement Chasm Room)
|-
|[[Room $83]]
|Desert Palace (West Entrance Room)
|-
|[[Room $84]]
|Desert Palace (Main Entrance Room)
|-
|[[Room $85]]
|Desert Palace (East Entrance Room)
|-
|[[Room $86]]
|Empty Clone Room
|-
|[[Room $87]]
|Tower of Hera (Tile Room)
|-
|[[Room $88]]
|Empty Clone Room
|-
|[[Room $89]]
|Eastern Palace (Fairy Room)
|-
|[[Room $8A]]
|Empty Clone Room
|-
|[[Room $8B]]
|Ganon's Tower (Block Puzzle / Spike Skip / Map Chest Room)
|-
|[[Room $8C]]
|Ganon's Tower (East and West Downstairs / Big Chest Room)
|-
|[[Room $8D]]
|Ganon's Tower (Tile / Torch Puzzle Room)
|-
|[[Room $8E]]
|Ice Palace
|-
|[[Room $8F]]
|Empty Clone Room
|-
|[[Room $90]]
|Misery Mire (Vitreous[Boss])
|-
|[[Room $91]]
|Misery Mire (Final Switch Room)
|-
|[[Room $92]]
|Misery Mire (Dark Bomb Wall / Switches Room)
|-
|[[Room $93]]
|Misery Mire (Dark Cane Floor Switch Puzzle Room)
|-
|[[Room $94]]
|Empty Clone Room
|-
|[[Room $95]]
|Ganon's Tower (Final Collapsing Bridge Room)
|-
|[[Room $96]]
|Ganon's Tower (Torches 1 Room)
|-
|[[Room $97]]
|Misery Mire (Torch Puzzle / Moving Wall Room)
|-
|[[Room $98]]
|Misery Mire (Entrance Room)
|-
|[[Room $99]]
|Eastern Palace (Eyegore Key Room)
|-
|[[Room $9A]]
|Empty Clone Room
|-
|[[Room $9B]]
|Ganon's Tower (Many Spikes / Warp Maze Room)
|-
|[[Room $9C]]
|Ganon's Tower (Invisible Floor Maze Room)
|-
|[[Room $9D]]
|Ganon's Tower (Compass Chest / Invisible Floor Room)
|-
|[[Room $9E]]
|Ice Palace (Big Chest Room)
|-
|[[Room $9F]]
|Ice Palace
|-
|[[Room $A0]]
|Misery Mire (Pre-Vitreous Room)
|-
|[[Room $A1]]
|Misery Mire (Fish Room)
|-
|[[Room $A2]]
|Misery Mire (Bridge Key Chest Room)
|-
|[[Room $A3]]
|Misery Mire
|-
|[[Room $A4]]
|Turtle Rock (Trinexx[Boss])
|-
|[[Room $A5]]
|Ganon's Tower (Wizzrobes Rooms)
|-
|[[Room $A6]]
|Ganon's Tower (Moldorm Fall Room)
|-
|[[Room $A7]]
|Tower of Hera (Fairy Room)
|-
|[[Room $A8]]
|Eastern Palace (Stalfos Spawn Room)
|-
|[[Room $A9]]
|Eastern Palace (Big Chest Room)
|-
|[[Room $AA]]
|Eastern Palace (Map Chest Room)
|-
|[[Room $AB]]
|Thieves Town (Moving Spikes / Key Pot Room)
|-
|[[Room $AC]]
|Thieves Town (Blind The Thief[Boss])
|-
|[[Room $AD]]
|Empty Clone Room
|-
|[[Room $AE]]
|Ice Palace
|-
|[[Room $AF]]
|Ice Palace (Ice Bridge Room)
|-
|[[Room $B0]]
|Agahnim's Tower (Circle of Pots)
|-
|[[Room $B1]]
|Misery Mire (Hourglass Room)
|-
|[[Room $B2]]
|Misery Mire (Slug Room)
|-
|[[Room $B3]]
|Misery Mire (Spike Key Chest Room)
|-
|[[Room $B4]]
|Turtle Rock (Pre-Trinexx Room)
|-
|[[Room $B5]]
|Turtle Rock (Dark Maze)
|-
|[[Room $B6]]
|Turtle Rock (Chain Chomps Room)
|-
|[[Room $B7]]
|Turtle Rock (Map Chest / Key Chest / Roller Room)
|-
|[[Room $B8]]
|Eastern Palace (Big Key Room)
|-
|[[Room $B9]]
|Eastern Palace (Lobby Cannonballs Room)
|-
|[[Room $BA]]
|Eastern Palace (Dark Antifairy / Key Pot Room)
|-
|[[Room $BB]]
|Thieves Town (Hellway)
|-
|[[Room $BC]]
|Thieves Town (Conveyor Toilet)
|-
|[[Room $BD]]
|Empty Clone Room
|-
|[[Room $BE]]
|Ice Palace (Block Puzzle Room)
|-
|[[Room $BF]]
|Ice Palace Clone Room (Switch Room)
|-
|[[Room $C0]]
|Agahnim's Tower (Dark Bridge Room)
|-
|[[Room $C1]]
|Misery Mire (Compass Chest / Tile Room)
|-
|[[Room $C2]]
|Misery Mire (Big Hub Room)
|-
|[[Room $C3]]
|Misery Mire (Big Chest Room)
|-
|[[Room $C4]]
|Turtle Rock (Final Crystal Switch Puzzle Room)
|-
|[[Room $C5]]
|Turtle Rock (Laser Bridge)
|-
|[[Room $C6]]
|Turtle Rock
|-
|[[Room $C7]]
|Turtle Rock (Torch Puzzle)
|-
|[[Room $C8]]
|Eastern Palace (Armos Knights[Boss])
|-
|[[Room $C9]]
|Eastern Palace (Entrance Room)
|-
|[[Room $CA]]
|??
|-
|[[Room $CB]]
|Thieves Town (North West Entrance Room)
|-
|[[Room $CC]]
|Thieves Town (North East Entrance Room)
|-
|[[Room $CD]]
|Empty Clone Room
|-
|[[Room $CE]]
|Ice Palace (Hole to Kholdstare Room)
|-
|[[Room $CF]]
|Empty Clone Room
|-
|[[Room $D0]]
|Agahnim's Tower (Dark Maze)
|-
|[[Room $D1]]
|Misery Mire (Conveyor Slug / Big Key Room)
|-
|[[Room $D2]]
|Misery Mire (Mire02 / Wizzrobes Room)
|-
|[[Room $D3]]
|Empty Clone Room
|-
|[[Room $D4]]
|Empty Clone Room
|-
|[[Room $D5]]
|Turtle Rock (Laser Key Room)
|-
|[[Room $D6]]
|Turtle Rock (Entrance Room)
|-
|[[Room $D7]]
|Empty Clone Room
|-
|[[Room $D8]]
|Eastern Palace ("Zeldagamer Room" / Pre-Armos Knights Room)
|-
|[[Room $D9]]
|Eastern Palace (Canonball Room)
|-
|[[Room $DA]]
|Eastern Palace
|-
|[[Room $DB]]
|Thieves Town (Main (South West) Entrance Room)
|-
|[[Room $DC]]
|Thieves Town (South East Entrance Room)
|-
|[[Room $DD]]
|Empty Clone Room
|-
|[[Room $DE]]
|Ice Palace (Kholdstare[Boss])
|-
|[[Room $DF]]
|Cave
|-
|[[Room $E0]]
|Agahnim's Tower (Entrance Room)
|-
|[[Room $E1]]
|Cave (Lost Woods HP)
|-
|[[Room $E2]]
|Cave (Lumberjack's Tree HP)
|-
|[[Room $E3]]
|Cave (1/2 Magic)
|-
|[[Room $E4]]
|Cave (Lost Old Man Final Cave)
|-
|[[Room $E5]]
|Cave (Lost Old Man Final Cave)
|-
|[[Room $E6]]
|Cave
|-
|[[Room $E7]]
|Cave
|-
|[[Room $E8]]
|Cave
|-
|[[Room $E9]]
|Empty Clone Room
|-
|[[Room $EA]]
|Cave (Spectacle Rock HP)
|-
|[[Room $EB]]
|Cave
|-
|[[Room $EC]]
|Empty Clone Room
|-
|[[Room $ED]]
|Cave
|-
|[[Room $EE]]
|Cave (Spiral Cave)
|-
|[[Room $EF]]
|Cave (Crystal Switch / 5 Chests Room)
|-
|[[Room $F0]]
|Cave (Lost Old Man Starting Cave)
|-
|[[Room $F1]]
|Cave (Lost Old Man Starting Cave)
|-
|[[Room $F2]]
|House
|-
|[[Room $F3]]
|House (Old Woman (Sahasrahla's Wife?))
|-
|[[Room $F4]]
|House (Angry Brothers)
|-
|[[Room $F5]]
|House (Angry Brothers)
|-
|[[Room $F6]]
|Empty Clone Room
|-
|[[Room $F7]]
|Empty Clone Room
|-
|[[Room $F8]]
|Cave
|-
|[[Room $F9]]
|Cave
|-
|[[Room $FA]]
|Cave
|-
|[[Room $FB]]
|Cave
|-
|[[Room $FC]]
|Empty Clone Room
|-
|[[Room $FD]]
|Cave
|-
|[[Room $FE]]
|Cave
|-
|[[Room $FF]]
|Cave
|}

===Secondary Map===

{{toc}}

Main Page

2017-07-22T00:57:16Z

Tatters:

This is a wiki dedicated to documenting ''The Legend of Zelda - A Link to the Past''.

[https://discordapp.com/invite/jP5csBn Join the chat!]

==Links==

{{toc}}

Overworld Areas

2017-07-21T16:51:21Z

Tatters: /* How maps are stored */

{{subpage|Overworld}}

{{see|Standard Notation}}

Outdoor areas (also known as the Overworld) come in two flavors: Normal and special. Normal outdoor areas (the Light world and the Dark world) are mirrored 8{{x}}8 grids of 512{{x}}512-pixel cells for a total of 64 cells and a 4096{{x}}4096-pixel area in size. Normal outdoor grid cells can be quadruple in size (1024{{x}}1024 pixels), in which case their indices represent their top-left quadrants and the indices for the other three quadrants they occupy do not occur. Special outdoor areas (such as Zora's Domain) are separate individual mini-areas on their own.

== Area Index ==

In WRAM, there is a byte which indicates whether or not the player is currently in an indoor or outdoor area, and when the player is in an outdoor area, there is a word which contains the index of the outdoor area the player is currently in.

;{{$|7E001B}}[{{$|1}}]
: 0 while player is outside
: 1 while player is inside

;{{$|7E008A}}[{{$|2}}]
: the current area index while player is outside
: invalid while player is inside

== Player Coordinates ==

''See also: [[Player Position]]''

Let A be the current area index, (Px,Py) be the current absolute player coordinates, and (Lx,Ly) be the local coordinates of the player within the current area.

When the player is in the Light world (area index {{$|00}}..{{$|3F}}), the player's coordinates originate at the top-left corner of area {{$|00}}, and the coordinates can be calculated as follows.

<nowiki>Lx = Px - ( A % 8 ) * 512
Ly = Py - ( A / 8 ) * 512</nowiki>

When the player is in the Dark world (area index {{$|40}}..{{$|7F}}), the player's coordinates originate at the top-left corner of area {{$|40}}, and the coordinates can be calculated as follows.

<nowiki>Lx = Px - ( ( A - $40 ) % 8 ) * 512
Ly = Py - ( ( A - $40 ) / 8 ) * 512</nowiki>

When the player is in a special area (area index {{$|80}} and up), the player's coordinates originate at the top-left corner of the current special area. There are two special areas: {{$|80}} combines the Master Sword area and the area under the bridge east of the player's house, and {{$|81}} is Zora's Domain. Local coordinates within the Master Sword area and within Zora's Domain are equal to the absolute coordinates. The player is in the area under the bridge when their X coordinate is 256 or greater, and their local X coordinate is simply their absolute X coordinate minus 256.

== The Light World and the Dark World ==

The Light world and Dark world mirror each other: Any area index in the Light world refers to an area index in the Dark world of the same size and at the same location, except the Dark world index is increased by {{$|40}}. The following table lists the areas of both worlds by their Light world name for simplicity.

{|{{prettytable}}
! Index (Light World)
! Index (Dark World)
! Size (a{{x}}a)
! Description (for Light World)
|-
|{{$|00}} (0)
|{{$|40}} (64)
|1024
|Lost Woods
|-
|{{$|02}} (2)
|{{$|42}} (66)
|512
|Lumberjacks
|-
|{{$|03}} (3)
|{{$|43}} (67)
|1024
|Western Death Mountain
|-
|{{$|05}} (5)
|{{$|45}} (69)
|1024
|Eastern Death Mountain
|-
|{{$|07}} (7)
|{{$|47}} (71)
|512
|Turtle Rock
|-
|{{$|0A}} (10)
|{{$|4A}} (74)
|512
|Entrance to Death Mountain
|-
|{{$|0F}} (15)
|{{$|4F}} (79)
|512
|Entrance to Zora's Domain
|-
|{{$|10}} (16)
|{{$|50}} (80)
|512
|Path Between Kakariko Village and Lost Woods
|-
|{{$|11}} (17)
|{{$|51}} (81)
|512
|Kakariko Village Fortune Teller
|-
|{{$|12}} (18)
|{{$|52}} (82)
|512
|Pond Between Kakariko Village Fortune Teller and Sanctuary
|-
|{{$|13}} (19)
|{{$|53}} (83)
|512
|Sanctuary
|-
|{{$|14}} (20)
|{{$|54}} (84)
|512
|Graveyard
|-
|{{$|15}} (21)
|{{$|55}} (85)
|512
|River Between Graveyard and Witch's Hut
|-
|{{$|16}} (22)
|{{$|56}} (86)
|512
|Witch's Hut
|-
|{{$|17}} (23)
|{{$|57}} (87)
|512
|East of Witch's Hut
|-
|{{$|18}} (24)
|{{$|58}} (88)
|1024
|Kakariko Village
|-
|{{$|1A}} (26)
|{{$|5A}} (90)
|512
|Forest Between Kakariko Village and Hyrule Castle
|-
|{{$|1B}} (27)
|{{$|5B}} (91)
|1024
|Hyrule Castle
|-
|{{$|1D}} (29)
|{{$|5D}} (93)
|512
|Bridge Between Graveyard and Witch's Hut
|-
|{{$|1E}} (30)
|{{$|5E}} (94)
|1024
|Eastern Palace
|-
|{{$|22}} (34)
|{{$|62}} (98)
|512
|Smithy
|-
|{{$|25}} (37)
|{{$|65}} (101)
|512
|Path Between Hyrule Castle and Eastern Palace}} (top)
|-
|{{$|28}} (40)
|{{$|68}} (104)
|512
|Kakariko Village Maze Race
|-
|{{$|29}} (41)
|{{$|69}} (105)
|512
|Kakariko Village Library
|-
|{{$|2A}} (42)
|{{$|6A}} (106)
|512
|Haunted Grove
|-
|{{$|2B}} (43)
|{{$|6B}} (107)
|512
|Forest Between Haunted Grove and Link's House
|-
|{{$|2C}} (44)
|{{$|6C}} (108)
|512
|Link's House
|-
|{{$|2D}} (45)
|{{$|6D}} (109)
|512
|Path Between Hyrule Castle and Eastern Palace}} (bottom)
|-
|{{$|2E}} (46)
|{{$|6E}} (110)
|512
|Caves South of Eastern Palace (left)
|-
|{{$|2F}} (47)
|{{$|6F}} (111)
|512
|Caves South of Eastern Palace (right)
|-
|{{$|30}} (48)
|{{$|70}} (112)
|1024
|Desert of Mystery
|-
|{{$|32}} (50)
|{{$|72}} (114)
|512
|South of Haunted Grove
|-
|{{$|33}} (51)
|{{$|73}} (115)
|512
|Northwestern Great Swamp
|-
|{{$|34}} (52)
|{{$|74}} (116)
|512
|Northeastern Great Swamp
|-
|{{$|35}} (53)
|{{$|75}} (117)
|1024
|Lake Hylia
|-
|{{$|37}} (55)
|{{$|77}} (119)
|512
|Ice Cave
|-
|{{$|3A}} (58)
|{{$|7A}} (122)
|512
|Path Between Desert of Mystery and Great Swamp
|-
|{{$|3B}} (59)
|{{$|7B}} (123)
|512
|Southwestern Great Swamp
|-
|{{$|3C}} (60)
|{{$|7C}} (124)
|512
|Southeastern Great Swamp
|-
|{{$|3F}} (63)
|{{$|7F}} (127)
|512
|Path Between Lake Hylia and Ice Cave
|}

== Special Areas ==

;{{$|80}} ― 512{{x}}512
: Master Sword area ― (0,0) to (255,511)
: Area under the bridge ― (256,0) to (511,255)

;{{$|81}} ― 512{{x}}512
: Zora's Domain

==How maps are stored==
===Compression===
The background is composed of 32{{x}}32 blocks and are LZ1 compressed.

===Map32 to Map16 Conversion Values===
* {{0x|18000|1B3FE|3FE}} = Upper leftcorners //end with $FF at 0x1B3FF
* {{0x|1B400|1E7FE|3FE}} = Upper right corners //end with $FF at 0x1E7FF
* {{0x|20000|233FE|3FE}} = Lower leftcorners //end with $FF at 0x233FF
* {{0x|23400|267EE|3FE}} = Lower right corners //end with $FF at 0x267EF

{{note|1=Theses value come in pack of {{blue|4 bytes}}, followed by {{green|2 bytes}}. The {{green|2 bytes}} are 4 nibble value that are the extension of the {{blue|4 first}}}}

{{example|1=You have theses bytes:

{{blue|05 06 07 08 }}{{green|30 1A}}

* {{blue|05}} become {{$|305}}
* {{blue|06}} stays {{$|06}}
* {{blue|07}} become {{$|107}}
* {{blue|08}} become {{$|A08}}}}

==Map8 to Map16 Conversion Values==
* {{0x|78000|?????|470?}} = Map8 to Map16 conversion values (8 bytes per tile16), 2 byte each tile8
* {{red|v}}{{orange|h}}{{green|o}}{{blue|ppp}}{{purple|cc cccccccc}}
** {{red|v}} = mirror vertical
** {{orange|h}} = mirror horizontal
** {{green|o}} = ???
** {{blue|p}} = priority tile
** {{purple|c}} = tile index

==Map Size==
* {{0x|12844|12883}} = 1byte each map
** {{$|00}} = 512x512pixel map
** {{$|20}} = 1024x1024 pixel map

==Compressed tile arragement==
* {{0x|1794D}} = LONGPointers all tiles of maps [High] (mapid3)
* {{0x|17B2D}} = LONGPointers all tiles of maps [Low](mapid3)

{{Note|Data leading to is compressed using the LZ2 compression {{0x|05D97}} tiles gfx to load the map (correspond to GFX# in HM) surprisingly overworld only use 32 to 47 LW, 48 to 63 DW, 4 bytes per gfx}}

{{toc}}

Template:Example

2017-07-21T16:40:03Z

Tatters: Created page with "<includeonly><div style="border: 1px solid rgb(150, 150, 0); margin: 0.5em; padding: 0.5em; background-color: rgb(255, 255, 200);" class="plainlinks">'''Example:'''<br>{{{1}}}..."

<includeonly><div style="border: 1px solid rgb(150, 150, 0); margin: 0.5em; padding: 0.5em; background-color: rgb(255, 255, 200);" class="plainlinks">'''Example:'''<br>{{{1}}}</div>[[Category:Example]]</includeonly>
<noinclude>{{Example|Text}}[[Category:Templates]]</noinclude>

Overworld Areas

2017-07-21T16:30:09Z

Tatters: /* The Light World and the Dark World */

{{subpage|Overworld}}

{{see|Standard Notation}}

Outdoor areas (also known as the Overworld) come in two flavors: Normal and special. Normal outdoor areas (the Light world and the Dark world) are mirrored 8{{x}}8 grids of 512{{x}}512-pixel cells for a total of 64 cells and a 4096{{x}}4096-pixel area in size. Normal outdoor grid cells can be quadruple in size (1024{{x}}1024 pixels), in which case their indices represent their top-left quadrants and the indices for the other three quadrants they occupy do not occur. Special outdoor areas (such as Zora's Domain) are separate individual mini-areas on their own.

== Area Index ==

In WRAM, there is a byte which indicates whether or not the player is currently in an indoor or outdoor area, and when the player is in an outdoor area, there is a word which contains the index of the outdoor area the player is currently in.

;{{$|7E001B}}[{{$|1}}]
: 0 while player is outside
: 1 while player is inside

;{{$|7E008A}}[{{$|2}}]
: the current area index while player is outside
: invalid while player is inside

== Player Coordinates ==

''See also: [[Player Position]]''

Let A be the current area index, (Px,Py) be the current absolute player coordinates, and (Lx,Ly) be the local coordinates of the player within the current area.

When the player is in the Light world (area index {{$|00}}..{{$|3F}}), the player's coordinates originate at the top-left corner of area {{$|00}}, and the coordinates can be calculated as follows.

<nowiki>Lx = Px - ( A % 8 ) * 512
Ly = Py - ( A / 8 ) * 512</nowiki>

When the player is in the Dark world (area index {{$|40}}..{{$|7F}}), the player's coordinates originate at the top-left corner of area {{$|40}}, and the coordinates can be calculated as follows.

<nowiki>Lx = Px - ( ( A - $40 ) % 8 ) * 512
Ly = Py - ( ( A - $40 ) / 8 ) * 512</nowiki>

When the player is in a special area (area index {{$|80}} and up), the player's coordinates originate at the top-left corner of the current special area. There are two special areas: {{$|80}} combines the Master Sword area and the area under the bridge east of the player's house, and {{$|81}} is Zora's Domain. Local coordinates within the Master Sword area and within Zora's Domain are equal to the absolute coordinates. The player is in the area under the bridge when their X coordinate is 256 or greater, and their local X coordinate is simply their absolute X coordinate minus 256.

== The Light World and the Dark World ==

The Light world and Dark world mirror each other: Any area index in the Light world refers to an area index in the Dark world of the same size and at the same location, except the Dark world index is increased by {{$|40}}. The following table lists the areas of both worlds by their Light world name for simplicity.

{|{{prettytable}}
! Index (Light World)
! Index (Dark World)
! Size (a{{x}}a)
! Description (for Light World)
|-
|{{$|00}} (0)
|{{$|40}} (64)
|1024
|Lost Woods
|-
|{{$|02}} (2)
|{{$|42}} (66)
|512
|Lumberjacks
|-
|{{$|03}} (3)
|{{$|43}} (67)
|1024
|Western Death Mountain
|-
|{{$|05}} (5)
|{{$|45}} (69)
|1024
|Eastern Death Mountain
|-
|{{$|07}} (7)
|{{$|47}} (71)
|512
|Turtle Rock
|-
|{{$|0A}} (10)
|{{$|4A}} (74)
|512
|Entrance to Death Mountain
|-
|{{$|0F}} (15)
|{{$|4F}} (79)
|512
|Entrance to Zora's Domain
|-
|{{$|10}} (16)
|{{$|50}} (80)
|512
|Path Between Kakariko Village and Lost Woods
|-
|{{$|11}} (17)
|{{$|51}} (81)
|512
|Kakariko Village Fortune Teller
|-
|{{$|12}} (18)
|{{$|52}} (82)
|512
|Pond Between Kakariko Village Fortune Teller and Sanctuary
|-
|{{$|13}} (19)
|{{$|53}} (83)
|512
|Sanctuary
|-
|{{$|14}} (20)
|{{$|54}} (84)
|512
|Graveyard
|-
|{{$|15}} (21)
|{{$|55}} (85)
|512
|River Between Graveyard and Witch's Hut
|-
|{{$|16}} (22)
|{{$|56}} (86)
|512
|Witch's Hut
|-
|{{$|17}} (23)
|{{$|57}} (87)
|512
|East of Witch's Hut
|-
|{{$|18}} (24)
|{{$|58}} (88)
|1024
|Kakariko Village
|-
|{{$|1A}} (26)
|{{$|5A}} (90)
|512
|Forest Between Kakariko Village and Hyrule Castle
|-
|{{$|1B}} (27)
|{{$|5B}} (91)
|1024
|Hyrule Castle
|-
|{{$|1D}} (29)
|{{$|5D}} (93)
|512
|Bridge Between Graveyard and Witch's Hut
|-
|{{$|1E}} (30)
|{{$|5E}} (94)
|1024
|Eastern Palace
|-
|{{$|22}} (34)
|{{$|62}} (98)
|512
|Smithy
|-
|{{$|25}} (37)
|{{$|65}} (101)
|512
|Path Between Hyrule Castle and Eastern Palace}} (top)
|-
|{{$|28}} (40)
|{{$|68}} (104)
|512
|Kakariko Village Maze Race
|-
|{{$|29}} (41)
|{{$|69}} (105)
|512
|Kakariko Village Library
|-
|{{$|2A}} (42)
|{{$|6A}} (106)
|512
|Haunted Grove
|-
|{{$|2B}} (43)
|{{$|6B}} (107)
|512
|Forest Between Haunted Grove and Link's House
|-
|{{$|2C}} (44)
|{{$|6C}} (108)
|512
|Link's House
|-
|{{$|2D}} (45)
|{{$|6D}} (109)
|512
|Path Between Hyrule Castle and Eastern Palace}} (bottom)
|-
|{{$|2E}} (46)
|{{$|6E}} (110)
|512
|Caves South of Eastern Palace (left)
|-
|{{$|2F}} (47)
|{{$|6F}} (111)
|512
|Caves South of Eastern Palace (right)
|-
|{{$|30}} (48)
|{{$|70}} (112)
|1024
|Desert of Mystery
|-
|{{$|32}} (50)
|{{$|72}} (114)
|512
|South of Haunted Grove
|-
|{{$|33}} (51)
|{{$|73}} (115)
|512
|Northwestern Great Swamp
|-
|{{$|34}} (52)
|{{$|74}} (116)
|512
|Northeastern Great Swamp
|-
|{{$|35}} (53)
|{{$|75}} (117)
|1024
|Lake Hylia
|-
|{{$|37}} (55)
|{{$|77}} (119)
|512
|Ice Cave
|-
|{{$|3A}} (58)
|{{$|7A}} (122)
|512
|Path Between Desert of Mystery and Great Swamp
|-
|{{$|3B}} (59)
|{{$|7B}} (123)
|512
|Southwestern Great Swamp
|-
|{{$|3C}} (60)
|{{$|7C}} (124)
|512
|Southeastern Great Swamp
|-
|{{$|3F}} (63)
|{{$|7F}} (127)
|512
|Path Between Lake Hylia and Ice Cave
|}

== Special Areas ==

;{{$|80}} ― 512{{x}}512
: Master Sword area ― (0,0) to (255,511)
: Area under the bridge ― (256,0) to (511,255)

;{{$|81}} ― 512{{x}}512
: Zora's Domain

==How maps are stored==

===Background===

The background is composed of 32{{x}}32 blocks and are LZ1 compressed.

{{toc}}

Overworld Areas

2017-07-21T16:18:03Z

Tatters: /* How maps are stored */

{{subpage|Overworld}}

{{see|Standard Notation}}

Outdoor areas (also known as the Overworld) come in two flavors: Normal and special. Normal outdoor areas (the Light world and the Dark world) are mirrored 8{{x}}8 grids of 512{{x}}512-pixel cells for a total of 64 cells and a 4096{{x}}4096-pixel area in size. Normal outdoor grid cells can be quadruple in size (1024{{x}}1024 pixels), in which case their indices represent their top-left quadrants and the indices for the other three quadrants they occupy do not occur. Special outdoor areas (such as Zora's Domain) are separate individual mini-areas on their own.

== Area Index ==

In WRAM, there is a byte which indicates whether or not the player is currently in an indoor or outdoor area, and when the player is in an outdoor area, there is a word which contains the index of the outdoor area the player is currently in.

;{{$|7E001B}}[{{$|1}}]
: 0 while player is outside
: 1 while player is inside

;{{$|7E008A}}[{{$|2}}]
: the current area index while player is outside
: invalid while player is inside

== Player Coordinates ==

''See also: [[Player Position]]''

Let A be the current area index, (Px,Py) be the current absolute player coordinates, and (Lx,Ly) be the local coordinates of the player within the current area.

When the player is in the Light world (area index {{$|00}}..{{$|3F}}), the player's coordinates originate at the top-left corner of area {{$|00}}, and the coordinates can be calculated as follows.

<nowiki>Lx = Px - ( A % 8 ) * 512
Ly = Py - ( A / 8 ) * 512</nowiki>

When the player is in the Dark world (area index {{$|40}}..{{$|7F}}), the player's coordinates originate at the top-left corner of area {{$|40}}, and the coordinates can be calculated as follows.

<nowiki>Lx = Px - ( ( A - $40 ) % 8 ) * 512
Ly = Py - ( ( A - $40 ) / 8 ) * 512</nowiki>

When the player is in a special area (area index {{$|80}} and up), the player's coordinates originate at the top-left corner of the current special area. There are two special areas: {{$|80}} combines the Master Sword area and the area under the bridge east of the player's house, and {{$|81}} is Zora's Domain. Local coordinates within the Master Sword area and within Zora's Domain are equal to the absolute coordinates. The player is in the area under the bridge when their X coordinate is 256 or greater, and their local X coordinate is simply their absolute X coordinate minus 256.

== The Light World and the Dark World ==

The Light world and Dark world mirror each other: Any area index in the Light world refers to an area index in the Dark world of the same size and at the same location, except the Dark world index is increased by {{$|40}}. The following table lists the areas of both worlds by their Light world name for simplicity.

{|{{prettytable}}
! Index (Light World)
! Location (Light World)
! Index (Dark World)
! Location (Dark World)
! Size (a{{x}}a)
! Description (for Light World)
|-
|{{$|00}} (0)
|{{address|0x|8008|????}}(?)
|{{$|40}} (64)
|
|1024
|Lost Woods
|-
|{{$|02}} (2)
|
|{{$|42}} (66)
|
|512
|Lumberjacks
|-
|{{$|03}} (3)
|
|{{$|43}} (67)
|
|1024
|Western Death Mountain
|-
|{{$|05}} (5)
|
|{{$|45}} (69)
|
|1024
|Eastern Death Mountain
|-
|{{$|07}} (7)
|
|{{$|47}} (71)
|
|512
|Turtle Rock
|-
|{{$|0A}} (10)
|
|{{$|4A}} (74)
|
|512
|Entrance to Death Mountain
|-
|{{$|0F}} (15)
|
|{{$|4F}} (79)
|
|512
|Entrance to Zora's Domain
|-
|{{$|10}} (16)
|
|{{$|50}} (80)
|
|512
|Path Between Kakariko Village and Lost Woods
|-
|{{$|11}} (17)
|
|{{$|51}} (81)
|
|512
|Kakariko Village Fortune Teller
|-
|{{$|12}} (18)
|
|{{$|52}} (82)
|
|512
|Pond Between Kakariko Village Fortune Teller and Sanctuary
|-
|{{$|13}} (19)
|
|{{$|53}} (83)
|
|512
|Sanctuary
|-
|{{$|14}} (20)
|
|{{$|54}} (84)
|
|512
|Graveyard
|-
|{{$|15}} (21)
|
|{{$|55}} (85)
|
|512
|River Between Graveyard and Witch's Hut
|-
|{{$|16}} (22)
|
|{{$|56}} (86)
|
|512
|Witch's Hut
|-
|{{$|17}} (23)
|
|{{$|57}} (87)
|
|512
|East of Witch's Hut
|-
|{{$|18}} (24)
|
|{{$|58}} (88)
|
|1024
|Kakariko Village
|-
|{{$|1A}} (26)
|
|{{$|5A}} (90)
|
|512
|Forest Between Kakariko Village and Hyrule Castle
|-
|{{$|1B}} (27)
|
|{{$|5B}} (91)
|
|1024
|Hyrule Castle
|-
|{{$|1D}} (29)
|
|{{$|5D}} (93)
|
|512
|Bridge Between Graveyard and Witch's Hut
|-
|{{$|1E}} (30)
|
|{{$|5E}} (94)
|
|1024
|Eastern Palace
|-
|{{$|22}} (34)
|
|{{$|62}} (98)
|
|512
|Smithy
|-
|{{$|25}} (37)
|
|{{$|65}} (101)
|
|512
|Path Between Hyrule Castle and Eastern Palace}} (top)
|
|-
|{{$|28}} (40)
|
|{{$|68}} (104)
|
|512
|Kakariko Village Maze Race
|-
|{{$|29}} (41)
|
|{{$|69}} (105)
|
|512
|Kakariko Village Library
|-
|{{$|2A}} (42)
|
|{{$|6A}} (106)
|
|512
|Haunted Grove
|-
|{{$|2B}} (43)
|
|{{$|6B}} (107)
|
|512
|Forest Between Haunted Grove and Link's House
|-
|{{$|2C}} (44)
|
|{{$|6C}} (108)
|
|512
|Link's House
|-
|{{$|2D}} (45)
|
|{{$|6D}} (109)
|
|512
|Path Between Hyrule Castle and Eastern Palace}} (bottom)
|
|-
|{{$|2E}} (46)
|
|{{$|6E}} (110)
|
|512
|Caves South of Eastern Palace (left)
|
|-
|{{$|2F}} (47)
|
|{{$|6F}} (111)
|
|512
|Caves South of Eastern Palace (right)
|
|-
|{{$|30}} (48)
|
|{{$|70}} (112)
|
|1024
|Desert of Mystery
|-
|{{$|32}} (50)
|
|{{$|72}} (114)
|
|512
|South of Haunted Grove
|-
|{{$|33}} (51)
|
|{{$|73}} (115)
|
|512
|Northwestern Great Swamp
|-
|{{$|34}} (52)
|
|{{$|74}} (116)
|
|512
|Northeastern Great Swamp
|-
|{{$|35}} (53)
|
|{{$|75}} (117)
|
|1024
|Lake Hylia
|-
|{{$|37}} (55)
|
|{{$|77}} (119)
|
|512
|Ice Cave
|-
|{{$|3A}} (58)
|
|{{$|7A}} (122)
|
|512
|Path Between Desert of Mystery and Great Swamp
|-
|{{$|3B}} (59)
|
|{{$|7B}} (123)
|
|512
|Southwestern Great Swamp
|-
|{{$|3C}} (60)
|
|{{$|7C}} (124)
|
|512
|Southeastern Great Swamp
|-
|{{$|3F}} (63)
|
|{{$|7F}} (127)
|
|512
|Path Between Lake Hylia and Ice Cave
|}

== Special Areas ==

;{{$|80}} ― 512{{x}}512
: Master Sword area ― (0,0) to (255,511)
: Area under the bridge ― (256,0) to (511,255)

;{{$|81}} ― 512{{x}}512
: Zora's Domain

==How maps are stored==

===Background===

The background is composed of 32{{x}}32 blocks and are LZ1 compressed.

{{toc}}

Monologue

2017-07-02T19:24:20Z

Tatters: /* Pointers */

== Font ==

The Japanese font is compressed.

The font for the English version is in the uncompressed 2BPP format.

{|{{prettytable}}
!English
!German
|-
|[[File:Font_(U).png|256px]]
|[[File:Font_(G).png|256px]]
|}

* The German version's font is shorter by one pixel in some cases.
* The arrows are largers in the German version.
* The German version uses more graphic space.
* Certain characters are different like "C".

The German version has additional font characters at {{0x|77500}} for the menu screen in the uncompressed 2BPP format. The English releases has the font compressed as 3BPP in a different locaiton.

== English version ==

=== Pointers ===

Each dialogue entry in the game doesn't have a pointer, rather, the pointers for each entry are generated while the game runs through some calculations. As a result, we have <u>two</u> pointers for the dialogue, which is split up into <u>two</u> banks.

{|{{prettytable}}
!
!Lo
!Hi
!Bank
!Assembled pointer
!Size
|-
!Bank 1
|{{0x|753F5}}
|{{0x|753F6}}
|{{0x|753EF}}
|{{0x|E0000}}
|{{$|8000}}
|-
!Bank 2
|{{0x|75437}}
|{{0x|75438}}
|{{0x|7543C}}
|{{0x|75F40}}
|{{$|14C0}}
|}

The "assembled pointer" is the address where the dialogue is located at. The size of the monologues isn't actually a stored value.

=== Widths ===

The widths for each character are located at {{address|0x|74ADF|74B41|62}}

=== DTE ===

The English version uses DTE compression. The pointer starts at {{0x|74703}} with {{$|61}} entries. The pointers are two bytes long in {{hex|LO HI}} order. The dictionary entries are in the same bank so the bank value is implied. The dictionary values have no delimiter, the end of each entry is calculated by the next pointer. The last entry is three bytes long (not sure how this is determined in the game). There is zero room for expansion because code starts immediately after the DTE table.

{{toc}}

Monologue

2017-07-02T19:22:46Z

Tatters: /* English version */

== Font ==

The Japanese font is compressed.

The font for the English version is in the uncompressed 2BPP format.

{|{{prettytable}}
!English
!German
|-
|[[File:Font_(U).png|256px]]
|[[File:Font_(G).png|256px]]
|}

* The German version's font is shorter by one pixel in some cases.
* The arrows are largers in the German version.
* The German version uses more graphic space.
* Certain characters are different like "C".

The German version has additional font characters at {{0x|77500}} for the menu screen in the uncompressed 2BPP format. The English releases has the font compressed as 3BPP in a different locaiton.

== English version ==

=== Pointers ===

Each dialogue entry in the game doesn't have a pointer, rather, the pointers for each entry are generated while the game runs through some calculations. As a result, we have <u>two</u> pointers for the dialogue which is split up into <u>two</u> banks.

{|{{prettytable}}
!
!Lo
!Hi
!Bank
!Assembled pointer
!Size
|-
!Bank 1
|{{0x|753F5}}
|{{0x|753F6}}
|{{0x|753EF}}
|{{0x|E0000}}
|{{$|8000}}
|-
!Bank 2
|{{0x|75437}}
|{{0x|75438}}
|{{0x|7543C}}
|{{0x|75F40}}
|{{$|14C0}}
|}

The "assembled pointer" is the address where the dialogue is located at. The size of the monologues isn't actually a stored value.

=== Widths ===

The widths for each character are located at {{address|0x|74ADF|74B41|62}}

=== DTE ===

The English version uses DTE compression. The pointer starts at {{0x|74703}} with {{$|61}} entries. The pointers are two bytes long in {{hex|LO HI}} order. The dictionary entries are in the same bank so the bank value is implied. The dictionary values have no delimiter, the end of each entry is calculated by the next pointer. The last entry is three bytes long (not sure how this is determined in the game). There is zero room for expansion because code starts immediately after the DTE table.

{{toc}}

Monologue

2017-07-02T19:14:19Z

Tatters: /* Pointers */

== Font ==

The Japanese font is compressed.

The font for the English version is in the uncompressed 2BPP format.

{|{{prettytable}}
!English
!German
|-
|[[File:Font_(U).png|256px]]
|[[File:Font_(G).png|256px]]
|}

* The German version's font is shorter by one pixel in some cases.
* The arrows are largers in the German version.
* The German version uses more graphic space.
* Certain characters are different like "C".

The German version has additional font characters at {{0x|77500}} for the menu screen in the uncompressed 2BPP format. The English releases has the font compressed as 3BPP in a different locaiton.

== English version ==

=== Pointers ===

Each dialogue entry in the game doesn't have a pointer, rather, the pointers for each entry are generated while the game runs through some calculations. As a result, we have <u>two</u> pointers for the dialogue which is split up into <u>two</u> banks.

{|{{prettytable}}
!
!Lo
!Hi
!Bank
!Assembled pointer
!Size
|-
!Bank 1
|{{0x|753F5}}
|{{0x|753F6}}
|{{0x|753EF}}
|{{0x|E0000}}
|{{$|8000}}
|-
!Bank 2
|{{0x|75437}}
|{{0x|75438}}
|{{0x|7543C}}
|{{0x|75F40}}
|{{$|14C0}}
|}

The "assembled pointer" is the address where the dialogue is located at. The size of the monologues isn't actually a stored value.

=== Widths ===

The widths for each character are located at {{address|0x|74ADF|74B41|62}}

{{toc}}

Monologue

2017-07-02T19:12:27Z

Tatters: /* Font */

== Font ==

The Japanese font is compressed.

The font for the English version is in the uncompressed 2BPP format.

{|{{prettytable}}
!English
!German
|-
|[[File:Font_(U).png|256px]]
|[[File:Font_(G).png|256px]]
|}

* The German version's font is shorter by one pixel in some cases.
* The arrows are largers in the German version.
* The German version uses more graphic space.
* Certain characters are different like "C".

The German version has additional font characters at {{0x|77500}} for the menu screen in the uncompressed 2BPP format. The English releases has the font compressed as 3BPP in a different locaiton.

== English version ==

=== Pointers ===

Each dialogue entry in the game doesn't have a pointer, rather, the pointers for each entry are generated while the game runs through some calculations. As a result, we have two pointers for the dialogue which is split up into two banks.

{|{{prettytable}}
!
!Lo
!Hi
!Bank
!Assembled pointer
!Size
|-
!Bank 1
|{{0x|753F5}}
|{{0x|753F6}}
|{{0x|753EF}}
|{{0x|E0000}}
|{{$|8000}}
|-
!Bank 2
|{{0x|75437}}
|{{0x|75438}}
|{{0x|7543C}}
|{{0x|75F40}}
|{{$|14C0}}
|}

The "assembled pointer" is the address where the dialogue is located at. The size of the monologues isn't actually a stored value.

=== Widths ===

The widths for each character are located at {{address|0x|74ADF|74B41|62}}

{{toc}}

Monologue

2017-07-02T19:11:14Z

Tatters: /* English version */