#valve #bsp #parser #vbsp #helper #source #variant

vbsp-common

Common types and helpers for valve bsp files

1 unstable release

new 0.1.0 Mar 2, 2025

#16 in #bsp


Used in 3 crates

MIT license

14KB
414 lines

VBSP

Rust parser for valve bsp files.

Currently supports bsp files from Counter Strike Source and Team Fortress 2, other source games using bsp version 19 or 20 might also work. Adding other sourcemod variants should be fairly straight forward and pull requests for them are welcome.

Example usage

fn main() -> Result<(), vbsp::BspError> {
    let data = std::fs::read("maps/cp_steel.bsp")?;
    let bsp = vbsp::Bsp::read(&data)?;
    println!("{:?}", bsp);

    Ok(())
}

See vbsp-to-gltf or vbspviewer for some more examples of how to use the bsp data.

TODO

  • smooth normals for displacements
  • smooth normals for faces

Credits

This project is adapted from the quake bsp parser and wouldn't be possible without information from the source engine wiki.

Dependencies

~2.5MB
~59K SLoC