{"id":21942776,"url":"https://github.com/miriswisdom/hce.balsamv","last_synced_at":"2025-03-22T15:41:11.418Z","repository":{"id":116526853,"uuid":"158521896","full_name":"MirisWisdom/HCE.BalsamV","owner":"MirisWisdom","description":" HCE Profile Binary Editor.","archived":false,"fork":false,"pushed_at":"2019-01-22T09:05:34.000Z","size":330,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-17T19:48:19.946Z","etag":null,"topics":["binary","blam","editor","hce","profile","sav","spv3"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MirisWisdom.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-11-21T09:17:49.000Z","updated_at":"2019-01-03T23:08:03.000Z","dependencies_parsed_at":null,"dependency_job_id":"0f49558b-e7e0-48c3-96e4-a2419c734222","html_url":"https://github.com/MirisWisdom/HCE.BalsamV","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MirisWisdom%2FHCE.BalsamV","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MirisWisdom%2FHCE.BalsamV/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MirisWisdom%2FHCE.BalsamV/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MirisWisdom%2FHCE.BalsamV/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MirisWisdom","download_url":"https://codeload.github.com/MirisWisdom/HCE.BalsamV/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244981010,"owners_count":20542287,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["binary","blam","editor","hce","profile","sav","spv3"],"created_at":"2024-11-29T03:26:26.120Z","updated_at":"2025-03-22T15:41:11.395Z","avatar_url":"https://github.com/MirisWisdom.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003chtml\u003e\n    \u003cp align=\"center\"\u003e\n        \u003cimg src=\"https://user-images.githubusercontent.com/10241434/48844282-52a20680-edd4-11e8-8dd4-80036c26ca6e.png\"\u003e\n    \u003cp\u003e\n    \u003ch1 align=\"center\"\u003e\n        HCE.BalsamV\n    \u003c/h1\u003e\n    \u003ch3 align=\"center\"\u003e\n        HCE Profile Binary Editor\n    \u003c/h3\u003e\n    \u003cp align=\"center\"\u003e\n        \u003cimg src=\"https://user-images.githubusercontent.com/10241434/48846120-39e81f80-edd9-11e8-930a-f91f1b62689a.png\"\u003e\n    \u003cp\u003e\n    \u003cp align=\"center\"\u003e\n        \u003ca href=\"https://github.com/yumiris/HCE.BalsamV/releases/latest\"\u003e\n            Download\n        \u003c/a\u003e\n    \u003c/p\u003e\n\u003c/html\u003e\n\n# Introduction\n\nBalsamV is a library and editor for the binary file used by HCE to store the\nprofile configuration. It reads the saved values and allows the editing of them.\nThe main advantage is more freedom over setting values, including name hacks and\ncustom resolutions without refresh-rate locks.\n\nThis project is currently a work progress. At the moment, all values can be\nedited **except**:\n\n- KBM/Controller Input mappings\n- Video gamma value\n- Video refresh rate\n- Sound EAX/HW Acceleration\n\n# Usage\n\n1. [Download](https://github.com/yumiris/HCE.BalsamV/releases/latest) \u0026 run the\n   executable.\n2. If a HCE profile exists, it will automatically be loaded. If not, please\n   click on `Load` and select your `blam.sav`[1].\n3. Edit the values accordingly, then click `Save`.\n\n[1] - The `blam.sav` binary can be found in `\u003cpersonal hce\ndata\u003e\\savegames\\\u003cprofile name\u003e\\blam.sav`.\n\n# Documentation\n\nThe following documentation covers both the `blam.sav` and `lastprof.txt` files,\nand the BalsamV library.\n\n## Binary Properties\n\nConsidering that the `blam.sav` binary contains a lot of properties, the BalsamV\nlibrary and documentation has been split up into three categories. Refer to the\nfollowing development documentation for information on the various sections\n`blam.sav` binary:\n\n| Document                              | Topics                                   |\n| ------------------------------------- | ---------------------------------------- |\n| [BalsamV.Profile](./doc/profile.md)   | Profile name and player colour.          |\n| [BalsamV.Settings](./doc/settings.md) | Video, audio and network settings.       |\n| [BalsamV.Input](./doc/input.md)       | Keyboard, mouse and controller mappings. |\n\n## Profile\n\n- The last accessed HCE profile can be deduced by parsing the text data of the\n  `lastprof.txt` file.\n- The text file in question is officially located in `Documents\\My Games\\Halo\n  CE`.\n- BalsamV validates the inbound `lastprof.txt` data by checking for the `\n  lam.sav` suffix[1].\n\n[1] - Yup, the lack of `b` is deliberate!\n\n## Checksum\n\n- The `blam.sav` integrity is verified by HCE on process initiation by checking\n  the CRC32 hash stored at `0x1FFC`.\n- The hash is stored as an unsigned int32, with the value being the bitwise\n  complement of the CRC32 of `blam.sav` data range from `0x0000` to `0x1FFC`.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmiriswisdom%2Fhce.balsamv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmiriswisdom%2Fhce.balsamv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmiriswisdom%2Fhce.balsamv/lists"}