Skip to content

About

Halo: Combat Evolved (Xbox Classic) for Android and AAOS. Controller- and Touchscreen-Support. Optimized for Adreno, also working for other GPUs.

Topics

Resources

Stars

29 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

Halo: Combat Evolved — Android & AAOS

Android Architecture AI Controls Multiplayer

🎮 Introduction

An unofficial Halo: Combat Evolved port for Android phones, handhelds and Android Automotive OS (AAOS). Based on thelinkin3000/halo-ce-universal and the Halo Xbox decompilation projects credited upstream. Take a short preview.

image image

This fork adds controller-aware RetroTouch, profile volume controls, cleaned-up menus, immersive mobile display and an AAOS build that respects the vehicle's available screen area. AAOS audio buffering and Android memory-layout fallbacks are included. The game uses the original 30 FPS mode, with a corrected geometry-upload path tested on Retroid; 60 FPS can be switched on in the in-game settings (experimental). Use the AAOS build while parked.

image image

Requires ARM64, Android 9+ for mobile or 10+ for AAOS, and a compatible OpenGL ES 3 GPU. The Android badge describes the current build target (API 35), not device-wide certification; the recent rendering fixes were tested on Android 13. This is not Android Auto phone projection.

Open the repository root in Android Studio. Choose mobileDebug / mobileRelease or aaosDebug / aaosRelease. Matching native binaries are included. See Android build instructions for native rebuilds. Keep your signing key and increase versionCode for published updates.

🚗 What is AAOS?

Android Automotive OS (AAOS) is Android running directly on a vehicle's infotainment system. Apps are installed on the vehicle itself. It is different from Android Auto, which projects supported phone apps onto the car's screen. This project's AAOS build is intended for compatible vehicles while parked to be playable with a connected Bluetooth Controller.

In most cases, AAOS builds can only be installed via the Play Store, unless you have root access to your vehicle (you do this at your own risk).

image

Note

If you are interested in testing the AAOS version, contact me.

💾 Game data

No commercial game data is included. Supply an Xbox Halo: Combat Evolved .iso / .xiso image from your own legally obtained copy; PC and Custom Edition data are not substitutes for the Xbox maps.

  1. Copy the disc image to your Android device.
  2. Start the app and select the image in the installer.
  3. Let the app extract the game data, then start Halo.

The imported maps determine the available localized text and speech. For German menus and voices, use a compatible German-language Xbox release. The port supports PAL map timing conversion. The installer uses app-specific storage; you do not need to modify ui.map manually. Diagnostic exports, when requested, are written to Android/media/com.halo.decomp/.

🌐 Multiplayer

The upstream port provides System Link over LAN and online play through invite links, including cross-platform sessions with compatible Linux, Windows and Android builds. For LAN play, connect devices to the same network and avoid Wi-Fi client isolation. Use matching port versions and compatible game data on all participants.

Online connectivity depends on the network and upstream networking support; it is not an official Xbox Live service. See the multiplayer documentation and netcode notes. Multiplayer has not been revalidated by the recent single-player rendering tests.

⚖️ Legal

Halo, Halo: Combat Evolved, Xbox and their associated assets and trademarks belong to their respective owners, including Microsoft. This community project is not affiliated with or endorsed by Microsoft or Bungie.

This project is licensed under the GNU Affero General Public License, version 3 or (at your option) any later version (AGPL-3.0-or-later); the full text is in LICENSE. It takes fixes from thelinkin3000/halo-ce-universal (SlipstreamCE), which moved to the AGPL 3.0 in its commit 4b09168e7 (19.10.2026). The commits of this repository before the change to the AGPL (up to and including release 1.0.17) were released under CC0 1.0 and stay that way. Third-party components retain their own licenses, including SDL and musl. These notices do not grant rights to the original game's commercial assets. You must supply your own game data.

About

Halo: Combat Evolved (Xbox Classic) for Android and AAOS. Controller- and Touchscreen-Support. Optimized for Adreno, also working for other GPUs.

Topics

Resources

Stars

29 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages