EWTOOLS-BSPINFO(1)

📦 version 2.0.0~alpha11, in ubuntu stonking

💖 EWTOOLS-BSPINFO — bestie edition 💖

okay so hi, welcome to the ericw-tools manual, page one, entry EWTOOLS-BSPINFO(1). This is the whole entire page about bspinfo, and yes it also answers to the name ewtools-bspinfo. Same girl, two nicknames 💅

✨ NAME ✨

ewtools-bspinfo — spill the tea on a Quake BSP file, like, basic info only but make it cute

bspinfo — literally the exact same thing, just the shorter name 🎀

🌸 SYNOPSIS 🌸

bspinfo BSPFILE [BSPFILES]

🦋 DESCRIPTION 🦋

so bspinfo will print various info about each .bsp file you hand it, and here's the full rundown:

  • the BSP type
  • a list of BSP lumps, how many objects are in each one, and the total size in bytes
  • a list of BSPX lumps and their sizes in bytes

and then, because previewing lightmaps in Blender is a whole thing, it also packs the lightmaps into an atlas and outputs these bad boys:

  • mapname.bsp.geometry.obj — the BSP faces plus the lightmap UV's, all in one file, slay
  • mapname.bsp.lm_0.png, mapname.bsp.lm_1.png, etc. — one lightmap atlas per used style number, so like, one per style, you get it 💖

and for debugging, the bsp also gets converted into a JSON representation and written out to mapname.bsp.json. no cap, it just does that. 🔥

👑 AUTHOR 👑

Based on source provided by id Software. iconic lineage fr fr 🫶

💀 REPORTING BUGS 💀

pls post bug reports at <https://github.com/ericwa/ericw-tools/issues>. Improvements to the documentation are welcome and encouraged — like, genuinely, come thru, we want your edits 🥺

  • 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.

bestie. the "NO WARRANTY" part is in all caps in the original and that's not me being dramatic, that's just how licenses yell. respect it. 🫡

and that's the whole page!! this was EWTOOLS-BSPINFO(1) from ericw-tools, dated Jul 29, 2026, and it ate, no notes 💅✨ bye bestie, go inspect some BSPs 🧚

📦 where this page comes from