Guide

Game modes

Eight scripted game modes come with the game: Gun Game, Growth, One in the Chamber, Zone Control, Flood Infection, UNSC vs Covenant vs Flood, UNSC vs Covenant: Reach and Conquest. Each one is a single text file you can play, change, share or host. Only the host needs it: players just join.

New in 0.10Conquest is new: squads, tickets, and a map of the battle to choose where you deploy. The Flood join UNSC vs Covenant as a third faction, its picker has a second page of other games' characters, and UNSC vs Covenant: Reach brings the battle to Reach's maps with Reach's own characters. Every bundled mode is now one Megalo file, and the game type picker gathers them all on a Megalo card.

8game modes included, ready to play or change
3factions in UNSC vs Covenant vs Flood, any two to start
108classes in the two faction battles, each with its own character and loadout
64teams a mode can have, with names and colors of its own

The modes

The game installs these eight in the Project Reclaimer folder of your Game Modes folder. You find them all on the Megalo card of the game type picker, and each under the game type it plays. Conquest plays Territories; the others play Slayer.

Gun Game

Work through all 24 of Halo 3's weapons, from the Spartan Laser down to the Energy Sword. Each kill moves you up a weapon and earns a point; a beat-down earns nothing, and being assassinated costs you a weapon and a point. The first kill with the Energy Sword wins the round.

Growth

Everyone starts tiny, at a tenth of normal size, health and damage, with two random weapons. A kill adds your victim's size to yours, up to three times normal, so big targets are worth more. Any death shrinks you back to a tenth.

One in the Chamber

A Magnum with one bullet, and every hit kills. Each kill, melee included, earns one more bullet; miss and you're down to melee. Three lives each and no shields.

Zone Control

King of the hill for everyone at once. The hill appears where the first player spawns, with a Shotgun beside it. Stand in it alone to score, faster and with a white aura while you hold it; a second player in the hill stops the scoring for both.

Flood Infection

Survivors try to outlast a three-minute round while the infected play as campaign Flood bodies. Only a lethal bite from an Infection Form converts a survivor. A carrier's melee sets off its self-destruct.

UNSC vs Covenant vs Flood

Three factions of campaign characters on multiplayer maps. Choose a class before each life, earn points for stronger ones, and protect your faction's limited reinforcements. See how to play.

UNSC vs Covenant: Reach

The same battle on Halo: Reach's maps, with Reach's own characters and weapons: Army troopers, ODSTs and Spartans against Grunts, Jackals, Skirmishers, Drones, Engineers, Brutes, Elites, Hunters and a Gúta. See how to play.

Conquest

Two teams, five classes, squads of four. Capture Halo 3's territories to bleed the enemy's tickets, and choose where to deploy on a map of the battle: your base, a territory, your squad or its beacon. See how to play.

ModeTo winWhen you dieSet up for you
Gun GameA point per weapon. The kill with the Energy Sword, the 24th point, wins the round; the most points over three rounds wins the game.You keep your weapon. A melee kill from behind takes you back one weapon and one point.Free for all, 3 rounds, no time limit, infinite ammo, no weapons or vehicles on the map, no pickups or grenades.
GrowthA point per kill. The most points over two rounds wins.Back to 10% size, health and damage.Free for all, 2 rounds of 10 minutes, two random starting weapons, the map's own weapons, no vehicles.
One in the Chamber25 kills.Back to one bullet.Free for all, 1 round of 10 minutes, 3 lives, no shields, no weapons or vehicles on the map, no pickups or grenades.
Zone Control30 points, earned only in the hill. Kills score nothing.You lose the hill and its bonus until you get back in.Free for all, 1 round of 10 minutes, the map's own weapons and vehicles.
Flood InfectionSurvivors last three minutes; the infected win when no survivors remain.A lethal Infection Form bite converts a survivor. The infected get a random Flood body each life.Teams, 3 rounds, Shotgun and Magnum for survivors. Two living players start the outbreak countdown. Late arrivals join the infected.
UNSC vs Covenant vs FloodBe the last faction with reinforcements, or have the most when the ten-minute battle ends.Your faction loses a reinforcement. Choose a class for your next life.Three faction teams, campaign characters, third-person camera, 5-second respawn.
UNSC vs Covenant: ReachBe the faction with reinforcements left, or have the most when the ten-minute battle ends.Your faction loses a reinforcement. Choose a class for your next life.Two faction teams on a map of Reach's, Reach's characters and weapons, 5-second respawn.
ConquestRun the other team out of tickets, or have more when 30 minutes are up.Your team loses a ticket, unless a Medic revives you. Choose a class and a place to deploy.Two teams, Halo 3's Territories, 10-second respawn, 250 tickets each.

Modes with options. Open Game Options, then the game type's rules, such as Slayer Rules, and find Custom Mode Options. Each option moves between limits its author set:

