vbsp
vbsp is a command line utility that builds VMF files into BSP files. It is available for Windows and Linux.
Help Text
Valve Software - vbsp.exe (Nov 15 2024)
usage : vbsp [options...] mapfile
example: vbsp -onlyents c:\hl2\hl2\maps\test
Common options (use -v to see all options):
-v (or -verbose): Turn on verbose output (also shows more command line options).
-instancepath : Specify a directory to search for instances in first. Falls back to default behavior if not found
-onlyents : This option causes vbsp only import the entities from the .vmf file. -onlyents won't reimport brush models.
-onlyprops : Only update the static props and detail props.
-glview : Writes .gl files in the current directory that can be viewed with glview.exe. If you use -tmpout, it will write the files into the \tmp folder.
-nodetail : Get rid of all detail geometry. The geometry left over is what affects visibility.
-nowater : Get rid of water brushes.
-staticpropcombine : Cluster specially supported static prop models.
-keepsources : Don't clean up cluster models after bspzip.
-staticpropcombine_considervis : Cluster static prop models only within vis clusters.
-staticpropcombine_autocombine : Automatically combine simple static props without an explicit combine rule.
-staticpropcombine_suggestrules: Suggest rules to add to spcombinerules.txt
-low : Run as an idle-priority process.
-vproject <directory> : Override the VPROJECT environment variable.
-game <directory> : Same as -vproject.
Other options :
-threads : Control the number of threads vbsp uses (defaults to the # of processors on your machine).
-verboseentities: If -v is on, this disables verbose output for submodels.
-noweld : Don't join face vertices together.
-nocsg : Don't chop out intersecting brush areas.
-noshare : Emit unique face edges instead of sharing them.
-notjunc : Don't fixup t-junctions.
-noopt : By default, vbsp removes the 'outer shell' of the map, which are all the faces you can't see because you can never get outside the map. -noopt disables this behaviour.
-noprune : Don't prune neighboring solid nodes.
-nomerge : Don't merge together chopped faces on nodes.
-nomergewater: Don't merge together chopped faces on water.
-nosubdiv : Don't subdivide faces for lightmapping.
-micro <#> : vbsp will warn when brushes are output with a volume less than this number (default: 1.0).
-fulldetail : Mark all detail geometry as normal geometry (so all detail geometry will affect visibility).
-alldetail : Convert all structural brushes to detail brushes, except func_brush entities whose names begin with structure_.
-leaktest : Stop processing the map if a leak is detected. Whether or not this flag is set, a leak file will be written out at <vmf filename>.lin and it can be imported into Hammer.
-bumpall : Force all surfaces to be bump mapped.
-snapaxial : Snap axial planes to integer coordinates.
-block # # : Control the grid size mins that vbsp chops the level on.
-blocks # # # # : Enter the mins and maxs for the grid size vbsp uses.
-blocksize # : Control the size of each grid square that vbsp chops the level on. Default is 1024.
-dumpstaticprops: Dump static props to staticprop*.txt
-dumpcollide : Write files with collision info.
-forceskyvis : Enable vis calculations in 3d skybox leaves
-luxelscale # : Scale all lightmaps by this amount (default: 1.0).
-minluxelscale #: No luxel scale will be lower than this amount (default: 1.0).
-maxluxelscale #: No luxel scale will be higher than this amount (default: 999999.0).
-lightifmissing : Force lightmaps to be generated for all surfaces even if they don't need lightmaps.
-keepstalezip : Keep the BSP's zip files intact but regenerate everything else.
-virtualdispphysics : Use virtual (not precomputed) displacement collision models
-visgranularity # # # : Force visibility splits # of units along X, Y, Z
-xbox : Enable mandatory xbox options
-replacematerials : Substitute materials according to materialsub.txt in content\maps
-FullMinidumps : Write large minidumps on crash.
-upgradeversion : Upgrade an existing BSP to Strata Source BSP version 25.