Generation 2 / Research
Source BSP Import
Inside the research
The challenge
Can compiled Source BSP cells, portals, UVs and baked lightmaps become a reusable, walkable vanilla-JK level?
Can compiled Source BSP cells, portals, UVs and baked lightmaps become a reusable, walkable vanilla-JK level?
Research notes
Compiled geometry and light
Source air leaves become convex sectors and matching adjoins; solid detail brushes are subtracted around the cover wall frame. Subdivided world surfaces carry sampled lightmap luminance. Coordinates and texture axes retain their Source orientation at the same scale as the VMF prefab workflow.


A reusable import path
Shared readers cover VMF, VBSP geometry and lightmaps, opaque Source materials and compiled brush models. An explicit authored snapshot and SHA-256 receipt make this experiment repeatable. Unsupported geometry fails with a specific reason; omitted point entities and Source I/O appear in the manifest.
The four panels use simple saved health and collision removal. SPV2 gib bindings are a later integration point. World lighting is baked scalar light; brush models use approximate sector lighting. Retail JK and human acceptance remain unverified.

What we learned
Build 1 passes 9/9 gate checks and 30 library regression fixtures. The compiled jk_breakables BSP converts into a playable singleplayer JKL: 24 closed sectors, 62 portal pairs, four independent brush panels and two indexed materials. Bilinear baked-light samples become scalar vertex lighting without a SED pass. Independent readback checks geometry, solid exclusion, texture axes and 9,192 light samples. Native walking, collision, weapon destruction, save/load, standalone GOB and ordinary play with development hooks disabled pass. The VMF parser and convex fracture helpers now live in the shared library, preserving all 54 previous prefab outputs byte for byte. Human and patched-retail acceptance remain pending.
How to play
Move, jump and fire using your normal controls. A Bryar pistol and stormtrooper rifle are supplied.
Shoot each stone cover panel to open it. The permanent frame remains; hop over the bottom ledge to pass through a broken opening.
Release notes
Put P87.GOB in Jedi Knight's episode/ folder and select BSP Import in Single Player.
Target: Jedi Knight with the Thing and Adjoin limit patches. Human play and patched retail verification remain pending.
World lighting is sampled from the compiled BSP. Brush models use approximate sector lighting. This experiment implements basic panel removal; SPV2 gib bindings are a later integration point.
Credits
Map and textures supplied by SM Sith Lord. Conversion tooling developed in the JK workbench.
Valve Source SDK binary layout references are documented with the shared import libraries. No Source runtime is required.
