Skip to content

A The Legend of Zelda: The Wind Waker Rom Hack that adds a Debug Menu

License

Notifications You must be signed in to change notification settings

hallcristobal/WindWakerDebugMenu

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

The Wind Waker Debug Menu

The Wind Waker Debug Menu Rom Hack adds a Debug Menu with all kinds of useful Menus for editing the game's flags and inventory, activating cheats and warping to any stage in the game.

How To Compile

To compile the source code you need to get the Rust Nightly compiler toolchain. You can acquire it either through the official website or through multirust.

If you use multirust you might need to override the toolchain in the project by using multirust override nightly.

Since we'll compile PowerPC code, you'll need to get a compiled libcore for PowerPC. Luckily, there's a prebuilt version available here.

We'll need to target the GameCube specifically, so we'll need a special linker which you can get by installing DevkitPPC.

Now that we have the whole toolchain, you will need to unpack your version of Wind Waker (GZLJ01) into a new folder called game. You can use the GameCube ISO Tool for that. The game folder should contain the following folders if done correctly: root and sys. In the sys folder you can find a main.dol. This is the main executable of the game and will be the one we compile into. We'll need to create a backup of the file called original.dol that you put directly into the game folder.

The folder structure should look like this now:

  • game
    • sys
    • root
    • original.dol
  • libtww
  • patcher
  • src
  • ...

At this point you can execute the make command. It will fail to fully execute for now. Go into the src/target/powerpc-unknown-linux-gnu/release folder and create a link to librust.a located in a new folder called lib in the root folder. On Windows the library might have the extension .lib instead.

The folder structure should look like this now:

  • build
  • game
    • sys
    • root
    • original.dol
  • lib
    • librust.a
  • libtww
  • patcher
  • src
  • ...

Execute make again and it should compile now. The compiled executable will be located in the game/sys/ folder. You can use the GameCube ISO Tool to convert this into an ISO again or directly boot up the folder with Dolphin.

About

A The Legend of Zelda: The Wind Waker Rom Hack that adds a Debug Menu

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Rust 94.2%
  • Makefile 5.7%
  • Other 0.1%