Halo 3 (Project Reclaimer)

Port 0.10.0

Lanceur natif macOS pour le multijoueur de Halo 3, sans Wine.

Project Reclaimer est un lanceur autonome qui fait tourner le multijoueur de Halo 3 sur macOS sans Wine. Les archives macOS sont publiées à chaque version ; le site du projet donne les instructions d'installation.

Architecture

Mac OS X - macOS Mac OS X - macOS

Original game

Halo 3 Xbox 360

Download and links

Version history

0.10.0-v4
  • Ajout d’un partenaire d’entraînement (native-spar.sh) : joueur test local qui suit automatiquement la tête des ennemis (visée uniquement, pas de tir) sur un serveur privé.
  • Intégration d’un mécanisme de marche automatique pour les joueurs tests : déplacement aléatoire ou vers les zones de mort fréquente ou les ennemis proches.
  • Basculateur de micro sur la page de stats : mute le micro pour le chat vocal sans couper le son local.
  • Affichage de la direction de visée des joueurs dans les captures de stats ("aim").
  • Outils de test réservés aux profils locaux (NATIVE_REAL=1) et aux serveurs privés (pas de public game).
  • Fichiers inclus : outils natifs (scripts, nhook.dylib arm64), outils de map (Python 3 + numpy/Pillow), et documentation.

Project Reclaimer 0.10.0 on Apple Silicon, fourth release. Same client version as reclaimer-0.10.0: the native macOS Project Reclaimer.app with our tooling inside it (shim/native.sh + nhook.dylib), plus the loader for 0.9.x clients. Every fix with its reason and its old-behaviour switch: shim/docs/FIXES.md.

New in the native app

  • A sparring partner: bash shim/tools/native-spar.sh puts a second test player on your own local server. It turns toward the nearest enemy's head (it aims, never fires, and stands where it spawned); join the same server to practise against it. The server sees its aim on its target (checked to 0.01°). Its page (http://127.0.0.1:8766) has the Sparring aim switch.
  • The walker for test players in a local game: walks the map's floor graph around the places players died most, to random far-apart spots or toward the nearest enemy (the page's Walk list). In a joined game the server takes a player's moves from the app's own input, so it isn't offered there.
  • Mic switch on the stats page: mutes your microphone for the game's voice chat (the app hears silence). New and not yet checked in a real game.
  • Players' aim direction in the stats snapshot ("aim").
  • Both of these test helpers only run with a test profile (shim/native.sh without NATIVE_REAL=1) and only in a local game or on a server at a local/private address: never in your own client or a public game.

The loader (0.9.x clients)

Unchanged since reclaimer-0.10.0.

Bundle contents

  • shim/native.sh, shim/build/nhook.dylib (arm64, signed ad hoc), shim/tools/native-dedicated.sh, shim/tools/native-spar.sh, shim/tools/profile-native.py, shim/docs/native-client.md: the native app's tooling.
  • Reclaimer.app, shim/build/peload, shim/build/glhelper, shim/crt/, shim/play.sh and friends: the loader (as before).
  • re-tools/h3*.py: map tools run in the background (map pictures, walking graph, invisible walls, teleport spots; python3 with numpy and Pillow).

No game files are included. You need your own Halo: The Master Chief Collection on Steam, and the Project Reclaimer client from https://github.com/ProjectReclaimer/project-reclaimer-releases/releases (the native Mac app, or the 0.9.x exe for the loader).

Quick start (native app)

tar xzf ProjectReclaimerOSXNative-reclaimer-0.10.0-v4-macos.tar.gz
xattr -dr com.apple.quarantine ProjectReclaimerOSXNative-reclaimer-0.10.0-v4-macos
cd ProjectReclaimerOSXNative-reclaimer-0.10.0-v4-macos
NATIVE_REAL=1 bash shim/native.sh                                    # Project Reclaimer.app with the stats page
NHOOK_HITBOXES=1 NHOOK_HB_TRACERS=1 NATIVE_REAL=1 bash shim/native.sh --join-server 

Game log: /tmp/reclaimer_native.log. Loader quick start: README.md.

SHA-256 of the tarball: f1e01f6000884351fb810c0d77296e086daf760bb4d3a0c9289b667d85273336

