Skip to content
/ tww-gz Public
forked from zsrtww/tww-gz

Name pending. Practice rom for The Wind Waker (SD).

License

Notifications You must be signed in to change notification settings

Luzagar/tww-gz

 
 

Repository files navigation

tww-gz

The Wind Waker (SD) ROM hack to practice speedrunning.

To patch an ISO with a patch file, see: PATCHING.md
To build the project from source, see: BUILDING.md
For acknowledgements, see: THANKS.md

If you have questions or need help, ask in the #practice-rom-development channel of the Wind Waker Speedrunning Discord.

Controls

Button(s) Description
L + R + D-pad down Open menu
D-pad directions Navigate menus
A Select
B Go back

Some features have specific button combinations associated with them. See the features section for more details.

Features


Cheats

Enable and disable specific cheats. Some cheats are applied constantly, and some need a button combination to use.

See the table below for a description of each cheat
Cheat Description
Infinite air Always have max air
Infinite arrows Always have max arrows
Infinite bombs Always have max bombs
Infinite hearts Always have full hearts
Refill hearts Hold R+D-pad right to refill health
Infinite magic Always have full magic
Refill magic Hold L+D-pad up to refill magic
Infinite rupees Always have infinite rupees
Moon jump Hold R+A to moon jump
Storage Press D-pad right to get storage
Normal collision Hold L+D-pad down to get normal collision
Chest storage Hold L+D-pad right to get chest storage
Door cancel Hold L+D-pad left to get door cancel
Quarter heart Hold R+D-pad left to reduce health to quarter heart
Fast movement Hold D-pad left to get super speed
Upcharge Hold X + Z to get negative speed for upcharge

Flags

Set and unset various flags in the game.

General - Flags that are most relevant or important
Flag Name Description
FF2 Helmaroc Cutscene Switches to animation set 2, among other things
FF1 Gossip Stone Trigger Sets Pirate Ship to layer 2 (Ropes 2) and Outset to layer 4
Endless Night Activates Endless Night, incompatible with having Nayru's Pearl
Raise ToTG Raises Tower of the Gods
Load ToTG After T2Z Sets FF3 Layer and F&I Arrows at Mother & Child
Hyrule 3 Warp Opens golden warp to Hyrule 3
Hyrule Barrier Barrier Skip skip
Dark Portal Opens dark portal between FF3 and Ganon's Tower
Sea Chart Gives the sea chart
Dungeons - Flags related to dungeon collectables
Flag Name Description
dungeon <"name"> Change the dungeon being modified
keys <"amount"> Modify the number of small keys
boss key Gives the boss key
map Gives the dungeon map
compass Gives the dungeon compass
partner Spawns Medli/Makar (ET/WT Only)
partner room Spawns Medli/Makar in current room on using void out tool(ET/WT Only)
Savewarp - Flags related to savewarp locations (higher tiers take priortiy)
Flag Name Description
Leaving Outset Cutscene Sets savewarp location to Pirate Ship (Overworld Travelling)
Tetra Text After Getting Spoils Bag Sets savewarp location to Pirate Ship (At FF1)
Barrel Launch Cutscene Sets savewarp location to FF1
Post FF1 KorL Cutscene Sets savewarp location to Windfall, spawns KorL, and sets FoF to layer 2
Enter KorL First Time Sets savewarp location to most recent loaded area
Tuner - Flags related to tingle tuner
Flag Name Description
Kooloo-Limpah 10s Balloon+Shield Adds the 10s Balloon+Shield to the Kooloo-Limpah pool
Tingle Balloon Discount Gives Tingle Balloon Discount from 30 to 20 rupees
Tings Discount Gives 50 percent off discount for all tings
Hand-Me-Down Tingle Tuner Unlocks the Hand-Me-Down Tingle Tuner item in the tuner shop

Inventory

Modify various parts of the inventory:

