Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ata4/bspsrc

A Source engine map decompiler
https://github.com/ata4/bspsrc

Last synced: 6 days ago
JSON representation

A Source engine map decompiler

Awesome Lists containing this project

README 

        
# BSPSource



BSPSource is a map decompiler for [Source engine](http://developer.valvesoftware.com/wiki/Source) maps, written in Java.

It decompiles .bsp map files back to .vmf files that can be loaded in Hammer, Valve's official level editor.



BSPSource is based on a reengineered version of [VMEX 0.98g](http://www.bagthorpe.org/bob/cofrdrbob/vmex.html) by Rof, which is no longer developed and lacks support for newer Source engine games.



## Running BSPSource



1. Go to the [releases page](https://github.com/ata4/bspsrc/releases) and, depending on your operating system, download either `bspsrc-linux.zip` or `bspsrc-windows.zip`. Alternatively, `bspsrc-jar-only.zip` works on any system which has Java 22+ installed and properly configured.

2. Extract the contents of the zip file to a new folder.

3. To launch bspsrc/bspinfo, run the corresponding file: `bspsrc.bat`/`bspinfo.bat` on Windows, or `bspsrc.sh`/`bspinfo.sh` on Linux.



## Frequently asked Questions



* **Can you support _\_:** Generally speaking, most Source engine games should work with BSPSource out of the box, even though they might not be explicitly "supported". If you run into any problems or errors with any particular game/map, feel free to open an [Issue](https://github.com/ata4/bspsrc/issues).\

Games based on the older goldsrc or on the newer Source 2 engine, are not supported. Their map format wildly differs from the one the Source engine uses. 

* **Help, all the textures are gray/models are errors:** Most of the time this is due to the materials/models not existing in the base game but rather being embedded in the bsp file. This can frequently happen with workshop maps or with maps using csgo's automcombine prop feature. To make the materials/models visible in hammer, you need to extract the embedded files by checking `Extract embedded files` in the decompiler and then move the contents of the extracted material/model folders into your games material/model folder.



## Limitations and known bugs



* Some internal entities that are entirely consumed by vbsp can't be perfectly restored. This includes the following entities:

	* [func_instance](http://developer.valvesoftware.com/wiki/func_instance)

	* [func_instance_parms](http://developer.valvesoftware.com/wiki/func_instance_parms)

	* [func_instance_origin](http://developer.valvesoftware.com/wiki/func_instance_origin)

	* [func_viscluster](http://developer.valvesoftware.com/wiki/func_viscluster)

	* [info_no_dynamic_shadow](http://developer.valvesoftware.com/wiki/info_no_dynamic_shadow) 



## Improvements and changes compared to VMEX 0.98g



* Support for more and newer Source engine games up to Dota 2.

* Support for new entity types:

	* [func_areaportal](http://developer.valvesoftware.com/wiki/func_areaportal)

	* [func_areaportalwindow](http://developer.valvesoftware.com/wiki/func_areaportalwindow)

	* [func_occluder](http://developer.valvesoftware.com/wiki/func_occluder)

	* [info_lighting](http://developer.valvesoftware.com/wiki/info_lighting)

* Support for the tools/blocklight texture.

* Support for compressed and big-endian encoded maps (XBox 360, PS3)

* Decompiles VMEX maps flagged with protection and at least detects other anti-decompiling methods.

* Improved support for [prop_static](http://developer.valvesoftware.com/wiki/prop_static) and [info_overlay](http://developer.valvesoftware.com/wiki/info_overlay).

* Improved console output.

* New graphical user interface with output window.

* New command line interface.

* New integrated pakfile extractor.

* Numerous bug fixes.

* Open source.