BSPSource

From Valve Developer Community
Jump to: navigation, search
BSPSource v1.4.5

Stub

This article or section is a stub. You can help by adding to it.

English (en)Русский (ru)
Edit

BSPSource BSPSource is a GUI map decompiler for Source Source games, written in Java Java.

Based on VMEX, it converts BSP files 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.

Icon-Bug.pngBug:Newer version (1.4.4, 1.4.5) may not launch[1] on some systems (especially with systems with Windows 11 or localized version of the OS). Users can try to install Java 21 (or later) and download the 🖿bspsrc-jar-only.zip version and run the 🖿bspsrc.jar file, or alternatively, use older version of BSPSource, or downgrade Windows.
Note.pngNote:Due to technical reasons, decompiling maps doesn't accurately recreate their original VMF state, often presenting issues such as invalid geometry solids or misplaced areaportal brushes in the decompiled file.
PlacementTip.pngWorkaround: Decompiling the file again or more times may generate better results, such as avoiding some of these issues[Why?].
Note.pngNote:If there is decompilation protection present, the conversion may be more difficult to work with.

BSP with File Packing

In the tab "Other" set tick in in "Extract embedded files". Then put downloaded files in game directory.

BSPInfo

BSPInfo is a mode of BSPSource that instead of decompiling .bsp files, analyses them. Content such as: bsp version, compression type, checksums, AppID, lumps and compile parameters. It can also extract embedded files similiarly to GCFScape GCFScape.

External links

  • BSPSource on GitHub
  • Java 21 (or later) (optional, for 1.4.4 or later. This is only required if you are using 🖿bspsrc-jar-only.zip (which does not have Java bundled in.)
    • After installing, try to run the 🖿bspsrc.jar executable, or type javaw -jar "C:\your-bspsrc-folder\bspsrc.jar" in Command Prompt (CMD).
  • Java 8 (required in order to use BSPSource 1.4.3 or earlier)

References

  1. Application not launching caused by "java.lang.IllegalArgumentException: Comparison method violates its general contract!"