Reach-Randomiser

A dynamic C# console application leveraging managedblam to modify tags in Halo Reach's mod tools, introducing a new dimension of unpredictability by randomizing enemies and their weapons.

Use of this tool requires knowledge of the Halo Reach Editing Kit

You can use a pre-generated version of this mod using the steam workshop! Steam workshop link

Program Steps

• Load the scenario files e.g. m10, m20, m30
• Add all vehicles, characters and weapons to each scenarios palette.
  • For weapons and vehicles, this is also done on the scenarios resource files e.g. m10/resources/m10.scenario_vehicles_resource
• Loop through the designer zones which are used to load resources at specific points in the level to save memory on initial load.
  • Without this, some enemies, weapons and vehicles would not spawn until you got half way through the level.
• Get all the squads and loop through each of their cells.
  • If it has a template, it removes it.
  • Generates random weapons, characters and vehicles for the cells whilst retaining the original enemy count.
  • Your average Squad cell which is not a Guta/Hunter/Engineer or Vehicle will have a selection of 8 different enemies and up to 5 different weapons that they can spawn with.

Prerequisites

• .NET Framework 4.8: Ensure you have .NET Framework 4.8 installed on your system.
• Halo Reach Editing Kit: This tool requires the Halo Reach Editing Kit (HREK) to be installed and properly set up.

Installation and Usage

1. Extract HREK: Begin by extracting a fresh copy of HREK.7z.
2. Run Reach-Randomiser: Execute the Reach-Randomiser program. If necessary, adjust the default path of your HREK installation in the main function.
3. Package Scenario Files: Package each scenario file using the provided tools in the HREK.
4. Enjoy Randomized Maps: The generated map files will now feature randomized enemies, enhancing the unpredictability and replayability of the game.

Roadmap (TODO)

• Optimization: Refine and streamline the main function for better performance and readability.
• Comprehensive Documentation: Create detailed documentation for ease of understanding and contribution.

Contributing

Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Acknowledgments

• A thanks to the HaloMods Discord community and the contributors at c20.reclaimers.net for their brilliant documentation.
• A shoutout for HaloRuns speedrun community for enabling my Halo addiction.
• This project would not be possible without it.

---