#smash #super #brawl #lib #high-level #sdcard #bros


Brawl character file parser, based on brawlbox/brawllib

35 releases (breaking)

0.25.1 Dec 30, 2023
0.24.1 Mar 13, 2022
0.23.0 Dec 23, 2021
0.22.0 Oct 24, 2021
0.13.0 Mar 28, 2019

#316 in Game dev

Download history 1/week @ 2024-02-13 18/week @ 2024-02-20 74/week @ 2024-02-27 1/week @ 2024-03-05 3/week @ 2024-03-12 1/week @ 2024-03-26 28/week @ 2024-04-02

151 downloads per month

MIT license

12K SLoC


dependency status Crates.io Released API docs

A brawl file parser, based on brawlbox/brawllib, written in rust.

Doesn't support modifying files, only reading, processing and rendering them.


In this example we:

  • Create a BrawlMod from a brawl mod sd card folder and a brawl dump folder.
  • Load Fighters from the brawl_mod. This is the raw data from the fighter folder, stored in a tree of structs.
  • Create a HighLevelFighter from an exported brawl fighter directory. This contains processed data from the Fighter struct, stored in a tree of structs.
use brawllib_rs::brawl_mod::BrawlMod;
use brawllib_rs::high_level_fighter::HighLevelFighter;
use std::path::PathBuf;

let brawl_path = PathBuf::from("path/to/a/brawl/dump/folder");
let mod_path = PathBuf::from("path/to/a/brawl/mod/sd/card/folder");
let brawl_mod = BrawlMod::new(&brawl_path, Some(&mod_path));

for fighter in brawl_mod.load_fighters(false).unwrap() {
    println!("Fighter name: {}", fighter.cased_name);
    println!("The name of the first model file name: {}", fighter.models[0].name);

    let hl_fighter = HighLevelFighter::new(&fighter);
    println!("Hurtboxes on the 4th frame of 'Run' action {:#?}", hl_fighter.subactions.iter().find(|x| x.name == "Run").unwrap().frames[4].hurt_boxes);


~1M SLoC