HookLink v3.0.1 fixes area transition crashes on iPhone

HookLink releases a hotfix for crashes after area changes when running The Legend of Zelda: Ocarina of Time on iPhone.

Switch → iOS · Recompilation

olya_nro19 Nov 2026, 23:47· awesome-decomp

HookLink is a Mac app that turns your own dump of The Legend of Zelda: Ocarina of Time (Switch 2 Edition) into an iPhone app using nxnative, which translates the code and graphics to Metal. Version v3.0.1 (listed in the release notes as HookLink X2.0.1) fixes crashes after area changes on some iPhones, where brief flicker preceded the app closing. The project remains experimental and requires your own copy of the game.

Two X2 changes are out of the defaults: GPU occlusion is off by default, and a memory change from nxnative that freed textures when freeing a memory pool is taken back out until safely merged with HookLink’s memory handling. GPU occlusion remains under Settings -> Performance marked experimental, while the texture memory change was pulled rather than kept as a setting.

How to update

  1. Click the engine update in HookLink and build again on your Mac.
  2. Install the updated IPA over your current app using your sideloading tool.
  3. Recompiling shaders is skipped on rebuilds, so the update takes minutes.
Sources: github.com