🤖 Generated with Claude Code

0.10.0-v3
  • Corrections majeures sur la page de stats : les murs invisibles fonctionnent enfin, le téléportement place les joueurs sur des zones solides, et les canaux vocaux sont affichés correctement.
  • Améliorations des logs et des matchs : les départs de joueurs sont notés au moment où le serveur le détecte, chaque match est traité comme une nouvelle partie, et les médailles suivent systématiquement leurs kills.
  • Affichage des spawns clarifié : les armes de départ d’un match sont listées en une ligne avec le nom de la carte, et les armes abandonnées ne sont plus comptabilisées comme des spawns.
  • Stabilité accrue : la page de stats s’affiche systématiquement après que l’engine soit prête, évitant les plantages initiaux.
  • Outils de débogage et scripts : ajout de profile-native.py pour profiler la performance et de scripts Python (re-tools/h3*.py) pour analyser les cartes (images, graphes de déplacement, zones invisibles).

Project Reclaimer 0.10.0 on Apple Silicon, third release. Same client version as reclaimer-0.10.0: the native macOS Project Reclaimer.app with our tooling inside it (shim/native.sh + nhook.dylib), plus the loader for 0.9.x clients. Every fix with its reason and its old-behaviour switch: shim/docs/FIXES.md.

Fixed / new in the native app's stats page (http://127.0.0.1:8765)

All checked live with two clients on our own local server.

  • Invisible walls off now works in the native app (it had no effect before).
  • Teleport next to a player picks a spot with a floor under it: a player put beside someone at a ledge no longer drops into the kill zone.
  • Who talks says on which channel: global, team or proximity voice. The forensic archive records the channel too.
  • Who left: " left the game" shows when the server notices, before the game ends, not at the start of the next match.
  • Every game is a match: the server's next game on the same map starts a new match on the page.
  • Kill feed: a medal always follows its kill.
  • Spawns: the first spawn line of a match names the map's own weapons, in one line; a dead player's dropped weapon is no longer a "spawn".
  • The stats page always comes up: the hooks wait until the game engine is ready.

The loader (0.9.x clients)

Unchanged since reclaimer-0.10.0.

Bundle contents

  • shim/native.sh, shim/build/nhook.dylib (arm64, signed ad hoc), shim/tools/native-dedicated.sh, shim/tools/profile-native.py, shim/docs/native-client.md: the native app's tooling.
  • Reclaimer.app, shim/build/peload, shim/build/glhelper, shim/crt/, shim/play.sh and friends: the loader (as before).
  • re-tools/h3*.py: map tools run in the background (map pictures, walking graph, invisible walls, teleport spots; python3 with numpy and Pillow).

No game files are included. You need your own Halo: The Master Chief Collection on Steam, and the Project Reclaimer client from https://github.com/ProjectReclaimer/project-reclaimer-releases/releases (the native Mac app, or the 0.9.x exe for the loader).

Quick start (native app)

tar xzf ProjectReclaimerOSXNative-reclaimer-0.10.0-v3-macos.tar.gz
xattr -dr com.apple.quarantine ProjectReclaimerOSXNative-reclaimer-0.10.0-v3-macos
cd ProjectReclaimerOSXNative-reclaimer-0.10.0-v3-macos
NATIVE_REAL=1 bash shim/native.sh                                    # Project Reclaimer.app with the stats page
NHOOK_HITBOXES=1 NHOOK_HB_TRACERS=1 NATIVE_REAL=1 bash shim/native.sh --join-server 

Game log: /tmp/reclaimer_native.log. Loader quick start: README.md.

SHA-256 of the tarball: f1b7457626246df110f75a0d70562087016f646cc554135b9a8b2221e0275076

🤖 Generated with Claude Code

