Hacking Emulation Hardware [CEMU/Wii U] WWHD Tools

n0ted

Well-Known Member
Member
Joined
Nov 23, 2021
Messages
139
Reaction score
53
Trophies
0
XP
1,106
Country
Canada


WWHD Tools
Practice tools, cheats and an in-game menu for The Wind Waker HD
Wii U (Aroma) and Cemu​




Hey All,

I've been working on this for a while and it's finally at a point where I'm happy to let other people try it. WWHD Tools is a menu that runs inside Wind Waker HD. There are a ton of cool features that I have put into this such as save states, a fly cam, an inventory editor, a hitbox and collision viewer, a bunch of cheats, and tools for practicing tricks like storage, super swim and zombie hover (more on this later). The big goal for me was having all of this on an actual Wii U, not just on an emulator. So it runs on console through Aroma, and on Cemu through a graphics pack.

A lot of late nights in Ghidra went into this, with the TWW GameCube decomp open right next to it. If you run into anything weird, check the Bugs and feedback section.

Screenshots​

1790625168043.png

The main menu

1790624336874.png

Collision viewer​

1790624412526.png
1790624422048.png
1790624432100.png
1790624440465.png

Menu Items

1790624504000.png
1790624523418.png
1790624532414.png
1790624547875.png
1790624556496.png

Inventory editor

1790624616566.png

Fly cam

1790624662354.png
1790624676956.png
1790624689240.png
1790624713132.png

Great Sea Map Teleporting

1790624830120.png
1790624861228.png

Zombie hover trainer

1790624923786.png

Game info, input viewer and frame stats​

What's in it​

  • Save states, plus a save loader that loads save files straight off the SD card
  • Inventory editor for items, bottles, equipment, songs, pearls, Triforce shards, bags, charts, hearts, magic and rupees
  • Fly cam. Fly the camera anywhere, then hand control back to the game
  • Coordinates. Save your position to a slot and load it later, even from another room
  • Sea chart teleport. Pick a square on the chart and you're there
  • Reset game and reload stage on a button combo
Storage
Give yourself storage or clear it with a button combo, or skip the setup and jump straight to the collision a stored chest or door leaves Link with. The Game Info window shows when storage is active.

Super swim
Turn on the MSS macro, hold R while swimming, and it does the stick inputs for you.

Zombie hover
The trainer rates every input (perfect, good, ok or bad) and keeps your stats and run history in its own HUD window. It can also heal you instead of giving you a game over. There's a button that drops you to a quarter heart and empties your fairies so you can easily begin your Zombie Hover practice. There is also a restore button to put it all back afterwards. If you want to see what a good hover looks like, hold R3 and take a lethal hit, and it does the inputs for you.
  • Game info: position, speed, angle, action, frame count, storage state and more
  • Input viewer
  • Frame stats: FPS, CPU and GPU time, draw calls
  • Collision viewer: draws hitboxes, grass and tree collision, and the stage collision mesh over the game
  • Infinite hearts, magic, ammo, rupees and swim stamina
  • Invincibility
  • Moon jump
  • Walk, crawl and swim speed boosts
  • Launch Link (launches the boat instead while you're sailing)
  • Boat moon jump and boat speed
  • Automatic wind direction
  • Teleport to your boat
  • Hold a button to blow through text
  • Quick Access. Pin the things you use most to a small window

Every hotkey can be rebound, and it works with both the GamePad and the Pro Controller.

Download​

Grab the latest zip from GitHub releases. Inside you'll find a Wii U folder and a Cemu folder. You only need the one for where you play.

Supported versions​

GameWii UCemu
USAYesYes
EURYesYes
JPNYesNot yet
RandomizerYesExtra step, see below
Make sure the game has its latest update installed.

Installation​

You need a Wii U running Aroma. If you don't have that yet, follow wiiu.hacks.guide first.

  1. Open the zip and go into the Wii U folder.
  2. Copy the wiiu folder from there to the root of your SD card. Say yes if it asks to merge.
  3. Put the SD card back in and boot into Aroma.
  4. Start The Wind Waker HD.
  5. Press L + ZL + Minus to open the menu.

When you're done, your SD card should have these two files:
Code:
sd:/wiiu/environments/aroma/plugins/rpl_loader.wps
sd:/wiiu/rpl-loader/universal/wwhd_tools.rpl
rpl_loader.wps is a small Aroma plugin I wrote that loads code into games, and wwhd_tools.rpl is the tool itself.
  1. In Cemu, go to File > Open Cemu folder and open the graphicPacks folder.
  2. From the zip, copy the Cemu/WWHD-Tools folder into graphicPacks.
  3. Go to Options > Graphic packs, find The Legend of Zelda: The Wind Waker HD > Mods > WWHD Tools and tick it.
  4. Start the game and press L + ZL + Minus.

This will require you to acquire the latest action build of Cemu found here. If you don't want to do this then follow the instructions below


The following steps requires you to have your game files loose:
  1. In Cemu, right-click on WWHD and click on Game Directory .
  2. Open the code folder
  3. Move the wwhd-tools.rpl found in the graphics pack to the code folder, right beside the cking.rpx
  4. Go to Options > Graphic packs, find The Legend of Zelda: The Wind Waker HD > Mods > WWHD Tools and tick it.
  5. Start the game and press L + ZL + Minus.
Cemu graphics packs match the game by a checksum, and every rando seed changes that checksum, so the pack has to be told about your seed. I have a small Windows helper that does this for you. It'll be linked here once it's ready: RandoPack
WhatButtons
Open menuL + ZL + Minus
Quick AccessL + ZL + Plus
Save stateL + ZL + D-pad Up
Load stateL + ZL + D-pad Down
Reset gameL + ZL + D-pad Left
Reload stageL + ZL + D-pad Right
Fly camZL + ZR + L3 + R3
The cheat hotkeys (moon jump, speed boosts and so on) are shown next to each cheat in the Mods menu. You can rebind all of them from the Settings menu.

Where your stuff goes​

Settings, save states and logs live in sd:/wwhd_tools/. Put save files you want to load in sd:/wwhd_tools/saves. On Cemu that's the sdcard folder inside your Cemu folder.

The save loader and the inventory editor write to your save. Nothing should go wrong, but a backup is cheap insurance.


Bugs and feedback​

This is the first public release, and some of the newer parts (coordinates, sea chart teleport, the zombie hover trainer) haven't had much time on real hardware yet. If something breaks or crashes, post here or open an issue on GitHub.

  • Wii U or Cemu (and your Cemu version)
  • Your game region
  • What you were doing when it happened
  • The log from sd:/wwhd_tools/ if there is one

Feature requests are welcome too!

Thanks to the following as without it this project would not have happened as quick as it did:

Dear ImGui GX2 backend implementation - @GaryOderNichts
Dear ImGui Team
tww decomp Team
wiiu-dev Team
 

Attachments

  • 1790624203379.png
    1790624203379.png
    1.2 MB · Views: 1
Last edited by n0ted,

Site & Scene News