A native iPhone and iPad port of Halo: Combat Evolved. It runs the recovered Xbox engine from OpenCE (formerly Halo CE Universal) inside a native iOS app, with touch and controller support, cross-play multiplayer with OpenCE players, and a full in-app Settings menu.
One branch. The regular app, Mod Test, and the Non-Jailbreak build are options on Actions → Halo CE iOS — Build IPA. There is no separate Mod Test branch.
Status: playable. The regular app is playable on jailbroken devices, and the separate Non-Jailbreak build remains in beta (see device test results). The current source update is M2.6.124, on OpenCE build 387 (network version 44). This larger upstream jump needs CI, a Mac build and device validation before an IPA release. See the release notes and project status.
Jailbroken devices: the regular app is confirmed working on jailbroken iOS devices.
Non-jailbroken devices: the Non-Jailbreak Version (Beta) (a separate option in Actions → Halo CE iOS — Build IPA) is confirmed working on one stock iPhone, an iPhone 14 Plus on iOS 16.2, sideloaded with Sideloadly using a normal account and no memory entitlements. It has been tested on that one device only and is a beta: expect glitches, bugs and occasional crashes. It is not yet broadly tested or officially supported.
Free-account sideloading (Sideloadly, AltStore, SideStore): works on the tested device with the Non-Jailbreak Version. It needs the phone to be able to reserve one contiguous 4 GiB span of address space, and an iPhone 14 Plus on iOS 16.2 can do that only at a non-4-GiB-aligned address, which this build handles. An older iPad cannot reserve 4 GiB contiguously at all and is outside this design. Other iPhones are untested. See Install.
Paid Apple Developer accounts: people who have one may be able to sign the regular app with the
extended-virtual-addressingandincreased-memory-limitcapabilities and get it to start on a non-jailbroken device. We have not tested this, and the project does not require or build around paid accounts. See Install.
New: M2.6.108 adds the voice chat microphone (Settings > Audio > Voice Chat > OPEN MIC) and works with AirPods and other headsets with a microphone.
Fix: M2.6.107 repairs M2.6.104-106: a startup failure (guest ABI mismatch, fixed in M2.6.106) and a freeze when joining an internet game. Do not use those builds.
Update: M2.6.124 integrates OpenCE build 387 (network version 44). The larger MCC and multiplayer changes need CI, a manual Mac build and device validation. MCC package loading/sharing and Steam Workshop downloads are unavailable on iOS in this source update.
Prior: M2.6.123 moves to OpenCE build 335 (network version 41) with upstream renderer, input, multiplayer and server-browser changes; older network-38 builds cannot cross-play. Mac and device validation are pending.
Prior: M2.6.122 moves to OpenCE build 268 (network version 38), adding OpenCE gametype names to game listings and a per-player shield-effects option. Network-36 clients cannot cross-play with this build. M2.6.121 brought SWAT, Infection, Gun Game, Hardcore and Custom Edition HUD/texture work. M2.6.120 added the iOS Developer Console and mod-toggle synchronization. M2.6.119 brought build 246 and increased the memory window and texture cache. M2.6.118 integrated OpenCE build 244 / network 32 with the map-aware Custom Edition pickers. M2.6.117 added map-aware weapon and vehicle pickers; M2.6.116 added map-load recovery.
Previous: M2.6.113 moves to OpenCE build 220 (same network version 29) and makes Settings > Mods the same list as the game's new Mods menu: mods turned on or off, reordered, removed or added in either place show in both.
Earlier: M2.6.112 adds Settings search, a Talk / Mute button on the touch controls, the voice chat microphone off by default and in sync with the game, a profile picker, emoji and photo Settings icons with favorites, and clearer Mods filters.
Update: M2.6.110 moves to OpenCE build 211 (same network version 29) and turns map sharing off by default on iOS, with a switch in Settings > Multiplayer. Not yet run on a device.
Source update: M2.6.109 moves to OpenCE build 206 / network 29: a new network version (it cannot join build 201 or older hosts, nor they it). Custom Edition maps keep their own names (build 201 renamed them with a hash), map downloads are checked, and the changes are described in the update note. Not yet run on a device.
Source update: M2.6.105 moves to OpenCE build 201 / network 28: a new network version (it cannot join build 182 or older hosts), Custom Edition map sharing between players, shield glow and armor colors, first-person legs, and a web build that iOS does not use. M2.6.104 moved to OpenCE build 182 / network 25: a new network version (it cannot join build 154-167 hosts), Video Setup split into Graphics and FOV and Viewmodels screens, a viewmodel on/off switch, an elevator netcode fix and Android's on-screen controls (not used on iOS). M2.6.103 moved to OpenCE build 167 / network 24: netcode and sound-lifecycle fixes, correct transparent-surface ordering, a vote-kick switch on Server Setup and finer mouse-sensitivity steps. M2.6.102 brought OpenCE build 159 (voice chat with the Opus codec and player vote-kick); on iOS you can hear other players' voices, but the iPhone has no microphone path yet, so it cannot talk. M2.6.101 fixed the next Non-Jailbreak device crash (a frame-pointer chain walk in the HUD stack check) and records the Regular log after M2.6.100, which held about 60 FPS in gameplay. M2.6.100 was a Regular/Mod Test performance pass. A device log showed 16.2 million signal-bridge faults, 99.7% from the audio ADPCM decode loop, which reads guest memory through x30 (LLVM reuses the link register as a normal register). The aligned converter now translates x30 like any other base register, so those loads no longer fault. The Non-Jailbreak converter shares the same x30 handling from M2.6.99. Windows, Linux and Android stay on OpenCE.

