Skip to content
COG Factory

Generation 2 / Research

Source BSP Import

Inside the research

Imported BSP geometry and sampled baked lighting.

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.

Imported BSP geometry and sampled baked lighting.
Imported BSP geometry and sampled baked lighting.
The original Source player start in Jedi Knight.
The original Source player start in Jedi Knight.

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.

Compiled cover panels and the permanent frame.
Compiled cover panels and the permanent frame.

Back to Research

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.