Player's guide

How to play with bots in your offline Halo: The Master Chief Collection custom games, and how to use every tool.

Start a match

Offline custom games only, with Easy Anti-Cheat off. The mod will not run with anti-cheat on and never touches matchmaking, the Xbox network or Steam's online services.

  1. Press Play in the launcher. When Steam asks how to start MCC, choose the option with anti-cheat off.
  2. In MCC open Multiplayer > Custom Multiplayer and pick Halo: CE, Halo 2: Classic, Halo 2: Anniversary, Halo 3, Halo: Reach or Halo 4. For bot teammates against the Covenant, open Firefight > Halo: Reach Custom Firefight or Halo 3: ODST Custom Firefight.
  3. Select the BOTS tile next to START (or press B) and pick your bots.
  4. Pick a map and game type, then START. The bots join a few seconds after the match loads.

Up to 15 bots join, because a match holds 16 players. Bots show on the scoreboard as real players: they move, aim, strafe, jump-shot, take power weapons, drive and fly vehicles, play the objective and call out to their team.

The BOTS panel

The BOTS panel lists the exact bots that join your next match, by team.

Quick setup

Choose how many teams (2 to 8; Halo: CE has 2), how many bots on each, a difficulty and a play style, then Make bots.

Move bots

Drag a bot to another team, press Ctrl+Left / Right, or right-click it and choose Move to.

Edit a bot

Pick a bot to set its name, difficulty and play style. Del removes it. + Add bot and + Add team add more.

Whole roster

Balance teams, Shuffle teams, New names, Difficulty for everyone and Remove all.

Spectate

Spectate (no body) joins you as a free camera: WASD or the left stick, the mouse to look, Space up, Ctrl or C down, Shift fast. Not in Halo 2: Anniversary yet.

Settings

Each bot's profile with its 3D look, emblem and clan tag. Re-roll any of them.

Difficulty

Pick a difficulty for each bot, or one for everyone. Every difficulty aims the way a person does; what changes is how fast the bots react and how smart they play.

DifficultyHow it plays
EasyRelaxed games. Reacts a little slower than a person, rarely dodges and only jumps to get around. It doesn't plan: in Slayer it wanders, in objective games it heads straight for the objective. It mostly aims at your chest.
NormalAn average player. Strafes in fights, follows its team's plan, knows some routes and power weapons, uses equipment when it makes sense and goes for your head about half the time once your shields are down.
HeroicA good player. Reacts faster, strafes almost all the time and jump-shots, takes sneaky routes, knows where enemies spawn, checks its flanks and radar, and lands headshots nearly every time.
LegendaryA top player. The fastest reactions, constant strafing and jukes, holds the best spots, times every power weapon, uses every equipment trick and always goes for the head.
ScalingAdjusts to you. Legendary's smarts, but its reactions and aim change after every game so you and the bots finish about even. The panel shows it as a percentage, where 100% is a skilled player; lock it in the panel's Advanced tab.

Play styles

StyleWhat it does
RusherPushes fights and hunts people down; never camps.
CamperHolds power spots and defends; waits longer and crouches at its post.
ObjectiveTakes the flag, hill or ball, and skips far fights while it does.
GrenadierOpens most fights with a grenade and makes enemy vehicles its job.
GrudgeGoes after whoever killed it last.
SniperHangs back and defends from range.
FlankerAn all-rounder for now; side routes come with the difficulty.

Team directors

Every team of bots has its own director that knows only what its own team knows: where teammates are, what they saw and heard, the score and the clock. It calls out map positions, hands out roles every two seconds (in CTF: runner, escort, defender, hunter), pulls bots back to defend after a death near the flag, and sets the team's play by the score: careful when the enemy is about to win, all in when behind late.

Nothing shows over the game. Every decision is in the Observer's event feed.

Map the maps (LiDAR)

Bots play better on a map they have mapped: every floor, height, jump and drop. No scans ship with the mod, because each PC maps its own; until then bots use the map pack's height data. There are two ways to map:

LiDAR mode, in a match

Tick LiDAR mode in the BOTS panel and start any match: up to 16 players, all bots on your team, nobody fights. The bots walk every floor, measure heights and jumps, and record where they fall. They also visit every objective place the map has for all its game types.

Every jump you land that beats walking, and survive for 5 seconds after, is learned: from the next match every bot can use it. A notice in the game says when a jump of yours is learned. Floor you walk crouched works the same way (Halo 2: Anniversary and Halo 4).

The LiDAR Simulator, no game needed

See LiDAR Simulator.

LiDAR Simulator

