Source 1 BSP Import

Library

Editor Tool for importing bsp. Creates appropriate GameObjects with their components. Makes use of the mapping MeshComponent.

Doc updated 6mo ago 0 MB engine 25
thumb_up 10 open_in_new View on sbox.game
Source 1 BSP Import
sbox-bsp-import
Editor Tool for decompiling .bsp files and importing their environment into a scene.
The tool itself is supposed to be used to port an environment into scene. It expects you to have referenced content (models, materials, etc) ported or replaced ahead of time. Paths should remain the same.

How to Use:
Use the Bsp Import Menu in the Editor with an open scene, this will open a settings dialog. Select your desired import options and .bsp file, click Import and wait.

Features:
  • Uses the bsp tree to build the world's render mesh, instead of relying on brushes.
  • Rebuild Displacement Meshes with correct orientations.
  • Creates Game Objects for Brush Entities, Meshes and Displacements.
  • Try to create GameObjects & Apply Components for some base entities where appropriate.
  • Separate options to allow for importing only entities, only geometry, or skipping tools materials.
Planned features:
  •  More Entities; basic environment entities should be supported.
  •  Clip materials and similar. These need to be reconstructed.
  •  Vertex paint from displacements.

Issues and bugs:
Please make issues for bsp files the tool can't decompile&import. Provide the bsp and game info if possible. https://github.com/DoctorGurke/sbox-bsp-import

Contribute:
Feel free to contribute via PRs. The decompiler is written in a way where each lump and alterations thereof can be dissected in one type. Check existing Lump types for examples.
For bsp type reference: https://developer.valvesoftware.com/wiki/BSP_(Source)
3,670
Total Users
5,176
Total Sessions
18.0 days
Total Playtime
0 recorded entries
Rank Player Score Recorded
refresh
Discovering package leaderboards...
Package ID: doc.bsp_import
Created: 2024-05-05 23:45 UTC
Updated: 2026-04-10 21:08 UTC
Type: library
Public: Yes
Version: 195813
files: 89
Size: 0.4 MB
Engine Version: 25
Asset Version ID: 195813
Version Created: 2026-04-10 21:08 UTC
Hash: 1791472139
Manifest: Open manifest

more_horiz Additional Properties

Compiler: {"RootNamespace":"BspImport","DefineConstants":"SANDBOX;ADDON;DEBUG","NoWarn":"1701;1702;1591;","WarningsAsErrors":"","Nullables":true,"Whitelist":true,"AssemblyReferences":[],"IgnoreFolders":[],"DistinctAssemblyReferences":[]}
new_releases Latest Update Apr 10, 2026
(Patch) Fallback material for Displacements
195813 Apr 10, 2026
(Patch) Fallback material for Displacements
195811 Apr 10, 2026
Fallback materials
181242 Apr 4, 2026
Fixes, Basic water handling, updated settings
181117 Apr 3, 2026
Add README
181113 Apr 3, 2026
Fixes, Better Game handling & Skybox cull option
179368 Apr 1, 2026
Some small fixes and QOL improvements
169228 Mar 31, 2026
Progress bar
167657 Mar 28, 2026
More Entity Support
167106 Mar 28, 2026
Displacements & Entities
56392 May 6, 2024
Changes on 2024-05-06
info Live API Passthrough & Removal Notice

This file manifest and asset metadata are retrieved live directly from the official Facepunch s&box public API. s&box Explorer does not host, store, or redistribute any package files. All download links route directly to Facepunch CDN servers.