BSPUTIL(1)

📦 version 0.18.1, in nixpkgs unstable

💅 BSPUTIL(1) 💅

okay so bestie, welcome to the General Commands Manual page for bsputil — yes that's the manual name, no I'm not making it up, it's literally right there in the header 💖

✨ NAME ✨

bsputil — the utility for working with Quake BSP files 🎀 (and yes, the original page spells it "utiltiy", we don't fix it, we love it, it's iconic)

🌈 SYNOPSIS 🌈

bsputil [OPTION]... BSPFILE

🦋 DESCRIPTION 🦋

bsputil is a small utility for basic manipulation of Quake BSP files. that's it, that's the whole vibe check. small but mighty, a true main character 🫶

🔥 OPTIONS 🔥

  • --extract-textures — pulls the texture data out of BSPFILE and makes you a Quake WAD file 🎨. the output filename is generated from BSPFILE by stripping the .bsp extension and adding the .wad extension. automatic. slay.
  • --extract-entities — extracts the entity data from BSPFILE and creates a plain text .ent file 📝. output filename? generated from BSPFILE by stripping the .bsp extension and adding the .ent extension. same deal, different extension, no cap.
  • --check — loads BSPFILE into memory and runs a set of tests to check that all internal data structures are self-consistent 🕵️‍♀️✨. now listen — currently the tests are very basic and not all warnings will result in errors from all versions of the Quake engine. also this option is not targeted at level designers, it's intended to assist with development of the qbsp tool and check that a "clean" bsp file is generated. iykyk 🧚
lowkey important: "not all warnings will result in errors from all versions of the Quake engine" — don't come for me if a warning is fine on your engine and not on someone else's, the manpage said it first 💀

👑 AUTHOR 👑

  • Kevin Shanahan (aka Tyrann) — http://disenchant.net 🌸
  • Eric Wasylishen
  • Based on source provided by id Software

😭 REPORTING BUGS 😭

please please please post bug reports at https://github.com/ericwa/ericw-tools/issues 🐛.

Improvements to the documentation are welcome and encouraged — literally us, we're the improvement, bestie 💅🍓

Copyright (C) 2017 Eric Wasylishen
Copyright (C) 2013 Kevin Shanahan
Copyright (C) 1997 id Software
License GPLv2+:  GNU GPL version 2 or later
<http://gnu.org/licenses/gpl2.html>.

This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. (read that again, no warranty, zero, nada 🙈)

⭐ SEE ALSO ⭐

qbsp(1) light(1) vis(1) bspinfo(1) quake(6) — go read the whole squad fr fr 👯‍♀️

and that's the page, babes 🦋 — brought to you by TYRUTILS, version TYR_VERSION, living down there in the footer of BSPUTIL(1). mwah 💋🎀

📦 where this page comes from