https://github.com/miriswisdom/hce.balsamv

HCE Profile Binary Editor.
https://github.com/miriswisdom/hce.balsamv

binary blam editor hce profile sav spv3

Last synced: 2 months ago
JSON representation

HCE Profile Binary Editor.

• Host: GitHub
• URL: https://github.com/miriswisdom/hce.balsamv
• Owner: MirisWisdom
• License: gpl-3.0
• Created: 2018-11-21T09:17:49.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2019-01-22T09:05:34.000Z (over 6 years ago)
• Last Synced: 2025-03-17T19:48:19.946Z (2 months ago)
• Topics: binary, blam, editor, hce, profile, sav, spv3
• Language: C#
• Homepage:
• Size: 322 KB
• Stars: 0
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        

    


        

    


    


        HCE.BalsamV

    

    


        HCE Profile Binary Editor

    

    


        

    


    


        

            Download

        

    


# Introduction

BalsamV is a library and editor for the binary file used by HCE to store the

profile configuration. It reads the saved values and allows the editing of them.

The main advantage is more freedom over setting values, including name hacks and

custom resolutions without refresh-rate locks.

This project is currently a work progress. At the moment, all values can be

edited **except**:

- KBM/Controller Input mappings

- Video gamma value

- Video refresh rate

- Sound EAX/HW Acceleration

# Usage

1. [Download](https://github.com/yumiris/HCE.BalsamV/releases/latest) & run the

   executable.

2. If a HCE profile exists, it will automatically be loaded. If not, please

   click on `Load` and select your `blam.sav`[1].

3. Edit the values accordingly, then click `Save`.

[1] - The `blam.sav` binary can be found in `\savegames\\blam.sav`.

# Documentation

The following documentation covers both the `blam.sav` and `lastprof.txt` files,

and the BalsamV library.

## Binary Properties

Considering that the `blam.sav` binary contains a lot of properties, the BalsamV

library and documentation has been split up into three categories. Refer to the

following development documentation for information on the various sections

`blam.sav` binary:

| Document                              | Topics                                   |

| ------------------------------------- | ---------------------------------------- |

| [BalsamV.Profile](./doc/profile.md)   | Profile name and player colour.          |

| [BalsamV.Settings](./doc/settings.md) | Video, audio and network settings.       |

| [BalsamV.Input](./doc/input.md)       | Keyboard, mouse and controller mappings. |

## Profile

- The last accessed HCE profile can be deduced by parsing the text data of the

  `lastprof.txt` file.

- The text file in question is officially located in `Documents\My Games\Halo

  CE`.

- BalsamV validates the inbound `lastprof.txt` data by checking for the `

  lam.sav` suffix[1].

[1] - Yup, the lack of `b` is deliberate!

## Checksum

- The `blam.sav` integrity is verified by HCE on process initiation by checking

  the CRC32 hash stored at `0x1FFC`.

- The hash is stored as an unsigned int32, with the value being the bitwise

  complement of the CRC32 of `blam.sav` data range from `0x0000` to `0x1FFC`.