Skip to content

Latest commit

 

History

History
60 lines (42 loc) · 3.1 KB

README.md

File metadata and controls

60 lines (42 loc) · 3.1 KB
Raw

License: MIT X (formerly Twitter) Follow

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.