Zelda : The Wind Waker HD Recompiled

Portage 0.5.1

Recompilation du Zelda : The Wind Waker HD (Wii U), avec un binaire macOS Apple Silicon.

ZeldaWWHDRecomp reconvertit The Legend of Zelda : The Wind Waker HD, la version Wii U, en exécutable natif. Les archives macOS ARM64 sont publiées à côté des builds Windows, Linux et Android.

Jeux contenus

Architecture

Mac OS X - macOS Mac OS X - macOS Apple Silicon Apple Silicon

Téléchargement et liens

Historique des versions

0.5.1
  • Randomisation intégrée : ajout d’un générateur de graines (TWWHD Randomizer 1.2.0) dans les paramètres, avec import depuis des seeds existants, support des options avancées (comme le shuffle des entrées) et sauvegardes isolées pour les jeux randomisés.
  • Modèles de joueurs GameCube : import de packs de modèles GameCube (fichier Link.arc) pour personnaliser l’apparence de Link en haute définition, appliqué dynamiquement sans redémarrage.
  • Mods intégrés : ajout des Achievements (99 objectifs, affichage via une fanfare) et du suivi de progression (checklist, carte des trésors, pourcentage), désactivés par défaut.
  • Correction macOS : prise en charge des Steam Controllers lancés via Steam et du rumble des manettes compatibles (DualSense, etc.), nécessitant un redémarrage après mise à jour.
  • Correction macOS : avertissement explicite pour macOS 14 (nécessité de clic droit > Ouvrir) et rappel de ne pas déplacer l’application hors de son dossier d’origine.
  • Correction générale : suppression d’un shader crashant le GPU (macOS, Linux, Android) lors du démarrage, avec tentative de réactivation après une mise à jour.

The Wind Waker HD, native PC port, v0.5.1

This release contains no game files, no game code and no keys. You need your own disc dump (.wux/.wud with its disc key, plus the Wii U common key from your console), a Cemu .wua archive (no keys needed), or an already extracted game folder. The installer builds the game from it on your machine.

Install: download the zip for your system, unzip it anywhere and start Wind Waker HD. The first start prepares the game once from your dump (about two minutes); later starts launch it directly. Everything stays in that folder.

  • macOS (Apple Silicon, macOS 14+): Wind Waker HD.app. The release is not signed by Apple: macOS 15+: System Settings > Privacy & Security > Open Anyway; macOS 14: right-click > Open. Keep the app inside the unzipped folder (move the whole folder, not just the app)
  • Windows: Wind Waker HD.exe (SmartScreen: "More info" > "Run anyway"); windows-x86_64 for x86-64, windows-arm64 for Windows on ARM (Snapdragon X)
  • Linux (glibc 2.35+, Vulkan): wind-waker-hd; linux-x86_64 for x86-64, linux-aarch64 for arm64 (Raspberry Pi 5, Asahi Linux, ARM laptops). Or one file: chmod +x the .AppImage and start it from anywhere (Steam Deck included); its game, code, saves and settings go to ~/.local/share/wwhd and ~/.config/wwhd instead of beside it (Ubuntu 24.04+: libfuse2t64, or --appimage-extract-and-run)
  • Android (arm64, Android 13+, Vulkan 1.3): install the android-arm64.apk (android-x86_64 is for emulators and Chromebooks), choose your game in the app, and it builds the game on the phone (once, a few minutes). Signing certificate SHA-256: 7F:F6:D3:5E:4E:45:11:5E:E4:93:65:EF:5B:40:C0:EB:83:EA:F7:6C:C1:1C:E9:67:F2:64:5C:50:4F:58:B2:13

See "Install (releases)" in the README for details.

What's new

Thanks

