@blamnetwork/blf

Changelog ​

All notable changes to @blamnetwork/blf are documented here.

[1.0.0] — 2026-05-31 ​

Initial release.

  • find_chunk and search_for_chunk for locating chunks in BLF files
  • write_blffile for writing back.
  • Implementation of Halo's bitstream reader and writer.
  • Helper function for converting Halo: Reach gametypes between Halo: The Master Chief Collection and Xbox 360 versions.

BLF Chunks ​

Ported the following BLF chunks from the blf_lib Rust project. Import paths: @blamnetwork/blf/<game>/<build_id>.

  • Halo Reach — Title Update 1
    • s_blf_chunk_start_of_file (_blf 1.2)
    • s_blf_chunk_compressed_data (_cmp 1.1)
    • s_blf_chunk_end_of_file (_eof 1.1)
    • s_blf_chunk_author (athr 3.1)
    • s_blf_chunk_content_header (chdr 10.2)
    • s_blf_chunk_packed_game_variant (gvar 54.1)
    • s_blf_chunk_game_variant (mpvr 54.1)
    • s_blf_chunk_map_variant (mvar 31.1)
  • Halo: MCC – Reach
    • s_blf_chunk_start_of_file (_blf 1.2)
    • s_blf_chunk_compressed_data (_cmp 1.1)
    • s_blf_chunk_end_of_file (_eof 1.1)
    • s_blf_chunk_content_header (chdr 10.2)
    • s_blf_chunk_packed_game_variant (gvar 54.1)
    • s_blf_chunk_game_variant (mpvr 54.1)
    • s_blf_chunk_map_variant (mvar 31.1)
  • Halo: MCC
    • s_blf_chunk_fileshare_metadata (_fsm 1.1)
  • Halo 3 — Title Update 2
    • s_blf_chunk_start_of_file (_blf 1.2)
    • s_blf_chunk_compressed_data (_cmp 1.1)
    • s_blf_chunk_end_of_file (_eof 1.1)
  • Halo 3: ODST
    • s_blf_chunk_start_of_file (_blf 1.2)
    • s_blf_chunk_compressed_data (_cmp 1.1)
    • s_blf_chunk_end_of_file (_eof 1.1)

Helpers ​

  • @blamnetwork/blf/helpers — Reach gametype conversion between Xbox 360 TU1 and MCC, including map variant (mpvr) handling