Halo 3 (Project Reclaimer)
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
Original game
Halo 3 Xbox 360
Download and links
- Download Halo 3 (Project Reclaimer)
- Official website
- Source code 7 GitHub stars
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.shputs 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.shwithoutNATIVE_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.shand 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.shand 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 withbash 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.shand 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
0.10.0
- Application native macOS : version autonome avec support Metal, sans Rosetta, incluant sa propre récompilation de halo3.dll et ses outils intégrés.
- Outil de migration de profil : script shim/tools/profile-native.py convert pour transférer l’ID joueur depuis le loader vers l’app native (vérifie la clé sans l’afficher).
- Tableau de bord complet : stats en temps réel (kills/débuts/assistances), heatmap, liste des joueurs avec IP, traçage des projectiles lents, et overlay graphique (hitboxes, véhicules, zones de sécurité).
- Enregistrement de parties : capture vidéo (MP4) et audio (M4A), capture d’écran, et logs forensiques (événements, paquets par seconde).
- Performances sur Apple Silicon : 120–200 FPS en matchs à 52–72 joueurs en 3440×1440 (contre 37–48 FPS avec le loader).
- Fonctionnalités absentes : liste des serveurs, traçage des balles, gestion du son/micro, et zones cachées (overlay traverse les murs pour l’instant).
Project Reclaimer 0.10.0 on Apple Silicon. Since 0.10.0 Project Reclaimer ships its own native macOS app (Project Reclaimer.app, Metal, no Rosetta): it recompiles MCC's halo3.dll itself and needs no loader. This release adds our tooling inside that app, and keeps the loader for 0.9.x clients. Releases are named for the Reclaimer client version they support.
New: tooling for the native 0.10 app
- Keep your player ID moving from the loader to the app:
shim/tools/profile-native.py convertwrites the app's profile format from the same key (same community id; it checks the key and never prints it). Back up both profiles first. shim/native.sh+shim/build/nhook.dylib: starts/Applications/Project Reclaimer.appwith our dylib (NATIVE_REAL=1= your real player folder, otherwise a test profile). The live stats page comes back on http://127.0.0.1:8765:- players, kills / deaths / assists / betrayals / suicides / score (Halo 3's own replicated scoreboard), a kill feed paired from it, the heatmap, game rules, an fps line;
- the Connected list, an IP column per player and the Packets window with player names and reverse-DNS names;
- the overlay in the app's own frames: hitboxes, vehicles and weak spots, info labels, items, tracers of slow projectiles, kill / safe zones, soft ceilings and invisible walls. The overlay uses Halo 3's camera and is aligned on ultrawide screens. Infection team filters go by zombie / human;
- clip recording (mp4 / m4a), Capture frame, and /forensics (events, roster, per-second packet sums).
- Measured on an M4: 120-200 fps in 52-72 player games at 3440x1440 (the loader: 37-48 fps in big Infection games).
- Not in the native app yet: voice / mute, bullet tracers (the app replaced halo3's object_delete with its own code), "visible only" and zones hidden behind walls (the overlay draws through walls for now), a server list from the command line.
The loader (0.9.x clients)
Unchanged in purpose: Reclaimer.app / shim/play.sh run the Windows client and MCC's halo3.dll under Rosetta 2 (no Wine). Since reclaimer-0.9.20: clients 0.9.21-0.9.23 (and the Windows build of 0.10.0), a packet-type log, input-to-screen latency measurements, a faster big-game render path, and more fixes. Every fix with its reason and its old-behaviour switch: shim/docs/FIXES.md.
Bundle contents
Reclaimer.app,shim/build/peload,shim/build/glhelper,shim/crt/,shim/play.shand friends: the loader (as before).shim/native.sh,shim/build/nhook.dylib(arm64, signed ad hoc),shim/tools/profile-native.py,shim/docs/native-client.md: the native app's tooling.re-tools/h3*.py: map tools run in the background (map pictures, walking graph, invisible walls; 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-macos.tar.gz
xattr -dr com.apple.quarantine ProjectReclaimerOSXNative-reclaimer-0.10.0-macos
cd ProjectReclaimerOSXNative-reclaimer-0.10.0-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: ed4e91c67f8896b8c062a662928d0c8f3748a8de76b30dcf963ade5922570136
0.9.20
- Lancement simplifié : l’application Reclaimer.app s’exécute par double-clic sans Terminal, avec une signature ad hoc (quarantine à lever une fois).
- Prise en charge native Apple Silicon : le moteur graphique s’exécute dans un processus arm64 dédié (+12 % de FPS en moyenne, optimisations pour les jeux lourds comme Big Team Battle).
- Support macOS étendu : compatibilité avec macOS 13+, gestion automatique des ressources (60 FPS max sur GPU M1, 1 Go RAM max sur 8 Go de mémoire).
- Corrections critiques : suppression des fuites mémoire entre les chargements de cartes (shaders, entrées audio, etc.), suppression des crashes audio et des plantages sur les cartes Forge.
- Page de stats locale : affichage détaillé des kills, des votes, des spawns et des paramètres graphiques en temps réel (contrôle via http://127.0.0.1:8765).
- Améliorations des mods : téléchargement des mods Workshop via DepotDownloader (pas de timeout sur les gros fichiers).
Project Reclaimer 0.9.20 on Apple Silicon, natively through a Win64 PE loader under Rosetta 2 (no Wine, CrossOver or VM). Releases are named for the Reclaimer client version they support: this one is reclaimer-0.9.20 (servers refuse older clients within hours of a client release).
New since reclaimer-0.9.18-v2
- Reclaimer.app: double-click it to play, no Terminal needed. It sits at the top of the bundle and starts the menu from the folder it is in (keep it there). It is signed ad hoc; clear the download quarantine once (Quick start below). The first launch from Desktop / Documents / Downloads asks for access to that folder: allow it.
bash shim/tools/make-app.sh --applicationsalso puts a copy in ~/Applications for Launchpad and Spotlight. - Client 0.9.20 support.
bash shim/tools/client-update.shdownloads the newest client release and checks it against the release's SHA-256 list; the launchers use the newestclient/project-reclaimer-client-v*.exe. - Much faster big games: the GL driver runs in a native arm64 helper process (Big Team Battle 13-25 fps -> median 49 on an M4), copy-on-write game-state copies, a working
NtDelayExecution(the client's voice and frame-pacing threads spun a core each: +12% median fps in a 128-player match), import fast paths, Windows' real CPU count. - Older and smaller Macs: binaries run on macOS 13 and later. Retina screens get the full window (the picture sat in the bottom-left quarter). A per-Mac profile picks worker counts by performance cores; on a base-tier GPU (M1 class) the first run uses the Medium graphics preset and caps at 60 fps, and on 8 GB Macs the background walking-graph tool is capped at 1 GB.
PELOAD_MONITOR=xsets the client's render resolution. - Picture fixes: compressed textures upload with their own mip chain (~2 GB less GL memory on big maps), Forge World's ground, dark interiors and auto-exposure on every map, bloom / blur filters sample at their real offsets, menu color grading, the loading screen during heavy loads.
- Memory over many map changes: shaders, input layouts, threads, audio capture streams, file views and timers the game releases are freed instead of piling up with every map load.
- Stats page (http://127.0.0.1:8765): exact kill feed with weapons, kills and K/D, sortable columns, player slots, the map in the whole window, weapon / vehicle / power-up spawns, a per-feature overlay panel (team filter, visible only, label size), vehicle weak spots, invisible walls, clip recording (mp4 / m4a), a graphics quality control (Low / Medium / High / Ultra, applied live), map-vote and called-vote auto answers, and a forensic archive of the voice, chat and events you receive (one-party consent setting; your own local files only).
- Games you host or your own local dedicated server: teleport spots past the boundaries for every map (made from your map files on first play), 2x speed, boundaries and invisible walls on / off -- also from a client of your own local server.
- Mods: the client's Required Mods screen downloads Workshop items through DepotDownloader (
shim/tools/workshop-helper.sh, your remembered Steam login, never a password); progress no longer times out on big downloads. - Security hardening: the stats server refuses cross-site requests and DNS rebinding, and the shader translator, compute interpreter and file APIs check crafted map data.
- Crash fixes: the client's audio crash ("0xC000001D at unmapped module") is gone, and a crash in object position lookups on Forge maps is guarded.
- Every fix is listed with its reason and its old-behaviour switch in
shim/docs/FIXES.md.
Bundle contents
Reclaimer.app: the double-click launcher (a small signed native program that runsshim/play.sh).shim/build/peload: the loader (x86_64, runs under Rosetta 2);shim/build/glhelper: the native GL helper (arm64).shim/crt/: Microsoft VC++ runtime DLLs (app-redistributable).shim/play.sh,shim/target.sh,shim/dedicated.sh,shim/tools/: launcher, test opponent, dedicated server, client updater, Workshop helper, server list, map pictures, USB install.re-tools/h3*.py: the map tools the loader runs in the background (map pictures, walking graph, invisible walls, teleport spots, vehicle weak spots; python3 with numpy and Pillow).reclaimer-mac.sh download: fetches your MCC files with DepotDownloader (your Steam login).README.md,shim/docs/mods.md,shim/docs/game-options.md,shim/docs/FIXES.md.
No game files are included. You need your own Halo: The Master Chief Collection on Steam and the Project Reclaimer client exe from https://github.com/ProjectReclaimer/project-reclaimer-releases/releases (client-update.sh fetches it).
Quick start
tar xzf ProjectReclaimerOSXNative-reclaimer-0.9.20-macos.tar.gz
xattr -dr com.apple.quarantine ProjectReclaimerOSXNative-reclaimer-0.9.20-macos
cd ProjectReclaimerOSXNative-reclaimer-0.9.20-macos
./reclaimer-mac.sh download # one time: MCC files via your Steam login (or install from a USB stick)
bash shim/tools/client-update.sh # the newest client exe into client/ (SHA-256 checked)
open Reclaimer.app # or double-click it; from Terminal: bash shim/play.sh
Live stats: http://127.0.0.1:8765. Game log: /tmp/reclaimer_play.log.
SHA-256 of the tarball: 82b540696c3be0de92593fa5591aee2bc28cfef7d5846e896cb202d898ada4a6
🤖 Generated with Claude Code
0.9.18-v2
- Amélioration des performances : les jeux multi-joueurs (jusqu’à 100 joueurs) gagnent 15 à 30 FPS grâce à une simulation de particules GPU optimisée et à un traitement GL séparé.
- Page de stats live : affichage en temps réel des événements (kills, votes), du chat (avec balises TEAM/NEARBY), des positions des joueurs et d’une heatmap des morts sur la carte.
- Fonctionnalités dédiées aux serveurs : lancement d’un serveur local dédié via bash shim/dedicated.sh et outils pour gérer les mods (liste des serveurs actifs et procédures pour DepotDownloader).
- Correction des fuites audio : suppression des fuites de files CoreAudio et du busy-polling du clavier dans le thread vocal (optionnel).
- Support natif Apple Silicon : build x86_64 sous Rosetta 2, sans Wine ou VM, avec gestion des fichiers MCC via reclaimer-mac.sh download.
- Crash connu : plantage occasionnel lors du chargement de la carte ou de la reconnexion vocale (solution temporaire : PELOAD_NO_WASAPI=1).
Project Reclaimer 0.9.18 on Apple Silicon, natively through a Win64 PE loader under Rosetta 2 (no Wine, CrossOver or VM). Second build for client 0.9.18: releases are named for the Reclaimer client version they support, so this one is reclaimer-0.9.18-v2.
New since reclaimer-0.9.18
- Big games run much faster: a 100-player Infection game went from 15-24 fps to 37-48 fps. The GPU particle simulation runs on 4 CPU workers 64 lanes at a time, the GL work moves to its own thread in games with 40+ players (
PELOAD_D3DGL_SUBMIT=auto, the default), and per-frame stalls are gone. - Live stats page at http://127.0.0.1:8765 while you play:
- Event feed (joins and leaves, kills with the weapon or vehicle, votes, server notices, match start and end) and Chat (everyone's text chat with TEAM / NEARBY marks, the server's messages) side by side.
- Players (shield, health, weapon, deaths, accuracy, active traits; respawning and quit players listed last), the game's rules and trait sets, everyone connected with voice mute buttons and a talking light.
- A death heatmap over a top-down picture of the map made from your own map files, with everyone's live position; player details on click.
- The in-game overlay switches (hitboxes, tracers, player info, items, visible-only F9, frame capture F8).
- In games you host (
PELOAD_ALLOW_TELEPORT=1): teleport next to a player or to a spot clicked on the map, and switch the map boundaries off to explore past the edges.
- Dedicated server on the Mac:
bash shim/dedicated.sh(local-only by default). - Mods:
shim/tools/servers.shlists the busiest servers and the mods each needs;shim/docs/mods.mdshows how to fetch Workshop-only mods with DepotDownloader (tested with HugeGrass Rebalance, Hugegrass, Permafrost and Ultimate Forge). - Second test player without a window (
shim/target.sh), for practice games. - Fixes: the client's audio streams no longer leak one CoreAudio queue every 5 s; Unicode in the client's console output; the client's microphone-less voice thread no longer busy-polls the keyboard (opt-in damper).
Known issue
- Occasional crash at a map load or the 5 s voice retry ("Experimental startup exception 0xC000001D at unmapped module", inside Apple's audio allocator). It comes from the client's own audio output (menu music and voice-chat playback), not the game sound. If it hits you, start with
PELOAD_NO_WASAPI=1 bash shim/play.sh: game audio stays, voice chat and menu music go quiet. A fix is in progress.
Bundle contents
shim/build/peload: the loader (x86_64, runs under Rosetta 2).shim/crt/: Microsoft VC++ runtime DLLs (app-redistributable).shim/play.sh,shim/target.sh,shim/dedicated.sh,shim/tools/: launcher, test opponent, dedicated server, test runner, server list, map pictures, USB scripts.re-tools/h3map.py,h3bsp.py,h3bounds.py: make the stats page's map pictures (needs python3 with numpy and Pillow).reclaimer-mac.sh download: fetches your MCC files with DepotDownloader (your Steam login).README.md,shim/docs/mods.md,shim/docs/game-options.md.
No game files are included. You need your own Halo: The Master Chief Collection on Steam and project-reclaimer-client-v0.9.18.exe from https://github.com/ProjectReclaimer/project-reclaimer-releases/releases, placed in client/.
Quick start
tar xzf ProjectReclaimerOSXNative-reclaimer-0.9.18-v2-macos.tar.gz
xattr -dr com.apple.quarantine ProjectReclaimerOSXNative-reclaimer-0.9.18-v2-macos
cd ProjectReclaimerOSXNative-reclaimer-0.9.18-v2-macos
./reclaimer-mac.sh download # one time: MCC files via your Steam login (or install from a USB stick)
cp ~/Downloads/project-reclaimer-client-v0.9.18.exe client/
bash shim/play.sh # live stats: http://127.0.0.1:8765
🤖 Generated with Claude Code
0.9.18
- Prise en charge native du client Reclaimer 0.9.18 via un chargeur Win64 PE sous Rosetta 2, sans émulation Wine ou VM.
- Jouabilité en ligne complète : navigateur de serveurs, connexion à des serveurs publics (testé en Big Team Battle avec 60 joueurs), lobby, vote de cartes et tableau des scores.
- Audio fonctionnel : son du jeu, musique du menu et lecture des voix via un périphérique WASAPI sur CoreAudio.
- Corrections majeures : rendu de l’eau, suppression du gel intermittent après l’écran de chargement et correction du titre affichant un FPS surestimé.
- Outils de débogage : surlignage des hitboxes (F2), traçage des projectiles (F3), infos bouclier/santé/arme (F4), étiquettes d’objets (F5), filtre allié/ennemi (F6).
- Installation USB : script make-usb.sh pour copier l’intégralité des fichiers (y compris MCC) sur une clé USB, avec install.sh pour configurer un second Mac sans redownload.
Project Reclaimer 0.9.18 on Apple Silicon, natively through a Win64 PE loader under Rosetta 2 (no Wine, CrossOver or VM). Releases are now named for the Reclaimer client version they support.
New since v0.1.0
- Reclaimer client 0.9.18 (the version servers run); the loader finds its client patches by byte signature.
- Online play: Server Browser, joining public servers (Big Team Battle tested with 60 players), lobby, map vote, scoreboard, join-in-progress.
- Audio: game audio, plus the client's own menu music and voice playback (new WASAPI device on CoreAudio).
- Fixes: water renders; the intermittent freeze right after the loading screen is gone (thread ids); the frame-rate title no longer over-reports.
- Debug overlays (launch variable or key): real hitboxes from each object's collision model (F2), projectile and bullet tracers (F3), player shield/health/weapon info (F4), item labels (F5), friend/enemy filter (F6). See the README table.
- USB install:
shim/tools/make-usb.shcopies everything (including your MCC files) to a stick;install.shon the stick sets up a second Mac without downloading MCC again. - Window sizes itself to your screen; Halo 3 engine settings via
PELOAD_H3.
Bundle contents
shim/build/peload-- the loader (x86_64, runs under Rosetta 2)shim/crt/-- Microsoft VC++ runtime DLLs (app-redistributable)shim/play.sh,shim/target.sh,shim/tools/-- launcher, test opponent, test runner, USB scriptsreclaimer-mac.sh download-- fetches your MCC files with DepotDownloader (your Steam login)README.md
No game files are included. You need your own Halo: The Master Chief Collection on Steam and project-reclaimer-client-v0.9.18.exe from https://github.com/ProjectReclaimer/project-reclaimer-releases/releases, placed in client/.
Quick start
tar xzf ProjectReclaimerOSXNative-reclaimer-0.9.18-macos.tar.gz
xattr -dr com.apple.quarantine ProjectReclaimerOSXNative-reclaimer-0.9.18-macos
cd ProjectReclaimerOSXNative-reclaimer-0.9.18-macos
./reclaimer-mac.sh download # one time: MCC files via your Steam login (or install from a USB stick)
cp ~/Downloads/project-reclaimer-client-v0.9.18.exe client/
bash shim/play.sh
🤖 Generated with Claude Code
0.1.0
- Première version jouable sur Apple Silicon avec un loader natif Win64/PE sous Rosetta 2, sans Wine ou VM.
- Fonctionnalités implémentées : rendu Direct3D 11 → OpenGL-on-Metal (éclairage, ombres, arme FPS, particules, flash de canon, explosions, HUD, écran de chargement).
- Audio géré via CoreAudio et contrôleurs (Xbox, DualSense) + clavier/souris pris en charge.
- Temps de démarrage à la partie : ~12 secondes, performance moyenne ~116 fps sur M4 (50–200 fps selon les scènes).
- Titre de fenêtre affichant durée écoulée, temps de chargement et FPS en temps réel.
First playable build: a Guardian Slayer match running on Apple Silicon through a native Win64 PE loader under Rosetta 2. No Wine, CrossOver or VM.
What works
- Rendering: Direct3D 11 → OpenGL-on-Metal, with lighting, shadows, the first-person weapon, particles, muzzle flash, explosions, the HUD and the loading screen.
- Audio: game audio through CoreAudio.
- Input: controllers (Xbox, DualSense, …) and keyboard/mouse.
- Speed: about 12 s from launch to the match; ~116 fps average on an M4 (roughly 50–200 fps depending on the scene).
- Window title: shows elapsed time, load time and the live frame rate.
Bundle contents
shim/build/peload— the loader (x86_64, runs under Rosetta 2)shim/crt/— Microsoft VC++ runtime DLLs (ucrtbase.dll,vcruntime140.dll,msvcp140.dll; app-redistributable) that the loader runs the client againstshim/play.sh— the launcherreclaimer-mac.sh download— fetches your MCC files natively with DepotDownloaderREADME.md
No game files are included. You need:
- your own Halo: The Master Chief Collection on Steam (downloaded with
./reclaimer-mac.sh download, ~25 GB) project-reclaimer-v0.9.13.exefrom https://projectreclaimer.dev, placed inclient/(SHA-256a393504dc32a8fd35dabb5b26ea1427fbaedabdac76b00133d49ebc44fb8efd1; it must be this exact build)
Quick start
tar xzf ProjectReclaimerOSXNative-v0.1.0-macos.tar.gz
xattr -dr com.apple.quarantine ProjectReclaimerOSXNative-v0.1.0-macos
cd ProjectReclaimerOSXNative-v0.1.0-macos
./reclaimer-mac.sh download # one time: MCC files via your Steam login
cp ~/Downloads/project-reclaimer-v0.9.13.exe client/
bash shim/play.sh
Known issues
- Holding Back/Tab shows the scoreboard bars without names or scores. Reclaimer draws those only when running under its own menu, which this launcher skips.
- Reclaimer's frontend menu boots (its Halo 3 menu scene renders), but its UI is blank, so it can't be used yet.
- The MCC pause menu is unavailable in standalone mode; F1 releases the mouse.
Reply on the forum
A question or a hands-on report? Open the discussion on the forum.