BSPSource: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
mNo edit summary
No edit summary
 
(58 intermediate revisions by 26 users not shown)
Line 1: Line 1:
{{otherlang2
{{LanguageBar}}
|ru=BSPSource:ru
{{Stub}}
 
{{SoftwareBox
| title = BSPSource [[File:BSPSource icon.png|16px]]
| developer = ata4
| initial_release = Apr 5, 2011
| stable_release = Apr 24, 2025</br><small>(1.4.7)</small>
| type =  Map Converter Tool
| distribution = Freeware
| windows = 1
| source = 1
| website = [https://github.com/ata4/bspsrc/ Repository]
| download = [https://github.com/ata4/bspsrc/releases Download]
}}
}}
[[Image:BSPSource icon.png|left]]'''BSPSource''' is a [[VMEX]]-based map decompiler for the [[Source]] engine. It converts [[BSP]] format files back into [[VMF]] format maps that can be loaded into [[Hammer]]. Support has been extended to newer Source engine games, such as {{game link|Dark Messiah of Might and Magic}}, {{game link|Left 4 Dead 2}}, and {{game link|Portal 2}}. Most of the annoying bugs found in the last release of VMEX have been fixed and new features have been added.
{{clr}}
New features include:
* Extracting the embedded ZIP file
* BSP analysis
* Support for processing multiple files at once.
* Convenient file Drag 'n' Drop
* Much more!
<!--It also has that lovable German charm you can't find anywhere else!-->
{{note|Decompiling maps may not always result in 100% accurate builds. Some differences (keyvalues, materials, etc) may not be an exact match as the original map.}}


== See also ==
[[File:BSPSource.png|thumb|right|300px|Screenshot of BSPSource.]]
* [[Decompiling Maps]]
 
* [[Map Obfuscator]]
{{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 (starting with 1.4.4 or later) may not launch{{cite|1}} on some systems (especially with systems with Windows 11 or localized version of the OS). Users can try to install latest version of Java 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/upgrade/reinstall Windows.}}
{{note|Due to technical reasons, decompiling maps doesn't accurately recreate their original '''VMF''' state, often presenting issues such as invalid geometry solids, tools textures such as NPC Clip or Player Clip all replaced with either Nodraw or entirely replaced with NPC Clip or Player Clip which cause lighting issues or NPCs to get stuck, 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 similarly to {{Gcfscape|2}}.
 
== See also ==
*{{hlusmd|4}} - GUI map decompiler for {{Gldsrc|4}}


== External links ==
== External links ==
* [http://nuclearvelocity.com/barracuda/bspsrc/ BSPSource homepage] - more information and download of the latest version
* [https://github.com/ata4/bspsrc/releases BSPSource on GitHub]
* [https://www.oracle.com/java/technologies/downloads Latest Java] (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|1=
{{ref2|cite id=1|access-date=June 19, 2025|"[https://github.com/ata4/bspsrc/issues/180 Application not launching caused by "java.lang.IllegalArgumentException: Comparison method violates its general contract!"]". BSPSource. ''GitHub Issues''.}}
}}


[[Category:Third Party Tools]]
[[Category:Third Party Tools]]
[[Category:Level Design]]
[[Category:Level Design]]
{{sdktools|cat=0|0}}

Latest revision as of 04:57, 18 October 2025

English (en)Polski (pl)Русский (ru)Translate (Translate)

Stub

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

BSPSource BSPSource icon.png
Developer(s)
ata4
Initial release
Apr 5, 2011
Stable release
Apr 24, 2025
(1.4.7)
Operating system
Windows
Type
Map Converter Tool
Target engine(s)
Source
Distribution
Freeware
Website
Download
Screenshot of BSPSource.

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 (starting with 1.4.4 or later) may not launch[1] on some systems (especially with systems with Windows 11 or localized version of the OS). Users can try to install latest version of Java and download the 🖿bspsrc-jar-only.zip version and run the 🖿bspsrc.jar file, or alternatively, use older version of BSPSource, or downgrade/upgrade/reinstall Windows.  [todo tested in ?]
Note.pngNote:Due to technical reasons, decompiling maps doesn't accurately recreate their original VMF state, often presenting issues such as invalid geometry solids, tools textures such as NPC Clip or Player Clip all replaced with either Nodraw or entirely replaced with NPC Clip or Player Clip which cause lighting issues or NPCs to get stuck, 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 similarly to GCFScape GCFScape.

See also

External links

  • BSPSource on GitHub
  • Latest Java (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

References


Mod tools
Map editors
Map compilers
VBSP_h4xed • Slammin' Compile Tools
CST compilers: CSTBSP • CSTRAD • CSTVIS
Ficool2's compilers: VBSP++ • VVIS++ • VRAD++
Map compiler frontends
Map converters
005 Decompiler • BSPSource • MapFool • VMEX
Map tools
AutoBSPpackingTool • BSPEntSpy • Crafty • Convexer • EntEd • Entspy • JERC • Map Analyst • Map Obfuscator • Material Enumerator • Pakrat • Source Compile Analyzer • TAR • TeamSpen's Hammer Addons • Vgroup • VMF Optimizer • VMF Updater • WinBSPZip • LumpStich • VPKEdit
Model compilers
Model compiler frontends
Model converters
Model tools
3Dcoat • 3DS Max • Blender • Cinema 4D • Fragmotion • GMax • HLMV++ • kHED • Lightwave • Maya • MilkShape 3D • Modo • SourceOps • VSIF2VCD • Softimage Mod Tool • Zbrush
Displacement tools
Particle converters
Texture converters
Texture tools
Sound tools
VPK tools
Libraries
AVIKit • HLLib • VectorLib • VTFLib
Plugins
Other
Retrieved from "https://developer.valvesoftware.com/w/index.php?title=BSPSource&oldid=490946"