BSPSource

BSPSource v1.4.0

BSPSource is a VMEX-based map decompiler for Source games. It converts BSP files back into VMF ones that can be loaded in Hammer. It also includes numerous bug fixes over VMEX and new features for doing the conversion, such as extracting embedded assets, processing multiple BSPs at once, and more.

Note:Decompiled maps aren't identical to the original VMF files that were used to compile them, and often present issues such as invalid geometry solids or misplaced areaportal brushes.

Note:Some maps protected from decompilation prevent the conversion. However, VMEX "Protection methods" like using No_decomp 1, tools/locked and the obfuscation shape will be ignored. A warning will pop up, but it will decompile anyways.

Console Commands

usage: bspsrc [options] <path> [path...]

Note: BSPSource must be ran with java console via like java -jar <jarfile> args1 args2 etc.

Note: Options must come first, example: java -jar "bspsrc.jar" -o "D:\programs x86\vmfs" "D:\bsps\arena_badlands.bsp" Which will decompile arena_badlands.bsp and put the vmf into the path given.

Cmd?	Description
-d	Enable debug mode. Increases verbosity and adds additional
-h,--help	Prints the commands
-l <file>	Use a text files with paths as input BSP file list.
-o <file>	Override output path for VMF file(s). Treated as directory if multiple BSP files are provided. default: <mappath>/<mapname>_d.vmf
-r	Decompile all files found in the given directory.
-v	Print version info.
-no_areaportals	Don't write func_areaportal(_window) entities.
-no_brush_ents	Don't write any brush entities.
-no_cubemaps	Don't write env_cubemap entities.
-no_details	Don't write func_detail entities.
-no_ladders	Don't write func_ladder entities.
-no_occluders	Don't write func_occluder entities.
-no_overlays	Don't write info_overlay entities.
-no_point_ents	Don't write any point entities.
-no_rotfix	Don't fix instance entity brush rotations for Hammer.
-no_sprp	Don't write prop_static entities.
-force_manual_areaportal	Force manual entity mapping for areaportal entities
-force_manual_occluder	Force manual entitiy mapping for occluder entities
-brushmode <enum>	Brush decompiling mode: BRUSHPLANES - brushes and planes ORIGFACE - original faces only ORIGFACE_PLUS - original + split faces SPLITFACE - split faces only default: BRUSHPLANES
-no_brushes	Don't write any world brushes.
-no_disps	Don't write displacement surfaces.
-thickness <float>	Thickness of brushes created from flat faces in units. default: 1.0
-bfacetex <string>	Replace all back-face textures with this one. Used in face-based decompiling modes only.
-facetex <string>	Replace all face textures with this one.
-no_texfix	Don't fix texture names.
-no_tooltexfix	Don't fix tool textures.
-appid <string/int>	Overrides game detection by using this Steam Application ID instead. Use -appids to list all known app-IDs.
-appids	List all available application IDs
-format <enum>	Sets the VMF format used for the decompiled maps: AUTO - Automatic OLD - Source 2004 to 2009 NEW - Source 2010 and later default: AUTO
-no_cams	Don't create Hammer cameras above each player spawm.
-no_lumpfiles	Don't load lump files (.lmp) associated with the BSP file.
-no_prot	Skip decompiling protection checking. Can increase speed when mass-decompiling unprotected maps.
-no_smart_unpack	Disable 'smart' extracting of embedded files. Smart extracting automatically skips all files generated by vbsp, that are only relevant to running the map in the engine.
-no_visgroups	Don't group entities from instances into visgroups.
-no_vmf	Don't write any VMF files, read BSP only.
-unpack_embedded	Unpack embedded files in the bsp.

External Links

• Original BSPSource on GitHub
• Anthonypython's CI fork on Github

Note:The fork has Github CI, which means anyone can do pull request change merges and a new build will be created automatically with newly-pushed changes.