ModeOptionDefaultRange
Zone Controlpoints_per_second11 to 10
Flood Infectioninitial_infected11 to 8, always leaving a survivor
Flood Infectionround_seconds18030 to 900
Flood Infectionwarmup_seconds100 to 60
UNSC vs Covenant vs Floodpoints_per_kill501 to 1,000
UNSC vs Covenant vs Floodreinforcements15010 to 1,000
UNSC vs Covenant vs Floodround_seconds60060 to 3,600
UNSC vs Covenant: Reachpoints_per_kill501 to 1,000
UNSC vs Covenant: Reachreinforcements15010 to 1,000
UNSC vs Covenant: Reachround_seconds60060 to 3,600
Conquesttickets25010 to 2,000
Conquestbleed_seconds31 to 30
Conquestdeath_cost10 to 10
Conquestround_seconds1,80060 to 3,600
Conquestsquad_size42 to 8
Conquestsquad_spawn_seconds50 to 30

Zone Control's hill is a ball that reaches 8 Forge units out from its middle, with no visible edge: follow the Hill distance row on your HUD, which counts down in feet as you get closer. While you're in it alone, a Controlling hill row fills up to each point and you move at 125% speed with a white aura.

Gun Game's ladder runs from the weapon with the hardest-hitting shot down: Spartan Laser, Rocket Launcher, Shotgun, Missile Pod, Sniper Rifle, Beam Rifle, Brute Shot, Fuel Rod Gun, Mauler, Battle Rifle, Machine Gun Turret, Magnum, Plasma Cannon, Carbine, Plasma Rifle, Spiker, Assault Rifle, Flamethrower, Plasma Pistol, SMG, Needler and Sentinel Beam, then the Gravity Hammer and the Energy Sword. Your score is always the number of weapons you've completed, so the scoreboard shows who's furthest along. On the last two weapons, melee attacks count, since melee is what they do. A kill made after you died, with a grenade or rocket still in flight, counts too: you respawn with the next weapon. Drop a turret, the Missile Pod or the Flamethrower by switching weapons and you get it straight back.

In Growth, your size is also your damage and your health: at 10% you deal a tenth of normal damage and can take a tenth as much, at 300% three times both. Two 10% players fight each other like two normal players. A fall or a suicide shrinks you as well.

The game keeps the bundled modes up to date by itself. A mode you never changed gets its new rules the next time you open Host Game. A copy you edited is kept as it is. To get the new version, move your copy out of the Game Modes folder and choose Refresh: the game puts a missing bundled mode back.

Coming from 0.9? Your own modes move with your player folder and keep working. The bundled JSON modes you never changed are replaced by their .rmeg versions; one you edited stays beside them, under the same name unless you rename it.

UNSC vs Covenant vs Flood

Fight as campaign characters on a multiplayer map, in up to three factions. The factions with players fight it out: any two start the battle, and a faction nobody joined sits it out. The host needs Halo 3's campaign installed; see what a mode needs.

  1. Choose the modeIn Host Game, open Game Type, select the Megalo card and choose UNSC vs Covenant vs Flood. Pick a multiplayer map and start the game. The lobby's teams are the factions, so players choose one there.
  2. Choose a character for each lifeClick a class card before you spawn. The class picker opens when you join and, after each death, once the respawn countdown ends. Every faction has free classes. Enemy kills earn deployment points you can spend on stronger ones next life.
  3. Fight for your factionUse the close third-person camera and aim with the crosshair. Each death costs your faction a reinforcement. A faction with none left deploys nobody until the battle ends. When one faction is left standing, or the ten minutes are up, the faction with the most reinforcements wins; a tie is a draw.
A class picker with a card for each class, showing its loadout and cost
The class picker: dimmed cards cost more points than you have.

The mode's own Megalo script draws the class picker, the reinforcement bars at the top of the screen and the status lines. The picker shows your faction's title, your deployment points and a card for each of your faction's classes. Cards you can't afford are dimmed, limited classes show how many of your faction are playing them out of the limit, and a line says why when a click can't buy a class. While you wait to choose, a line at the bottom left counts down to class selection; once deployed, it shows your points. Escape still opens the pause menu while you choose; Resume returns to the picker.

The classes

A purchase lasts one life, and unspent points carry over. Enemy kills earn 50 points, and every faction earns 25 points every 30 seconds during the battle, including while waiting to deploy. The kills of a carrier's infection forms count as the player's. At once is how many players of a faction can be that class at the same time.

