BSP Version 25

BSP v25 is Strata Source’s modified BSP format that raises many of the baked-in limits that BSP traditionally has. Version 25 was selected to avoid collisions with other projects that are also modifying the BSP map format.

This document goes over the significant changes to the format so non-Strata devs can parse and analyze our maps.

BSP v25 is extremely new right now and is subject to change. Until these changes are finalized and merged into our primary development branch, this format may change without a BSP or lump version increase.

Map Bounds

MAX_COORD_INTEGER was changed to 65536 (from 16k), making the world a max of 131072 units on any axis, spanning from -65k to 65k.

Limit Summary

New Lump Versions

The following table lists current lump versions for all lumps that are versioned in Strata Source:

Structures

In the BSP v25 update, all lumps listed in the lump version table have been modified. This section lists the new structure format for each of those lumps.

struct dphysdisp_t
{
	unsigned int numDisplacements;
	//unsigned int dataSize[numDisplacements]; // Note that the array that follows this is using unsigned int
};

struct dnode_t
{
	int				planenum;
	int				children[2];
	float			mins[3];
	float			maxs[3];
	unsigned int	firstface;
	unsigned int	numfaces;
	short			area;
};

struct DispSubNeighbor_t
{
	unsigned int neighbor;
	unsigned char neighborOrient;
	unsigned char span;
	unsigned char neighborSpan;
};

struct DispNeighbor_t
{
	DispSubNeighbor_t neighbors[2];
};

struct DispCornerNeighbors_t
{
	unsigned int neighbors[4];
	unsigned char neighborCount;
};

class ddispinfo_t
{
	Vector		startPosition;
	int			m_iDispVertStart;
	int			m_iDispTriStart;
    int         power;
    int         minTess;
    float       smoothingAngle;
    int         contents;
	unsigned int	m_iMapFace;
	int			m_iLightmapAlphaStart;
	int			m_iLightmapSamplePositionStart;
	
	DispNeighbor_t			m_EdgeNeighbors[4];
	DispCornerNeighbors_t	m_CornerNeighbors[4];

	enum unnamed { ALLOWEDVERTS_SIZE = 10 };
	unsigned int	m_AllowedVerts[ALLOWEDVERTS_SIZE];
};

struct dedge_t
{
	unsigned int	v[2];
};

struct dprimitive_t
{
	unsigned char	type;
	unsigned int	firstIndex;
	unsigned int	indexCount;
	unsigned int	firstVert;
	unsigned int	vertCount;
};

struct dface_t
{
	unsigned int	planenum;
	byte		side;
	byte		onNode;
	int			firstedge;
	int			numedges;
	int			texinfo;
	int		dispinfo;
	int		surfaceFogVolumeID;
	byte		styles[MAXLIGHTMAPS];
	int			lightofs;
    float       area;
	int			m_LightmapTextureMinsInLuxels[2];
	int			m_LightmapTextureSizeInLuxels[2];
	int origFace;
	unsigned int m_EnableShadows : 1;
	unsigned int m_NumPrims : 31;
	unsigned int	firstPrimID;
	unsigned int	smoothingGroups;
};

struct dfaceid_t
{
	unsigned int	hammerfaceid;
};

struct dfacebrushlist_t
{
	unsigned int	m_nFaceBrushCount;
	unsigned int	m_nFaceBrushStart;
};

struct dleaf_t
{
	int				contents;
	int				cluster;
	int				area:17;
	int				flags:15;
	float			mins[3];
	float			maxs[3];
	unsigned int	firstleafface;
	unsigned int	numleaffaces;
	unsigned int	firstleafbrush;
	unsigned int	numleafbrushes;
	int				leafWaterDataID;
};

struct dleafambientindex_t
{
	unsigned int ambientSampleCount;
	unsigned int firstAmbientSample;
};

struct dbrushside_t
{
	unsigned int	planenum;
	int				texinfo;
	int				dispinfo;
	byte			bevel;
	byte			thin;
};

struct dareaportal_t
{
	unsigned int	m_PortalKey;
	unsigned int	otherarea;
	unsigned int	m_FirstClipPortalVert;
	unsigned int	m_nClipPortalVerts;
	int				planenum;
};

struct dleafwaterdata_t
{
	float	surfaceZ;
	float	minZ;
	int		surfaceTexInfoID;
};

#define OVERLAY_BSP_FACE_COUNT	64
struct doverlay_t
{
	int			nId;
	int			nTexInfo;
	unsigned short	m_nFaceCountAndRenderOrder;
	int			aFaces[OVERLAY_BSP_FACE_COUNT];
	float		flU[2];
	float		flV[2];
	Vector		vecUVPoints[4];
	Vector		vecOrigin;
	Vector		vecBasisNormal;
};

#define WATEROVERLAY_BSP_FACE_COUNT				256
struct dwateroverlay_t
{
	int				nId;
	int				nTexInfo;
	unsigned short	m_nFaceCountAndRenderOrder;
	int				aFaces[WATEROVERLAY_BSP_FACE_COUNT];
	float			flU[2];
	float			flV[2];
	Vector			vecUVPoints[4];
	Vector			vecOrigin;
	Vector			vecBasisNormal;
};