Amounts - Modify amounts for health, magic, etc.
Flag Name Description
Health Modify the current health by quarter
Bombs Modify the current bomb count
Arrows Modify the current arrow count
Rupees Modify the current rupee count
Magic Modify the current magic amount
Heart Pieces Modify the current heart pieces collected
Joy Pendants Modify the current Joy Pendants count
Skull Necklaces Modify the current Skull Necklaces count
Boko Baba Seeds Modify the current Boko Baba Seeds count
Golden Feathers Modify the current Golden Feathers count
Knights Crests Modify the current Knights Crests count
Red Chu Jelly Modify the current Red Chu Jelly count
Green Chu Jelly Modify the current Green Chu Jelly count
Blue Chu Jelly Modify the current Blue Chu Jelly count
Item Inventory - Modify Item Inventory Menu
Flag Name Description
Telescope Add/remove telescope to/from inventory
Sail Add/remove sail to/from inventory
Wind Waker Add/remove wind waker to/from inventory
Grappling Hook Add/remove grappling hook to/from inventory
Spoils Bag Add/remove spoils bag to/from inventory
Boomerang Add/remove boomerang to/from inventory
Deku Leaf Add/remove deku leaf to/from inventory
Tingle Tuner Add/remove tingle tuner to/from inventory
Progressive Picto Box Add/remove/upgrade picto box
Iron Boots Add/remove iron boots to/from inventory
Magic Armor Add/remove magic armor to/from inventory
Bait Bag Add/remove bait bag to/from inventory
Progressive Bow Add/remove/upgrade bow
Bombs Add/remove bombs to/from inventory
Bottle 1 Add/remove bottle 1 to/from inventory
Bottle 2 Add/remove bottle 2 to/from inventory
Bottle 3 Add/remove bottle 3 to/from inventory
Bottle 4 Add/remove bottle 4 to/from inventory
Delivery Bag Add/remove delivery bag to/from inventory
Hookshot Add/remove hookshot to/from inventory
Skull Hammer Add/remove skull hammer to/from inventory
Quest Status - Modify Quest Status Menu
Flag Name Description
Sword Add/remove/upgrade sword
Shield Add/remove/upgrade shield
Magic Add/remove/upgrade magic
Quiver Add/remove/upgrade quiver
Hurricane Spin Add/remove Hurricane Spin
Hero's Clothes Add/remove Hero's Clothes
Bomb Bag Add/remove/upgrade bomb bag
Power Bracelets Add/remove power bracelets from inventory
Pirate's Charm Add/remove pirate's charm from inventory
Hero's Charm Add/remove hero's charm from inventory
Wind's Requiem Add/remove wind's requiem from songs list
Ballad of Gales Add/remove ballad of gales from songs list
Command Melody Add/remove command melody from songs list
Earth God's Lyric Add/remove earth god's lyric from songs list
Wind God's Aria Add/remove wind god's aria from songs list
Song of Passing Add/remove song of passing from songs list
Din's Pearl Add/remove din's pearl from inventory
Farore's Pearl Add/remove farore's pearl from inventory
Nayru's Pearl Add/remove nayru's pearl from inventory
Triforce Piece 1 Add/remove triforce piece 1 from inventory
Triforce Piece 2 Add/remove triforce piece 2 from inventory
Triforce Piece 3 Add/remove triforce piece 3 from inventory
Triforce Piece 4 Add/remove triforce piece 4 from inventory
Triforce Piece 5 Add/remove triforce piece 5 from inventory
Triforce Piece 6 Add/remove triforce piece 6 from inventory
Triforce Piece 7 Add/remove triforce piece 7 from inventory
Triforce Piece 8 Add/remove triforce piece 8 from inventory
Spoils Bag - Modify Spoils Bag Item Slots
Flag Name Description
Slot 1 Modify Item in Spoils Bag slot 1
Slot 2 Modify Item in Spoils Bag slot 2
Slot 3 Modify Item in Spoils Bag slot 3
Slot 4 Modify Item in Spoils Bag slot 4
Slot 5 Modify Item in Spoils Bag slot 5
Slot 6 Modify Item in Spoils Bag slot 6
Slot 7 Modify Item in Spoils Bag slot 7
Slot 8 Modify Item in Spoils Bag slot 8
Delivery Bag - Modify Delivery Bag Item Slots
Flag Name Description
Slot 1 Modify Item in Delivery Bag slot 1
Slot 2 Modify Item in Delivery Bag slot 2
Slot 3 Modify Item in Delivery Bag slot 3
Slot 4 Modify Item in Delivery Bag slot 4
Slot 5 Modify Item in Delivery Bag slot 5
Slot 6 Modify Item in Delivery Bag slot 6
Slot 7 Modify Item in Delivery Bag slot 7
Slot 8 Modify Item in Delivery Bag slot 8
Bait Bag - Modify Bait Bag
Flag Name Description
Slot 1 Modify Item in Bait Bag slot 1
Slot 2 Modify Item in Bait Bag slot 2
Slot 3 Modify Item in Bait Bag slot 3
Slot 4 Modify Item in Bait Bag slot 4
Slot 5 Modify Item in Bait Bag slot 5
Slot 6 Modify Item in Bait Bag slot 6
Slot 7 Modify Item in Bait Bag slot 7
Slot 8 Modify Item in Bait Bag slot 8
Charts - Modify All Chart Types
Flag Name Description
Special Charts Add/Remove Special charts
Triforce Charts Add/Remove/Decipher/Complete Triforce charts
All Charts Add/Remove all charts