UNSC classPointsLoadoutAt once
Marine RiflemanFreeAssault Rifle, 2 frag grenadesAny
Naval CrewmanFreeSMG, 1 frag grenadeAny
Marine Scout50SMG, Magnum, 2 frag grenadesAny
Marine Marksman150Battle Rifle, 2 frag grenadesAny
Marine Breacher150Shotgun, Magnum, 2 frag grenadesAny
ODST250Battle Rifle, SMG, 2 frag grenadesAny
Marine Heavy250Rocket Launcher, Assault Rifle, 2 frag grenadesAny
Marine Sniper250Sniper Rifle, Automag, 2 frag grenadesAny
ODST Recon250Silenced SMG, Automag, 2 frag grenadesAny
ODST Heavy300Shotgun, Rocket Launcher, 2 frag grenadesAny
Sentinel300Its own beam2
Sergeant Johnson400Battle Rifle, Shotgun, 2 frag grenades1
Spartan500Assault Rifle, Battle Rifle, 2 frag grenades1
Spartan Breacher500Assault Rifle, Shotgun, 2 frag grenades1
Spartan Recon550Battle Rifle, Sniper Rifle, 2 frag grenades1
Spartan Heavy550Rocket Launcher, Assault Rifle, 2 frag grenades1
Spartan Laser Specialist600Spartan Laser, Battle Rifle, 2 frag grenades1
Covenant classPointsLoadoutAt once
Grunt MinorFreeNeedler, 2 plasma grenadesAny
Grunt Heavy100Fuel Rod Gun, 2 plasma grenadesAny
Jackal ShieldbearerFreePlasma Pistol, 2 plasma grenadesAny
Jackal Carbine SpecialistFreeCovenant Carbine, 2 plasma grenadesAny
Jackal Sniper150Beam Rifle, 2 plasma grenadesAny
Drone50Plasma PistolAny
Brute Minor100Spiker, 2 spike grenadesAny
Elite Minor150Plasma Rifle, 2 plasma grenadesAny
Brute Jumper250Spiker, Mauler, 2 spike grenades2
Brute Captain300Brute Shot, Covenant Carbine, 2 spike grenades2
Elite Spec Ops300Covenant Carbine, Energy Sword2
Elite Spec Ops Dualist300A Plasma Rifle in each hand1
Elite Major350Plasma Rifle, 2 plasma grenades2
Brute Chieftain450Gravity Hammer, Spiker1
War Chieftain Heavy450Fuel Rod Gun, Plasma Rifle, 2 plasma grenades1
Arbiter600Covenant Carbine, Energy Sword, 2 plasma grenades1
Hunter700Hunter particle cannon1
Flood classPointsLoadoutAt once
Combat FormFreeAssault Rifle, tentacle meleeAny
Carrier Form50Melee bursts it into infection forms3
Stalker Form100Its own meleeAny
Elite Combat Form150Plasma Rifle, tentacle meleeAny
Brute Combat Form200Spiker, tentacle meleeAny
Ranged Form250Its own spines2
Tank Form400Its own melee1
  • Durability, on top of a character's own health: 100% for Marines, Naval Crewmen and Carrier Forms, 150% for ODSTs, Sentinels, Drones, Combat, Stalker and Ranged Forms, 200% for Grunts, Jackals, Sergeant Johnson and Elite Combat Forms, 250% for Brute Minors, Jumpers, Captains and Brute Combat Forms, 300% for every Spartan, Elite and Chieftain, the Arbiter and the Tank Form, and 400% for Hunters.
  • Shields: Spartans, Sentinels, Brute Minors, Jumpers and Captains, Elite Minors and Spec Ops, and Elite Combat Forms have normal shields. Elite Majors, Chieftains and the Arbiter have double shields. Captains, Majors, Chieftains and the Arbiter get another 25%.
  • Health: the three ODST classes and the Grunt Heavy have 125% health, and Hunters 200%.
  • Seats: Grunts and Jackals man turrets but never drive or ride in a vehicle. Sentinels, Drones, Hunters and the Carrier, Stalker, Ranged and Tank Forms take no seat at all. A seat your class can't use shows Halo 3's “can't use” prompt.
  • Bodies: the Spartan classes play campaign Master Chief, and nobody picks up weapons. Each class keeps what its body does: the Sentinel fires its beam, the Brute Jumper flies while you hold jump in the air, and a Carrier Form's melee bursts it into infection forms that fight for you.
  • Flying: as a Sentinel or a Drone, jump climbs and crouch descends. The Sentinel is always in the air and moves where you look; the Drone takes wing when you hold jump and walks again once it's back on the ground.

Other games' characters

The picker has a second page: click MORE CHARACTERS for the characters of Halo: Reach, Halo: Combat Evolved and Halo 2, and BACK for the first page. Each plays in its own game's body, with that game's health, shields and movement. A card shows only when the game can bring that character onto the map: its game must be installed in MCC, and the host's Other games' characters setting, on by default, must be on. A character the map can't have is left off the page, so on some maps the page is short.

