The Legend of Zelda : The Wind Waker

Port 0.7.0

Native port by chrissotraidis.

Native port, to be completed before release.

Games included

2002 GameCube

The Legend of Zelda : The Wind Waker

Maritime adventure in cel-shading: an ocean to sail across, islands to explore, and a young Link on a quest to save his sister.

Architecture

iOS iOS

Download and links

Version history

0.10.0
  • Amélioration des performances : jusqu’à 14 % de gain sur Steam Deck et 6 à 11 % sur Mac (M3 Max) et PC, via une optimisation des registres et des données de collision.
  • Correction visuelle majeure : suppression de l’halo sombre autour de Link et des ombres clignotantes dans le mode HD, avec ajustement des nuages, torches et ombres solaires.
  • Étoiles réintégrées dans le ciel nocturne, stables avec le Smooth Motion, pour toutes les plateformes.
  • Suppression du blocage audio sur macOS : le son ne ralentit plus le jeu comme sur les autres plateformes.
  • Nouvelle fonctionnalité pour iPhone/iPad/Android : export des logs de quête au format .gci lisible par Dolphin.
  • Prise en charge native du contrôleur Nintendo Switch : bascule automatique des boutons A/B et X/Y, avec un commutateur dédié.
  • Construction macOS : uniquement via compilation source depuis un dépôt, avec sauvegardes conservées dans ~/Library/Application Support/BlueWake.

BlueWake 0.10.0 makes the game faster on every platform, most of all on the Steam Deck and slower PCs, fixes the HD look's dark outline around Link and its flickering shadows, puts the stars back in the night sky, and brings the first ready-made Linux AppImage. Every version needs your own USA (GZLE01) disc image. The ready-made Windows and Linux builds include the game code translated from my disc; nothing else from the game is included.

Install

Windows: download BlueWake-v0.10.0-windows-x64.zip, unpack the whole folder and run BlueWake.exe. Your saves and settings in %APPDATA%\BlueWake carry over. You need Windows 10 or 11 and a CPU with AVX2. SHA-256 of the zip: c56325884ef6f3f4cc502dd6c129e16a6d66316082a546bb3a99476dcd668f66. BlueWake.exe isn't code-signed, so a new build can be flagged by mistake; check the SHA-256 and see If Windows says it's a virus.