Memory

Watches: View and pin on-screen values at specific memory locations
TODO: Explain more about how this works

Memory Editor: Edit values at specific memory locations
TODO: Explain more about how this works

Flag Logger: Output triggered events/switches to the bottom left of the screen


Practice

The practice menu contains hacked save files which allow you to instantly warp to key points in a speedrun route. The following categories are supported. Click the dropdown to view a list of each save:

Any%
Save Description
Manual Superswim Just after the intro, at bottom of watchtower
Post Manual Superswim After MSS at DRI
FF1 Exterior At FF1 after leaving jail cell
Door Cancel Leaf At windfall island, post FF1 cutscene
Forest Haven Climb Outside forest haven with door cancel
Deku Tree Cutscene Skip Inside Forest Haven at top entrance, for DTCS
Greatfish Cutscene Skip At windfall cove after leaf for gfcs
Sail Skip In KorL near Windfall, after Greatfish cutscene skip
Ropes 2 Inside pirate ship, ropes 2 minigame state
Door Cancel FF2 At windfall docks after bombs for door cancel ff2
Helmaroc Skip Inside FF2 Tower, at start of Helmaroc King fight
Barrier Skip Outside Hyrule Castle, about to do barrier skip
Trials Skip Inside Ganon's Tower, in trials room for trials skip
Light Arrow Skip In Phantom Ganon's room for light arrow skip with Tuner
Puppet Ganon Cutscene Skip At bottom Grand Staircase for Puppet Ganon cutscene skip
Puppet Ganon Skip Bottom of Ganondorf's Bedroom for Puppet Ganon skip with Tuner
Ganondorf On top of Ganondorf's Tower, at start of Ganondorf fight
Any% No MSS
Save Description
After Intro Just after the intro at bottom of watchtower
Orca Inside orca's house about to do sword tutorial
Forest of Fairies Inside forest of fairies about to rescue tetra
Ropes 1 Inside pirate ship about to play ropes 1 minigame
Early Light Cycle On Pirate Ship before barrel launch cutscene
FF1 [Alt] At start of ff1 after gossip stone cutscene
FF1 Interior Inside FF1 in rope swing room
Windfall At windfall island just finished talking to korl
Bombs Swim At dragon roost island just got the wind waker
Ropes 2 Inside pirate ship about to play ropes 2 minigame
Forest Haven Swim At windfall island about to swim to forest haven
Forest Haven Climb Outside forest haven with door cancel or Tuner
Lip Crush Cutscene Skip Inside forest haven at top for lip crush
Chin CS Skip [Alt] Inside forest haven at bottom for normal dtcs
Leaf Hover [Alt] Inside Forest Haven, after DTCS with leaf spawned
Quiver Swim At forest haven about to swim to thorned fairy island
FF2 Swim At thorned fairy island about to swim to ff2
Helmaroc Skip Inside ff2 tower at start of helmaroc king fight
Barrier Skip Outside hyrule castle about to do barrier skip
Trials Skip Inside ganon's tower about to do trials skip
Puppet Ganon Fight Inside ganondorf's bedroom at start of puppet ganon fight
Tuner Hover [Alt] At top of rope in ganondorf's bedroom for Tuner hover
Morth Hover Inside ganondorf's bedroom after fight at top of room
Ganondorf On top of ganondorf's tower at start of ganondorf fight
All Dungeons
Save Description
Manual Superswim After intro at bottom of tower
Post Manual Superswim After MSS at DRI
Forsaken Fortress 1 Chest Storage FF1 in yellow rupee chest room
Windfall At Windfall, after FF1 cutscene for sail/tuner/GFCS
Ropes 2 In pirate ship, ropes 2 state
Forest Haven Swim At Windfall for swim to Forest Haven
Early Leaf Hover Outside Forest Haven for hover to higher entrance
Deku Tree Cutscene Skip Inside Forest Haven upper spawn for cutscene skip
Forbidden Woods Start of Forbidden Woods
Kalle Demos Kalle Demos boss fight
Enter Dragon Roost Cavern Outside Forest Haven for swim to ETI/DRI
Dragon Roost Cavern Start of DRC
DRC Miniboss Outside area of DRC
DRC Boss Key Skip Inside DRC in boss door room for BK skip
Gohma Gohma boss fight
Nayru's Pearl At DRI after DRC for balloon swim to Outset
Enter Tower of the Gods Outside Jabuun's Cave for swim to STI/NTI
Tower of the Gods Start of TOTG
Darknut Darknut miniboss
TOTG Third Statue TOTG after returning second statue
Gohdan Gohdan boss fight
Puzzle Skip Inside Hyrule Castle for puzzle skip
Hyrule Escape Inside Hyrule Castle after Master Sword for Hyrule escape
Barrier Skip Outside Hyrule Castle for barrier skip
Trial Skip Inside Ganon's Tower, in trials room for trials skip
Boomerang Skip In Phantom Ganon's room for boomerang skip
Phantom Ganon Phantom Ganon fight miniboss
Enter Helmaroc After Phantom Ganon fight for chest storage climb
Hyrule 2 Skip In Helm boss fight for EMS cutscene skip
Early Wind God's Aria At Windfall after FF2 for swim to Gale Isle
Power Bracelets At Fire Mountain for power bracelets
Early Earth Temple At Headstone for early Earth Temple
Earth Temple Start of Earth Temple
Song Stone Skip In Earth Temple in song stone room
Jalhalla Jalhalla boss fight
Iron Boots At Headstone for swim to Ice Ring for Iron Boots
Makar At Ice Ring for swim to Forest Haven for Makar
Enter Wind Temple At Forest Haven for balloon swim to Gale Isle
Wind Temple Start of Wind Temple
Wizzrobe Wizzrobe miniboss
After Hookshot Wind Temple after Hookshot
Molgera Molgera boss fight
Swim to Flight Control Platform At Gale Isle for swim to Flight Control Platform
FCP Layer Manip At Flight Control Platform for layer manip dark portal
Puppet Ganon Cutscene Skip In Grand Staircase for Puppet Ganon cutscene skip
Puppet Ganon Skip In Puppet Ganon room on layer 8 for Puppet Ganon skip
Puppet Ganon Puppet Ganon fight if not doing PG skip
Ganondorf Ganondorf boss fight
Any% (Bombs First, No PG Skip)
Save Description
Manual Superswim Just after the intro, at bottom of watchtower
Post Manual Superswim After MSS at DRI
Windfall At Windfall Island, post FF1 cutscene
Ropes 2 Inside pirate ship, ropes 2 minigame state
Forest Haven Swim At Windfall Island post bombs for swim to Forest Haven
Deku Tree Cutscene Skip Inside Forest Haven for first time, for DTCS
Leaf Hover Inside Forest Haven, after DTCS with leaf spawned
Quiver Swim Outside Forest Haven, quiver swim or FF2 PG skip swim
FF2 Swim At Thorned Fairy Island, FF2 swim assuming you got quiver
Helmaroc Skip Inside FF2 Tower, at start of Helmaroc King fight
Barrier Skip Outside Hyrule Castle, about to do barrier skip
Trials Skip Inside Ganon's Tower, in trials room for trials skip
Puppet Ganon Fight Bottom of Ganondorf's Bedroom, at start of Puppet Ganon fight
Morth Hover Inside Ganondorf's Bedroom after fight, at top of room
Ganondorf On top of Ganondorf's Tower, at start of Ganondorf fight