UNSC classPointsLoadoutAt once
Noble Spartan450Halo: Reach's Spartan: Assault Rifle, Magnum, 2 frag grenades2
Army Trooper50Halo: Reach's trooper: Assault Rifle, 2 frag grenadesAny
Master Chief (CE)450Assault Rifle, Magnum, 2 frag grenades1
Marine (CE)FreeAssault Rifle, 2 frag grenadesAny
Spartan (Halo 2)400Battle Rifle, SMG, 2 frag grenades2
Master Chief (Halo 2)500Battle Rifle, SMG, 2 frag grenades1
Marine (Halo 2)FreeSMG, 2 frag grenadesAny
Covenant classPointsLoadoutAt once
Elite (Reach)450Plasma Rifle, Plasma Pistol, 2 plasma grenades2
Skirmisher100Plasma Pistol, 2 plasma grenadesAny
Grunt (Reach)FreePlasma Pistol, 2 plasma grenadesAny
Jackal (Reach)FreePlasma PistolAny
Brute (Reach)150Spiker, 2 spike grenadesAny
Elite (CE)150Plasma Rifle, 2 plasma grenadesAny
Grunt (CE)FreePlasma Pistol, 2 plasma grenadesAny
Jackal (CE)FreePlasma PistolAny
Hunter (CE)700Its own cannon1
Arbiter (Halo 2)600Covenant Carbine, Energy Sword, 2 plasma grenades1
Elite (Halo 2)150Plasma Rifle, 2 plasma grenadesAny
Brute (Halo 2)250Brute ShotAny
Grunt (Halo 2)FreeNeedler, 2 plasma grenadesAny
Jackal (Halo 2)50Covenant CarbineAny
Drone (Halo 2)50Plasma PistolAny
Hunter (Halo 2)700Its own cannon1
Flood classPointsLoadoutAt once
Combat Form (CE)FreeAssault RifleAny
Elite Combat Form (CE)150Plasma RifleAny
Carrier Form (CE)50Its own burst3
Combat Form (Halo 2)FreeShotgunAny
Elite Combat Form (Halo 2)150Plasma RifleAny
Carrier Form (Halo 2)50Its own burst3

Skirmishers, and the Grunts and Jackals of every game, man turrets but take no vehicle seat. Hunters, Halo 2's Drone and the carrier forms take no seat at all.

The values are in the mode's file, faction-battlefront.rmeg: the class list in its header, and health, shields and seats in the last rule of its script. To build your own, see classes in the Megalo guide. Team selection, the scoreboard and the final standings show UNSC, Covenant and Flood.

UNSC vs Covenant: Reach

The same battle for Halo: Reach's maps, with Reach's own characters and weapons. Two factions: the UNSC's Army troopers, ODSTs and Spartans against the Covenant's Grunts, Jackals, Skirmishers, Drones, Engineers, Brutes, Elites, Hunters and a Gúta. It plays as UNSC vs Covenant vs Flood does: choose a class before each life, earn 50 deployment points a kill and 25 every 30 seconds, and the faction that runs out of its 150 reinforcements, or has fewer when the ten minutes are up, loses.

  1. Choose the modeIn Host Game, pick one of Halo: Reach's maps, open Game Type, select the Megalo card and choose UNSC vs Covenant: Reach. The lobby's two teams are the factions.
  2. Choose a class for each lifeThe class picker lists your faction's classes on one page. Each character keeps Reach's own health, shields and movement.
  3. Fly what fliesAs a Sentinel, a Drone or an Engineer, jump climbs and crouch descends. The Sentinel and the Engineer are always in the air and move where you look. A Drone walks until you hold jump, then takes wing, and walks again once you bring it down.

What it needs. The host needs Halo: Reach installed in MCC. The troopers and ODSTs, and the Covenant other than the Elites, are characters of Reach's missions: the game takes them from Reach's installed missions and Firefight maps. Without those, each faction plays its Spartans or Elites alone, and a free Spartan Recruit and Elite Recruit take the place of the free trooper and Grunt. The Sentinel is Halo 3's, and shows where Halo 3's campaign is installed. A class whose character the map can't have is left out of the picker.

