BSP → MAP / LOCAL & PRIVATE

BSP Forge

Recover editable brushwork, entities, and texture alignment from compiled Quake-family maps. Nothing is uploaded.

BSP28BSP29Quake 64BSP2BSP2-RMQHalf-LifeHexen IIQ2 BSP38QBSPBSPX BRUSHLIST

01 / INPUT

Compiled map

Drop a BSP here or click to browse Runs completely in your browser

02 / RECOVERY

Decompiler settings

Geometry source

Uses exact stored brush planes when a BRUSHLIST is present.

Collision hull

Decimal precision

Recover texture alignment Writes Valve 220 axes from BSP texinfo. Split texture boundaries Divides leaf brushes when compiled faces disagree. Merge convex fragments Rejoins BSP-split fragments whose union stays convex. Recover clip brushes Un-expands collision hull 1 to restore clip-only volumes. Extract textures to WAD Writes a matching .wad and sets worldspawn "wad". Forensic comments Annotates recovered models, leaves, and BSPX brushes.

03 / OUTPUT

Your recovered map appears here

Load a BSP to inspect its format, reconstruct convex brushwork, and export editor-ready Valve 220 map source.

Recovered geometry

Scroll or +/− to zoom · drag or arrows to pan

METHOD / TRANSPARENCY

What can—and cannot—be recovered

Prefer original planes

BSPX BRUSHLIST stores source brush bounds and non-axial planes. When present, BSP Forge uses them before attempting inference.

Rebuild convex leaves

For classic BSPs, decision-tree planes are walked into bounded convex volumes, redundant planes are removed, and texture boundaries are split.

Preserve what survives

Entities, submodel origins, face textures, and Valve 220 alignment are retained. Original CSG ordering and brushes erased by compilation cannot be known.

COMPARED WITH BSPUTIL

What BSP Forge adds

Built on the same hard-won understanding of Quake BSPs, with a new recovery path and a browser-native workflow.

GEOMETRY

BSPX source-brush recovery

Reads FTE/ericw BRUSHLIST version 1 and reconstructs its stored bounds and non-axial planes. The current ericw decompile path marks BSPX brush use as a TODO.

DECISIONS

Per-model recovery fallback

Automatically prefers BSPX where available, uses exact Quake II brush lumps, and falls back to BSP-tree reconstruction for models without stored source brushes.

INSPECTION

Visual and forensic feedback

Shows the detected container, chosen geometry path, exact-brush count, output statistics, warnings, and an interactive top-down preview before download.

SAFETY

Untrusted-file guardrails

Checks lump ranges and geometry references, limits traversal depth and cycles, caps preview work, and isolates CPU-heavy recovery in a cancellable Web Worker.

CONTROL

Interactive recovery policy

Switch geometry source, hull, texture recovery, boundary splitting, numeric precision, and forensic comments without learning command-line flags.

DELIVERY

Zero-install, local web app

Runs as a static GitHub Pages tool, keeps BSP data inside the browser, and produces editor-ready MAP downloads on desktop or mobile.

EDITOR FIDELITY

TrenchBroom-native output

Writes deterministic game/format headers, uses stable points from recovered face windings, removes clipped sides, and repairs invalid compiled texture axes.

ENGINE COMPATIBILITY

QSS-M and FTE edge cases

Recognizes prerelease BSP28 and Quake 64 BSPs, reports misaligned lumps, and repairs the swapped entity/plane directory found in some Blue Shift BSP30 maps.

Not a claim that bsputil is obsolete: its native implementation is mature, fast, scriptable, and remains the reference for BSP manipulation. BSP Forge focuses on BSPX-aware recovery, inspection, accessibility, and safe browser use.