ShimmerFairy: /* Gameshark Codes */ Add more codes for Debug ROM

2015-03-01T02:59:15Z

‎Gameshark Codes: Add more codes for Debug ROM

ShimmerFairy: Fix tutorial, add Happy Mask Salesman code

2015-02-24T07:59:50Z

Fix tutorial, add Happy Mask Salesman code

Show changes

ShimmerFairy: Copy from OoT wiki (not corrected for MM yet)

2015-02-24T01:43:24Z

Copy from OoT wiki (not corrected for MM yet)

New page

This tutorial will show you how to replace any actor, object, or variable in the game, with the exception of those which are dynamically spawned.

==Reference Material==

===Finding Room Headers===

# Open the '''Ocarina of Time Debug ROM''' or '''Ocarina of Time 1.0''' in '''Nemu64'''.
# Go to the room you wish to find the header for.
# Go to Nemu's '''Plugins''' menu and choose '''Debugger:Memory'''.
# Type '''80223CE8''' (Debug ROM) or '''80120C44''' (1.0) into the address box.
#* This will bring you to '''80223CE8''', where you'll find the current room address in the first column.
# Paste the address of the current room into the address box.
# This will bring you to the room header.

===Understanding Room Headers===
More details about these commands can be found on the [[Scenes and Rooms]] page.

{| class="wikitable"
| 18000000 bboooooo ||
|-
| 16000000 000000yy || 08xx0000 0000yyzz
|-
| 12000000 xx010000 || 10000000 xxxxyy00
|-
| 0A000000 bboooooo || 0Bxx0000 bboooooo
|-
| 01xx0000 bboooooo || 14000000 00000000
|}

* '''Alternate Setups List:''' 18000000 bboooooo
** Optional. If it doesn't exist, the scene only has one setup. If it does exist, it will have multiple scene setups

* '''Sound Settings:''' 16000000 000000yy
** '''y''' sets the echo level of the sound effects

* '''Room Behavior Settings:''' 08xx0000 0000yyzz
** '''x''' and '''z''' affect various properties, such as Link's idling animation. This command hasn't been fully documented yet.

* '''Skybox Settings:''' 12000000 xx000000
** If '''x ≠ 0''', the skybox will be disabled.

* '''Time Settings:''' 10000000 xxxxyy00
** '''x''' sets the time of day when entering the room.
*** If '''x = FFFF''', the room defaults to the current game time.
** '''y''' sets the speed at which time flows. The value can be negative.

* '''Mesh Header Location:''' 0A000000 bboooooo
** '''b''' is the bank index. 03 is used to reference the current room file.
** '''o''' is the location of the room's mesh header, relative to the start of the file. This renders the room's model.
*** '''room header address''' + '''o''' = location of mesh header

* '''Object List:''' 0Bxx0000 bboooooo
** '''x''' indicates the number of objects.
** '''b''' is the bank index. 03 is used to reference the current room file.
** '''o''' is the location of the room's object list, relative to the start of the file.
*** '''room header address''' + '''o''' = location of object list

* '''Actor List:''' 01xx0000 bboooooo
** '''x''' indicates the number of actors.
** '''b''' is the bank index. 03 is used to reference the current room file.
** '''o''' is the location of the room's actor list, relative to the start of the file.
*** '''room header address''' + '''o''' = location of actor list

* '''End of Header Command:''' 14000000 00000000
** This command tells the game that the header ends here.

===Understanding Actor Lists===

Each line represents a different actor.

{| class="wikitable"
| aaaaxxxx yyyyzzzz || ccddee0B 0000vvvv
|-
| aaaaxxxx yyyyzzzz || ccddee00 0000vvvv
|-
| aaaaxxxx yyyyzzzz || ccddee9F 0000vvvv
|-
| aaaaxxxx yyyyzzzz || ccddee00 0000vvvv
|-
| aaaaxxxx yyyyzzzz || ccddee00 0000vvvv
|-
| aaaaxxxx yyyyzzzz || ccddee00 0000vvvv
|-
| aaaaxxxx yyyyzzzz || ccddee00 0000vvvv
|}