Scene

Change/view various properties of the scene

Option Description
Disable BG Music Disable background music from playing
Freeze Time Freeze the current time of day
Wind Direction Change current wind direction
Chart Set Change current chart set of file
Current Hour Change current hour
Current Minutes Change current minute
Current Date Change current date/moon phase
Collision Viewer View various types of collision
Actor List Display info from actor list
Actor Spawner Spawn actors at current position

Collision Viewer - view various types of collision

Option Description
Attack Colliders View hitboxes; Colliders that hurt Target Colliders
Target Colliders View hurtboxes; Colliders that get hurt by Attack Colliders
Push Colliders View colliders that allow actors to bump/push into each other
Ground Polys View floor collision polygons
Roof Polys View ceiling collision polygons
Wall Polys View wall collision polygons
Poly Edges View edges of each polygon
Poly Draw Raise Amount to raise the drawn polygons by
Opcaity Transparency amount of collision viewer

TODO: Explain more about how Actor List works

TODO: Explain more about how Actor Spawner works


Settings

Option Description
Cursor Color Change cursor color
Font Change font
Drop Shadows Add shadows to all font characters
Decimal Angles Display angles in decimal instead of hex
Custom Save Positions Turn on/off custom positions in saves that support them
Item Equip Priorities Adjust priorities on item equips in practice saves
Save Card Save settings to memory card
Load Card Load settings from memory card
Delete Card Delete settings on memory card
Menu Positions Change menu object pistions (A tot oggle selection, Dpad to move)
Fast Swim Speed Change max speed of fast movement cheat for swimming
Fast Land Speed Change max speed of fast movement cheat on land
Spawn ID Set spawn ID for disable save checks tool, invalid ID's will crash