Open the LiDAR Simulator from the launcher. It runs the bots on a map's level data and shows them mapping it in 3D: 16 bots map the floor and call jumps, and 8 aircraft fly the air above it.

  • Pick a map opens the map list; click a map. A map with other versions (Forge saves and MCC's built-in ones, such as MLG) opens a list of them; each is its own scan.
  • Every map maps them all in turn, each saved when it finishes; set Every run scans to Layouts for Every layout, a run of its own. Stopped part way, it goes on from where it stopped next time; Skip to next map moves on from one that takes too long. Tick Only those not scanned yet to run just the ones never scanned.
  • Speed: 1x (real time) to 16x, or Max. Big maps run slower than asked on most PCs; the panel shows the real speed.
  • Pause and Stop and save.
  • Click spots to cover (C): click where the bots should go first. A pink ring turns green once a bot gets there, or a red cross if no bot finds a way within 2 minutes.

A map runs until nothing new turns up for 45 seconds. Run it again to add to its scan. The simulator only knows the level data, so LiDAR mode in a real match fills in floor and steps the data lacks.

LiDAR Viewer

The LiDAR Viewer shows any map's scan in 3D, and your LiDAR match live while one runs. The header shows the map, whether the scan comes from matches or the simulator, and the view buttons.

  • Maps (L): one entry per map, by game. A map with layouts (Forge saves and MCC's built-in versions) opens a list of them. Remove scan starts a map over; the files move to backups\lidar.
  • Layers: switch deaths, jumps and paths, weapons, map features, windows and fences, air space, air paths, earlier runs and the grid on or off. Each shows its key.
  • View: drag or the arrow keys to turn, right-drag or Shift-drag to move, the wheel to zoom. Top view (T), Reset view (R), Follow you (F).

In a live scan bots are white dots and you are gold. Each step colours the floor by height. A jump turns magenta only if the bot lands and is still alive 5 seconds later, and a red cross marks a deadly edge.

Paint the nav

An advanced tool: mark by hand where bots may and may not walk, on a top-down view of each floor of a map.

  1. Pick a map. The first time, press Make the roofless view: it takes a few seconds.
  2. Move the Height slider to the floor you want; floors above it are cut away.
  3. Pick a layer and paint with the left mouse button. Right-drag moves the view and the wheel zooms. 1 to 8 pick layers, [ and ] change the brush.
  4. Save. Bots use it from the next match.
LayerMeans
WalkFloor bots may walk that the level data is missing.
BlockFloor bots must not walk.
Drive small, medium, largeGround that vehicles of that size may drive.
Fly low, Fly highOptional areas pilots keep to for attack runs and travel. Flying heights are set from the ground automatically.
Draw a jump (J)Click where a jump takes off, then where it lands. Shift-click a jump to delete it.

Observer and recordings

Open the Observer from the launcher and pick a game; a game in progress shows LIVE. Scrub the timeline and click a bot to see what it saw, thought, was told and did.

The You section puts your numbers beside the bots': how fast you aim at enemies, your fights, speed and strafing, where you spend your time, fight distance and who aims first, and with the Data collector on, your accuracy, damage and guns.

Data collector

Turn on Data collector in the BOTS panel to record your shots, guns and equipment too. It reads only what the game itself knows; your keyboard, mouse and controller are never recorded, and everything stays on your PC.

How many games are kept

The Observer keeps your newest 5 games and the last 15 minutes of each. Press Keep game to keep one for good; exported games and games with bug reports are always kept. Change both in Recording settings.

Share a game

In the Observer, pick a game and press Export game. It saves one zip with everything recorded in that game: every player marked person or bot, everything the bots did and decided, and MCC's post-game report. A copy also goes to logs\exports.

Gamertags and clan tags become Player 1, Player 2 and so on, and Xbox ids are always removed. Tick Keep names to keep the names. Import game opens a zip someone shared with you.

Report a problem

  1. In a match with bots, press F9 or choose Report bot bug in the pause menu at the moment it happens.
  2. Type what went wrong. The moment is saved with the recording around it in logs\bug_reports.
  3. Attach that folder, zipped, or the Observer's export of the game, to a bug report on GitHub.

Settings

Open Settings in the launcher. A change takes effect in a game that is already running and is kept through updates and Repair.

  • Halo: CE ragdolls (on): bodies in Halo: CE multiplayer go limp and fall like they do in Halo 2. Turn it off for Halo: CE's own death animations. Halo 2's ragdolls are always on.
  • Halo: CE ragdoll gravity (100%): how heavy bodies are as they fall, 50% to 150%.
  • Halo: CE keep dead bodies (on): a body stays where it fell until its player dies again. Off: the game clears bodies when it needs room, as it always did.

Troubleshooting

What you seeWhat to do
No BOTS tile in the lobbyMCC was started with anti-cheat on: quit it and press Play again, choosing anti-cheat off. Or MCC updated since this version of the mod: check for a newer release.
The launcher says Windows Security removed inject.exeThe Windows Security exclusion is missing. Restore inject.exe from Windows Security > Protection history, then run the installer again with the exclusion ticked, or add the install folder's native\bin under Virus & threat protection > Manage settings > Exclusions.
Bots do not joinLook in logs\brain.txt (Open the install folder in the launcher), and attach it to a bug report.
The game stutters with many botsUse fewer bots or a smaller map: the bots think on one CPU core. See How many bots can my PC run?
Another mod is installed (ReShade, an ASI loader...)The launcher lists files from other mods that can clash and offers to start without them for one session.
The game is not found, or the wrong copy of MCC is usedIn the launcher, Game folder > Choose folder and pick your MCC folder (the one with MCC, halo1, halo3... in it), or paste its path and press Use. Run Repair after switching to another copy.
A 3D bot, picture or effect is missing or brokenPress Repair in the launcher: it builds every part again. Also after installing more MCC games.

Which copy of MCC is used

  1. The HB_MCC environment variable, if it is set.
  2. The folder you chose under Game folder in the launcher. It is kept through updates and Repair.
  3. The copy Steam has installed, in any of your Steam libraries.

Play starts Steam's own copy through Steam. Any other copy starts directly from its folder with anti-cheat off; Steam must be running and signed in. If a copy is already running, the bots load into that one.

Where things are

Press Open the install folder in the launcher.

FolderHolds
maps\<map>Each map's knowledge (callouts, positions, objects), its LiDAR scan and what the bots learned there.
logsThe bots' log, recordings, bug reports and exports.
native\binThe mod itself, the BOTS panel's settings and pictures, and the 3D bots.
userYour settings, kept through updates and Repair.
backupsRemoved LiDAR scans, ready to copy back.

How many bots can my PC run?

More bots than your PC can think for do not crash the game. They get less smooth.

  • Each bot is a small player your PC has to think for, 30 times a second: what it sees, where it walks, where it aims.
  • The thinking happens on the processor (CPU), on one core. A fast single core matters most. More cores do not add bots.
  • When there are more bots than that core can think for in time, every bot thinks later. You see slower reactions, jerkier aim and movement, and plans that lag behind the match. The bots are not made dumber on purpose. Their thinking just arrives late.
  • Big open maps are much heavier than small ones. Now and then a bot searches a large map for a route or a good spot, and all the bots wait for that one search.

Your PC's number

Your PC, in the launcher's First-time setup box, shows your PC's specs (read on your PC, sent nowhere) and what it runs in each game once setup is done. The numbers come from a two-second speed test. For each map size it shows the most bots to use before they get sluggish: with more, it can no longer give every bot its 30 thoughts a second, so they react late and move in jerks. That is not a crash limit. It warns you when your saved match has more bots than the smooth count, and while a match runs it says whether the bots are at full speed. Run the test again repeats the test, for example after plugging in a laptop. The BOTS panel in the game shows the count for each game too.

What we measured

On the test PC, an 8-core desktop CPU from 2024 with one of the fastest single cores you can buy. The numbers are how much of each thinking step the bots used, measured without the game running. In a real match add about a quarter. 100% or more means the bots fall behind.

BotsEasyNormalHeroicLegendaryHow it feels
410%11%10%9 to 15%Smooth
820%25%24%21 to 22%Smooth
1228 to 31%45%32%31 to 39%Smooth
16, a full lobby40 to 65%52 to 68%41 to 48%43 to 57%Smooth on small and medium maps. On the largest maps the bots often freeze for a moment, a tenth of a second to nearly a second

A PC whose single core is half as fast uses twice these numbers: it runs smoothly up to about 11 bots, and the bots get sluggish from 14.

If the bots feel choppy

  1. Use fewer bots. This helps the most.
  2. Pick a smaller map. A full lobby on the largest maps is the heaviest thing you can ask for.
  3. Close other heavy programs, above all ones that keep the processor busy.
  4. On a laptop, plug it in, then press Run the test again.
  5. Have 16 GB of memory for the largest maps. The bots can use up to 4 GB there.

What does not help: a lower difficulty. Easy bots cost the PC as much thinking as Legendary ones.

System requirements

MinimumRecommended
Windows10, 64-bit, or Linux / SteamOS with Proton11, 64-bit
GameHalo: The Master Chief Collection on Steam, Easy Anti-Cheat off
CPU4 cores, one as fast as an Intel Core i5-8400 or AMD Ryzen 5 36006+ cores, one as fast as an AMD Ryzen 5 5600X or Intel Core i5-12400
Memory8 GB16 GB
GraphicsMCC's own minimumMCC's recommended
StorageAbout 2.5 GB beside MCCThe same on an SSD

The bots think on one CPU core, so a fast single core matters most; fewer bots need less. See How many bots can my PC run?

Uninstall

Press Uninstall at the bottom of the launcher, or use Windows Settings > Apps > Installed apps > Project Proving Grounds > Uninstall. It removes the Windows Security exclusion and asks whether to keep your LiDAR scans, learned map data and recorded matches.

Linux and Steam Deck

MCC runs on Linux and SteamOS through Proton, and so does the mod. Linux support is new: please report anything that doesn't work.

  1. Install MCC through Steam, start it once, then quit it.
  2. Download ProjectProvingGrounds-Linux from the releases page and unpack it.
  3. In a terminal in the unpacked folder, run ./install.sh. It finds Steam and MCC, copies the mod and runs the first-time setup.
  4. Paste the line it prints into Halo: The Master Chief Collection > Properties > General > Launch Options in Steam.
  5. Press Play in Steam (Game Mode works) and choose the anti-cheat off option.