BSPSource: Difference between revisions
Jump to navigation
Jump to search
Bug: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 
Note: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. 
Workaround:Decompiling the file again or more times may generate better results, such as avoiding some of these issues[Why?].
Note:If there is decompilation protection present, the conversion may be more difficult to work with.
mNo edit summary |
(badly moved multipage 7856) |
||
| Line 1: | Line 1: | ||
{{LanguageBar}} | |||
[[File:BSPSource.png|thumb|right|300px|BSPSource v1.4.5]] | [[File:BSPSource.png|thumb|right|300px|BSPSource v1.4.5]] | ||
{{Stub}} | {{Stub}} | ||
{{ | {{Bspsource|4}} is a GUI map decompiler for {{src|4}} games, written in {{java|4}}. | ||
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. | |||
{{Bug|Newer version (1.4.4, 1.4.5) may not launch{{ref|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 {{path|bspsrc-jar-only|zip}} version and run the {{file|bspsrc|jar}} file, or alternatively, use older version of BSPSource, or downgrade Windows.}} | |||
{{note|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. {{workaround|Decompiling the file again or more times may generate better results, such as avoiding some of these issues{{why}}.}} }} | |||
{{note|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|4.1}}. | |||
== See also == | |||
*{{hlusmd|4}} - GUI map decompiler for {{Gldsrc|4}} | |||
== External links == | |||
* [https://github.com/ata4/bspsrc/releases BSPSource on GitHub] | |||
* [https://www.oracle.com/java/technologies/downloads/#jdk21-windows Java 21 (or later)] (optional, for 1.4.4 or later. This is only required if you are using {{path|bspsrc-jar-only|zip}} (which does not have Java bundled in.) | |||
** After installing, try to run the {{path|bspsrc|jar}} executable, or type {{code|javaw -jar "C:\your-bspsrc-folder\bspsrc.jar"}} in Command Prompt (CMD). | |||
* [https://www.java.com/download/ Java 8] (required in order to use BSPSource 1.4.3 or earlier) | |||
== References == | |||
# [https://github.com/ata4/bspsrc/issues/180 Application not launching caused by "java.lang.IllegalArgumentException: Comparison method violates its general contract!"] | |||
[[Category:Third Party Tools]] | [[Category:Third Party Tools]] | ||
Revision as of 05:23, 12 July 2024
BSPSource is a GUI map decompiler for 
Source games, written in 
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.
Bug: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. [todo tested in ?]Note: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. Workaround:Decompiling the file again or more times may generate better results, such as avoiding some of these issues[Why?].Note: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.
See also
Half-Life Unified SDK Map Decompiler - GUI map decompiler for 
GoldSrc
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.jarexecutable, or type javaw -jar "C:\your-bspsrc-folder\bspsrc.jar" in Command Prompt (CMD).
- After installing, try to run the
- Java 8 (required in order to use BSPSource 1.4.3 or earlier)
References
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
