rust-bsor

BS Open Replay Rust parser

Disclaimer: This is my Rust learning project, so expect bugs and non-idomatic code

Known limitations

The current version does not support replays that do not conform to the BL Open Replays specification saved by a very old version of the Beat Leader mod (incorrect utf8 string encoding).

Install

Run following Cargo command in your project directory

cargo add bsor

Or add the following line to your [dependencies] section of the Cargo.toml:

bsor = "0.2.1"

Usage

Loading the entire replay into memory:

use bsor::prelude::*;
use std::fs::File;
use std::io::BufReader;

fn main() {
    let mut br = BufReader::new(File::open("example.bsor").unwrap());

    let replay = Replay::load(&mut br).unwrap();

    println!("{:#?}", replay);
}

Since you may rarely need the full replay structure (especially Frames) and at the same time would like to keep memory usage low, there is also the option of loading only selected blocks (keep in mind that Header and Info blocks are always loaded).

use bsor::prelude::*;
use std::fs::File;
use std::io::BufReader;

fn main() {
    let mut br = BufReader::new(File::open("example.bsor").unwrap());

    let parsed_replay = ParsedReplay::parse(br).unwrap();

    let notes = parsed_replay.notes.load(br).unwrap();
    println!(
        "Info: {:#?}\nNotes count: {:#?}",
        parsed_replay.info,
        notes.len()
    );
    if !notes.is_empty() {
        println!("{:#?}", notes.get_vec()[notes.len() / 2]);
    }
}

The memory savings can be significant, for example, for an average replay of 1375kB:

Tests

Crate is fully tested according to the BL Open Replay specification, but keep in mind that actual replays may differ slightly from it, for example, older versions of the BL mod incorrectly encoded utf8 strings. If you come across a replay that crate cannot read please report it in GitHub Issues, along with a link.