Thanks to everyone who sent code for this release:

  • @itsarahtonin: change Link's name mid-game (#343), sharp settings text at 4K (#345), % refused in new-game names (#351), the GameCube adapter on Windows (#357), and two test fixes (#403, #404)
  • @GenissonEmilio: Android touch on the title screen, file select and name entry (#340), safer save import (#339), touch controls on the Poco M8 Pro (#338)
  • @davidsgullick: controller rumble (#347) and Steam Controllers (#348) on macOS
  • @mkopec: HDR metadata (#337) and the Mali (panvk) sky fix (#317)
  • @rhemfur: keep your save in a cloud folder (#238)
  • @RaphaelFakhri: Linux launchers for folders with special characters (#377)
  • @DaniXK-96: a Vulkan colour-target fix (#399)
  • @francosang: the HD minimap's SDK proposal (ZeldaWWHDMods #33), used for #434

Many features in this release come from two Android forks of the port, with their authors' code or ideas:

  • @GreenNaugahyde's Android fork (GreenNaugahyde/ZeldaWWHDRecompAndroid): the in-app randomizer, GameCube player models, Achievements, Game progress, Walk-through doors, 16-character names, Instant text, Deku Leaf wave to rise, touch button pictures, menu sounds, controller dialogs, frame generation and several Android memory and driver fixes
  • @Nycolazs' Android fork (Nycolazs/WindWakerHD-Android-Plus): frame generation, the Turnip, Huawei, storm-picture, Shop Ship, texture-memory and low-memory fixes

And thanks for reports, ideas and testing: @aaronlink127, @AnythingVocaloid, @alexander-beepx, @andreasbertram5-alt, @Eggtooth, @findel77, @Froggjarl, @jamesmendel, @KaitoCrisHub, @MattPlays02, @plxjammerplx, @Sherisherisherisheri, @SpicyAwesomeSauce and @thejorro.

New

  • Randomizer built in (#430, #431, #390, #366, #408, #396, #433, #435, for #117, the in-app approach from the GreenNaugahyde Android fork, thanks @GreenNaugahyde; randomizer: TWWHD Randomizer 1.2.0, MIT). Setup's Randomized games page makes a seed from a preset, a seed name or a permalink, checks it against the port and builds it. A game made with the official TWWHD Randomizer is added with Import seed… on the same page (or setup --import-seed PATH). Every option of 1.2.0 is accepted, including Quiet Swift Sail and entrance shuffle (thanks @KaitoCrisHub for the report, #383); seeds from 1.1.1 and older are refused. In the game, Settings › Randomizer shows the seed, its permalink and (after a question) the spoiler log with a sea-chart map. Works for USA and European games and on Android. Every randomized game has its own saves, backups and save states; your normal save is never touched. Choose your game and setup --game-dir no longer accept a randomized game folder: install the game as it is, then import the seed. Randomized games installed the old way keep updating and keep their saves.
  • GameCube player models (#432, from the GreenNaugahyde Android fork, thanks @GreenNaugahyde). Mods › Install from a file takes a GameCube model pack you have (a folder or zip with Link.arc). The port converts it on your device onto HD Link's skeleton, materials and animations, with textures upscaled to HD's sizes. On the model's page in the Mods tab you choose it per save file; the choice applies live, no restart. No model packs ship with the port.
  • New built-in mod: Achievements (#410, goals, texts and points from the GreenNaugahyde Android fork, thanks @GreenNaugahyde). Off by default (Mods › Built-in). 99 goals read from your save data, earned for good, for all save files together and for each one; the record is kept in achievements.json in the port's config folder, never in the save. When you earn one, Link turns round and holds it up with the game's item fanfare (its volume is an option). Cheats pause achievements while they're used, unless you turn on Earn with cheats; loading a save state never takes one back. Pages on the item menu's settings page (Game tab) and in the Esc settings.
  • New built-in mod: Game progress (#409, idea, count and places from the GreenNaugahyde Android fork, thanks @GreenNaugahyde; chart numbers from TWWHD Randomizer). Off by default (Mods › Built-in). Shows how much of the game your save file has found: a percent, a checklist in ten parts (dungeons, hearts, items, equipment, upgrades, songs, pearls and Triforce, charts, the sea chart, the Nintendo Gallery) and a sea-chart map of where each thing is found. An option shows the percent on screen. Two places (Crescent Moon Island's sunken treasure, Triforce Chart 2) are still to be checked in the game.
  • 60 fps (generated), experimental (#425, from the GreenNaugahyde and Nycolazs Android forks, thanks @GreenNaugahyde and @Nycolazs). On Vulkan, Graphics › Frame rate › 60 fps (generated, experimental) keeps the game at 30 fps and generates every other frame on the GPU from the last real one (camera and object movement, with the HUD kept exact). Off by default; not yet checked on a phone. Not available on Metal (on a Mac, use the Vulkan renderer).
  • Keep your save in a cloud folder (#238, for #190, thanks @rhemfur). Settings → Saves → Save folder (Windows, macOS, Linux) puts your save in a folder you choose, for example in OneDrive, Dropbox, iCloud Drive or Google Drive, so it stays the same on all your computers. The save only replaces the real one once it is fully on disk, a lock warns when the folder is in use on another computer, and cloud conflict copies are offered at the next start. Nothing is replaced or removed without a backup first and without your answer. See the README section "Optional: keep your save in a cloud folder".
  • Change Link's name mid-game, up to 16 characters (#343, for #328, thanks @itsarahtonin; #428, idea from the GreenNaugahyde Android fork, thanks @GreenNaugahyde). The settings page in the pause menu (Game tab) and the Settings window's Saves tab can rename Link on the save file being played; the new name shows right away and is kept with your next save. Names can now have up to 16 characters: the game's texts use the whole name, the file select shows the first 8. The whole name travels with the save (backups, exports, randomizer saves). % and characters the game's font can't show are refused.
  • Quick doors: new "Walk through" mode (#426, from the GreenNaugahyde Android fork, thanks @GreenNaugahyde). Quick doors is now Off, Faster or Walk through. With Walk through, dungeon shutters and house doors open as Link walks up, he walks through without the door scene and the door shuts behind him. Locked doors, boss doors and doors with bars keep their scene, sped up as with Faster. Walk-through doors open with A makes them wait for A. The game code is rebuilt once after the update.
  • Instant text and No pauses in texts (#411, ideas and code from the GreenNaugahyde Android fork, thanks @GreenNaugahyde). Two new switches under Settings › Game, both off by default: message boxes show their whole text at once (each box still waits for A), and the short waits written into some texts are left out.
  • Deku Leaf: wave to rise (#412, ideas and code from the GreenNaugahyde Android fork, thanks @GreenNaugahyde). A new built-in option next to Jump anywhere, off by default: while gliding, each wave of the Deku Leaf lifts Link a little, and holding the button keeps waving. The height of one wave is 50–200 %; the glide still uses magic.
  • GameCube controllers and button prompts (#301, thanks @MattPlays02 for the idea; #374, for #355; #392, for #356, thanks @itsarahtonin for the report). Choose GameCube in Controls, or let Automatic pick it for a GameCube pad: A acts, B is the sword, X, Y and Z use the item slots, L targets and R shields (from a quarter of their travel or at the click), the C-stick turns the camera and a tap of Start opens the menus. A recognized GameCube controller gets this layout right away. GameCube button prompts show the GameCube's own buttons in the HUD, item menu and dialogue: the big green A, the red B, the kidney-shaped X and Y, the purple Z and the shoulder plates. Each controller can keep its own layout, and Restore previous controller bindings brings back the old buttons. Details in docs/gamecube-controller.md.
  • Keyboard and mouse button prompts (#364, for #265, thanks @Eggtooth for the idea). Choose Keyboard / mouse under Controls › Button prompts and the game's prompts show the key or mouse button you bound (for example Tab, M1, LShift, Wh+), drawn in the game's own font. The camera mods (mouse camera, direct camera, first person) moved from Mods › Built-in to Controls, with their settings unchanged.
  • Aim the boat cannon with the mouse (#360, for #332, thanks @AnythingVocaloid for the idea). With Mouse camera on and the pointer captured, moving the mouse aims the cannon on the King of Red Lions.
  • Targeting letterbox: On / Off with enemies / Always off (#395, for #114, thanks @andreasbertram5-alt for the request). The bars that appear while holding target can be kept, hidden only when an enemy is targeted, or hidden always (also for free targeting). Cutscene, event and minigame bars stay.
  • A 4:3 aspect-ratio preset (#359). Settings › Graphics (and the macOS Graphics menu) offer 4:3 next to the widescreen presets. WWHD_ASPECT=4:3 selects it too.
  • Story-item cheats (#362, for #289). Mods › More › Cheats › Story items can grant Nayru's, Din's or Farore's Pearl, or the fully powered Master Sword. The first use each session asks for confirmation, because it can change the story's order, and a backup of your save is made first.
  • HDR: metadata, darker shadows and a choice of format (#337, thanks @mkopec, and @findel77 for testing; #333, thanks @findel77). With HDR on, the game tells the display its brightness range, so HDR TVs and monitors tone-map it correctly (Auto Peak, on by default, reads the display's peak). The picture is turned into HDR with a gamma 2.2 curve, so shadows no longer look washed out; SDR curve in HDR offers Gamma 2.2 (default), Gamma 2.4 or sRGB (the previous look). HDR format picks Auto, scRGB or HDR10 (PQ). See docs/hdr.md.
  • Settings plays the game's menu sounds. Moving, choosing, switching tabs and opening or closing Settings play the game's own menu sounds. Settings → Audio → Menu sounds (on by default). Idea from GreenNaugahyde's Android fork, thanks @GreenNaugahyde.
  • GamePad screen: bars filled with the menu background (#397). Where the GamePad picture doesn't fill the screen (the Thor's second screen, phones in GamePad-only mode, the GamePad window), the bars around it show the menu's own background instead of black. On by default; Settings → Display → Fill GamePad bars with background.

Improved

  • 60 fps frame interpolation plays exactly like 30 fps (#436). Before, some characters behaved differently at 60 or 120 fps and random events drifted from what the game does at 30 fps (on Outset the grass cutter stopped cutting, and from then on enemy behaviour and drops differed). The picture still gets its in-between frames; the game logic behind them is now the same as at 30 fps.
  • True 60 is retired (#407). The experimental "True 60" frame rate (Link and the camera at 60 game steps a second) was broken in many places and is gone; key 7 does nothing now. If you had True 60 selected, the game starts with 60 fps frame interpolation instead. Nothing to do on your side.
  • Touch controls: Link in the button pictures, a boat item ring and more taps (#427, ideas and code from the GreenNaugahyde Android fork, thanks @GreenNaugahyde). Action buttons show a small picture of Link in that action's pose (jump, sword, crouch, roll, lift, talk, defend, grab, throw, the rope, Cruise and more) with the game's word under him, drawn from your own game files (Settings → Display → Touch controls → Link in the button pictures, on by default). On the boat, the item ring only shows items you can use there. Letters, stone tablets and signs move on with a tap, and after a game over you can tap Continue or Quit. The Classic style always shows every button. Not yet checked on a phone; reports welcome.
  • Settings dialogs with a controller (#413, ideas and code from the GreenNaugahyde Android fork, thanks @GreenNaugahyde). Dialogs open with their default button selected (Cancel where the action can't be undone), the selection shows again when the controller takes over from the mouse, the right stick scrolls long dialog text, and a button still held while the menu opens presses nothing.
  • The Controls settings are split into pages (#371). Settings › Controls has five tabs: Bindings, Controller, Prompts, Camera and Gameplay. Every setting keeps its value; only its place changed.
  • The settings page in the pause menu no longer takes Left from the game. Left goes to the game's item slots first; only where the game has nothing further left does the cursor move onto the page arrow (A or Left again opens the page). ZL no longer opens it, and Settings page in the pause menu in Controls turns the arrow off. The arrow's design follows the GreenNaugahyde Android fork (thanks @GreenNaugahyde).
  • Picture scaling: Sharp is pixel perfect (#414, idea from the GreenNaugahyde Android fork, thanks @GreenNaugahyde). The settings now say that Sharp shows each rendered pixel as a crisp block. Only the wording changed.
  • Windows setup: compiler unpacking shows progress (#394, for #388, thanks @Sherisherisherisheri for the report). Setup shows how many files are unpacked instead of sitting silent for minutes, and if unpacking fails it says why (most often an antivirus program or a full disk) and what to do next.

Fixed

  • Picto Box at wide and tall screens (#303, thanks @aaronlink127). Wider than 16:9 or taller (16:10, 4:3, phones), the Picto Box now takes the same 16:9 picture as on the Wii U, and its subject check only counts what is inside that frame. Normal play keeps your full view.
  • Leaving Beedle's Shop Ship could stop the game (#416, from the Nycolazs and GreenNaugahyde Android forks, thanks @Nycolazs and @GreenNaugahyde).
  • The 3D picture could go black for some frames in a storm (#417, from the Nycolazs and GreenNaugahyde Android forks, thanks @Nycolazs and @GreenNaugahyde). Some GPUs (seen on Adreno 650 phones) produced invalid pixel values near lightning at night, which bloom spread over the whole screen. Shaders are compiled once more after this update.
  • A shader that crashes the GPU driver no longer stops the game from starting (#418, from the GreenNaugahyde Android fork, thanks @GreenNaugahyde). The next start leaves that one shader out and logs it; it's tried again after a driver, GPU or port update (Linux, macOS and Android).
  • Loading a portable state made while crawling (#365, for #361, thanks @thejorro for the report and the state). Link arrives still crawling instead of standing inside the tunnel's ceiling.
  • Controller dead after switching it in a menu (for #330, thanks @itsarahtonin). Switching Keyboard and controllers act as while the pause menu or file select was open no longer leaves the game ignoring every button.
  • The rupee sparkle fades out with the rupee counter (#358, for #353, thanks @thejorro for the report).
  • Match window keeps exact preset ratios (#372, for #349, thanks @plxjammerplx for the report). A window shaped exactly like a preset (for example 1280×960) uses that preset's exact ratio instead of a rounded one.
  • Long help lines no longer make the settings page flicker at high resolutions (#345, thanks @itsarahtonin).
  • The new-game name screen refuses % (#351, thanks @itsarahtonin), which the game reads as a format code.
  • Start-up audio waits like on the console. At boot the game now waits for its audio threads to finish setting up, as the Wii U does, so the sound system is always ready before the game first uses it.
  • Windows: a damaged native mod no longer freezes startup (#437). It now fails with an error instead of waiting on a hidden Windows error box.
  • Windows: the Wii U GameCube adapter works (#357, for #354, thanks @itsarahtonin). Install the WinUSB driver for it with Zadig (the same driver Dolphin uses); see the GameCube controller guide.
  • macOS: Steam Controllers launched through Steam (#348, for #342, thanks @davidsgullick for the change and @jamesmendel for testing every step on real hardware). The macOS app reads Steam Input's virtual pad, so a Steam Controller started from Steam works and is found again after a reconnect.
  • macOS: controller rumble (#347, for #346, thanks @davidsgullick). Any pad macOS reports haptics for rumbles, for example a DualSense.
  • Linux: NVIDIA on Wayland closing the game (#309, thanks @Froggjarl). The game turns on NVIDIA's older sync method on Wayland by itself (__NV_DISABLE_EXPLICIT_SYNC=1, driver 575 or newer); a value you set yourself is kept. If it still closes, SDL_VIDEO_DRIVER=x11 runs the game through XWayland.
  • Linux on Mali (panvk): one colour over the whole picture at sea (#317, follow-up to #310, thanks @mkopec). v0.5.0's fix for the flickering sky could turn the picture one solid colour near Outset. On panvk, draws that don't write depth now clip in their shaders, as the Wii U does. WWHD_VK_CLIP_EMULATION=0 turns it off. Details in docs/vulkan.md.
  • Linux: launchers for data folders with special characters (#377, for #376, thanks @RaphaelFakhri for the report and the fix). A folder name with $, `, ", \ or % (for example Games 100%) no longer breaks play.sh or the menu entry.
  • Vulkan: continued draws pick the right colour targets after a scissor change (#399, thanks @DaniXK-96). A correctness fix; no known visible glitch.

Android

  • Fixed: Android running at about half speed since v0.5.0 (thanks @SpicyAwesomeSauce, #334). From the second launch on, Snapdragon phones ran much slower (Windfall at 40 fps ran at about 22 fps). It holds 40 fps again, with no extra stutter when new areas load. WWHD_VK_PIPELINE_WARMUP=0 is no longer needed.
  • Tap the title screen to start, and touch on file select and name entry (#340, thanks @GenissonEmilio). Your touches reach the game's own GamePad touchscreen on those screens; with no second display, the GamePad picture shows on the main screen there and your view comes back afterwards.
  • Safer save import (#339, thanks @GenissonEmilio; #382). An imported save is checked completely before it replaces yours, and your previous save is kept as a backup. An interrupted import brings your old save back, oversized or damaged archives are refused, and a second import or export can't start while one is running.
  • Touch controls stay visible on the Poco M8 Pro (#338, thanks @GenissonEmilio). The phone's built-in key injector no longer counts as a controller.
  • Turnip on Adreno 6xx GPUs runs without UBWC (#420, from the Nycolazs and GreenNaugahyde Android forks, thanks @Nycolazs and @GreenNaugahyde). With a custom Turnip driver, Adreno 6xx phones (seen on a Galaxy S20 FE) could restart at the first frame above 1x resolution; now 1.5x runs too. A TU_DEBUG you set yourself still wins.
  • BC textures decoded on the CPU on Huawei GPUs (#419, from the GreenNaugahyde and Nycolazs Android forks, thanks @GreenNaugahyde and @Nycolazs). Huawei's Maleoon driver crashed compiling the texture decoder shader.
  • Textures that haven't been used for a while are freed (#423, from the GreenNaugahyde and Nycolazs Android forks, thanks @GreenNaugahyde and @Nycolazs). Textures not drawn for about four minutes are released (sooner when memory is tight), so long sessions use less memory. WWHD_VK_TEXTURE_BUDGET=0 turns it off. Not yet measured on a phone.
  • Dynamic resolution also steps down when memory runs low (#422, from the GreenNaugahyde and Nycolazs Android forks, thanks @GreenNaugahyde and @Nycolazs). On devices with less than 3.8 GB of RAM it starts at 1× at most.
  • No save state when memory is about to run out (#421, from the GreenNaugahyde Android fork, thanks @GreenNaugahyde). Such a save is refused with "not saved (too little free memory, close other apps)", instead of Android closing the game in the middle of it.
  • Share log can include your save files (#415, ideas and code from the GreenNaugahyde Android fork, thanks @GreenNaugahyde). A new checkbox, off at every start, adds your save file and Picto Box photos for bug reports. Every name in the save becomes "Link" first. Not yet tested on a phone.
  • Fixed: code mods "not available" in Android development builds (mods issue #6, thanks @alexander-beepx). Releases weren't affected.

Mods and mod SDK

  • Profile mods get their own saves (#385). A mod can declare its own save profile; its saves, backups, settings and save states are then kept apart from your normal game, so a profile mod can't overwrite an ordinary save. Turning the mod off (or Switch all mods off) takes effect on the next launch, which also gives Android players a way back to the normal game without reinstalling.
  • Fixed: Story Notebook leaving the menu broken (mods issue #9, thanks @francosang). After the notebook closed, the menu cursor or bait icons could stay hidden; the item button now shows the notebook on the TV and the GamePad.
  • For mod authors: mirrored HUD images and the game's own layout texts (#434, from the HD minimap's SDK proposal in ZeldaWWHDMods #33, thanks @francosang). A HUD image drawn with reversed UVs shows mirrored, and wwhd_game_message_get("layout-message:/", …) returns the game's own text for a layout label. Mods check hud.mirrored-images.version / layout-message.version first. HUD API 3, mod manager 1.9.0.
  • For mod authors: boat compasses and chart selection. Code mods can take over the boat compass corner while sailing (wwhd_hud_boat_compasses) and select a sea chart like the GamePad does (wwhd_map_chart_selected / _select / _cancel). See docs/mod-sdk-v2.md. Used by the HD minimap mod.
  • For mod authors: mods can require an exact game build (#429). A manifest can list supported_game_builds (for example ["USA"]); the manager refuses the mod on a port built for another game version. Needs minimum_manager_version 1.8.0.
  • For mod authors: native actors, story flags, quick-use and traversal (#375, #369, #389). C mods can register their own native actors with wwhd_native_actor_profile_register; wwhd/save_flags.h reads and changes the game's story flags with checked inputs (take a save backup first); and source mods get services for the game's quick-use item actions, ready-item checks, boat sail wind and target calculation.
  • Fixed for mod authors: C mods and hooks leave the game's state alone (#367, #384, #387, #391). Hooks no longer change the hooked function's registers; C mods keep the game's paired-single float registers; and mods are built with -mstackrealign, since the game can call them with an 8-byte-aligned stack. Rebuild C mods from source to get the stack fix; older mods get a best-effort safeguard.
  • For mod authors: True 60 is gone (#407). render.true60 still exists and always reads 0, and wwhd_logic_dt is always one 30 Hz step.
  • Editor: MCP access starts once the game is ready (#386). With --editor --mcp, the MCP server starts after the game code is loaded and all mods are initialized.

Decomp build and testing

  • Decomp build (experimental) (#368, #370, #373). In the -DWWHD_DECOMP=ON build, 63 functions of the game's compiler runtime and nn wrappers run as host code, each matched to the original by measurement (WWHD_HOSTRT=0 runs the originals); the scalable font draws with the game's main font, since the port doesn't provide the Wii U's system font; and the build reads the decompilation's unit specs the way its own checks do. The normal build is unchanged and keeps the game's own code.
  • Tests (#403, #404, thanks @itsarahtonin; #379). The Vulkan BC self-test accepts NVIDIA's slightly different BC4/BC5 rounding, the SDL input tests ignore real controllers such as a plugged-in GameCube adapter, and scripted Android runs (WWHD_NO_HOST_INPUT) skip the first-start touch-controls question.

Checksums (SHA-256)

d9aa58c1745e9c9bb32a163bc0dd06b6290cd4832ef852d6084886f3f6a75105  WindWakerHD-v0.5.1-linux-aarch64.zip
d7f56850b5b74788f001bab8eecac8cccde5b1e24e11473e14fbd673b7616c3c  WindWakerHD-v0.5.1-linux-x86_64.zip
3e5d7b8715ee7263c641f5eaa7ccd400299601d6c6ae1a0ff01578e4130d92f6  WindWakerHD-v0.5.1-macos-arm64.zip
bd53bdb718d2f65d6bce08fbc72ff38edb196b59a05e390820d128f67e21a2a9  WindWakerHD-v0.5.1-windows-arm64.zip
2e8a8b29ed1b35e6d3cae370a7c9b6878a05d6269b28420dd492415da72f48c4  WindWakerHD-v0.5.1-windows-x86_64.zip
9151908c2db0a14fee9da199973a7d7d67133f754f87e15615c1804c20cd45df  WindWakerHD-v0.5.1-linux-aarch64.AppImage
e7532b3f4a04ccc0f4b6bb6dfb7bf79ceb8e249d71853c0bf62b0ed1ce5ebf8a  WindWakerHD-v0.5.1-linux-x86_64.AppImage
1157a798095f17814df0b748fac414b450e301ea34a7fcacc13adc85799f11ac  WindWakerHD-v0.5.1-android-arm64.apk
bd6cfc5e742a6da0ed8deb739787e4f482521f4212c21379f20271119e33e340  WindWakerHD-v0.5.1-android-x86_64.apk

VirusTotal

Scan results of this release's files at publishing time (results can change as engines update):

  • WindWakerHD-v0.5.1-linux-aarch64.zip: 0 of 63 engines flag it, report
  • WindWakerHD-v0.5.1-linux-x86_64.zip: 0 of 62 engines flag it, report
  • WindWakerHD-v0.5.1-macos-arm64.zip: 0 of 57 engines flag it, report
  • WindWakerHD-v0.5.1-windows-arm64.zip: 0 of 67 engines flag it, report
  • WindWakerHD-v0.5.1-windows-x86_64.zip: 3 of 67 engines flag it, report
  • WindWakerHD-v0.5.1-linux-aarch64.AppImage: 0 of 61 engines flag it, report
  • WindWakerHD-v0.5.1-linux-x86_64.AppImage: 0 of 62 engines flag it, report
  • WindWakerHD-v0.5.1-android-arm64.apk: 0 of 56 engines flag it, report
  • WindWakerHD-v0.5.1-android-x86_64.apk: 0 of 45 engines flag it, report
  • Wind Waker HD.exe: 0 of 69 engines flag it, report
  • Wind Waker HD.exe: 3 of 71 engines flag it, report

Detections on the Windows files are generic heuristics on an unsigned program (Elastic, Google, Ikarus), reported to the vendors as false positives; see issue #58.

0.5.0
  • Intégration fluide et réduction des stutters : préparation des shaders accélérée (12 secondes au lieu d’une minute sur macOS) et suppression des attentes de shaders sur Android (passant de ~1 000 à ~35 ms).
  • Menu de paramètres intégré : page dédiée dans le menu pause (système, graphismes, contrôleurs), compatible clavier, souris, contrôleur et tactile, avec support multilingue (anglais, français, allemand, italien, espagnol).
  • Contrôles tactiles et améliorations : sticks flottants adaptatifs, boutons contextuels (ex. : tir au bow), roue d’objets et mode "One screen" (simulant le GamePad en mode portable), activé par défaut sur Android.
  • Corrections graphiques majeures : textures macOS aussi nettes qu’à l’origine Wii U (Metal/Vulkan), suppression des artefacts (flickering de torches, checkerboard sous les chests), stabilité des scènes (horizon, mer, ciel).
  • macOS : redimensionnement et déplacement de l’image du GamePad avec la souris, installation requiert macOS 14+ (non signée par Apple, autorisation manuelle nécessaire).
  • Stabilité et corrections : suppression des judder (soleil/moon), continuité après Game Over avec interpolation, fix des dates du Quest Log, et gestion des sauvegardes GameCube dans le Picto Box.

This update is about smooth play: far fewer shader stutters and steadier frame interpolation, plus more than 100 other changes since v0.4.0. Here are the highlights.

In short

  • Far fewer stutters: faster shader preparation in setup, and on Android setup now prepares model shaders by default (on our test phone, shader waits dropped from about 1,000 to about 35).
  • A settings page inside the game's own pause menu, drawn like the game's menus, with Camera, Controls, Screen, Graphics, Game and Mods tabs. It works with a controller, keyboard, mouse and touch.
  • New touch controls for Android: floating sticks where your thumb lands, buttons that show only when they do something, tap-to-aim items, and talks and shops by tap. Plus an item wheel (also for controllers) and a One screen (handheld) mode that plays like the GamePad in Off-TV Play.
  • Controllers: a short setup for each new pad, buttons per controller, button prompts that follow your own face buttons, and buttons for Jump anywhere and the moon jump.
  • Sharper, steadier picture: smooth bloom and sharp torchlight at 2x and 3x, torches without a flickering outline, Mac textures as sharp as on the Wii U, and scenes that look the same on every run.
  • Smoother frame interpolation that no longer changes the game: 40 fps without judder, many more things moving smoothly, and the game now plays exactly as at 30 fps.
  • More platforms and options: HDR on Linux, a floating theater on Meta Quest, a 10× smaller Linux install, and looping sounds such as waves and wind no longer cut out.
  • Many fixes, among them Quest Log dates, Continue after a Game Over with frame interpolation, and a stuck Picto Box quest after importing a GameCube save.

The full list is in the changelog.

Thanks

Contributions in this update:

  • @itsarahtonin: button prompts that follow custom face buttons (#319, #326), full-size torchlight (#318), smooth bloom at higher resolutions (#307, #308) and sharp torchlight on objects (#313)
  • @aaronlink127: the Triforce chest glow fix (#297), a smooth camera in the Boating Course (#299), Continue after a Game Over (#295), Link staying invisible after talks (#283), and the hookshot chain with interpolation (#304)
  • @CaptainLibrary: the sun and moon judder (#320) and the loading screen speed (#300) with interpolation, and the file select Quit button (#278, with @Tamryell)
  • @Tamryell: the Quit button on the file select screen (#278)
  • @Eggtooth: Quit as part of the file select's selection and the mouse button fix in menus (#315), and the "Access Denied" fix when building code mods on Windows (#282)
  • @KelpyCode: many world editor improvements: full rooms, model changes, exact joins, kit models and an easier Claude / MCP setup (#281, #296)
  • @mkopec: HDR on Linux and HDR10 (#311), and no more sky flicker on Mali (panvk) (#310)
  • @pancreations: the Meta Quest floating theater (#259) and detailed profiling as a setting (#261)
  • @rhemfur: measurements for the Quest theater's Full SBS 3D (#248) and the Quest game icon fix (#325)
  • @Pulpparty: the Nintendo Gallery figurines cheat (#327), and with @depende3000 ideas from SwitchWakerHD: the smaller shader template, looping sounds that no longer cut out, and the hang watchdog
  • @depende3000: ideas from SwitchWakerHD (shader template, hang watchdog)
  • @l0nkDev: the One screen mode idea from SwitchWakerHD
  • @koenada: correct Quest Log dates (#322)
  • @Froggjarl: no more crash when the chosen GPU can't show the picture (#309)
  • @pontesryan: the Picto Box quest fix for imported GameCube saves (#306)
  • @shaneoreilly: moving and resizing the GamePad picture with the mouse on macOS (#305)
  • @missionfloyd: a 10× smaller Linux install (#314)
  • @Linken17: controller input while the game isn't focused (#267)
  • @alexander-beepx: code mods in Android's Community list (ZeldaWWHDMods#6)
  • @Omaley360: the report, save state and confirmation for the invisible Link fix (#283)
  • The GreenNaugahyde Android fork, where the ideas for the new touch controls, the item wheel, the settings page, the controller setup, the camera options and the low-memory handling come from
  • SwitchWakerHD, for the One screen mode, the shader template, sound and diagnostics ideas
  • aurora's GX layer (MIT), for the ideas behind the new opt-in Vulkan switches

And thanks to everyone who reported issues and tested the development builds.

Settings and menus

  • Settings in the pause menu: a page in the item menu drawn with the game's own paper, font and sounds, in English, French, German, Italian and Spanish. Tabs for Camera, Controls, Screen, Graphics (resolution, frame rate, dynamic resolution, bloom, FXAA, filtering, clouds, torchlight), Game and Mods. The full Settings window stays for everything else.
  • Quit on the file select screen: a Quit button in the game's style (X or click), and the game's own selector moves onto it.
  • HUD fades (optional): hearts, rupees and the magic meter can fade while nothing changes.
  • Large Picto Box view drops the finder's black frame.
  • New cheat: all Nintendo Gallery figurines.

Controls and touch

  • Flexible touch controls, now the default on Android: a stick appears where your thumb lands; the right half turns the camera. Classic fixed sticks are still there. The layout editor gains size, shape, opacity, a mirrored grid, and saved layouts with export and import.
  • Context buttons: a touch button shows only when it does something, with the game's own word or icon. Tap the bow, boomerang or hookshot to aim, tap again to shoot.
  • Talks, answers and shops by tap (or mouse, as an option), and B goes back while conducting the Wind Waker.
  • Item wheel: hold X, Y or R to pick an item from a ring; the game slows down while it's open.
  • One screen (handheld) mode: plays like the GamePad in Off-TV Play, without the "GamePad or Pro Controller?" question. On by default on Android, an option on desktop and Steam Deck.
  • Controller setup for each new pad, buttons per controller, and button prompts that follow your own face buttons, with optional coloured action words.
  • Jump anywhere and the moon jump get buttons of their own; a standing jump now goes straight up.
  • Walking and camera options: keep the walking direction while turning the camera, a camera that swings behind Link, a faster boat camera, and pinch to zoom on Android.
  • Controllers can keep playing while the game isn't focused (an option, for streaming or a second screen).
  • macOS: move and resize the GamePad picture with the mouse.

Graphics

  • Bloom is smooth and torchlight is sharp at 2x and 3x, as at 1x.
  • Full-size torchlight (on by default, off on Android) removes the flickering outline around lit objects near torches.
  • Mac: textures as sharp as on the Wii U (Metal and Vulkan).
  • Scenes look the same on every run: fixes for the distant sea and grass at Outset's cliff changing colour, and for the horizon flickering on Metal.
  • The glow under Triforce Shard and Chart chests no longer shows a checkerboard.
  • Effects such as elemental arrows and rupee sparkles sit in the right place at every aspect ratio.
  • HDR on Linux under Wayland, and HDR10 where scRGB isn't offered.
  • Linux on Mali (panvk): no more flickering shapes in the sky.
  • New setting Shader compile: Fast keeps playing while new shaders compile.

Frame interpolation

  • The game now plays exactly as at 30 fps at 40, 60, 120 and 240 fps; only the picture is smoother.
  • 40 fps without judder: every frame shows the game at its exact point in time.
  • Much more moves smoothly: camera shake, clouds, the sun and moon, hair and ropes, the sword trail, the hookshot chain, flags, shadows, fades, cutscene bars and more.
  • Fixed: Continue after a Game Over, Link staying invisible after some talks, a floating fist, flickering fades, the Boating Course camera, the sun and moon judder, and the loading screen speed.
  • Fast Forward's 3x and 4x now really run three and four times as fast.

Shaders and stutter

  • Faster shader preparation in setup: about 12 seconds instead of a minute on a Mac, with far less memory.
  • Android: setup prepares model shaders by default for far fewer stutters (about 40 minutes on a recent phone; you can untick it).
  • Vulkan: after setup's models step, recorded pipelines are built in the background while you play.
  • Smaller shader caches, Metal cache versioning, and shaders that failed to translate before now work.
  • Setup on a network share (NAS) works again.

Android and handhelds

  • The new touch controls, item wheel and One screen mode above.
  • "Use the new touch controls?" on first start, and mods can be installed from a file.
  • Less likely to be closed when memory runs low.
  • Fixed: false "too hot" warnings, and the heat pause flashing on and off, on some handhelds (AYANEO).
  • Meta Quest: a floating theater with a flat or curved screen, 2D/3D (now Full SBS), size, distance and passthrough.

Sound

  • Waves, wind and other looping sounds no longer cut out after a slow frame.

Mods and the world editor (for mod makers)

  • Mod SDK: live options, input filters, touches and pinches, points on the picture, the microphone (only when an option asks for it), and the game's own HUD art.
  • New world pieces: the Goron merchants, torches, lava (with col_lava ground), calm water around islands, bigger islands, game materials on your own sea models, and islands seen from farther away.
  • World editor: replace, watch and remove imported models, the game's materials without MCP, own 3D models in the Windows release, custom items, exact joins and marked faces, and an easier Claude / MCP setup.
  • One mod that can't start no longer stops all the others, and a missing mod compiler gets a clear message.

Other fixes

  • Quest Log dates are right again.
  • The Picto Box quest no longer gets stuck after importing a GameCube save.
  • Choosing a GPU that can't show the picture no longer crashes the game.
  • A mouse button bound to a controller button works in menus again.
  • Mouse camera up/down is no longer inverted in some interiors.
  • The game starts when run directly, and --editor works through the launcher.
  • Linux: the installed game is about 10× smaller.
  • Windows: building code mods no longer fails with "Access Denied".
  • Android: code mods can be installed from the Community list.
  • A hang watchdog writes a report to the log if the game stops drawing, and detailed profiling is now a setting (off by default).

The full list of changes is in CHANGELOG.md.


The Wind Waker HD, native PC port, v0.5.0

This release contains no game files, no game code and no keys. You need your own disc dump (.wux/.wud with its disc key, plus the Wii U common key from your console), a Cemu .wua archive (no keys needed), or an already extracted game folder. The installer builds the game from it on your machine.

Install: download the zip for your system, unzip it anywhere and start Wind Waker HD. The first start prepares the game once from your dump (about two minutes); later starts launch it directly. Everything stays in that folder.

  • macOS (Apple Silicon, macOS 14+): Wind Waker HD.app. The release is not signed by Apple: macOS 15+: System Settings > Privacy & Security > Open Anyway; macOS 14: right-click > Open. Keep the app inside the unzipped folder (move the whole folder, not just the app)
  • Windows: Wind Waker HD.exe (SmartScreen: "More info" > "Run anyway"); windows-x86_64 for x86-64, windows-arm64 for Windows on ARM (Snapdragon X)
  • Linux (glibc 2.35+, Vulkan): wind-waker-hd; linux-x86_64 for x86-64, linux-aarch64 for arm64 (Raspberry Pi 5, Asahi Linux, ARM laptops). Or one file: chmod +x the .AppImage and start it from anywhere (Steam Deck included); its game, code, saves and settings go to ~/.local/share/wwhd and ~/.config/wwhd instead of beside it (Ubuntu 24.04+: libfuse2t64, or --appimage-extract-and-run)
  • Android (arm64, Android 13+, Vulkan 1.3): install the android-arm64.apk (android-x86_64 is for emulators and Chromebooks), choose your game in the app, and it builds the game on the phone (once, a few minutes). Signing certificate SHA-256: 7F:F6:D3:5E:4E:45:11:5E:E4:93:65:EF:5B:40:C0:EB:83:EA:F7:6C:C1:1C:E9:67:F2:64:5C:50:4F:58:B2:13

See "Install (releases)" in the README for details.

Checksums (SHA-256)

31bccded0cb2493bb12d38f851a1290a5cff8ea0efa10b7001f661ca9eae5789  WindWakerHD-v0.5.0-linux-aarch64.zip
3584c4fe05ce99fdd460b73777ca34a7ce75ffb5e56bd1a84d89ef363bb69cf9  WindWakerHD-v0.5.0-linux-x86_64.zip
41004d42c39d862814f383b327bbf81492b026fe7ca0d7858d9dea631d1ac406  WindWakerHD-v0.5.0-macos-arm64.zip
48624feb8b14b0b41d82c45298ea833f14b794f504e31ff2c7577e104cb1d226  WindWakerHD-v0.5.0-windows-arm64.zip
11681f6584757567b0feeb2a464fcc2e792a3315ac27105d6c6d3345bf61d105  WindWakerHD-v0.5.0-windows-x86_64.zip
3e86ab17fb4f20a7feacca4b844383ca8066a5cd0ab9cec50c608c5941c7498f  WindWakerHD-v0.5.0-linux-aarch64.AppImage
7772ccac38854a23c19328437d6aca07d569a1fc097aabad00b9839f7417ba89  WindWakerHD-v0.5.0-linux-x86_64.AppImage
6af660aac1c67e5d99bbc653b1c2b9f0e429a8513e0e9ca0c497b0c37177f791  WindWakerHD-v0.5.0-android-arm64.apk
61dbe882fc339225d8708227e9fddd7ad9544e2073def1f159c8745e7117f8a7  WindWakerHD-v0.5.0-android-x86_64.apk

VirusTotal

Scan results of this release's files at publishing time (results can change as engines update):

  • WindWakerHD-v0.5.0-linux-aarch64.zip: 0 of 63 engines flag it, report
  • WindWakerHD-v0.5.0-linux-x86_64.zip: 0 of 65 engines flag it, report
  • WindWakerHD-v0.5.0-macos-arm64.zip: 0 of 65 engines flag it, report
  • WindWakerHD-v0.5.0-windows-arm64.zip: 0 of 66 engines flag it, report
  • WindWakerHD-v0.5.0-windows-x86_64.zip: 3 of 65 engines flag it, report
  • WindWakerHD-v0.5.0-linux-aarch64.AppImage: 0 of 61 engines flag it, report
  • WindWakerHD-v0.5.0-linux-x86_64.AppImage: 0 of 61 engines flag it, report
  • WindWakerHD-v0.5.0-android-arm64.apk: 0 of 58 engines flag it, report
  • WindWakerHD-v0.5.0-android-x86_64.apk: 0 of 56 engines flag it, report
  • Wind Waker HD.exe: 1 of 69 engines flag it, report
  • Wind Waker HD.exe: 4 of 71 engines flag it, report

Detections on the Windows files are generic heuristics on an unsigned program (Elastic, Google, Ikarus, MaxSecure, Microsoft), reported to the vendors as false positives; see issue #58.

0.4.0
  • Éditeur de monde (préversion pour moddeurs) : accès via --editor pour placer/modifier en temps réel objets, PNJ, ennemis, portes, quêtes visuelles et scènes sans coder.
  • Améliorations Android : mode double écran pour handhelds, garde thermique, cadence stable à 60 fps, résolution dynamique (réduction progressive en cas de surcharge GPU).
  • Optimisations graphiques macOS : réduction des variantes de shaders sur Metal (500 au lieu de 3 500), cache des shaders sauvegardé plus fréquemment.
  • Nouveaux modes de framerate : ajout du mode 40 fps (3 étapes logiques sur 4 frames) pour écrans à 40/80/120 Hz (ex. Steam Deck).
  • Corrections critiques : résolution des bugs liés à la restauration de session après un quit en donjon/cave, réactivation des anneaux du Pirate’s Charm au-dessus de 60 fps.
  • Prise en charge des modèles animés : jusqu’à 16 matériaux par modèle (textures, transparences, faces doubles) pour les îles modifiées.

This update brings the world editor, a preview for mod makers, a much better Android version for phones and handhelds, more speed on every platform, and many fixes. The full list of changes is below.

Thanks

Contributions in this update:

  • @pancreations: Vulkan stereo (3D) improvements (#257) and Android setup tests (#260)
  • @almost-drowned-rat: on Android, Full screen hides the system bars (#225), the app's files folder in the system file manager (#226), and Back opens and closes Settings (#227)
  • @mhbxyz: one-press combat items and animation speed presets (#196), camera-directed Leaf gusts and initial item facing (#203)
  • @rhemfur: a game-icon shortcut on Meta Quest (#249)
  • The GreenNaugahyde Android fork, where many of this update's Android and graphics ideas come from (dynamic resolution, less GPU work on Vulkan, fewer shader variants on Metal, shadows without depth clamp, and more)

And thanks to everyone who reported issues and tested the development builds.

World editor (preview, for mod makers)

Start the game with --editor to build mods inside the running game:

  • Place and change things live: the game's own villagers, enemies (from ChuChus and Bokoblins to Darknuts, Wizzrobe summoners and Kargaroc riders), chests, pots, switches, doors and your own models. Drag them, turn them, set routes for villagers, and see the change at once.
  • Quests without code: a visual quest editor, quest talks for the game's villagers, letters, treasure charts and items, and story changes while the game runs.
  • Scenes: a scene editor that plays cutscenes with the game's own cutscene system.
  • Islands and levels: island grounds and parts, island buildings, eighteen more islands to place, a water tool for ponds, rivers and waterfalls, and new levels and dungeons of your own (with a dungeon map).
  • New mod… starts a mod in a few clicks. Export the game's islands for Blender as a reference.
  • Works with Claude and other AI assistants through MCP (off by default).

Android

  • A big update for phones and handhelds: two-screen handhelds (AYN Thor and similar), a heat guard for handhelds with a fan, even frame pacing at 60 fps, code mods, "Share log", and fixes for PowerVR phones (e.g. Pixel 10).
  • Dynamic resolution (off by default): lowers the resolution in small steps when the graphics chip can't keep up, without stutter.
  • Less GPU work, and shadows on GPUs without depth clamp (older Mali and PowerVR phones).

Faster on every platform

  • Less work on the render thread (graphics register writes, a fast path, graphics recorded on a second thread).
  • Keep game speed holds the game at full speed on devices just under 60 fps; a new 40 fps mode.
  • Fewer shader variants on macOS (Metal), and the shader cache is saved more often.

Graphics and comfort

  • Toon clouds, horizon haze and cloud shadows. A sharp picture on the Steam Deck in Gaming Mode by default.
  • Save states: Last session and auto saves. Quick-use locked items, run/swim boost options, an option to turn off the letterbox bars while targeting, Quit Game in Settings, remappable shortcuts (Esc opens Settings).
  • Automatic picture-in-picture shows the Wind Waker's song list. GamePad sounds through the main speakers.

Fixes (selection)

  • The Pirate's Charm rings again at 60 fps and above; Sploosh Kaboom shows no doubled markers; no crash at Orca's sword training with True 60; Link's fist no longer flies in with frame interpolation.
  • Continue last session works after quitting inside a dungeon, cave or house.
  • Controller rumble no longer stops by mistake; code mods work again in the Linux AppImage; fixes for Intel graphics on Windows.

Full list of changes

  • Fixed: switches and doors waited for a restart in the world editor. With all of the editor's live kinds installed, the table for the port's own actor types was full, so switches and doors fell back to "after a restart". They now appear at once like the other actors, and a failure names its cause in the log.

  • Mod stages: the light of a place of the game, the game's trees, joined rooms (for mod makers). A mod stage can take its light from another place, e.g. "light": {"stage": "sea", "room": 44} for Outset's daylight that follows the game's clock; it can place the game's own trees (small, bushy, large with a scale, palm) as room actors; and rooms joined by an open passage are now drawn together. The editor accepts parameters of two types (such as a kit given by number or by stage and room). See mod stages.

  • Dynamic resolution (all platforms, off by default; idea from the GreenNaugahyde Android fork). Settings → Graphics → Dynamic resolution lowers the internal resolution in small steps (down to 75% or 50%) while the graphics chip holds the game back, and raises it again when there is room. The picture keeps its size and is scaled smoothly, and a change of level causes no stutter. It helps on devices where the graphics chip, not the processor, is the limit; it costs some extra graphics memory (about 35 MB on a phone). See the Android and Vulkan docs.

  • Fewer shader variants on Metal (macOS) (idea from the GreenNaugahyde Android fork). Metal now keys shaders on the same narrow state as the Vulkan renderer, so the same scenes need far fewer shaders and pipelines (in our Outset test about 500 instead of 3,500 shaders); existing shader caches keep working. Pictures are unchanged.

  • Crash logs and performance reports list the renderer's live shaders, pipelines and memory mappings, which helps us find out-of-memory crashes.

  • Less GPU work on Vulkan (idea and first versions from the GreenNaugahyde Android fork). Shaders use the slower exact multiply only where a value may be infinite, and rendered mip chains are built only as deep as the game samples them, starting from the first changed level. On our test phone the GPU time per frame fell by about 8–9%; pictures match the previous version (a few pixels differ in the lowest bits).

  • Export the game's islands for Blender (for mod makers). The editor's new export_glb command (and tools/story_mods/export_glb.py) writes a game room, e.g. Outset or Windfall, or one building as a GLB file with textures, the game's material names and optionally collision by ground type and actor markers. It is a reference for scale, style and material names when building your own islands; the files are your own copy of the game's content and must not be shared or put into mods. See world objects.

  • Fixed: mod stages in release builds. The stage builder was missing from release packages, so mod stages, list_kit_materials and the stage templates failed there; development builds were not affected.

  • Mod stages and scenes: quests through stages, cutscene clips, carrying Link (for mod makers). Chests, defeated Darknuts and warps in a mod stage can move a quest on (then), quest places can point into the mod's own stage, scenes can use clips from the game's cutscene archives that play once and hold, Link's face animations and blending, a smooth blend when attaching one actor to another (e.g. the Helmaroc King grabbing and carrying Link with the game's own capture animation), and a scene spawn that drops Link in from above.

  • Fixed: Continue last session after quitting inside a dungeon, cave or house. Starting the game with At start → Continue last session (or a save state chosen to load at start) put Link at the save file's start point on Outset and then left the screen black. Link now arrives where you left off; loading states during play is unchanged.

  • Mod SDK: mod dungeon maps for HUD mods (for mod makers). A guest mod can read the current room's map of a mod dungeon (rooms, visited rooms, Link's position, and with the compass the chests), so minimap mods can show mod dungeons too.

  • Vulkan stereo (3D) improvements (#257, thanks to the contributor). Formats that can't be scaled fall back to full-size eyes instead of drawing into a cleared image, and stereo modes reuse their image memory between frames. Nothing changes with stereo off.

  • Less render-thread work on graphics register writes (all platforms; idea from the GreenNaugahyde Android fork). Register writes look up what they affect in a table instead of walking ranges, shader constants take a fast path, and the hot paths no longer use per-thread variables: about 0.3–0.5 ms less render-thread time per frame in our tests.

  • Shadows on GPUs without depth clamp (older Mali and PowerVR phones; idea from the GreenNaugahyde Android fork). Such GPUs used to fail on the game's shadow draws; the port now clamps depth in the shader instead.

  • Fixed: the Pirate's Charm shook without ringing at 60 fps and above (#262). With frame interpolation the game's on-screen interface logic also ran on the in-between frames, where sounds are skipped so nothing plays twice, and the charm's ring always landed there. It now runs once per game step at every frame rate, as at 30 fps; this also brings the interface's other small animations back to their original speed.

  • Scenes and kit materials for mod makers. A demo actor can ask for its own copy with "spawn": "always" (for example the Helmaroc King, while the room's own one waits hidden for its story moment). A room without a material mapping now uses the kit's main material instead of an arbitrary one, which fixes streaked or black ground. Scenes without text, sounds or story actions no longer need the Story Notebook. New editor and MCP commands: list_kit_materials, edit_demo_actor, set_package_info, and focus with an eye point.

  • Mod dungeons: sky islands and boss rooms (for mod makers). A stage can borrow the sky of a game stage (day sky, stars or dusk) over your own models; list_stage_templates in the editor and MCP lists which stages have a sky, a boss door and music to borrow, and the Stages tab can filter for skies. New entry style: an updraft that lifts Link into the stage. A big chest can hold a heart container, and a warp can wait until a chest is opened. Talks and scene ends can take Link into a stage. A stage can bring its own shader template so it doesn't stutter on the first visit (installed after setup: run setup's Repair). Game Over in a mod stage restarts at the stage's start.

  • World editor: scenes play right away, and easier demo steps (for mod makers). A new scene can be played with Play scene or Play step without saving and restarting first. In the Scenes window the step row no longer hides its buttons on narrow panels; the buttons say "Duplicate scene" / "Remove scene…" and "Duplicate step" / "Remove step", a step can be removed with right-click or Delete, and Undo brings back a removed scene. A demo step's actors and events are now picked from lists instead of typed as JSON: game characters, models and your mod's characters; sounds (with a Play button) and particles by name; joints, animations, Link's modes, time, rain and messages. The JSON stays under "Advanced". Full save states made by an older build in editor mode can't be loaded by this one.

  • Water tool: new ponds are swimmable, and pond surfaces always appear. A new pond's level now defaults to its depth above the shore, so Link can swim in it right away; banks stay compact, and nothing reaches down to the sea floor. Some pond outlines left the visible water out because its surface model couldn't be prepared; that is fixed, and the editor names the reason if a model ever can't be prepared. Such a model no longer stops the game at start.

  • Less render-thread work on the Vulkan renderer (#178). Shader programs are fingerprinted again only after the game writes to them, and texture invalidation now looks only at the textures it can reach. On a Snapdragon phone this cut the render thread's CPU time by about 11% in Windfall; the picture is unchanged.

  • Eighteen more islands to place (for mod makers). Shark, Horseshoe, Rock Spire, Thorned Fairy, Seven-Star, Overlook, Stone Watcher, Cliff Plateau, Angular, Boating Course, Gale, Headstone, Greatfish, Cyclops Reef, Two-Eye Reef, Diamond Steppe, Mother & Child and Fire Mountain join the island grounds, built from your own game files. Diamond Steppe and Mother & Child keep their own moving water. Pits, holes and doorways send Link back to the restart point. Fire Mountain comes without its lava for now, and Bird's Peak is too large to offer.

  • World editor: building mod levels, also with an AI assistant (for mod makers, preview). A new Stages tab creates a level from your room models (import, add, build, warp in), adds rooms, places entries, exits, doors with locks, chests, enemies, pots and return warps where Link stands, and moves them with handles in the picture. Check lists unreachable rooms, keys behind their own doors and room models without UVs or named materials. Every step is also an MCP command, so an assistant such as Claude Code can model rooms in Blender and build and look at the level in the game; see the new guide "Building a dungeon with an AI assistant".

  • Fixed: ponds on a mod's own island (water tool). A pond drawn on a terrace of the mod's own island model no longer turns into a column down to the sea floor and is no longer refused as "in the way": the water's level follows the ground at its shore, the island's own surfaces count as ground, and only what really rises through the water (a wall, a pillar, a house) blocks it. Messages now name the game place that blocks a spot and where it is.

  • Mod SDK: a dungeon map for mod dungeons (for mod makers, preview). A mod dungeon with a map shows it on the GamePad's map page (and on the TV's map tab with the Pro Controller): rooms seen from above, made from the rooms' floors, the rooms Link has visited, where he stands, and with the dungeon map every room; with the compass also the chests (open or not) and the boss door. Only Link's floor is shown for now.

  • 40 fps mode. A new frame rate next to 30, 60, 120 and 240 fps: three game steps over four frames, at full game speed. It suits screens that run at 40, 80 or 120 Hz, such as the Steam Deck LCD at 40 Hz or the OLED at 80 Hz, where every frame is shown for the same time. On Android the app asks for a matching screen rate; some phones choose the rate themselves, and on a 60 Hz screen 40 fps runs unevenly (Settings says so). Keep game speed works as at 60 fps.

  • Mod SDK: dungeons in mod levels (for mod makers, preview). A mod level can now be a small dungeon: rooms taken from any game room or the mod's own models, small-key, boss and shutter doors, chests with a small key, map, compass or boss key, enemies (ChuChus, Bokoblins, Keese, Darknuts), pots and a return warp. Each mod dungeon keeps its own keys, opened chests and switches; the game's save still only stores a normal entrance. See the example "mod-stage-dungeon".

  • Mod SDK: new levels of their own (for mod makers, preview). A mod can add a new cave or dungeon level with its own rooms, reached from a box in a game level and left through a floor exit. The level is built from the player's own game files when the game starts, with the look and music of a game level the mod names; doors between its rooms work. Saving inside it is safe: the game's save always keeps a normal entrance, so the save still loads with the mod removed, and with the mod the Quest Log continues inside. Save states made in a mod level ask for its mod. The editor lists mod levels for warping. See the example "mod-stage-cave".

  • Automatic picture-in-picture shows the Wind Waker's song list (#256). With the GamePad screen set to Automatic picture-in-picture, the GamePad picture now also appears while Link conducts with the Wind Waker, with the song list and the conducting guide, and goes away again when he stops.

  • Fixed: Link's fist no longer flies in from elsewhere with frame interpolation (#255). When Link's hand pose changed (for example from standing to running, or after targeting), a hand pose could appear for one in-between frame at the spot where it was last used and fly to his hand, most visibly at 120 fps and above. A part of a model that comes back after being hidden is now drawn where it is, without blending; everything else blends as before.

  • Mod SDK v3 and the editor: Kargarocs with riders and Wizzrobe summoners (for mod makers). A Kargaroc can carry a Moblin or Bokoblin along a mod path and drop it at the path's release point. A Wizzrobe summoner teleports between the points of one path and calls waves of enemies at the points of the next, in the game's own wave sizes (up to 20); summoned enemies give no drops. The editor sets up both paths when a summoner is placed.

  • World editor: a water tool for ponds, rivers and waterfalls (for mod makers, preview). Under Add > Water, click points on an island's ground: a pond gets a level handle, a river a band with flow arrows, shallow parts to wade and a reverse button, and a waterfall forms at a river's step or from two points. Link swims, wades and falls as in the game. Banks slope into the island's own grass and sand, the water is the game's own, and foam shows only at the shores. Check marks problems in red in the picture. The same is available as MCP commands. On the sea only; a pond can't be dug into the ground, so on a slope it sits in a grassy mound.

  • Fixed: the world editor no longer crashes at start when code mods are off. With Code-mod support turned off (and in the decomp version), --editor now starts; live editing is off and the editor says so, and edits are still saved.

  • Mod SDK v3 and the editor: paths, the wall cannon, warship routes and wandering Floormasters (for mod makers). A mod can draw lines and areas in a room (up to 16 per mod) and its enemies can use them. The game's wall cannon can be placed with an area as its firing range: it turns to Link and fires while he is inside, and a bomb destroys it, with the mod's own defeat flag and drops. An enemy warship can sail a route back and forth, firing at Link, and a Floormaster can glide along a line. The editor draws and edits paths in the picture, and its Check warns when a ship's route runs over land or a Floormaster's line leaves the floor; the same is available as MCP commands.

  • Mod SDK v3 and the editor: every placeable villager can walk a route (for mod makers). The Windfall villagers without a walk of their own (the old women, the young women and the large sailors) now walk their routes with another villager's walk, fitted to their own bodies when the game starts, from the player's own files. Feet stay on the ground at any walking speed. Full save states made with the editor before this update can't be loaded.

  • Keep game speed at 60 fps holds full speed on devices just under 60 fps (#254). With Keep game speed on, a device that draws a little under 60 fps (for example a phone at 57-58 fps) no longer runs the game slightly slow, and a short hitch no longer costs game time: the game skips exactly as many in-between frames as it needs, without waiting after a skip. A slow device that takes 20-25 ms per frame now shows a third to two thirds of its in-between frames instead of almost none, at full game speed. 30 fps, 120/240 fps and Keep game speed off are unchanged.

  • Mod SDK v3 and the editor: sea and dungeon enemies (for mod makers). The Kargaroc (flying or perched, without riders), the red Wizzrobe with its fireballs, the enemy warship (at sea only; its cannonballs hit only Link and his boat), groups of one to five Gyorgs (they appear once Link has the boomerang), the Floormaster (it grabs Link and lets go again, it never takes him away) and the Big Octo as a target whose eyes are shot out (no swallowing, no whirlpool) can be placed, each with the mod's own defeat flag, drops and defeat switch. Defeating them by a mod doesn't count toward the game's sea kills.

  • Fixed: things can now be placed on top of a mod's island (houses, signs, villagers, enemies and other world objects); the island no longer counts as "in the way". Objects only block each other where their shapes really overlap, so turned buildings next to each other are no longer refused. In the editor, clicking the open sea now places an island (or anything else) on the water surface.

  • Mod SDK v3 and the editor: more native enemies (for mod makers). Stalfos, Redead, Mothula (on the ground or winged), Morth, Magtail, Poe, Armos and Armos Knight can be placed, each with the mod's own defeat flag, drops and defeat switch, live in the editor. What holds Link (a Redead's scream and bite, a Poe's possession, clinging Morths) lets go when the enemy is removed, its room changes or a state is loaded. A placed Stalfos does not split in two under a spin attack, and a placed Mothula does not release Morths; place Morths next to it instead.

  • Animated mod models can have several materials too (for mod makers): up to 16 per model, each with its own texture, opaque or cut-out (for leaves, fences, hair) and optionally double-sided, with the same texture budget as static models. They work in scenes and demo steps, with save states and in the editor. An example walker is included.

  • Mod SDK v3 and the editor: demo steps, cutscenes played by the game's own cutscene system (for mod makers, preview). A scene can now play a demo: keyframed camera, actors flying or walking along curves (game characters, villagers the mod placed, the mod's own actors, and Link in his cutscene poses), messages that wait for A, sounds and effects, one actor carried on another's joint (for example the Helmaroc King carrying someone), and time of day and rain that come back afterwards. Characters a demo needs but the room lacks are created for it. Demos can be skipped, follow each other directly, and a choice between two demo steps picks which one plays. A time change in a demo never starts a new day. In the editor, a demo step's lanes appear on the Scenes timeline with keys, clips, messages and carry markers, a preview at the cursor and curve handles in the picture; the same is available as MCP commands. Nothing changes for players or mods that don't use demo steps.

  • Mod SDK v3 and the editor: more native enemies (for mod makers). Boko Babas, red and blue Bubbles, Fire Keese, Octoroks and Seahats can be placed, each with the mod's own defeat flag, drops and defeat switch. A Boko Baba bites but never grabs Link and leaves no flying head behind; a Seahat or Octorok defeated by a mod does not count toward the game's sea kills. (The game has no Ice Keese.)

  • Fixed: Link's boomerang, arrows and bombs now hit mod enemies. Thrown, fired and exploding ones were ignored before, also by the Bokoblins, Moblins, Peahats and ChuChus placed by mods.

  • Mod SDK v3 and the editor: island grounds (for mod makers). Six islands without their buildings can be placed as ground for a mod's own island: Crescent Moon, Triangle, Five-Star, Star, Bomb and a fairy island, in the editor's new Islands list. Each is made from your own game files the first time a mod uses it, has its own collision, shows on the horizon from the neighbouring squares, and the ship stops at its shore. Holes drop Link back to the room's start.

  • Mod collision: water to swim in, shallow water, waterfalls, ice and void surfaces, and a water material for ponds ("material": "water"). A pond placed above the room's height range is not found as water; the docs explain this.

  • Fixed: mod collision marked as metal hurt Link (it was read as a damage surface, e.g. on the buoy example). Full save states made before this update keep their objects; their old collision is used until the room is next loaded.

  • Mod SDK v3 and the editor: island parts (for mod makers). Smaller pieces of other islands can be placed like the island buildings: Dragon Roost's shrine, torii, walkways, rope posts and sea rocks, Windfall's windmill cap, and two Forsaken Fortress shipwrecks. They are made from your own game files the first time a mod uses them, have their own collision and take the light of the room they stand in. Island pieces now check the textures they are built from, so existing piece caches are rebuilt once.

  • Fixed: the mod actor heap diagnostic (WWHD_MOD_ACTOR_HEAPS) no longer crashes when a game heap isn't set up.

  • Mod SDK v3 and the editor: rat holes and patrolling Moblins (for mod makers). A rat hole lets out three rats (or bomb rats, or a mix) one after another while Link is near; each defeated rat gives the hole's drops, and the hole closes once all three are beaten (its defeat_switch is set then). A bomb rat's bomb only hurts Link and the mod's own enemies. Placed Moblins can patrol a route like Bokoblins.

  • Fixed: a mod enemy, prop, switch or door that the game refuses to create no longer stops the game later.

  • Island buildings and world objects: only real conflicts refuse a place now (doors, start points, villagers and their walks, chests, event triggers); pots, signs, rupees, message and hint areas and the sea's surface no longer count. In the editor a building can be placed anywhere: on a red spot it shows as an outline with what is in the way drawn in, and it appears in the game once dragged to a green spot.

  • Mod SDK v3 and the editor: the Darknut (for mod makers), plain, with a shield, with a helmet, or the Mighty Darknut with its cape. Its sword and cape stay its own and go with it, it writes no game switch, and its defeat can open a mod door (defeat_switch).

  • Mod models can have up to 16 materials (for mod makers), each with its own texture, so mod islands can mix sand, grass, rock and wood like the game's own islands; cut-out materials (glTF alpha clip) for leaves, fences and foliage cards, and double-sided faces lit correctly on both sides. New example world-objects-w5.

  • Fixed: island buildings in released builds. The release packages lacked the converter the island buildings need.

  • Quick-use locked items (Mods > Built-in, off by default; #196, thanks mhbxyz): while locked onto an enemy, one item-button press equips and uses the bow (including fire, ice and light arrows), boomerang, hookshot or grappling rope; bombs are readied and thrown, and equipping the hammer completes one strike. A Quick-use animation speed of 1x, 1.25x or 1.5x speeds up the supported equip animations.

  • Keep game speed now holds the game's speed at 60 fps when the graphics can't keep up (#178, e.g. Steam Deck): in-between frames that don't fit are skipped instead of slowing the game to 21–25 logic steps a second. The performance overlay's slow-motion warning now appears below 29 logic steps a second (was 26) and no longer flickers.

  • Mod SDK v3: more enemies and enemy switches (for mod makers). The Peahat and a black ChuChu can be placed; enemies can open doors through a mod switch once all of them are defeated (defeat_switch, also in the editor's Inspector); Bokoblins can patrol a route of the mod's own.

  • World objects: island protection now works on the sea (for mod makers). Placement used to read sea rooms at the wrong coordinates and protected nothing there, and dungeon rooms with a turned map were checked turned. World objects now keep clear of what the island needs (villagers and their routes, doors, chests, items, switches, cutscene areas and the places where Link arrives) by their real size instead of wide 100 m zones, and may stand over grass and trees. A world object that can't stand where it is placed is left out with a log line instead of stopping the game; the editor shows its footprint in red with the reasons.

  • Mod SDK v3 and the world editor: island buildings (for mod makers). Mods can place some of the islands' own buildings as "actor": "piece:": four Outset houses (their windows light up at night), Outset's lookout tower and well shelter, the Flight Control Platform, the Private Oasis cabana and Tingle's tower. They are made once from your own game files, lit by the island's light at every time of day and in all weather, and Link can walk on them; their doors lead nowhere. A building must keep clear of the island's villagers and their routes, chests, doors, items and cutscene areas (the editor shows what is in the way), and a room's buildings share 24 MiB. In the editor they are in the Game objects palette.

  • Performance report: it says whether Keep game speed is on (and at which interpolation rate), and the log records its value and where it came from at start and on every change.

  • Controller rumble no longer stops by mistake: the safety stop for a stalled game could switch off a rumble that had just been started. The game's list of villager names (for mod makers) is now kept in the mod manager's folder; it is built once more after the update.

  • Mod SDK v3: placed villagers can walk a route. Uo1, Uo2, Uo3, Um1 and Um2 walk up to 15 points with their own walk: once, in a loop or back and forth, at their own pace or yours, with optional strolling pauses. They still stop to look at Link and talk as usual, and a walker that runs into a wall or walks off an edge is caught. Your own models' routes can also go back and forth, pause now and then, and name their walk and idle clips.

  • World editor: a Route section in the Inspector for walking villagers and your skinned models. Add points at Link or the camera, drag them in the picture, reorder or remove them, and set speed, mode and pauses; the route shows in green, and stretches without walkable ground in red. New route commands for MCP clients.

  • Mods and the world editor can place the game's own objects by name (game:palm, trees, tables, shelves, lamps, plant pots, flowers, nests, the Rito and sea flags, the sea lookout tower, grass, flowers and small trees): they load from your own game files, never from the mod. In the editor: Add > Game objects, with Variant, Turn and Scale in the Inspector; list_game_objects over MCP.

  • Mod SDK v3: thirteen more Windfall villagers can be placed (residents uo1, uo3, ub1–ub4, uw1, uw2, um2, sa1–sa4); um3, sa5, ug1 and ug2 are refused with the reason.

  • Mod SDK v3: more enemies — red, blue and yellow ChuChus (parameters.variant), the Miniblin, and Bokoblins with a shield or a machete, each with the mod's defeat flag and drops. The editor picks a villager or an enemy variant from a list in Add and in the Inspector.

  • World editor: the Inspector no longer says an enemy's changes wait for a restart when they apply at once.

  • World editor: story changes while the game runs. Quests, quest talks (also those for the game's villagers), letters and charts change in the running game at the next calm moment, with every edit, Undo and Redo; an item's name, description, amount and use change at once. A new item, its icon, held model and hold_up, and removed charts still wait for a restart, and the status bar says which. The Quest Log is never touched: saves and save states always play with the current story, and the status bar says when a renumbered step moved a loaded quest.

  • World editor: New mod… starts a new, empty mod of your own from inside the editor (also new_mod over MCP): its own package, turned on in your mod profile and opened at once.

  • World editor: quest talks for the game's villagers. The game's own villagers show their names in the picture; click one to give it a quest talk in your mod, as a new quest, a new step or a step's talk (also list_villagers, pick_villager and add_villager_talk). The villager's own dialogue and save flags are never changed.

  • World editor: placing and dragging fixed. Clicks find the ground under the mouse again (piers, roofs and grass were missed or hit the sea floor); residents, enemies and props appear at once also in a mod that had no actors at start-up; a dragged enemy or resident now moves with the drag instead of staying at its old spot; and a resident's type is chosen in Add and in the Inspector.

  • Story mods: Bokoblins see Link. Bokoblins placed by a mod stood blind and never attacked; they now notice Link at the game's usual range and fight. (A save state with such a Bokoblin from before puts it aside.)

  • World editor: the docked panels react to the mouse again. Since the dockable panels arrived, the full-screen picture could sit in front of the docked panels, so they got no hover or clicks on any renderer; the picture now always stays behind them.

  • Android: handhelds with a fan keep 60 fps longer (#247). Their heat guard now pauses 60 fps at a thermal headroom of 1.00 instead of 0.90 (Relaxed: 1.10); the AYANEO EVO and KONKR Pocket FIT Elite ran 60 fps well around 0.90-0.96. Phones keep their limit.

  • World editor: native scene previews after loading a save state. A scene's native version now also plays in the preview after a save state was loaded or after a preview fell back to the scene's steps, and the editor says why when it can't restore the world after a preview.

  • Without mods and without --editor, the world editor and the Mod SDK v3 stay completely off. Nothing of theirs runs or reserves game memory then, so full save states made without mods by builds from before 17 October load again.

  • Story mods: more of a quest without code (for mod makers). Content packages may hold only letters, charts, items or quests; letters can wait for a quest or flag and a number of game days (when, after_days); characters and scenes can give a treasure chart; items with hold_up are held over Link's head when he gets them; placed chests can hold more rupees, a heart piece or container, or the mod's own items (with a "Chest holds" picker in the editor); and reset_quest also clears the quest's charts and items.

  • World editor: letters, treasure charts and items (--editor and its MCP tools, for mod makers). A new Story tab and commands create, change and remove letters on their own, treasure charts (with the X placed at Link or the camera) and items (with icon import). Removing something still in use is refused with the list of its uses.

  • Android: heat guard for handhelds with a fan (#247). AYANEO, KONKR, AYN and Retroid handhelds now keep 60 fps until they are much hotter than phones, and the new Settings → Graphics → Heat guard (Normal / Relaxed / Off) sets how early 60 fps pauses when the device gets hot. Phones keep their current limit by default.

  • Android: even frame pacing at 60 fps. A frame that is ready early now waits a few milliseconds, so each frame stays on screen equally long. With Record graphics on a second thread on, a third of the frames on a 120 Hz phone screen used to stay for one or three refreshes instead of two (a slight judder); now almost all stay for two. The game's speed is unchanged. On by default on Android.

  • World editor: scene editor, live actors and smooth dragging (--editor, for mod makers). A new Scenes window edits a scene's steps, takes camera keys from the fly camera, shows a timeline to scrub and retime, and sets choices, walking paths, triggers and the native version; scenes preview in the game with Skip and Stop. Pots, barrels, crates, switches, doors and enemies now appear and change live in the room, and dragging an actor moves it smoothly in place (one undo step). The editor and its MCP tools also cover the new quest forms: talks, flag and multi-quest conditions, finishing a quest and places inside buildings.

  • Mod SDK v3 preview: world objects (for mod makers). Mods can place solid scenery and walkable islands in the sea, with collision from the model and wood, sand or grass ground; objects that bob on the waves or drift and can be ridden; surfaces Link can climb, hookshot and grapple; islands that are visible from neighbouring sea squares, get a ring on the sea chart and an arrival notice; and animated coast foam that uses the game's own foam look.

  • GamePad picture-in-picture: simpler settings (#221). Settings → Display → Picture-in-picture now has one slider each for size (5–100 %) and opacity (10–100 %). Dragging the picture places it freely, and clicking one of the nine circles in the diagram snaps it to that spot.

  • Mod quests: finishing, flags and places inside buildings (for mod makers). A character's dialogue or a scene's end can now finish a quest (the reward is given once), characters and quest steps can react to the mod's own flags or to several quests at once, a character can offer step-specific conversations, and a quest step can point into a building, cave or dungeon (the notebook shows where, and the sea chart marks the island).

  • Graphics: toon clouds, horizon haze and cloud shadows (Settings → Graphics → Effects, all optional). Cloud style adds Toon clouds (Lite / High): puffy, cel-shaded clouds that follow the game's own clouds, weather and time of day (Original stays the default; Lite is the lighter one for weaker devices). Horizon haze (100 % = original) gives a clearer, deeper blue sky when lowered together with Bloom strength. Cloud shadows (off by default) let the drifting clouds cast soft shadows on the sea, islands and characters. Stereo 3D keeps the original clouds for now.

  • Mod SDK v3 preview: native scenes (for mod makers). A scene can include an optional native turn_camera version that the game's own event system plays: two residents turning toward each other and a camera move. It can be skipped with Plus and survives save states, and the scene's normal steps play whenever the native version can't run.

  • Android/Vulkan: texture decoder self-test. Phones that decode compressed (BC) textures in a compute shader now check that decoder at start-up and switch to the CPU decoder if the graphics driver gets it wrong (Qualcomm's driver 762 miscompiled it, leaving speckled edges on the HUD hearts and streaks on water when that path was used). One rare case in signed BC4/BC5 textures also decodes correctly now.

  • Mouse camera: smooth while sailing (#237). Turning the camera with the mouse on the boat (sailing, paddling, salvage) now follows the mouse directly at the same sensitivity as on foot, instead of turning in jerky steps.

  • Settings dialogs and phone text size. Every dialog in Settings now has a close button in its title bar and also closes with a tap outside it, Esc, B or Back; long dialogs such as Gyro aiming keep Close on screen. On phones, Settings uses smaller text so more fits at once, while buttons stay at least 7 mm tall to tap. Tablets, handhelds and PCs look as before, and the UI size setting still wins.

  • Android: code mods (such as the story quests). Turn on Code mods in the setup app (or Settings → Mods): your device builds the game again with mod support, and builds each code mod itself the first time it's used. Uses the compiler and Python the setup already has; the download grows by only a few KB.

  • Record graphics on a second thread (Graphics → Advanced, off by default). The render thread hands recording and submitting the Vulkan commands to a second CPU thread. On a Xiaomi 14 it makes typical frames a little faster (about 20% less render-thread time) but adds short hitches (the slowest 1% of frames about 3 ms slower), so it stays opt-in everywhere for now. Steam Deck owners: please try it on and off in the same spot and tell us the fps, the 1% lows and whether the Deck runs warmer.

  • Shader cache saved more often: pipelines built while playing are now saved every few minutes and when the Android app goes to the background, so fewer are rebuilt after a crash or after Android closes the game.

  • World editor (preview, for mod makers): start the game with --editor for a dedicated editor mode: after the title screen and file select it opens a free camera with its own panels (toolbar, outliner, inspector, problems & export, log). Place new actors by clicking into the picture, move and turn them with handles (grid and angle snapping), import .glb models with clear limit checks, write dialogue with a live preview in the game's message box and choose what happens after it, change everything with undo/redo, warp to any island, room or quest place, check the package with a clickable problem list and export it. Play / Stop lets you test as Link in a test mode that never touches your real save, and Stop puts the world back. New enemies, pots, switches and doors appear after a restart. Saving writes only your mod's own package. See docs/mod-editor.md.

  • World editor: Claude and other MCP clients (for mod makers). In --editor mode, Settings → Editor → Claude / MCP access lets Claude Code (or another MCP client) use the editor's commands: place and change actors, write dialogue, warp, take screenshots and check the package. It is off at every start, only reachable from your own computer with a new token each session, and removing, replacing or exporting asks you to Allow in the game first. See docs/mod-editor.md.

  • World editor: visual quest editor (for mod makers). Build a quest as a graph: steps are nodes, and dragging from one step to the next chooses who moves the quest on; branches, unreachable steps and other problems show on the nodes. Start at this step jumps straight into a test of any step (test mode, only your mod's own progress is set), the quest step and your mod's flags show live while you play, and you can search, select several actors and copy/paste actors and steps, also into another room.

  • World editor: live handles, docking panels, Esc (for mod makers). Dragging a move or turn handle now moves the actor (or the whole selection) live in the game, still as one Undo step. The editor's panels dock to the screen edges and into each other as tabs, with a default layout and Reset layout. While placing, dragging or connecting quest steps, the first Esc cancels that; Esc with nothing to cancel opens Settings.

  • Mod SDK v3 preview: enemies, props, switches and effects (for mod makers). Mods can now place the game's own residents, breakable props, switches and doors, and enemies with their own state; original mod enemies take damage, react to hits, can be targeted, defeated and drop items; mod props can be carried and thrown, and original item models can sit in Link's hand; plus a curated set of the game's particle effects, simple mod effects and custom textures on placed props. New original example: a patrolling enemy.

  • Android two-screen handhelds: with GamePad screen set to Off, the game no longer takes the lower screen for a moment when it starts (#222).

  • PowerVR phones (e.g. Pixel 10): no more stretched spikes (#207). On PowerVR GPUs the game now converts vertex data on the CPU automatically, because their drivers decode some of it wrongly in the shader. Only the one kind of data they get wrong is converted (found with a tester's help), so it costs much less speed than converting all of it; Graphics → Advanced → Convert vertices on the CPU switches it off (Automatic restores it).

  • Shortcuts: remapping works, Esc opens Settings (#220). Remapped shortcuts take effect again (the Controls tab was catching the input first). Every binding clears the same way in Controls and Shortcuts (right-click, or Delete / Backspace / X on a focused binding); extra controller buttons (Capture/Share, rear paddles, touchpad click) can be bound; Home is listed under Settings. Esc now opens Settings (with a captured mouse the first Esc frees it), F1 keeps working for now, and on macOS Cmd+, still opens Settings from the app menu.

  • Steam Deck Gaming Mode: sharp picture by default (#214). In Gaming Mode the game now starts in full screen with the GamePad picture as picture-in-picture, because Gaming Mode shows one window at a time and a separate GamePad window made the picture blurry. Also with the Windows build through Proton. Your own saved choices and launch options still win; the old launch-option workaround is no longer needed.

  • Sploosh Kaboom: no more doubled hit and miss markers at higher frame rates (#179). The board's markers are moved between cells once per game step; the in-between frames no longer blend a marker from its old cell to its new one.

  • Option to turn off the letterbox bars while targeting (#114). Settings → Mods → Built-in → Camera → Letterbox while targeting (on by default). Switched off, normal Z-targeting no longer shows the black bars; cutscenes, scripted cameras, minigames and item aiming keep theirs.

  • Run/swim speed: boost bar options and "Roll, then hold A" (#233). New Show boost bar switch; with Boost time set to no limit the bar no longer appears; the boost bar and the climbing stamina wheel now hide while menus, cutscenes and conversations are on screen. New boost button Roll, then hold A: roll while running and keep A held to boost until you let go (on land).

  • Android: big update for phones and handhelds (most ideas from GreenNaugahyde's Android fork):

    • Fewer stutters after Android closes the game: the shader cache is now also saved every few minutes and when the app goes to the background, so the next start doesn't rebuild what you already had (desktop benefits after a crash too).
    • Display refresh rate: the game asks Android for the rate it draws (60, or 120 with 120 fps interpolation). Some phones (for example Xiaomi with HyperOS) still limit games to 60 Hz on their own.
    • If the graphics driver crashes, the game offers another driver on the next start; crash reports now also cover times Android closed the game itself, and include more detail.
    • Older Qualcomm (Adreno) drivers: shader pipelines are built one at a time there, which avoids crashes on those drivers.
    • Less memory: shaders keep less data after compiling, and save states are written and read in small pieces instead of all at once (all platforms).
    • Gyro with the phone's own sensors: Controls → Gyro… → Source: Device gyro.
    • Phone vibration follows the game's rumble while you use touch controls (Settings → Controls → Phone vibration: Off, Touch only, or also when no rumble controller is connected).
    • Touch layout editor: hold the on-screen controller button to move and resize the touch controls.
  • Save states: Last session and auto saves (all platforms). A Last session state is kept when you quit (on Android also when the app goes to the background); At start → Continue last session in the Saves tab picks up right where you left off. Auto save every 2, 5 or 10 minutes (off by default) into three rotating slots. These are save states, separate from the game's own save file (#234).

  • New built-in mods (Settings → Mods → Built-in, off by default): Faster ivy climbing, Faster ledge hanging, and Jump anywhere (L by default, optional double jump). Cheats gain infinite rupees, infinite bait and spoils, infinite swimming and "Fill the bags".

    Please help test these: we've checked the basics on our own phone, but these need real players and other devices. If something doesn't work, open an issue with your device and the log (Settings → Graphics → Bug reports → Share log on Android):

    • auto saves and Continue last session after quitting or switching apps;
    • Device gyro aiming and Phone vibration;
    • the touch layout editor;
    • Jump anywhere, faster climbing/ledge hanging and the new cheats;
    • phones with older Adreno or other GPUs, and whether 120 fps reaches your display.
  • True 60: no more crash at Orca's sword training (#223). Talking to Orca and choosing "yes" stopped the game in True 60 mode; event commands now only run on full game steps.

  • GamePad sounds through the main speakers (#218). Sounds the Wii U plays only on the GamePad's own speaker (switching items, saving and other GamePad menu sounds) are now heard during TV play too. Settings → Audio has the switch (on by default) and its own volume; sounds already on the TV aren't doubled, and Off-TV Play is unchanged.

  • Linux AppImage: code mods work again (#230). Turning on a code mod such as the story quests failed with "Guest mod build tools are missing". Setups made with an earlier start of the AppImage are repaired automatically, without running setup again.

  • Settings: Quit Game (#231). A button at the bottom right of every Settings tab, with a confirmation (Cancel is preselected), so you can quit with just a controller, e.g. on a Steam Deck in Gaming Mode or an Android handheld. On Android the game also leaves the recent apps list.

  • Graphics → Advanced, diagnostic options for broken 3D geometry (e.g. PowerVR GPUs, #207): "Convert vertices on the CPU", "Full precision in shaders" and "No vertex reuse", each off by default and applied after a restart. They help us find the cause on GPUs we can't test ourselves; the first one is slow and only meant for testing.

  • Mod SDK v3 preview: animated characters and scenes. Mods can add animated characters (a rigged glTF model with idle, walk, talk and extra clips) that look at Link, walk paths or to quest places, block Link and react to sword hits; mod code can drive them through a small C API. Scenes gain eased camera paths, follow shots, music, and the game's choice box with branches. Two original examples: a tide sprite on Windfall and a wandering creature (preview, for mod makers).

  • Mod SDK v3 preview: static mod models. A quest mod can now place its own static model (a glTF .glb from Blender) in the world, lit and shadowed like the game's objects, with collision, L-targeting and a Check/Talk prompt. The model is converted on your own machine using a material from your own game, so packages never contain game files. The Windfall example gained an original carved post (preview, for mod makers).

  • Android handhelds (thanks to almost-drowned-rat):

    • Full screen now hides the system bars on Android 11 and newer too, so they no longer cover the top and bottom of the picture (based on GreenNaugahyde's Android fork; #212, #225).
    • The app's files folder (saves, settings, mods) appears in the system Files app and file picker; the prepared game and shader caches are read-only there and console keys are never shown (#213, #226).
    • The system Back button or gesture opens and closes Settings, like F1 on desktop (#215, #227).
  • Render-thread fast path (Vulkan): a draw reuses the previous draw's prepared state when only pointers or arithmetic values change, about 6–9% less render-thread CPU in tests (most on devices where the render thread limits the frame rate, like the Steam Deck), with identical pictures. On by default; WWHD_VK_FASTPATH=0 turns it off if you see wrong textures or blending, and please report it (#178).

  • Android two-screen handhelds: GamePad screen Off frees the lower screen (#222). With the GamePad screen switched off, the lower screen is released to the launcher and other apps (e.g. a video on an AYN Thor); switching it back on takes it again with picture and touch.

  • Mods on Windows: a mod's preparation tool can now load its own helper files there too (the port's Python on Windows didn't look next to the tool). This stopped the GC minimap from installing on Windows; gc-minimap 0.2.2 also fixes it on its own for v0.3.0 (#224).

  • Settings → Shortcuts: remap the app's shortcuts (Settings, full screen, screenshot, save and load states, the graphics toggles), each with a key, a second key and a controller combination such as Select + D-pad Up. New actions (GamePad picture-in-picture, performance overlay, mute, volume) start unbound, and F6 now loads state slot 1. The defaults stay as they were (#220).

  • macOS setup: when macOS points to another developer folder than the installed Command Line Tools (a removed Xcode, or one whose license hasn't been accepted), setup now uses the installed tools directly instead of waiting forever, and says what to do if they still can't be used (#219).

  • Android, two screens (AYN Thor and similar): choosing GamePad screen Off (or hiding it) while the second screen is connected now turns that screen black and ignores its touches while the game plays on the main screen; the choice is remembered. Without that choice the second screen shows the GamePad as before (#222).

  • GamePad picture-in-picture placement: nine positions (corners, edge centres, centre) plus a custom one, exact size (10–50%) and opacity (20–100%), and a small screen diagram in Settings → Display where you tap or drag the GamePad picture into place; while that section is open the game shows a live, draggable preview. The default bottom-right position now sits above the rupee counter instead of covering it (#221).

  • Mod SDK v3 preview (opt-in, for mod makers): mods can place a small set of the game's own actors (chests, signs, a Windfall resident) with talk actions, and play short scenes: camera shots, dialogue, fades and the game's letterbox bars, skippable with Plus/Start. Placed chests and signs keep their state in the mod's own part of the save. Nothing changes without such a mod. See docs/mod-sdk-v3.md and the sdk-v3-windfall example.

  • Android: "Share log" in the setup app and in Graphics → Bug reports: it shares the latest game logs through Android's share sheet, with your user paths removed (as in crash reports). Android now writes a log by default (at most 64 MB per run), so there is one to share after a problem. The log also lists more about the GPU (driver, vertex formats, limits), and Graphics → Advanced has Force RGB vertex fallback for testing GPUs like PowerVR (#207).

  • Intel graphics on Windows: drivers older than 101.5000 now use the classic render-pass mode automatically, which fixes the crash at start on driver 101.3111 (Iris Xe) without setting anything (#204).

Réagir sur le forum

Une question, un retour d’expérience ? Ouvrez la discussion sur le forum.

Réagir sur le forum