IshaanKalra2103 / BotWRecomp

# BotW Recompiled (unofficial)
A native port of **The Legend of Zelda: Breath of the Wild (Wii U)** to iPhone and Apple Silicon
Macs. The game's PowerPC code (`U-King.rpx`) is statically recompiled to C++ and runs on a Cafe OS
runtime written for this port, with Cemu's Latte GPU layer drawing through Metal. There is no
emulator and no JIT, so it runs as an ordinary signed iOS app.
> [!IMPORTANT]
> This repository contains no game files and no game code. You need your own copy of the Wii U game.
> The build recompiles *your* copy on *your* Mac, and you install the result on your own iPhone.
> There is no download-and-play IPA, and there never will be one: it would contain Nintendo's code.
## Status
**iPhone (main target).** Tested on one iPhone 16 Pro (A18 Pro, 8 GB), signed with a free Apple ID.
The game boots and plays with on-screen touch controls. The GPU ran at mostly 35-60 fps in the open
world, using about 2.4 GB of memory. On the one long run so far, the game hung after about 4 minutes
of play (the cause is not known yet), so expect that. Nothing else has been tested: no other iPhone,
no iPad.
**Mac.** Plays with keyboard or a controller (DualSense, with gyro aiming). On an M1 Pro: 60 fps in
menus, 24-35 fps in the open world at the default render scale (about 2.4x).
Known gaps: the iPhone hang above; the app keeps sending GPU work when it goes to the background;
shaders compile on first use, so the first run hitches; DLC is untested. Details for iOS are in
`ios/PORTING.md`.
## What you need
- **A Mac with Apple Silicon** to build, even for the iPhone. Xcode (from the App Store, with the
 iOS platform installed) and Homebrew.
- **An iPhone on iOS 18 or later**, A14 chip or newer. Only an 8 GB iPhone 16 Pro has been tested;
 phones with less memory will probably run out of it. A free Apple ID is enough to sign the app.
- **The game, as files**: Breath of the Wild for Wii U, **USA, with update 1.6.0 (v208)**, as a
 folder containing `code/`, `content/` and `meta/`. The recompiler and the game patches are made
 for that exact executable. Check yours:
 [code] 
### Getting the game files
Dump the game and its update from your own Wii U (for example with
Dumpling). Then copy the update's `code/`, `content/` and
`meta/` folders over the base game's, replacing files, so that one folder holds the updated game.
If you have a `.wud` or `.wux` disc image and its disc key instead, `tools/wud_extract.py` unpacks
the base game. It needs the Wii U common key, which is not included here. Pass it in
`WIIU_COMMON_KEY`, either as hex or as a file:
 [code] 
You still need the v208 update from your console on top of that.
The scripts look for the game in a folder named `game` next to this repository. If yours is
elsewhere, set `BOTW_GAME=/path/to/game`.
## Build for iPhone
 [code] 
2. Sign in to Xcode with your Apple ID (Xcode > Settings > Accounts). Connect the iPhone by USB,
 unlock it and tap Trust. If Developer Mode is off, turn it on under Settings > Priva