How to open .BSP files on Windows
To open .BSP files on Windows, identify the originating engine/workflow (most commonly Source or GoldSrc). If it came from a Source mod/map compile, it is typically a Source compiled map.
Step-by-step instructions
- Identify the originating engine/workflow (most commonly Source or GoldSrc). If it came from a Source mod/map compile, it is typically a Source compiled map.
- Open it using the appropriate Valve game/toolchain for that engine (for Source maps, use the Source game or Source SDK tools associated with the map).
- If it still won’t open, confirm the file version/variant (Source vs GoldSrc) and try opening it with tools meant for that specific BSP type rather than a generic viewer.
Recommended software
- VS Code
- Notepad++/TextEdit
- jq (CLI)
Alternative methods
- Open .BSP in a browser-based viewer if desktop apps fail.
- Try opening .BSP on Windows with a secondary app to rule out app-specific issues.
- Convert .BSP only with trusted tools when direct opening is not possible.
Common issues
The .BSP file won’t open or won’t load in-game
This often happens when the BSP is for a different engine branch/version (Source vs GoldSrc), or the game/tools don’t recognize the file’s version/lump layout.
- Confirm whether it is a Source BSP or a GoldSrc (BSP30) file and use tools intended for that specific format.
- Try loading it with the exact game/toolchain it was built for (engine/version mismatches are common).
File association error (double-click opens the wrong app)
Desktop environments may not know what to do with .BSP and may pick an unrelated program.
- Open the map from within the appropriate game/modding tools instead of double-clicking.
- If needed, change the file association to the relevant application on your system.
Corrupted or incomplete download
Because BSPs contain many structured “lumps,” truncated files can fail to load or crash tools that expect valid lump offsets/sizes.
- Re-download or re-copy the file from the original source and verify the transfer completed.
- If you have the original editable map sources, recompile the map (for Source: compile with VBSP as part of the normal compile process).
Security note
Treat .BSP files from unknown sources as untrusted: they are complex binary formats parsed by games/tools, and malformed files can trigger crashes or vulnerabilities in parsers.