Source Pretty Parsers

Several modern C++20 libraries for sanely parsing Valve formats, rolled into one big repository.

Included Libraries

Name	Supports	Read	Write	Wrappers
`bsppp`^*	BSP v17-27	✅	✅
`dmxpp`^*	DMX Binary v1-5	✅	❌
`gamepp`	Get Source engine instance window title/position/size	✅	❌	C Python
`gamepp`	Run commands in a Source engine instance remotely	❌	✅	C Python
`kvpp`	KeyValues Text v1^†	✅	✅
`mdlpp`^*	MDL v44-49	✅	❌
	VTX v7	✅	❌
	VVD v4	✅	❌
`steampp`	Find Steam install folder	✅	-	C Python
`steampp`	Find installed Steam games	✅	-	C Python
`toolpp`	FGD (Source 1) • Hammer++ modifications • Strata Source modifications	✅	✅	Python
`toolpp`	WC (CmdSeq) v0.1-0.2 • Strata Source modifications	✅	✅	Python
`vcryptpp`	VICE encrypted files	✅	✅	C C# Python
`vcryptpp`	VFONT encrypted fonts	✅	❌	C C# Python
`vpkpp`	BMZ	✅	✅	C C#
	BSP v17-27	✅	✅
	FPX v10 (Tactical Intervention)	✅	✅
	GCF v6	✅	❌
	GMA v1-3 (Garry's Mod)	✅	✅
	PAK (Quake, WON Half-Life)	✅	✅
	PCK v1-2 (Godot Engine)	✅	✅
	PK3 (Quake III)	✅	✅
	PK4 (Quake IV, Doom 3)	✅	✅
	VPK pre-v1, v1-2, v54 • Counter-Strike: 2 modifications • Counter-Strike: Source ClientMod modifications	✅	✅
	VPK (Vampire: The Masquerade - Bloodlines)	✅	✅
	WAD v3	✅	✅
	ZIP	✅	✅
`vtfpp`	BMP	✅	✅	Python
	EXR v1	✅	✅
	GIF	✅	❌
	HDR	✅	✅
	JPEG	✅	✅
	PIC	✅	❌
	PNG	✅	✅
	PNM (PGM, PPM)	✅	❌
	PPL v0	✅	✅
	PSD	✅	❌
	TGA	✅	✅
	VTF v7.0-7.6 • Strata Source modifications	✅	✅

(*) These libraries are incomplete and still in development. Their interfaces are unstable and will likely change in the future. Libraries not starred should be considered stable, and their existing interfaces will not change much if at all. Note that wrappers only exist for stable libraries.

(†) Many text-based formats in Source are close to (if not identical to) KeyValues v1, such as VMT and VMF.

Wrappers

Wrappers for libraries considered complete exist for C, C#, and/or Python, depending on the library. The Python wrappers can be found on PyPI in the sourcepp package.

Special Thanks

steampp is based on the SteamAppPathProvider library by @Trico Everfire and Momentum Mod contributors.
vpkpp's GCF parser was contributed by @bt and @ymgve.
vpkpp's WAD3 parser was contributed by @ozxybox.
vtfpp's write support is based on work by @Trico Everfire.

Gallery

A list of projects using the sourcepp parser set. If you'd like to see your project here, make a PR!

VPKEdit: An open source MIT-licensed tool that can create, extract from, preview the contents of and write to several pack file formats. A CLI application is bundled with the program which replicates the functionality of Valve's vpk.exe.
GodotSource: A work-in-progress set of bindings to connect the sourcepp libraries to Godot. Allows GDScript to work with the libraries, and allows Godot to directly load Source engine assets from a user project or from installed Source games.
Verifier: A small program that can build an index of a game's files, and validate existing files based on that index. Think Steam's "Verify integrity of game files" option, but without actually overwriting any files. sourcepp is used to parse Steam depot configs, as well as enable indexing the contents of VPKs.