pancreations/Halo-MCC-VR v0.1-alpha

Halo MCC VR — Alpha 0.1

on GitHub

GRAB THE LATEST VERSION ABOVE

A native OpenXR VR mod for Halo: The Master Chief Collection (Steam).

This is an early alpha. Halo 3 campaign is the tested path. Other MCC titles, online play, custom games, Forge, every weapon, vehicles, scopes, and long sessions have not all been validated.

Alpha 0.1 was refreshed on July 20. The current download includes the protected uninstaller and a fully manual, no-script installation option. If you downloaded Alpha 0.1 earlier, discard that ZIP and download the current one below.

This code was written by AI. Every line was written by Anthropic's Claude and OpenAI's Codex, directed by a human modder who is not a programmer. He made the decisions, ran the builds, and confirmed results in a headset, but no human reviewed every line. Treat it as unaudited source; the code is public so you can inspect it before running it. Licensed MIT.

Pancreations is a 3D animator and does not use generative AI artwork in their work. This mod began as a request from a friend.

What works

• True per-eye stereo and 6DOF head tracking
• Motion-controller input: snap/smooth turning, melee, grenades, and menu control
• Controller-driven weapon aim with authored per-weapon VR crosshairs and enemy-red states
• Articulated VR arms, including a free left support hand on the shotgun
• Native HUD with the centered flat-screen reticle hidden
• Six picture-quality presets, from Potato (50%) to Keith David (150%)

Required MCC settings

Set these in MCC's own menus. The mod does not change them, and you can change them with the headset on.

Do not enable FSR in MCC's video menu; it breaks VR image scale. Use the mod's picture-quality presets instead.

FOV 120 keeps the engine from culling scenery at the edges of the headset view. V-Sync or a 60 FPS limit can make frame pacing feel poor regardless of GPU speed.

Install - choose either method

Download HaloMCCVR-alpha-0.1.zip below and unzip it first. Do not run files from inside the ZIP.

Manual install (no scripts)

1. In Steam, open MCC > Manage > Browse local files.
2. Inside the main Halo The Master Chief Collection folder, create a folder named exactly halo3xr.
3. Copy only halo3xr.dll and halo3xr_launcher.exe from the unzipped package into that new folder.
4. Start Steam and your OpenXR headset runtime, then run halo3xr_launcher.exe.
5. Optional: right-click the launcher and choose Send to > Desktop (create shortcut).

The final path should be:

Halo The Master Chief Collection\halo3xr\halo3xr_launcher.exe

Do not copy the files loose into the main MCC folder. To uninstall manually, close MCC and delete only the dedicated halo3xr folder you created.

Automatic install

1. Close MCC, then run install.bat from the unzipped package.
2. Pick a picture quality. Low is the safest first try; the F1 menu can change it later.
3. Launch with the Halo MCC VR desktop shortcut it creates.

Requires Windows 10/11 64-bit, Steam MCC with Halo 3 installed, and a working OpenXR runtime. No compiler, CMake, or Visual C++ redistributable is needed.

Safety

• Launches MCC through its official anti-cheat-disabled mode. Do not use it in anti-cheat-enabled matchmaking.
• No game files are patched or redistributed. Normal Steam launches stay unmodded.
• The files are unsigned, so Windows or antivirus may inspect them. Do not disable security software globally.
• Automatic uninstall is available from the installed halo3xr folder. The current script validates the exact folder and deletes only known mod files.

Download verification

Current ZIP SHA-256:

3800FC032871FDE37C7FAD666E1D8DA8F9E341AF0A650901E21FBE10845B738B

Built from commit 1c6643e. Per-file hashes are included in BUILD-INFO.txt inside the ZIP.

Reporting problems

Open an issue with what appeared in the headset, plus halo3xr_launcher.log, halo3xr.log, the ZIP's BUILD-INFO.txt, and your headset, GPU, and OpenXR runtime.

Quest Pro and additional headset/controller combinations still need playtesters and may not work out of the box.

Known bugs

• Right-stick zoom is not implemented correctly and can clip or hide the character and nearby elements.
• Some toggles in the F1/thumb-stick-click menu remain unfinished.
• Loading another Halo title currently breaks the 3D hook.

Tips

• Click both thumb sticks to open the F1 VR settings menu.
• To pause, press both face buttons on the left controller together; this enters 2D mode and returns to 3D when resumed.
• A 120 FPS game cap is recommended even if the headset runs at 72 Hz. Keep V-Sync off.
• Keep in-game FSR off. External OpenXR scaling tools may work.
• Quad-view eye tracking is supported.
• Vehicles require strong VR legs. Steering currently follows right-hand movement because the right aim stick is tied to the right hand.
• Cutscenes, vehicles, turrets, and the flamethrower remain third-person.
• The IK rig can be hidden for floating hands.
• Dual-wield bullets, projectiles, and crosshair follow the right hand.
• Two-handed weapon placement can be adjusted.

Credits

Inspired by HaloCEVR by LivingFray and the ReclaimerVR proof of concept by Nibre. Halo is a Microsoft trademark; this project is not affiliated with Microsoft or Halo Studios.

GRAB THE LATEST VERSION ABOVE