Main menu on iPhone — Xbox UI controls

Main menu on iPhone — PlayStation UI controls
- Native app. An
arm64iOS app hosts the recoveredarm64_32engine and draws with OpenGL ES 3. iOS and iPadOS 15 or later. - Touch controls. Five named control schemes (Xbox and PlayStation styles), a drag-to-edit layout, touch look, floating sticks, left-handed layout, toggle crouch and zoom, gyro aiming and optional touch-aiming helpers. Controls guide
- Controller support. Xbox, PlayStation and other controllers supported by Apple's GameController framework, with stick tuning and button remapping.
- Multiplayer. Crossplay with compatible OpenCE clients on other platforms: invite links, an invite file in iCloud Drive or the app's folder, a QR code, recent games, LAN games, and the public Server Browser, Direct Link and Create Game screens. Multiplayer guide
- Display. 30 FPS original, a 60 FPS target or uncapped; 4:3, widescreen or fullscreen; four render-resolution choices; a live HUD editor; first-person view options; AirPlay mirroring. Display / AirPlay, Settings reference
- Sound. Native audio with separate Master, Music, Dialogue, Effects and Ambient volumes.
- Campaign tools. An optional, campaign-only Cheats menu organised into sections (survival, weapons, power-ups, movement, world, visuals, checkpoints, teleport, spawn), with a saved cheat recipe for each control scheme.
- Backups and data management. Separate Xbox and Custom Edition map libraries, optional user-supplied MP4 movie fallback, versioned backups you can export to Files or iCloud Drive, profile export and import, and diagnostics with a one-tap problem report. Backups
Prefer a visual walkthrough? Watch the iPhone setup video to see the IPA installed, a backup restored and Custom Edition maps loaded.
- Get the app. Download
HaloCE.ipaorHaloCE-NonJailbreak.ipafrom the M2.6.118 beta release, or get an IPA from a successful Actions run. You can also build it yourself. - Install it. The IPA must be re-signed and sideloaded onto your device. Install guide
- Add your game data. The app does not include game maps. Import the Xbox
.mapfiles from your own copy of the game, includingui.map. Game data guide - Play. Open Halo CE, import your maps and start the game. Open the gear button at any time for Settings.
| Halo CE (regular) | Halo CE Non-Jailbreak (Beta) | Halo CE Mod Test | |
|---|---|---|---|
| Purpose | The regular app, for jailbroken devices and TrollStore | For stock, sideloaded iPhones that are not jailbroken. Beta: expect glitches, bugs and crashes | A separate experiment that loads very large converted campaign maps |
| How to build | Actions → Build IPA, options off | Same workflow, tick Non-Jailbreak | Same workflow, tick Mod Test |
| Output | HaloCE.ipa (artifact HaloCE-iOS) |
HaloCE-NonJailbreak.ipa (artifact HaloCE-iOS-NonJailbreak) |
HaloCE.ipa (artifact HaloCE-iOS-ModTest) |
| Bundle ID | com.haloceuniversal.ios.m0 |
com.haloceuniversal.ios.m0 (same as the regular app) |
com.haloceuniversal.ios.modtest |
| Invite scheme | halo:// |
halo:// |
halomodtest:// |
The three apps share the same features and are kept up to date together. The regular and Non-Jailbreak apps use the same bundle ID, so install one or the other. Mod Test installs side by side with either and keeps separate data. See Mod Test for what makes the third app different, and Install for the Non-Jailbreak app.
Open an issue and fill in the form. On the title screen tap Logs to get the problem report, and paste it or attach it. Please include your iPhone model, iOS version, the app version (Settings > About) and which app you use. Issues are public, so do not post anything private. The Non-Jailbreak build is a beta, so crash reports from it are especially useful.
| Guide | What it covers |
|---|---|
| Install | Requirements, getting the IPA, sideloading, first launch, updating |
| Build the IPA | Building with GitHub Actions or on a Mac, build options, publishing a release |
| Game data | Importing maps, extracting maps from an Xbox ISO or XISO, where files live |
| Backups | What a backup contains, exporting, restoring, recovery |
| Settings reference | Every Settings screen and option |
| Controls | Touch controls, controllers, gyro, touch aiming |
| Multiplayer | Invites, iCloud Drive and folder invite files, LAN, cross-play |
| Display / AirPlay | Frame rate, picture shape and detail, the HUD editor, first-person view, heat and battery, menus, and showing the game on a TV |
| Troubleshooting | Safe Start, logs, problem reports, common problems |
| Mods | Adding mods to your iPhone, the load order, what a mod can replace, making your own |
| Mod Test | The separate Mod Test app |
| Device test results | What has been tested on real devices |
| Release notes | Every update, with its device checklist |
| Official project and other platforms | OpenCE, its downloads and credits |
This repository is an iOS-focused fork. The official project, its updates, and the Windows, Linux and Android versions are maintained by OpenCE:
- Repository: https://github.com/OpenCommunityEdition/OpenCE
- Releases and downloads: https://github.com/OpenCommunityEdition/OpenCE/releases
Official project and other platforms lists the downloads, where each platform is documented, and the credits. The original README of the upstream project is kept in docs/UPSTREAM_README.md.
This port exists because of the work of others:
- OpenCE (formerly Halo CE Universal) and its contributors: the cross-platform port of the decompiled engine, its netcode and invite-link multiplayer, the Custom Edition style menus, and the project this app is built on.
- bnunu/halo-1, the decompilation of the Xbox build 2342 (
cachebeta.exe) that OpenCE starts from, and punpckhdq/halo, the project it was forked from. - Bungie, who created Halo: Combat Evolved, and Microsoft / Xbox Game Studios and 343 Industries, its later owners and stewards.
- The open-source libraries bundled in
port/third_party: expat, extract-xiso, kcp, mbedtls, miniupnpc, Monocypher, musl math, stb and tomlc17, each under its own license. - The iOS port in this repository is maintained by SnailBBQ.
See Official project and other platforms for details.
App icon artwork by ORION
Used with ORION's permission. All credit goes to them.
GitHub ·
Discord
This is an unofficial, non-commercial fan project. It is not affiliated with or endorsed by Microsoft, Xbox Game Studios, 343 Industries or Bungie. Halo and its name, characters and artwork are owned by Microsoft.
No game files are included (no maps, assets or original executable). You need your own copy of the game, and you are responsible for using it in line with its license. We can't provide game files or help you find them, so please don't share them, or links to them, here.
The engine is recovered from the original game by the upstream OpenCE project. This project claims no rights held by Microsoft or anyone else.
This project is free software under the GNU Affero General Public License, version 3 or (at your option) any later version (LICENSE), the license OpenCE moved to with build 246 (the source of earlier OpenCE builds stays under CC0 1.0). If you change the game and let others play with your version over a network, the AGPL asks you to offer them your source (section 13); this repository is the source of the iOS app, and the app's Settings > About links to it. That gives you no rights in Halo. Third-party libraries and fonts, the app icon by ORION, and the screenshots in the docs keep their own terms (see the credits).
Builds are free and come with no warranty. If you share one, keep it free: no selling and no ads.
For maintainers, the public release checklist records the remaining publication and verification steps.
