bspPack

Standalone packing tool stripped out of CompilePal

Usage

Paths to game folder ( folder of gameinfo.txt ) and to steam installation folder are stored in config.ini ( created on first use ).
There is no automatic detection so they need to be provided manually.
Running bspPack --modify creates ResourceConfig.ini which is used instead of multiple other flags in CompilePal.
If compressed BSP is provided automatic decompression is attempted by running bspzip with -repack flag.

Flags

-V | --verbose - Outputs a complete listing of added assets
-D | --dryrun - Creates a txt file for bspzip usage but does not pack
-R | --renamenav - Renames the nav file to embed.nav
-N | --noswvtx - Skips packing unused .sw.vtx files to save filesize
-P | --particlemanifest - Generates a particle manifest based on particles used
-C | --compress - Compresses the BSP after packing
-M | --modify - Modifies PakFile based on ResourceConfig.ini¹
-U | --unpack - Unpacks the BSP to <filename>_unpacked
-S | --search - Searches /maps folder of the game directory for the BSP file

Missing functionality

Support for renaming conflicting particle names
Packing VPK

Linux problem

For reaons I have not quite figured out yet some texture paths are stored in upper case in BSPs.
This does not seem to be a problem with how CompilePal manages files but just the way BSPs store paths.
Because linux paths are case sensitive all paths are normalized to lower case, meaning all textures that are supposed to be packed need to be in lower case.
Until there is a way to deal with upper case in BSPs this will remain an issue.

Footnotes

1. Replaces --include, --includefilelist, --includeDir, --includesourcedirectories, --exclude, --excludeDir, and --excludeVpk flags from CompilePal ↩