UNSC classPointsLoadoutAt once
Army TrooperFreeAssault Rifle, 2 frag grenadesAny
Trooper Marksman100DMR, 2 frag grenadesAny
Trooper Breacher100Shotgun, Magnum, 2 frag grenadesAny
Trooper Grenadier150Grenade Launcher, Assault Rifle, 2 frag grenadesAny
Trooper Sniper200Sniper Rifle, Magnum, 1 frag grenade3
Trooper Heavy250Rocket Launcher, Assault Rifle, 2 frag grenades3
ODST200DMR, Magnum, 2 frag grenades4
Spartan Rifleman400Assault Rifle, Magnum, 2 frag grenades2
Spartan Marksman450DMR, Magnum, 2 frag grenades2
Spartan Breacher450Shotgun, Assault Rifle, 2 frag grenades2
Spartan Grenadier500Grenade Launcher, DMR, 2 frag grenades1
Spartan Sniper550Sniper Rifle, Magnum, 2 frag grenades1
Spartan Heavy550Rocket Launcher, Assault Rifle, 2 frag grenades1
Spartan Laser Specialist600Spartan Laser, DMR, 2 frag grenades1
Sentinel350Its own beam. It flies2
Spartan RecruitFreeAssault Rifle, 1 frag grenade. Only where no trooper can deployAny
Covenant classPointsLoadoutAt once
Grunt MinorFreePlasma Pistol, 2 plasma grenadesAny
Grunt Major50Needler, 2 plasma grenadesAny
Grunt Heavy150Fuel Rod Gun, 1 plasma grenade2
JackalFreePlasma Pistol, 1 plasma grenadeAny
Jackal Sniper150Beam Rifle, 1 plasma grenade3
Skirmisher50Plasma Pistol, 1 plasma grenadeAny
Skirmisher Marksman150Needle Rifle, 1 plasma grenadeAny
Drone100Plasma Pistol. It flies4
Drone Needler200Needler. It flies2
Engineer150No weapon. It flies2
Brute Minor100Spike Rifle, 2 plasma grenadesAny
Brute Captain250Concussion Rifle, Spike Rifle, 2 plasma grenades3
Brute Berserker450Gravity Hammer, Spike Rifle, 2 plasma grenades1
Brute Chieftain550Gravity Hammer, Spike Rifle, 2 spike grenades1
Elite Minor300Plasma Repeater, 2 plasma grenades3
Elite Officer400Needle Rifle, Plasma Pistol, 2 plasma grenades2
Elite Spec Ops450Energy Sword, Plasma Repeater, 2 plasma grenades2
Elite Ultra500Concussion Rifle, Plasma Rifle, 2 plasma grenades1
Elite General600Plasma Launcher, Energy Sword, 2 plasma grenades1
Hunter700Its own cannon2
Gúta650Its own claws. Five metres tall, for open ground1
Elite RecruitFreePlasma Repeater, 1 plasma grenade. Only where no Grunt can deployAny
  • Seats: Grunts, Jackals and Skirmishers man turrets but never drive or ride in a vehicle. The Sentinel, Drones, Engineers, Hunters and the Gúta take no seat at all.
  • The Gúta is five metres tall: it's for open ground, and fits through no door of an indoor map.
  • Options: points_per_kill, reinforcements and round_seconds, as in UNSC vs Covenant vs Flood.

The mode's file is reach-battlefront.rmeg: the class list in its header, and seats in the last rule of its script. Modes of your own can use the same characters and weapons on Reach's maps: see other games' bodies in the Megalo guide.

Conquest

Two teams fight over Halo 3's own territories, in squads and classes, for tickets. It plays on every map that has Territories objectives.

  1. Choose the modeIn Host Game, open Game Type and choose Conquest on the Megalo card. Pick a map with territories and start the game. Stand in a territory to capture it.
  2. Watch the ticketsEach team starts with 250. Every death costs its team one, and a Medic's revive gives it back. While one team holds more territories than the other, the other loses one every three seconds. A team out of tickets loses; when the 30 minutes are up, the team with more wins.
  3. Deploy where you chooseWhile you wait to respawn, the deployment map shows the battle from above: the territories in their holders' colors, your teammates where they are and your squad in green. Choose a class and a place on the panel or on the map. You can choose while the countdown runs, and you deploy as it ends.
The deployment map: the battle seen from above, with territories and deploy points marked
The deployment map: a class and a place to deploy, chosen on the panel or on the map.

You can deploy at HQ, your team's own spawn points, at a territory your team holds, beside a squad mate who has been out of combat for five seconds, or at your squad's beacon. If the place is gone when the countdown ends, you deploy at HQ. In split screen you get the class cards instead of the map.

Every player is put in a squad of up to four of their team. Classes use the game mode ability keys, X, 2 and 3 by default, and D-pad right, left and down on a controller:

ClassCarriesAbilities
AssaultBattle Rifle, Magnum, 3 frag grenadesA quarter more health.
MedicAssault Rifle, Magnum, 2 frag grenadesSpawns with a regenerator (Use equipment), and Ability 1 deploys another (45 s). Hold Ability 3 over a fallen teammate's body, marked with a cross, for two seconds to revive them there, as the class they were.
SupportSMG, Shotgun, 2 frag grenadesAbility 1 drops an ammunition case that refills teammates beside it (30 s); on a map without the case, the teammates beside you and you are refilled at once. Ability 2 gives them an overshield (25 s).
EngineerRocket Launcher, SMG, 1 frag grenadeAt most 3 a team. Spawns with a trip mine. Ability 1 deploys a power drain (45 s). Hold Ability 3 in or beside a vehicle to repair it while it still stands.
ReconSniper Rifle, Magnum, 1 frag grenadeAt most 2 a team. Ability 1 hides you for 8 seconds (30 s). Ability 2 marks the enemy in your sights for your team for 10 seconds. Ability 3 plants your squad's spawn beacon (30 s), which the enemy can destroy.

