Zenonia HLE

Zenonia HLE is a community fork of touchHLE focused on preserving and running the original 32-bit iOS release of Zenonia 3 on modern hardware.

The first public release targets macOS. It contains the emulator and our Zenonia-specific compatibility work, but does not contain Zenonia 3, an IPA, game assets, saves, or Apple signing material. You must supply a legitimately obtained, decrypted copy of the game from your own library or device.

Early project: standard graphics is the recommended setting. Compatibility and performance are still being improved, and a save made by an original copy should always be backed up before testing.

Download and play on a Mac

1. Open the repository's Releases page and download the ZIP for your Mac: arm64 for Apple silicon or x86_64 for an Intel Mac.

2. Open the ZIP and drag Zenonia HLE to Applications.

3. If macOS blocks the first launch, Control-click the app, choose Open, and confirm once. The community build is ad-hoc signed, not Apple-notarized.

4. Put your decrypted Zenonia 3 .ipa in:

   ~/Library/Application Support/touchhle.org/touchHLE/touchHLE_apps/
   

5. Launch Zenonia HLE and select Zenonia 3.

Read the full Mac quick-start guide if the game does not appear or launch.

Guides

• Mac quick start — install, add your game, launch, and find saves.
• Supplying your own game — what kind of IPA is required and what this project cannot distribute.
• What we changed in touchHLE — compatibility, rendering, input, CPU, and performance work.
• Build from source — make a reproducible Mac build.
• Troubleshooting — common macOS, IPA, graphics, audio, and save problems.
• Compatibility status — what has actually been verified and what remains experimental.

Why a touchHLE fork?

Zenonia 3 depends on behavior from early iPhone OS that was not yet fully represented by upstream touchHLE. This fork adds the missing compatibility surface and a deliberately conservative rendering path for Zenonia. It also keeps the technical work inspectable and reproducible instead of distributing a modified game.

The most important changes include:

• missing Foundation, Core Foundation, UIKit, OpenGL ES, audio, networking, and filesystem behavior needed by the game;
• Zenonia-specific landscape and touch-coordinate handling;
• a stable Core Animation composition path for menus and gameplay;
• portable ARM execution work and guarded hot paths used by the modern-iOS experiment;
• diagnostics for guest FPS, input, transitions, and compatibility failures.

See What we changed for the detailed tour.

Project boundaries

• This repository is not affiliated with Com2uS, GAMEVIL, Apple, or the upstream touchHLE project.
• Zenonia and its assets are trademarks/copyrights of their respective owners.
• Do not open an issue asking for an IPA, download link, save file, signing certificate, or copyrighted game data.
• Mac support is the public release target today. The iPhone host remains experimental development work and is not part of this release.
• A launch is not proof of a complete playthrough. Please report the exact area, graphics mode, Mac model, macOS version, and log when filing a bug.

Contributing

Bug reports and focused compatibility changes are welcome. Please read CONTRIBUTING.md and include reproduction details without uploading the game or private device data.

Zenonia HLE retains touchHLE's commit history and source attribution. The project is distributed under the Mozilla Public License 2.0, with third-party components under their own included licenses.