Moveable Lists: Main Menu, FIFO Queue, Link Debug Info, Time Display, Input Viewer, Frame Timer, Zombie Hover Info, Stage Info


Tools

Option Description
Link Debug Info Display position and angle data for Link
Display Time Info Display current day, time and moon phase
Stage Info Display Link's current stage info
Teleport R+D-pad up to save position. R+D-pad down to load
Area Reload Reload the current room by pressing L + R + A + Start
Map Aelect Load Map Select by holding D-pad down + Y + Z
Zombie Hover Info Display A and B button presses per second
Input Viewer Show current inputs
Timers Toggle timers (frames and seconds) with L + R + D-pad Right, reset with L + R + D-pad Left
Frame Advance D-pad Down to pause/unpause, D-pad Up to advance frames
ESS Checker Change input viewer stick color based on distance from perfect ess
Deadzone Checker Change input viewer stick coor if stick is in deadzone
Disable Save Checks Disable save location safety checks, set used spawn ID in settings menu
Intro Skip Skip lore segment of intro on start of new file
Room Reload/Void Out Reload room by void out with L + R + B + Start

About

Name pending. Practice rom for The Wind Waker (SD).

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C++ 89.1%
  • CMake 5.1%
  • C 2.7%
  • Python 2.1%
  • Assembly 0.5%
  • Shell 0.3%
  • Dockerfile 0.2%