Every class is free. Only Engineers pick up Rocket Launchers, Spartan Lasers, Fuel Rod Guns and Missile Pods, and only Recons pick up Sniper and Beam Rifles.

The mode's file is bf-conquest.rmeg. The Megalo guide shows how it's built, and megalo-conquest.rmeg is a smaller example, tickets over territories without classes or squads.

Play one

  1. Host a gameChoose Host Game in the main menu.
  2. Pick the modeChoose Game Type. The Megalo card, after the game types, lists every Megalo mode with the game type it plays: click one to take it into the lobby. A mode also shows among the variants of its game type, such as Slayer. The lobby's Game Type row shows the mode's name.
  3. Pick a mapChoose Map: any multiplayer map, or one with territories for Conquest. For a first game, use one everyone has installed.
  4. Change the basics (optional)Game Options changes the time limit, score to win and lives as for any game type. Leave weapons, pickups and ammo as the mode has them until you've played it: the modes depend on them. A mode with settings of its own lists them under Custom Mode Options, in the game type's rules.
  5. StartIf the lobby runs a playlist, set Playlist to Off to play this one game. Players join from the Server Browser as usual. Choose Start Game.
The game type picker, with a card for each game type and a Megalo card after them
The game type picker: the Megalo card lists every Megalo mode.
  • Only the host needs the mode. The script runs on the host or dedicated server, and players who join see what it does through the game itself. They don't download or run it.
  • What a mode needs: Gun Game, Growth, One in the Chamber, Zone Control and Conquest play with the game's multiplayer maps alone. Flood Infection and UNSC vs Covenant vs Flood use campaign characters, so the host needs Halo 3's campaign installed: the game adds the characters to the map when the game starts. UNSC vs Covenant: Reach needs Halo: Reach, with its missions or Firefight maps for most of its classes. Players who join make the same map from their own files and download what they lack from the host. A mode's author lists anything else a mode needs.
  • Every round starts fresh: sizes, weapon stages, zones, timers and the numbers a script keeps all reset.
  • Films of a mode's games play back in Theater, those whose script gives players other bodies or places and removes objects included: the film keeps what the script did and does it again at the same moments. Films recorded before 0.10.7 still lack it.
  • In a playlist: in the playlist editor, add a game with the mode as its game type. In a playlist file, name it like any saved game type: { "map": "Guardian", "game": "Gun Game" }. See custom playlists.
  • On a dedicated server: the server gets the bundled modes in content/Game Modes/Project Reclaimer the first time dedicated check or dedicated runs. Name one in a playlist, or give a server map = "Guardian" and game = "Gun Game". See install, share and host.

Other games' game types

New in 0.10, with each game installed in MCC:

  • Halo: Reach's own: Host Game's GAME TYPE picker has a Halo: Reach card after the Megalo card, with the 418 multiplayer and Forge game variants MCC installs for Reach, by category and then name, each with its own description; the search finds one by its name or category. They play through the same Megalo interpreter as the modes above, on Reach's maps or any other, with their loadouts, starting weapons, armor abilities, traits, messages and round cards. The playlist editor lists them after Halo 3's game types.
  • Big games. Reach's game types keep running in games of up to 128 players, such as Slipspace's Fleet game types with around 120: a script's allowance of work grows with the players in the game, and it may keep 2,048 objects of its own at once. Scripts run several times faster in crowded games than in 0.10.6.
  • As in Halo: Reach. Nobody spawns until a Reach game type's loadout camera time has passed at the start of each round (10 seconds unless the game type says otherwise). A script sets health and shields in Reach's own numbers, hears of every vehicle and unit destroyed with the player Reach would credit, and writes a message's values as Reach does. See how Reach's game variants play.
  • Reach's maps play Halo 3's game types too.
  • Halo: Combat Evolved's and Halo 2's maps play their own game types, by their own rules: Combat Evolved's Slayer, Capture the Flag, Oddball, King of the Hill and Race, and Halo 2's Slayer, Capture the Flag, Assault, Oddball, King of the Hill, Juggernaut and Territories.
  • The modes above run on every game's maps. A mode that lacks something on a map, such as a character or an objective, goes without it there.
  • Characters cross games. A mode's classes can be characters of other installed games, on Combat Evolved's and Halo 2's maps too. Host Settings' Other games' characters, on by default, allows them, and Reach's Spartans and Elites also follow the host's Halo: Reach Spartans and Elites permission. Players who join then need that game.

