1509 Hotfix

This is a fix for batch extraction saving to the wrong location. See below for the full v2.0 change log.

Important notes on upgrading from versions earlier than 2.0:

• This version requires .NET Desktop Runtime 7 to be installed which you can get from here under the ".NET Desktop Runtime 7.0.x" section
• If you already had a previous version installed then updating to 2.0+ will reset your settings - if you want to keep your settings you should make a copy the settings.json file before updating, then restore it after updating
  • The settings file is located in %appdata%\Gravemind2401\Reclaimer
• The default install folder has changed from C:\Program Files (x86)\Gravemind2401\Reclaimer to C:\ProgramData\Gravemind2401\Reclaimer
• The Plugins folder has changed from C:\Program Files (x86)\Gravemind2401\Reclaimer\Plugins to %appdata%\Gravemind2401\Reclaimer\Plugins
  • If you have an existing plugins folder it will not be moved automatically - you will need to move it manually!
• If you have a previous version installed and want to install into the same folder then you will need to uninstall the old version first
  • Installing over an existing older version may not update all the files correctly, so a clean install is recommended

Change Log

General Bug Fixes and Improvements

• New app icons thanks to Sierra-D421
• Added a button in the meta viewer to open tag references
• Added a function in the meta viewer to export tag data to a JSON file
• Added support for palletized bump maps in Halo 1
• Added support for MCC Halo 1 classic BSPs
• Fixed backwards face winding on Halo 1 BSPs
• Added support for Halo 3 decorator models
• Fixed a chicken and egg situation where you couldn't change the FFmpeg path because FFmpeg wasn't found
• You can now extract sounds that would previously give an error saying "segmented sound data"
  • This affected a lot of sfx related sounds
• Fixed Red and Purple themes not working
• Added a bunch of new themes from Visual Studio 2022
  • The old themes can still be accessed from the menu under Themes > 2015

Bitmap Improvements

• Fixed channel toggles in the bitmap viewer not working properly for a8r8g8b8 and x8r8g8b8 bitmaps
• The bitmap viewer will now display the bitmap format and dimensions in the footer
• Added support for a handful of additional bitmap formats
• Improved bitmap decoding performance for a number of formats
• Fixed slight color accuracy issues in certain bitmap formats

Improved Support for Halo CEA

• Meshes are now scaled and positioned correctly
• Added support for skinning/rigging
• Added support for vertex normals
• Added support for .s3dpak and .ipak files from MCC (no decompression required)

Improved Support for Halo 5

• Added support for additional models, such as the MP spartans
• Added support for skinning/rigging/vertex weights
• Added support for vertex normals
• Added support for array bitmaps
• Added support for decorator models
• Improved materials in model exports
• Added button in module viewer to show/hide tag resources in the tag list
• Added right-click menu option to dump tag binary (also works on tag resources)
• When adding linked modules, the search filter will no longer get reset each time
• Big thanks to Connor-jt for the following additional Halo 5 improvements
  • Added support for scenario_structure_bsp tags
  • Added support for structure_lightmap tags
  • Added support for particle_model tags
  • Added support for scenario tags

Added Support for Halo Infinite

• Big thanks to Surasia for contributions on this
• Extraction supports the following types of tags:
  • bitmap
  • render_model
  • scenario_structure_bsp
  • runtime_geo
  • customization_globals_definition

To see tag names you will need to set the String IDs File setting in the Module Viewer settings.

You can download the strings file (and meta viewer xml definitions) from https://github.com/Surasia/ReclaimerFiles

Model Viewer Improvements

• The geometry loading system has been reworked for faster load times and significantly lower memory usage
• The model viewer is now using DirectX-based rendering and should have a much better frame rate
• No more gimble lock when looking directly up or down
• Added FPS display
• Improved initial camera position for some models
• Fixed the (un)select-all not always working correctly on models with a huge number of components
• Added keyboard navigation for the permutation tree
• Improved grouping of geometry instances for BSP models
• The coordinate system will now match the source geometry (such as Y-up for CEA models)
• Models with multiple permutations will now show both a 'Regions' tab and a 'Permutations' tab
  • The Regions tab breaks the model up into regions (this is the existing behaviour)
  • The Permutations tab breaks the model up into the separate permutations, making it easier to select or unselect certain variants

Scenario Tag Support

The above performance improvements in the model viewer now makes it feasible to load significantly more geometry into the viewer at once without affecting performance.

Support has now been added for viewing scenario tags in the model viewer.
When opening a scenario tag you can view all of the following objects at the same time:

• BSPs
• Skies
• Scenery
• Machines
• Controls
• Crates

Scenario tags can only be exported using the new RMF model format - see below.

Scenario tags will not be extracted during batch extracts.
You can either extract via the model viewer or right-click on the tag and select the Extract menu option.

Reclaimer Model Format

A new model export format has been added: RMF. This format is the successor to AMF with the primary goal being to address the many shortcomings of AMF.

The RMF format has a new importer that supports modern versions of both Blender and 3DS Max and (mostly) supports all the same functionality between the two.

This format has the following key improvements over AMF:

• Blender and 3DS Max both get the same import UI and import options
• Much closer feature parity between Blender and 3DS Max
• Significantly faster imports
• Significantly improved material setup
• Support for multiple models in the same file (such as an entire scenario)
• Support for multiple UV channels
• Support for vertex weighting with more than 4 bones per vertex
• Support for vertex colors (currently Blender only)
• Automatic conversion from source units to Blender/Max units
• Automatic bitmap path detection
• Smaller file sizes

When importing files that contain multiple objects, the importer will retain the model hierarchy and make use of collections/layers to organise the imported objects.

RMF Importer Download

• For Blender
  • Versions earlier than 4.2: Download the zip with xplatform in the name
  • Version 4.2 or later: Download the zip with windows or linux in the name, depending on your operating system
• For 3DS Max
  • Download the zip with xplatform in the name

See the RMF Importer README for more information on importing RMF files and setting up the RMF importer addon for Blender or 3DS Max.