0.10.0-v2
  • Ajout d’un serveur dédié local avec une page de stats dédiée (port 8767), accessible uniquement sur le même Mac, sans master server ni UPnP.
  • Outils de manipulation dans la page de stats : désactivation des limites de carte, des murs invisibles, et boost de vitesse à 200 % pour tous les joueurs.
  • Nouveaux indicateurs dans le feed : détails des medailles, historique des premiers kills après un lancement, et affichage des messages de chat/serveur.
  • Analyse des tirs : colonne "Aim" montrant l’écart des tirs et les confirmations de dégâts, avec un système de détection d’"aimbot" pour les valeurs aberrantes.
  • Archivage forensique : enregistrement des voix via un micro dédié, avec un lecteur audio et une timeline pour l’analyse.
  • Correction visuelle : suppression des hitboxes sur les cadavres et amélioration de l’affichage des impacts (tirs traversant les hitboxes).

Project Reclaimer 0.10.0 on Apple Silicon, second release. Same client version as reclaimer-0.10.0: the native macOS Project Reclaimer.app with our tooling inside it (shim/native.sh + nhook.dylib), plus the loader for 0.9.x clients. Every fix with its reason and its old-behaviour switch: shim/docs/FIXES.md.

New in the native app's stats page (http://127.0.0.1:8765)

  • Host tools for the game's host or your own server: teleport (next to a player, to a point on the map, to the map's spots past the boundaries), boundaries off (kill volumes, safe zones, soft ceilings), invisible walls off, speed 200% for everyone.
  • Your own local dedicated server with the stats page: bash shim/tools/native-dedicated.sh start (this Mac only: hidden, no master server, no UPnP; page on http://127.0.0.1:8767, where the host tools take &slot=). Join it with bash shim/native.sh --join-server 127.0.0.1:49190.
  • Aim column: how far each player's straight shots pass from the nearest enemy's hitboxes, and how many shots through a hitbox the server confirmed with damage. Aimbot? column: flags players far outside the lobby on those numbers.
  • Hook cost panel: what each hook and overlay part costs per frame, a "measure" button that switches one off and on to give its real fps cost, and a switch per hook. Hooks that are off cost nothing; the stats snapshot runs on efficiency cores and can't slow the game.
  • Kill feed: exact from Halo 3's game results, including the first kills after a launch; no replayed history after joining a game in progress; medals in the feed and in each player's details; "Game over: won".
  • Chat, server and notice lines in the feed; who talks; page mutes through the app's own mute list.
  • Packets window: player names and DNS names by each address ("server" for a dedicated server), plus a "game" layer naming Halo 3's session messages.
  • Overlay: no hitboxes on dead bodies; hits now mean shots through an enemy's hitboxes.
  • Forensic archive (/forensics): voice audio from the app, an always-open microphone split into what was said, a cleaner audio player and timeline lanes.

The loader (0.9.x clients)

Unchanged since reclaimer-0.10.0.

Bundle contents

  • shim/native.sh, shim/build/nhook.dylib (arm64, signed ad hoc), shim/tools/native-dedicated.sh, shim/tools/profile-native.py, shim/docs/native-client.md: the native app's tooling.
  • Reclaimer.app, shim/build/peload, shim/build/glhelper, shim/crt/, shim/play.sh and friends: the loader (as before).
  • re-tools/h3*.py: map tools run in the background (map pictures, walking graph, invisible walls, teleport spots; python3 with numpy and Pillow).

No game files are included. You need your own Halo: The Master Chief Collection on Steam, and the Project Reclaimer client from https://github.com/ProjectReclaimer/project-reclaimer-releases/releases (the native Mac app, or the 0.9.x exe for the loader).

Quick start (native app)

tar xzf ProjectReclaimerOSXNative-reclaimer-0.10.0-v2-macos.tar.gz
xattr -dr com.apple.quarantine ProjectReclaimerOSXNative-reclaimer-0.10.0-v2-macos
cd ProjectReclaimerOSXNative-reclaimer-0.10.0-v2-macos
NATIVE_REAL=1 bash shim/native.sh                                    # Project Reclaimer.app with the stats page
NHOOK_HITBOXES=1 NHOOK_HB_TRACERS=1 NATIVE_REAL=1 bash shim/native.sh --join-server 

Game log: /tmp/reclaimer_native.log. Loader quick start: README.md.

SHA-256 of the tarball: 741d6f2abac92f958dfe9439e3dd046eb640cdb86d5f402c61ab1af7a2fff2a3

🤖 Generated with Claude Code

Reply on the forum

A question or a hands-on report? Open the discussion on the forum.

Reply on the forum