Modes on Halo 3 and ODST maps, Reach's Invasion among them, bring Reach's objective items, the loadout weapons Halo 3 lacks (Invasion's plasma repeater, the DMR, the needle rifle and the rest), Invasion's territory alarms and missing announcer lines when Reach is installed and the host allows its content. Reach's armor abilities stay out there. A game type's flag, bomb or core keeps its team's color and can be picked up by those the game type lets take it. The map still needs the labels that mode expects. Reach content requirements and limits.

On a dedicated server, see every game in one playlist.

How a mode works

A mode is one text file, in the Megalo language that ReachVariantTool writes for Halo: Reach, with Halo 3 extensions. The file ends in .rmeg; ReachVariantTool's .rvt reads the same. It holds everything the mode is:

  • The mode header: a block at the top, in TOML, with the mode's name, the game type it plays, its rules and options, the settings hosts can change, its classes and more.
  • The script: what happens during the game, such as what a kill does, a timer, a class's ability, or a HUD drawn for each player.
zone-control.rmeg, shortened
-- Zone Control: one hill, where the first player to spawn stands, and a
-- shotgun beside it.
--[=[ mode
name = "Zone Control"

[rules]
score_to_win = 30
kill_points = 0

[options]
"rounds.teams" = 0
"rounds.limit" = 1
"rounds.minutes" = 10

[logic.options]
points_per_second = { value = 1, min = 1, max = 10 }
]=]

alias points = script_option[0]

The file plays as it is, with nothing to compile: put it in Game Modes, choose Refresh, and it's on the Megalo card. There's no script editor in the game; use any text editor, such as Notepad, TextEdit or Visual Studio Code. The Reclaimer Kit edits maps and tags, not modes.

Change a mode

The quickest start is a copy of a mode that works. This makes a slower Growth, where a kill adds half of your victim's size instead of all of it.

  1. Open the Game Modes folderIn Host Game, choose Game Type and then Open Folder. The bundled modes are in its Project Reclaimer folder.
  2. Copy GrowthCopy Project Reclaimer/growth.rmeg into Game Modes itself and rename the copy my-growth.rmeg. Leave the original alone: the game puts back any bundled mode that's missing, but never overwrites one you changed.
  3. Rename itOpen my-growth.rmeg in a text editor. Change name = "Growth" to name = "My Growth". That's the name the picker shows.
  4. Change the rewardFind killer.size += current_player.size. Numbers in Megalo are whole, and arithmetic is one step at a time, so add a line before it and change it:
    Part of my-growth.rmeg
    gained = current_player.size
    gained /= 2
    killer.size += gained
    Add alias gained = temporaries.number[1] beside the other aliases at the top, and save the file.
  5. Play itIn the game type picker, choose Refresh. My Growth is on the Megalo card. Select it and start a game with at least one other player.

After every change to the file, choose Refresh and select the mode again: the lobby keeps the copy it loaded, and a round that's running keeps its script until it ends.

If the mode isn't listed, the file has a mistake. mode-check says which line. For everything else, such as a new mode from nothing, classes, abilities or a HUD of your own, go to the Megalo guide, a tutorial first and the full reference after it.

Install, share and host

Install a mode

Put the file in your Game Modes folder, or any folder inside it, and choose Refresh in the game type picker. Open Folder there takes you to the right place:

SystemGame Modes folder
Windows%LOCALAPPDATA%\ProjectReclaimer\Game Modes
macOS~/Library/Application Support/ProjectReclaimer/Game Modes
Linux~/.local/share/ProjectReclaimer/Game Modes (or under $XDG_DATA_HOME)

The game reads Megalo sources (.rmeg, .rvt), saved game types (.json), and Halo 3 game variants (.bin). It also lists MCC's own and Workshop variants by itself. ElDewrito game variants put in the folder are converted when the game starts or on Refresh.

Share a mode

A mode is one file, so share the file. The other host puts it in their own Game Modes folder and chooses Refresh. Players who join them don't need it. Share your .rmeg, not your whole player folder: profile.json and stats-key.json hold your private keys.

Game Options → Save as Variant saves the mode as the lobby has it, script and game options together, as a new .json file in your Game Modes folder. The file gets a random name; rename it if you like. It carries your nickname as its author, which the loading screen shows. It's a Megalo mode like the source it came from, and stays on the Megalo card.

On a dedicated server

Copy the file into the server folder's content/Game Modes, then use it like any game type there:

dedicated.toml
[[server]]
name = "Gun Game"
port = 49178
map = "Guardian"
game = "Gun Game"

[[server]]
name = "Battle Royale"
port = 49179
variant = "content/Game Modes/megalo-battle-royale.rmeg"

Or name it in a playlist with "game": "Battle Royale". dedicated content lists the game types a server can name, dedicated check checks the mode along with the rest, and the server's log says when a mode's script runs into trouble. Campaign characters need the campaign maps in the server's game folder: see campaign files.

Modes also travel inside a mod: a .rmeg in a mod's folder under Mods is listed as well.

Test before you share

mode-check finds mistakes in the file, but not in how the mode plays. Play it with at least one other player and check:

  • The first spawn, several kills, and the respawn after each death.
  • A suicide, a fall off the map and a betrayal.
  • A second round, which should start everyone over.
  • A player leaving and joining again, and a late join: traits, bodies, objects and the HUD on the joining player's screen.
  • The score, lives and time limit ending the game the way you meant, and the right winner.
  • Melee rules: a beat-down from the front, one from behind, and a sword or hammer kill.
  • A kill made after dying, with a grenade still in flight.
  • Timers: one that should repeat fires more than once, and one on a player keeps going after they die.
  • Zones: an empty zone, one player inside, two players inside, and a player dying inside.
  • Teams: joining, leaving, changing teams and a team going empty.
  • Objects: a placed object on several maps, its size, and that it's gone in the next round.
  • Script menus: click the widgets from the joined player's PC, not only the host's.
  • Classes: a full class, a class the player can't afford, and a player who joins mid-game.

Limits and safety

The language's limits are in the Megalo guide. In short: a script holds 256 KB with its source, an event takes at most 65,536 steps in a game of up to 16 players and more in bigger games, and a mode has 32 HUD widgets and 2,048 objects of its own at once.

If a script fails while a game runs, such as a division by zero or a call out of range, the game goes on without it for the rest of the game: its sizes, HUD and rules go, and the host's log says why and at which line and column of the script. Fix the file and start a new game.

What a script can't do

A script can only change gameplay. The language has no way to reach files, the network, other programs or the console, and it runs inside the game's own interpreter, never as code on your PC. So a mode from someone you don't know can change how your game plays, and nothing more:

  • Only the host runs it. Players receive what it does through the game, never the script. A click or a key press sends the host only which one it was.
  • Every event has a step limit, so no script can run forever or hold up the game.
  • A script names only what the game offers: its own calls, and the map's own objects and sounds by path. No addresses, no other game data.
  • Text a script shows is plain text.
  • The game checks each file when it lists it, the parts that never run included, and leaves out one that asks for anything it can't play.

A mode can still be unfair within those limits: try one before you host it for others.

Older JSON modes

Modes used to be written in JSON. Older JSON modes keep working: the game lists and plays them as before, on the host's own interpreter, and mode-check reads them. New modes are written in Megalo, which does all they did and much more.

Troubleshooting

ProblemWhat to do
The bundled modes aren't listedIn the game type picker, choose Refresh and select the Megalo card. The game installs them each time it scans your content.
My mode isn't listedCheck the file ends in .rmeg, not .rmeg.txt (turn on file name extensions in your file manager), that it's inside Game Modes, and run mode-check: files with mistakes are left out, and the log has a Skipped content file line saying why.
Two modes have the same nameGive your copy its own name in its header, or move the extra copy out of Game Modes.
My changes don't showSave the file, choose Refresh, select the mode again, and start a new game.
A deleted mode came backThe game puts the bundled modes back when they're missing. To get an original back after you changed it, move your version out of Game Modes and choose Refresh.
A bundled mode still has its old rulesYou changed your copy, so the game kept it instead of updating it. Move it out of Game Modes and choose Refresh.
The lobby plays something elseA playlist chooses the games. Set Playlist to Off, or add your mode to it.
UNSC vs Covenant vs Flood waits and nothing happensIt starts when two factions have players. Move a player to another faction in the lobby.
Players stay Spartans in a class modeThe host doesn't have the campaign map that character comes from. Install Halo 3's campaign, or copy the campaign maps to a dedicated server.
UNSC vs Covenant: Reach offers only Spartans and ElitesThe other classes come from Halo: Reach's missions and Firefight maps, on a map of Reach's. Install Reach's campaign or Firefight in MCC, and host it on one of Reach's maps.
The second page of characters is short or emptyA card shows only for a character the map can have: that character's game must be installed, and the host's Other games' characters setting on.
The class picker doesn't openIt opens once the respawn countdown ends. A faction out of reinforcements deploys nobody until the battle ends.
Conquest has no territoriesPick a map with Territories objectives. A map that has none leaves nothing to capture.
I can't find Zone Control's hillIt's where the first player spawned this round, and it has no visible edge. Follow the Hill distance row on your HUD down.
An ability key does nothingCheck it under Game Mode Abilities in Settings, and that no chat or menu is open. The keys do nothing in modes that don't use them.
The script stopped during a gameLook in the host's log for game mode '...' stopped:, the reason and the line and column it stopped at, fix the file and start a new game.

The game's log is Logs/client.log in your player folder, beside Game Modes; a dedicated server's is data/<server>/server.log. Lines about modes start with [modes], [engine] game mode or, for files left out, Skipped content file. When you report a problem, include the mode's file, the map, and what happened in the game before it. For script errors, see the Megalo guide's troubleshooting.