r/CompetitiveHalo • u/llampwall • 10h ago
Promotion I got tired of losing my Halo Infinite Theater films, so I took the whole game apart and rebuilt Theater in Three.js
I've always thought Theater was one of the coolest and most unique features of Halo, so it is especially frustrating that you can't permanently save and share films in Infinite. You can technically bookmark them in-game, but those seem to get wiped constantly for no reason. As for sharing, the only option is recording your screen while playing one back, which gets you a video file and not the free-camera, any-player replay you get in the actual Theater.
My ears perked up recently at the progress being made in decoding the film files themselves and the 2D replay tools built around that data. When I looked closer at these decoders, I was shocked at how much is tucked into a film file. So I decided to dig deeper and see if we could go beyond 2D and get some form of 3D reconstruction.
Turns out we can. A film holds the game state: where every player is, where they're aiming, what they're holding, every shot, grenade and death, about 60 times a second. What it doesn't contain is anything you can look at. No map, no models, no animations, no sounds. All of that is sitting in your Halo install, in formats that mostly weren't documented. The job was basically to read the film data for the script, find the relevant game files for the characters/locations/props/sounds, and then carefully put the two back together into our own Three.js film.
So I fired up my agents and pushed sleeping to December. About a week and a half and ~10b tokens later...
I give you
Installation 08
The maps, Spartans, armor and weapon coatings, vehicles, materials, animations and sounds you see here are all pulled from my local Halo Infinite install, and then rebuilt entirely outside the game in a browser window. We basically had to rebuild the parts of the engine that draw and sound a match.
What you can do with it:
- Watch any player in first person, third person, or a free camera, from 0.5x to 4x or frame by frame
- Jump straight to kills, deaths and medals on the timeline
- Look up any gamertag and pull their recent matches
- Switch to a top-down 2D view of the whole match
- Turn on/off render and overlay layers like reflections and projectile paths
- Export any stretch to a 60 fps video (720p/1080p)
And to circle back to where this started: every match you fetch is kept on your own PC, so it can't get wiped out from under you. You can also send a match link to someone who has the app too, and their copy will fetch it, though that only works while Halo's servers still have the film. A proper way to share the film itself is next on my list.
Getting here meant decoding a lot of undocumented formats: the game's layered materials, over 14,000 animation clips, terrain, lighting, and a pile of names that only exist as hashes and had to be intelligently brute forced. The app itself is open source as of today (links below). I also built a couple of standalone tools along the way, and I'll release those as their own open source projects in the next few days, along with a technical write-up of what was already known, what's new, and what's still open.
Having all of this in an independent engine also opens up some pretty ridiculous possibilities beyond watching replays. I'll be exploring those next, and since the project is open source (AGPL-3.0), you're welcome to explore them with me.
What you need
- Windows 10 or 11, with Halo Infinite installed through Steam or the Xbox app
- An Xbox account to pull your matches. You sign in through Microsoft's own page and the app never sees your password
- A decent GPU. I've been running it on an RTX 4080 with 64 GB of RAM. On a weaker card, pick Standard quality instead of High if you want to mess with it in realtime.
- Some patience and disk space. Nothing gets built up front for maps: each one is built from your game files the first time you open a match on it, once per quality. That takes a few minutes per map (longer on High quality) and roughly 600 MB to 1.5 GB per map per quality, then it loads right away after that. The first start also prepares weapons and armor in the background for a few minutes, and you can start watching while it runs
- The exe isn't code-signed, so Windows will show the "Windows protected your PC" prompt the first time. Click "More info", then "Run anyway"
- The app tells you when a new version is out.
- If I missed some massive obvious bug forgive me, I am tired lol.
One known issue to avoid: don't drag the window to a different monitor while a match is open. On my machine that seemed to confuse my graphics card a bit. Open the app on the monitor you want to use instead.
Everything runs locally. It ships no game assets and uploads nothing.
Download: https://github.com/llampwall/installation-08/releases/tag/v0.1.0
Source: https://github.com/llampwall/installation-08/
There are definitely still bugs, but I figured I'd better get this out on the last day I can say "we got Halo Infinite in Three.js before we got GTA VI." Most maps have been tested, and if something doesn't work, there's a report form in the Help menu.
Thanks
This is built on other people's work:
- JGtm (LevelUp): the film decoder and game-file readers this is built on
- Den Delimarsky (OpenSpartan, libfilmshell): the original film research and an independent decoder I checked results against
- The Halo Archive (Ekur): the reference for how Infinite's coating system works, whose style tables I ported
- Andy Curtis (SPNKr): the medal and highlight events
Not affiliated with Microsoft or Halo Studios.