Linux and Steam Deck: download BlueWake-v0.10.0-linux-x86_64.AppImage, make it executable (chmod +x, or Properties › Permissions on the Deck's desktop) and run it. On its first start it asks for your disc image. Your saves in ~/.local/share/BlueWake are kept. You need a CPU with AVX2. SHA-256: 2f5c1305de1bf934fdbace34e559fe1c3781380323380c17b73135e3ad1510fc. To build it yourself instead, see docs/LINUX.md.

iPhone and iPad: build your app with PadMint on an Apple Silicon Mac. It downloads BlueWake-v0.10.0-ios-unsigned.ipa (the app without game code) and adds the game made from your disc. Install it over your current BlueWake to keep your saves.

Mac: build it from this release's source: scripts/builder/build.sh "/path/to/GZLE01.iso" --platform macos --out build/macos. Your saves in ~/Library/Application Support/BlueWake are kept.

Android (experimental): build it yourself from your own disc, as docs/ANDROID.md describes. It now runs on Android 10 and newer.

What's new

Faster everywhere (thanks to irregularthanis and pdale-boop)

  • The translated game spends less time saving and restoring registers, and finding where the game keeps its collision data. Against 0.9.0 on the benchmark tour it's 7 to 11% faster at every stop on my Mac (M3 Max) and 8 to 11% on my iPad Pro. Contributors measured about 14% on a Steam Deck (one lava cave a third faster) and about 6% on Windows and Linux PCs. Every build you make trains on its own, so this needs nothing from you.

The Wind Waker HD look (thanks to pdale-boop, for #491)

  • No more dark outline around Link, and no dark patch on the floor in front of him.
  • Shadows no longer flicker when a hit shakes the camera, the clouds keep their shading, the sky stays sharp, torches are softer, and sun shadows no longer stripe walls or shade islands in blocks.
  • A switch for each part of the look, in Wind Waker HD look settings under the look on the Display tab. Sun shadows moved there from Mods › Experimental, and F2 now turns them off with the rest of the look.
  • New, off until you turn them on: HD's sky and light (Wind Waker HD's sky colours and sunlight for the hour, with choices for how strong the sunlight is and how dark the sun shadows are), and HD's clouds in the sky. Both read your own Wind Waker HD files, so import your HD textures again to get them. Sun shadows are also timed and shaped as in Wind Waker HD.

Fixes

  • The stars are back in the night sky, for everyone, and stay steady with Smooth Motion (thanks to pdale-boop).
  • Linux and Steam Deck: closing BlueWake from Steam's menu no longer resets all your settings (#511).
  • Mac: the audio no longer holds the game back on top of the clock, as on every other platform (#509).
  • Building with PadMint works again on Macs that use Apple's own Python 3.9 (#496).
  • Linux's first start says when the data folder is out of space, instead of blaming the disc (thanks to jkoehler11, #479).
  • The Windows builder finds the Windows SDK on PCs where a policy blocks reg.exe (thanks to imcamilouribe).

Menus and controls (thanks to pdale-boop)

  • Nintendo button layout: one switch that swaps A and B, and X and Y, so a Switch controller's buttons do what their letters say. It turns on by itself the first time BlueWake starts with a Switch controller or Joy-Cons. It replaces Swap A and B and Swap X and Y: if you had only one of those on, check Controls.
  • A setting your settings file left empty now shows its real state (Direct right-stick camera showed off while it was on).
  • With a controller, the menu scrolls on to the notes at the end of a tab, and a greyed setting says which switch turns it on.
  • Smooth Motion under sustained load: Automatic, or Never pause, for when Smooth Motion keeps pausing while the game holds 30 FPS (thanks to irregularthanis, #473).

Saves

  • Export Dolphin Save… on iPhone, iPad and Android writes your three quest logs out as a .gci that Dolphin opens. Your card is only read (thanks to jkoehler11, #508).

How it was checked

I built 0.10.0 and 0.9.0 for the Mac from my own disc the same way and ran the benchmark tour on both, alternating, from one saved moment: 0.10.0 was 7 to 11% faster at every stop (Outset, Windfall, Dragon Roost Cavern, Forest Haven, the sea by the Fortress), and both builds reached exactly the same game state at every checkpoint. All 468 places in the stage select ended the same way as in 0.9.0, with my save untouched. With the HD look off the picture matches 0.9.0's, except that the night sky has its stars again; with it on, Outset's pier has no outline around Link and no dark band on the sea. I installed 0.10.0 on my iPad Pro, where the same tour ran 8 to 11% faster than 0.9.0 did last week. PadMint made a complete iPhone and iPad build of this release on a Mac the way a player's PadMint does, from a fresh copy of the source with Apple's Python. Exporting a Dolphin save from my own card wrote all three quest logs and left the card as it was.

I built the Windows version on my PC (Ryzen 7 5700U) from my own disc and the same commit: it started with Direct3D 12 and quit cleanly. I didn't play it on Windows this time, so the HD look, the stars, saving and the controller menu haven't been checked by hand there, and I haven't measured its speed against 0.9.0 myself. The Linux AppImage was built on the same PC from the same commit in the Linux CI container; it passed its compatibility check (it needs nothing newer than glibc 2.38) and started to the title screen. I haven't played it on Linux or a Steam Deck myself; contributors have played these changes on Linux and measured them on a Steam Deck.

Known problems

  • On slower CPUs the game can still dip below full speed where its own thread is the limit, at Outset most of all (#215, #427).
  • With the HD look's sun shadows, Outset at sunrise shows streaks.
  • Dragon Roost Cavern can flicker on Windows at 60 FPS and above (#483); it's being looked into.
  • Some flags and the poles on the barrels are missing their textures (#505, #69).
  • The Wind Temple's rooms R04 and R08 need an opt-in switch to load from the stage select (#318).

Thanks to pdale-boop, irregularthanis, jkoehler11, imcamilouribe, and everyone who reported a bug.

Found a problem? Open an issue or ask on Discord, and attach your session log (%APPDATA%\BlueWake\logs on Windows; ~/.local/share/BlueWake/logs on Linux; ⋯ › Help & Feedback › Share Session Log on iPhone and iPad).

0.9.0
  • Performances optimisées sur Mac, iPhone et iPad : les builds locales atteignent désormais les mêmes performances que Windows/Linux (jusqu’à +79 % de FPS sur iPad Pro M2/M3).
  • Correction du dip de caméra en mode "Direct right-stick camera" (tous les quelques secondes).
  • Suppression du flicker avec Smooth Motion au-delà de 60 FPS (HD, nuages, vagues, natation).
  • Menu unique pour Windows, Mac et Linux, avec navigation au pad, ajustement de contraste et taille de texte.
  • Contrôleurs : possibilité de jouer en arrière-plan même si une autre fenêtre est active (option désactivée par défaut).
  • HD textures : import depuis une image disque Wind Waker HD (WUD/WUX) avec gestion des clés (fichier ou keys.txt).
  • Partage de logs sur iPhone/iPad/Android : inclut la session précédente pour les rapports de crash post-redémarrage.

BlueWake 0.9.0 makes the Mac, iPhone and iPad builds as fast as the PC builds, fixes the camera dipping with the right-stick camera, stops the flicker with Smooth Motion, and brings one settings menu to every computer. Every version needs your own USA (GZLE01) disc image. The ready-made Windows build includes the game code translated from my disc; nothing else from the game is included.

Install

Windows: download BlueWake-v0.9.0-windows-x64.zip, unpack the whole folder and run BlueWake.exe. Your saves and settings in %APPDATA%\BlueWake carry over. You need Windows 10 or 11 and a CPU with AVX2. SHA-256 of the zip: 3c0edc36241fc1783693e1a9fa942995f4f32efec14fb3a9afc889a595da61ce. BlueWake.exe isn't code-signed, so a new build can be flagged by mistake; check the SHA-256 and see If Windows says it's a virus.

iPhone and iPad: build your app with PadMint on an Apple Silicon Mac. It downloads BlueWake-v0.9.0-ios-unsigned.ipa (the app without game code) and adds the game made from your disc, now with the faster preparations below. Install it over your current BlueWake to keep your saves.

Mac: build it from this release's source: scripts/builder/build.sh "/path/to/GZLE01.iso" --platform macos --out build/macos. Your saves in ~/Library/Application Support/BlueWake are kept.

Linux: build it from this release's source with python3 scripts/linux/build.py /path/to/GZLE01.iso (steps in docs/LINUX.md). The container build works again at the player's CPU target. Contributors have built the AppImage from this release's commit with their own discs; a ready-made one will be added to this release once it's checked and uploaded.

Android (experimental): build it yourself from your own disc, as docs/ANDROID.md describes; the builder now runs on a Mac as well as Windows.

What's new

Much faster on Mac, iPhone and iPad

  • Builds you make with PadMint or the builder now get the same module preparations and behaviour timing as the Windows and Linux builds. On the benchmark tour that's 75 to 79% more game frames a second on an iPad Pro (M2) and 64 to 77% on an M3 Max, with a smaller game module and a much shorter build. At normal speed the iPad's game thread is about half idle. --conservative builds it the old way.

Fixes

  • The camera no longer dips for a frame every few seconds with Direct right-stick camera and aiming on (thanks to jslay88).
  • No more flicker with Smooth Motion above 60 FPS in the HD look, the clouds, the wave crests and swimming (thanks to pdale-boop).
  • Linux builds at the player's CPU target again (thanks to jslay88).

One menu on every computer (thanks to pdale-boop)

  • Windows, Mac and Linux draw the same settings menu from one list, with controller navigation, contrast and text size, a Config tab, greyed settings that say why, and pausing under the menu as a setting.

Controls

  • A controller can keep playing while another window is in front (Controls, off by default).
  • Keep the right-stick camera but aim with the left stick: turn off The right stick aims too (first person, items).
  • On iPhone and iPad, the menu's switches keep the menu open, so you can change several settings in one visit.

HD textures from a real Wind Waker HD disc image (thanks to jkoehler11)

  • The importer reads the content a real WUD/WUX stores, takes a key file, a pasted key or an emulator keys.txt as it is, keeps the form after a mistake, and says what it imported and skipped.

Also new

  • Sun shadows from a shadow map in the HD look, so what's off screen still casts a shadow (thanks to pdale-boop). Off by default, under Mods › Experimental.
  • A sea compass switch: the red end points the way you're sailing (thanks to jslay88). Off by default, with Better Wind Waker's settings.
  • On iPhone, iPad and Android, Share Session Log includes the session before, so a crash can be reported after relaunching.

How it was checked

I built the Mac and iPad versions from my own disc and played the iPad build: steady at 30 FPS with no dips, Smooth Motion and the touch controls fine. On the iPad Pro the benchmark tour (Outset, Windfall, Dragon Roost Cavern, Forest Haven, the sea by the Fortress) ran 75 to 79% faster than 0.8.0 at every stop, with my save untouched. On the Mac all 468 places in the stage select ended the same way as in 0.8.0, and a scripted stand-still with the right-stick camera showed no dips in three minutes, against one every few seconds without the fix. I built the Windows version on my PC (Ryzen 7 5700U) from my own disc, from the same commit, in 85 minutes; it started, drew with Direct3D 12 and quit cleanly after a long run at the title and opening. I didn't play it on Windows this time, so the camera, Smooth Motion and saving haven't been checked by hand there. I built the iPhone and iPad app without game code from this release's commit and checked that it holds no game code. PadMint then made a complete iPhone and iPad build from it on a Mac the way a player's PadMint does, from a fresh copy of the source.

Known problems

  • 0.9.0 doesn't make Windows, Linux, the Steam Deck or Android faster than 0.8.0. On slower CPUs the game can still dip below full speed where its own thread is the limit (#215, #427); that's the next version's focus.
  • The Wind Temple's rooms R04 and R08 need an opt-in switch to load from the stage select (#318).

Thanks to pdale-boop, jslay88, jkoehler11, irregularthanis, benwolfram, cforain, LiquidAzir and Elliott Tate.

Found a problem? Open an issue or ask on Discord, and attach your session log (%APPDATA%\BlueWake\logs on Windows; ⋯ › Help & Feedback › Share Session Log on iPhone and iPad).

0.8.0
  • Ajout d’un rendu HD inspiré de The Wind Waker HD (désactivé par défaut), incluant brouillard de profondeur, occlusion ambiante, ombres de nuages et éclairage doux, contrôlable via F2 ou les mods.
  • Intégration de textures HD personnalisées depuis une sauvegarde Wii U décryptée ou une image WUD/WUX, via Mods › Wind Waker HD textures › Import from Wind Waker HD…, sans dépendance à Python.
  • Amélioration des performances par défaut sur Windows et Linux (7 à 11 % de gain sur Intel, 9 % sur Steam Deck) grâce à l’optimisation des timings et des appels système.
  • Uniformisation des menus et raccourcis (F1 à F10) et prise en charge des contrôles (D-pad, gyroscope, écrans 21:9) sur toutes les plateformes.
  • Correction de bugs critiques : Lenzo accepte désormais les bonnes photos, les cartes d’île s’affichent correctement, et le marchand de Greatfish reste en place.

BlueWake 0.8.0 brings the Wind Waker HD look, HD textures you make from your own Wind Waker HD game inside the app, more speed by default on Windows and Linux, the same menus on every computer, and an experimental Android build. Every version needs your own USA (GZLE01) disc image. The ready-made Windows build includes the game code translated from my disc; nothing else from the game is included.

Install

Windows: download BlueWake-v0.8.0-windows-x64.zip, unpack the whole folder and run BlueWake.exe. Your saves and settings in %APPDATA%\BlueWake carry over. You need Windows 10 or 11 and a CPU with AVX2. A Direct3D 12 GPU is best. On older GPUs BlueWake now tries Direct3D 11 instead of showing a black screen; I haven't been able to check that on such a PC yet, so tell me how it goes.

Linux: build it from this release's source with python3 scripts/linux/build.py /path/to/GZLE01.iso (steps in docs/LINUX.md). A ready-made AppImage will be added to this release once one is built and checked.

iPhone and iPad: build your app with PadMint on an Apple Silicon Mac. It downloads BlueWake-v0.8.0-ios-unsigned.ipa (the app without game code) and adds the game made from your disc. Install it over your current BlueWake to keep your saves.

Mac: build it from this release's source: scripts/builder/build.sh "/path/to/GZLE01.iso" --platform macos --out build/macos. Your saves in ~/Library/Application Support/BlueWake are kept.

Android (experimental): build it yourself from your own disc on a Windows PC, as docs/ANDROID.md describes (thanks to LiquidAzir). It's checked on one phone so far.

What's new

The Wind Waker HD look, off by default

  • Islands on the horizon from further away, bloom, the far-distance blur, ambient occlusion, cloud shadows, and edge and torch light, kept gentle so the game keeps its colours. Press F2 on Windows, Mac and Linux, or turn it on under Mods on iPhone and iPad. Each piece can be turned off by itself (docs/WWHD_LOOK.md).

HD textures from your own Wind Waker HD game

  • Mods › Wind Waker HD textures › Import from Wind Waker HD… makes the texture pack, HD menus and HUD included, from your decrypted HD dump or a USA WUD/WUX image with its keys, on Windows, Mac, Linux, iPhone and iPad. No Python, and nothing from the Wii U game is included in BlueWake.

Faster

  • Behaviour timing is on by default on Windows and Linux: 7 to 11% faster on Intel desktops and 9% on the Steam Deck.
  • Lighter checks around the game code (thanks to pdale-boop) and Elliott Tate's faster returns and calls.
  • On Wayland the game runs at full speed (thanks to jslay88).

The same menus and keys on every computer (thanks to pdale-boop)

  • F1 settings, F2 the HD look, F5 and F8 save and load state, F7 the stage select, F9 the frame rate, F10 Smooth Motion, F11 fullscreen. The Windows menu works with a controller, and Linux gets Restart now and safe mode.

Controls

  • The D-pad moves the cursor in Items and Quest Status, gyro aiming with a DualSense, DualShock 4, Switch Pro or Steam Deck, swapping L and R, and 21:9 widescreen.

Fixes

  • Lenzo accepts the right Picto Box photos (thanks to jslay88).
  • Each island's sea chart shows its own map.
  • The Greatfish merchant stays on his raft (thanks to jslay88).
  • Resizing the window on Linux no longer crashes (thanks to pdale-boop).

Also new

  • The developers' stage select, off by default, with 468 places to jump to from your own file (thanks to pdale-boop).
  • Linux: portable mode, a working texture-pack folder picker (thanks to jkoehler11), and the build container (thanks to cforain).

How it was checked

I built the Windows version on my PC (Ryzen 7 5700U) from my own disc, from the same commit, in 81 minutes. It starts, draws with Direct3D 12 and quits cleanly; I only tried it briefly at Outset this time. I built the iPhone and iPad app without game code from this release's commit and checked that it holds no game code. PadMint then made a complete iPhone and iPad build from it on a Mac the way a player's PadMint does, from a fresh copy of the source. I also built the Mac version from my own disc: all 468 places in the stage select were tried (446 load; the rest are test rooms, known crash rooms and story scenes my file hasn't reached), and the benchmark tour ran through Outset, Windfall, Dragon Roost Cavern, Forest Haven and the sea by the Fortress with no slowdowns.

Known problems

  • With Smooth Motion above 60 FPS, clouds and the HD look can flicker on some PCs (#136). pdale-boop's fix is in progress (#371).
  • The Wind Temple's rooms R04 and R08 need an opt-in switch to load from the stage select (#318).
  • Busy scenes can still run below full speed on slower CPUs, including the Steam Deck (#215). Speed stays the main focus.

Thanks to Elliott Tate, pdale-boop, jslay88, cforain, jkoehler11, LiquidAzir and irregularthanis.

Found a problem? Open an issue or ask on Discord, and attach your session log (%APPDATA%\BlueWake\logs on Windows).

Reply on the forum

A question or a hands-on report? Open the discussion on the forum.

Reply on the forum