Repository files navigation

As this is a new randomizer, there may still be bugs until it is more thoroughly tested. Some of the information below may change with time.

• Information
  • Getting Stuck
  • Reporting Bugs
• Setup
  • On Console
  • On Emulator
  • Building
• Credits

A Randomizer forThe Legend of Zelda: The Wind Waker HD.

It shuffles all the items, makes the world open from the start, removes most cutscenes, and adds other tweaks to speed up mundane tasks. While most features from theoriginal Wind Waker Randomizer are present, some are yet to be ported due to the remake's changes.

If you can not find anywhere to progress, you should first check the spoiler log. The spoiler log is generated in the randomizer's save directory (sd:/wiiu/apps/save/<8 hex digits> (TWWHD Randomizer) on console) and contains information on everything in the seed.

If you have checked the log and are still stuck, it is possible you have encountered abug.

If you seem to have discovered a bug, let us know in ourDiscord server or byopening an issue. Be sure to share the spoiler log for the seed when reporting a problem.

You can download the latest stable version of the randomizer from thereleases page.

This randomizer currently supports the USA version of TWWHD. The European and Japanese versions of the game will not work, nor will the original Wind Waker.

Playing the randomizer on console requires a Wii U with the Aroma environment and sigpatches. A guide for installing Aroma can be foundhere. After following the guide, you will need to add01_sigpatches.rpx tosd:/wiiu/environments/aroma/modules/setup. Make sure to read each page of the guide closely, and pay attention to which environment you are booting into.

The patcher requires an accessible version of TWWHD (USA) on your Wii U (digital install or inserted disc). You must also have 2GB of space available for the randomized channel, either on the console's internal memory or a connected USB storage device (*This storage is reserved after first-time setup).

Once homebrew is set up, copy thewwhd_randomizer.wuhb from the releases page intosd:/wiiu/apps. Run the app from the home menu to open the patcher.

The first time it runs, the patcher will create a home menu channel for the randomized game. This can take some time (it needs to transfer all the game data), but only happens once. Subsequent randomizations do not take as long.

To play the randomized game, you must have a CFW/sigpatches active. This should always be the case as long as you loaded Aroma with sigpatches. The randomized channel will have an orange, mirrored icon of the vanilla game.

This method will require that you have a decrypted USA copy of TWWHD on your computer. The decrypted game consists of a folder with 3 subfolders (code,content, andmeta). It isnot a single file like an.iso or a.wad. You can dump a disc or digital install from your Wii U withdumpling.

Download the latest randomizer from thereleases page and extract its contents to wherever you wish (Windows and Mac are currently supported). After extraction, double-click on thewwhd_rando application to open it (wwhd_rando.exe on Windows). Set theBase Game Folder to the folder which holds your vanilla game and theOutput Folder to the location you want to place the randomized game. Once you've finished selecting your desired settings, click theRandomize button in the bottom-right and wait for the seed generation to finish. Afterwards, you will have the randomized game in the output folder. Note that generating a new seed will overwrite any previous seed in the output folder.

Open up your emulator of choice (probablyCemu) and add your output folder to the emulator's game paths to have it pick up the randomized game. The randomized game will have an orange, mirrored icon of the vanilla game. Now just click on it in the emulator to load it up. Enjoy!

To build for Wii U, use the dockerfile and run the image.From the source directory, this would be:

docker build -t <image-tag> .docker run -i -e BUILD_TYPE=randomizer -v "$(pwd):/src" <image-tag>

You can also change the build type to "asm" to rebuild the assembly patches, or "full" to build the assembly and the randomizer.

The randomizer program (wuhb) will be placed in the build folder.

To build the Desktop Application, download and install the latest version ofQt. Make sure to install the correct kit for your platform. After opening up Qt Creator, selectOpen Project and select theCMakeLists.txt file in the repo root. When prompted to select a kit, select the one you installed earlier. DefineQT_GUI in the project's CMake configuation, then press the green play button in the bottom left of the application to build and run the project.

All of this was made possible thanks to tremendous help fromcsunday95 andgymnast86, along with bugfixing assistance from the devs atForTheUsers. Translations were done by azer67 (French), Cithiel (Spanish), and Nacho (Spanish). Much of the work here was based on the research and code already written by theoriginal randomizer team.