Skip to main content

​
System Requirements

BSPSource requires Java 24 or later to run. Choose your installation method below based on your platform and preferences.
Java Version: BSPSource requires Java 24+ to be installed and properly configured when using the JAR-only distribution.

​
Installation Methods

1

Download

Go to the releases page and download bspsrc-windows.zip
2

Extract

Extract the contents of the zip file to a new folder (e.g., C:\Program Files\BSPSource)
3

Launch

To launch BSPSource, run the corresponding batch file:
  • bspsrc.bat - GUI and decompiler
  • bspinfo.bat - BSP file information tool
Add the BSPSource folder to your PATH environment variable to run bspsrc and bspinfo from anywhere.

​
Verify Installation

After installation, verify BSPSource is working correctly: 
bspsrc.bat --version
You should see output similar to: 
BSPSource 1.4.8-DEV

Based on VMEX v0.98g by Rof <[email protected]>
Extended and modified by Nico Bergemann <[email protected]>

​
Directory Structure

After extraction, your BSPSource directory will contain: 
bspsrc/
├── bspsrc.bat / bspsrc.sh      # Main decompiler launcher
├── bspinfo.bat / bspinfo.sh    # BSP info tool launcher
├── bspsrc.jar                  # Main application
├── bspinfo.jar                 # Info tool
└── lib/                        # Dependencies (platform builds)

​
Troubleshooting

This means Java is not installed or not in your system PATH.Solution:
  1. Install Java 24 or later from Oracle
  2. Add Java to your PATH environment variable
  3. Restart your terminal/command prompt
The shell scripts need execute permissions.Solution:
chmod +x bspsrc.sh bspinfo.sh
The GUI requires a graphical environment.Solution:
  • Use the CLI mode instead (see CLI Reference)
  • Or ensure you’re running in a graphical environment with X11/Wayland (Linux) or Windows desktop
Your Java version is too old.Solution: Install Java 24 or later. Check your version with:
java -version

​
Next Steps

Quick Start

Learn how to decompile your first BSP file

CLI Reference

Explore all command-line options and flags

Build docs developers (and LLMs) love

Get started for freeTalk to us