1 unstable release

Uses new Rust 2024

0.1.0 Mar 2, 2025

#5 in #parser-for-valve

50 downloads per month
Used in 4 crates (3 directly)

MIT license

14KB
414 lines

VBSP

Rust parser for valve bsp files.

Mainly tested with Team Fortress 2 and Counter Strike Source files, other source games using bsp versions 19, 20 or 21 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

~1–1.7MB
~36K SLoC