* '''aaaa''' = [[Actor List|Actor Number]]
* '''xxxx''' = X Coordinates (Hex)
* '''yyyy''' = Y Coordinates (Hex)
* '''zzzz''' = Z Coordinates (Hex)
* '''cc''' = X Rotation (Hex)
* '''dd''' = Y Rotation (Hex)
* '''ee''' = Z Rotation (Hex)
* '''vvvv''' = [[Actor List (Variables)|Variable Number]]

===Understanding Object Lists===

Each group of four digits/two bytes (ex. 01A5) comprises an object number. If a room has an odd number of objects (05 in this example), you only need to pay attention to the first five groups of four digits.

{| class="wikitable"
|-
| aaaabbbb ccccdddd || eeee0000 0163FFC8
|}

* aaaa = Object #1
* bbbb = Object #2
* cccc = Object #3
* dddd = Object #4
* eeee = Object #5
* 0000 = Padding

Look up the object numbers [[LINK|here]].

==Tutorial: Replacing a Treasure Chest in Mido's House==

===What You'll Need===

# '''Nemu64 Emulator'''
# '''Ocarina of Time Debug ROM'''
# '''Hex Calculator'''

Open Windows Calculator, change it to "Programmer" mode, and press the Hex button. Or, use an online calculator like [http://www.miniwebtool.com/hex-calculator/ this one].

===Room Header===

====Finding the Room Header====

# Go to '''Mido's House''' (Map 49 in Map Select) as Child Link.
# Go to Nemu's '''Plugins''' menu and choose '''Debugger:Memory'''.
# Type '''80223CE8''' into the address box.
#* This will bring you to '''80223CE8''', where you'll find the current room address in the first column.
#* The memory address for Mido's House is '''80262880'''.
# Paste the address of the current room ('''80262880''') into the address box.
# This will bring you to '''80262880''', where you'll find the room header.

====Deciphering the Room Header====

Below is the room header for Mido's House, located at '''80262880'''. Use it to find the number of scene setups, the number of objects, the address of the object list, the number of actors, and the address of the actor list.

{| class="wikitable"
| 16000000 00000003 || 08020000 00000005
|-
| 12000000 00010000 || 10000000 FFFF0000
|-
| 0A000000 030000C0 || 0B050000 03000040
|-
| 01070000 0300004C || 14000000 00000000
|}

* '''Scene Settings:''' xx000000 000000yy
** If '''xx = 16''', the room has one scene setup.
** If '''xx = 18''', the room has multiple scene setups.

'''xx = 16''' - Mido's house has one scene setup.

* '''Object List:''' 0Bxx0000 000000yy
** '''xx''' indicates the number of objects.
** '''yy''' is the location of the room's object list.
*** '''room header address''' + '''yy''' = location of object list

'''xx = 05''' - There are 05 objects in the room.
'''yy = 40''' - The location of the object list is '''80262880 + 40''', which is '''802628C0'''.

* '''Actor List:''' 01xx0000 000000yy
** '''xx''' indicates the number of actors.
** '''yy''' is the location of the room's actor list.
*** '''room header address''' + '''yy''' = location of actor list

'''xx = 07''' - There are 07 actors in the room.
'''yy = 4C''' - The location of the actor list is '''80262880 + 4C''', which is '''802628CC'''.

===Actors===

====Finding the Actor List====

# Type '''802628CC''', the location of the actor list, into the address box.
#* This will bring you to '''802628CC''', where you'll find a list of actors.
# Look up the actor numbers.
# Look up the variables.
# Replace them with whatever you want.

====Deciphering the Actor List====

Below is the actor list for Mido's House, located at '''802628CC'''. Each line represents an actor. Mido's House has 07 actors, so there are 07 lines.

{| class="wikitable"
| 0163FFC8 00100080 || 0000960B 0000FF04
|-
| 016D0003 00300086 || 00008000 0000FF00
|-
| 0163FF83 000C0048 || 0000549F 0000FF00
|-
| 000A003A 0000FFC9 || 00004000 000059A0
|-
| 000A003A 00000023 || 00004000 000059A1
|-
| 000AFFC4 0000FFC9 || 0000C000 00005982
|-
| 000AFFC4 00000023 || 0000C000 00005903
|}

The first four digits in each line comprise an actor number. Cross-reference them with [[LINK|this list]].

{| class="wikitable"
! Actor # || Filename || Actor ID || X || Y || Z || Variable # || Variable ID || Object #
|-
| 0163 || ovl_En_Ko || Kokiri Child || FFC8 || 0010 || 0080 || FF04 || ??? || 0001
|-
| 016D || ovl_En_Md || Mido || 0003 || 0030 || 0086 || FF00 || ??? || 00FB
|-
| 0163 || ovl_En_Ko || Kokiri Child || FF83 || 000C || 0048 || FF00 || ??? || 0001
|-
| 000A || ovl_En_Box || Treasure Chest || 003A || 0000 || FFC9 || 59A0 || ??? || 000E
|-
| 000A || ovl_En_Box || Treasure Chest || 003A || 0000 || 0023 || 59A1 || ??? || 000E
|-
| 000A || ovl_En_Box || Treasure Chest || FFC4 || 0000 || FFC9 || 5982 || ??? || 000E
|-
| 000A || ovl_En_Box || Treasure Chest || FFC4 || 0000 || 0023 || 5903 || ??? || 000E
|}

====Replacing Actors====

# Find the actor number of the actor you wish to replace.
#* Let's replace the treasure chest in line 4. ('''000A''')
# Find the [[Actor List|actor number]] of the actor you wish to replace it with.
#* Let's replace the treasure chest ('''000A''') with a sign ('''0141''').
# Overwrite the old actor number with the new one.
#* '''000A003A 0000FFC9 00004000 000059A0 -> 000A003A 0000FFC9 00004000 000059A0'''
# Find the variable number of the actor you wish to replace.
#* The variable of the treasure chest in line 4 is '''59A0'''.
# Find the [[LINK|variable number]] you will use for the new actor.
#* Let's make our sign say "XXXX". ('''XXXX''')
# Overwrite the old variable number with the new one.
#* '''000A003A 0000FFC9 00004000 000059A0 -> 000A003A 0000FFC9 00004000 0000XXXX'''

===Objects===

====Finding the Object List====

# Type '''802628C0''', the location of the object list, into the address box.
#* This will bring you to '''802628C0''', where you'll find a list of objects.
# Look up the object numbers.
# Replace them with whatever you want.

====Deciphering the Object List====

Below is the object list for Mido's House, located at '''802628C0'''. Each group of four digits comprises an object number. Cross-reference them with [[LINK|this list]]. Mido's House has 05 objects, so we only need to pay attention to the first five groups of four digits.

{| class="wikitable"
|-
| 00C500FC 00FD00FB || 000E0000 0163FFC8
|}

These numbers correspond to the following:

{| class="wikitable"
! Object # || Filename || Object ID
|-
| 00C5 || object_os_anime || Required by human-like npcs
|-
| 00FC || object_km1 || Strawberry-Haired Kokiri Boy
|-
| 00FD || object_kw1 || Strawberry-Haired Kokiri Girl
|-
| 00FB || object_md || Mido
|-
| 000E || object_box || Treasure Chest/Boss Key Chest/Light When Opening Chest
|}

====Replacing Objects====

# Use the [[Actor List|Actor List]] to find the object linked to the actor you wish to replace.
#* We've chosen to replace a treasure chest, which is linked to object '''000E''' (Treasure Chest/Boss Key Chest/Light When Opening Chest).
# Use the [[Actor List|Actor List]] to find the object linked to the actor you wish to replace it with.
#* We've chosen to replace the treasure chest (object '''000E''') with a sign (object '''012F''').
# Overwrite the old object number with the new one.
#* '''00C500FC 00FD00FB 000E0000 0163FFC8 -> 00C500FC 00FD00FB 012F0000 0163FFC8'''

==Gameshark Codes==

@@ Line 296: / Line 296: @@
 ===Debug ROM===
-===Happy Mask Salesman in Clock Tower Interior===
+====Happy Mask Salesman in Clock Tower Interior====
 CF6 oooo
@@ Line 303: / Line 303: @@
 For objects 0000 and 0001, either remove the object line, or set it to some other object. Actors using objects 0002 and 0003 can't be used with this code.

Actor Replacement - Revision history

ShimmerFairy: /* Gameshark Codes */ Add more codes for Debug ROM

ShimmerFairy: Fix tutorial, add Happy Mask Salesman code

ShimmerFairy: Copy from OoT wiki (not corrected for MM yet)