chrissotraidis/bluewake v0.5.0

BlueWake 0.5.0

on GitHub

BlueWake 0.5.0 is for Windows, Mac, iPhone and iPad. On Windows, it's the first build made from BlueWake's own code, and it replaces the Wind Waker Recomp 0.4.0 build. Every version needs your own USA (GZLE01) disc image. Nothing from the game is included.

Install

Windows: download BlueWake-v0.5.0-windows-x64.zip, unpack the whole folder and run BlueWake.exe. Then choose your disc image (.iso or .gcm). To use a Dolphin .rvz, convert it to ISO in Dolphin first: right-click the game and choose Convert File. You need Windows 10 or 11, a Direct3D 12 GPU, and a CPU with AVX2 (Intel Haswell from 2013, AMD Ryzen, or newer). Your saves in %APPDATA%\BlueWake carry over from 0.4.0. For a portable install, put an empty portable.txt next to BlueWake.exe, and saves, settings and logs stay in a user folder beside it.

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

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

What's new on Windows, compared with 0.4.0

• Choosing "Exact" sound no longer crashes the game (#58). If a launch ever does crash, the next one starts safely with the mods off, keeps a copy of your settings, and tells you what happened.
• Molgera's arena in the Wind Temple has its sand floor again (#126).
• On a processor without AVX2, BlueWake now shows a message instead of closing without a word (#77).
• Portable mode with portable.txt (#64).
• You can change which keyboard key and which mouse button presses each GameCube button (F1 › Controls). For example, right-click can be B.
• Controller button remapping (#66), plus Swap A and B and Swap X and Y for Nintendo-style layouts (#55).
• Controllers SDL doesn't recognize (#61): put gamecontrollerdb.txt from SDL_GameControllerDB in the folder with your saves.
• The camera no longer flips direction in water (#73), and the controller's camera invert setting works everywhere.
• "Quit the game" is in the F1 menu, and Brisk Sail, Unrestricted boat and Invert camera now explain what they do.
• Settings no longer reset themselves when the game starts.
• Taking a Pictobox photo no longer freezes the picture (#13).
• Smooth Motion (in-between frames) is off by default (#79). Press F10 to turn it on. 0.4.0's experimental 60 FPS game logic is gone.
• Jump and Run are off by default (#71). Turn them on under F1 › Mods.
• Elliott's work since 0.4.0: HD texture packs without shimmer, the Wind Waker HD texture importer, Forest Water options, and steadier Smooth Motion.
• The first-launch disc prompt explains how to convert an .rvz.

What's new on Mac, iPhone and iPad, compared with 0.2.0

• Molgera's sand floor in the Wind Temple (#126), on every platform.
• Mac: change which keyboard key and mouse button presses each GameCube button. Controller button remapping (#66), and gamecontrollerdb.txt support (#61).
• Mac: the camera invert setting also applies when the game's own camera has the view (#73). Jump and sprint are off by default.
• PadMint and the builder work with the Python that comes with macOS. Builds used to fail with a write_text() error.

How it was checked

Windows was built from this release's commit and checked on one PC, a Ryzen 7 5700U with integrated Radeon graphics. Checked there: the game runs, the intro plays all its sound, Exact sound starts, crash recovery, the AVX2 message, portable mode, keyboard remapping and the Molgera floor. Not tried on Windows yet: mouse-button remapping, the Quit button and option notes, the camera invert, and controllers. Other GPUs and long play sessions also aren't covered yet.

On the Mac, the Molgera floor and keyboard and mouse remapping were checked in the game. The iPhone and iPad app starts in the iOS Simulator, but it hasn't been run on a device with this release.

Known problems

• Dungeon maps show the room markers but not the map itself (#74). The cause is known, and the fix is next.
• Some cutscenes lose their music or sound on Windows (#65, #97), for example when Aryll is taken on the bridge. Reports link it to mods, HD textures or the mouse camera.
• Slow scenes: the bird scene at the start (#59), and busy places like Outset and the open sea on some PCs (#86).
• In portable mode, imgui.ini is still written to %APPDATA%\BlueWake (#64).
• The pirate ship's flag may still lack its texture (#69).
• The Tingle Tuner isn't supported: it needs a Game Boy Advance linked to the GameCube. Better Wind Waker's "Tingle Chests without the Tingle Tuner" option, on by default, opens the chests with ordinary bombs.

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

Files

• BlueWake-v0.5.0-windows-x64.zip: the Windows build. It contains code translated from the game, so it needs your own disc image to play.
• BlueWake-v0.5.0-source.zip: the source for that build.
• BlueWake-v0.5.0-ios-unsigned.ipa: the iPhone and iPad app without game code, for PadMint.
• BlueWake-v0.5.0-padmint.json: the recipe PadMint follows for this version.
• SHA256SUMS: checksums for all of the above.