Source Pretty Parsers

Several modern C++20 libraries for sanely parsing Valve formats.

Other Languages

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

Included Libraries

Library	Supports	Read	Write	Bindings
bsppp	BSP v17-27 • Console modifications • Left 4 Dead 2 modifications • Strata Source modifications	✅	✅	Python
fspp*	Source 1 filesystem accessor	✅	✅
gamepp	Get Source engine instance window title/position/size	✅	❌	C C# Python
	Run commands in a Source engine instance remotely	❌	✅
kvpp	DMX • Legacy binary v1-2 encoding (binary_vN) • Legacy SFM v1-9 encoding (sfm_vN) • Binary v1-5, v9 encodings (binary, binary_seqids) • srctools encodings (unicode_*)	✅	❌	Python
	KeyValues v1 Binary	✅	✅
	KeyValues v1 Text†	✅	✅
mdlpp*	MDL v44-49	✅	❌
	VTX v7	✅	❌
	VVD v4	✅	❌
sndpp*	WAV	✅	❌
	XWV v0-1, v4	✅	❌
steampp	Find Steam install folder	✅	-	C C# Python
	Find installed Steam games	✅	-
	Find Steam game library assets	✅	-
toolpp	FGD (Source 1) • J.A.C.K. modifications • Hammer++ modifications • Strata Source modifications	✅	✅	Python
	WC (CmdSeq) v0.1-0.2 • Hammer++ modifications • Strata Source modifications	✅	✅
vcryptpp	VICE encrypted files	✅	✅	C C# Python
	VFONT encrypted fonts	✅	✅
vpkpp	007 v1.1, v1.3 (007 - Nightfire)	✅	❌	C C# Python
	APK (Fairy Tale Busters)	✅	✅
	FGP v2-3 (PS3, Orange Box)	✅	✅
	FPX v10 (Tactical Intervention)	✅	✅
	GCF v6	✅	❌
	GMA v1-3 (Garry's Mod)	✅	✅
	HOG (Descent)	✅	❌
	OL (Worldcraft Object Library)	✅	❌
	ORE (Narbacular Drop)	✅	❌
	PAK (Quake, WON Half-Life) • SiN modifications • HROT modifications	✅	✅
	PCK v1-2 (Godot Engine)	✅	✅
	TAB v3 (Avalanche Engine)	✅	✅
	VPK pre-v1, v1-2, v54 • Counter-Strike: 2 modifications • Counter-Strike: Source ClientMod modifications	✅	✅
	VPK (Vampire: The Masquerade - Bloodlines)	✅	✅
	VPP v1-3 (Red Faction)	✅	❌
	WAD v3	✅	✅
	XZP v6 (Xbox, Half-Life 2)	✅	❌
	ZIP • BEE_PACK alias (BEE2.4 Package) • BMZ alias (Source 1 Bonus Maps) • FPK alias (Tactical Intervention) • PK3 alias (Quake III) • PK4 alias (Quake IV, Doom 3) • PKZ alias (Quake II RTX) • XZP2 modifications (X360 & PS3, misc. Source 1 titles)	✅	✅
vtfpp	APNG	✅	❌	C C# Python
	BMP	✅	✅
	EXR v1	✅	✅
	FRAMES (PS3, Orange Box)	✅	❌
	GIF	✅	❌
	HDR	✅	✅
	JPEG	✅	✅
	PIC	✅	❌
	PNG	✅	✅
	PNM (PGM, PPM)	✅	❌
	PPL v0	✅	✅
	PSD	✅	❌
	QOI	✅	✅
	SHT v0-1	✅	✅
	TGA	✅	✅
	TTX (TTH, TTZ) v1.0	✅	✅
	VBF v3	✅	❌
	VTF v7.0-7.6 • Strata Source modifications • XTF v5.0 (Xbox, Half-Life 2) • VTFX v8 (X360 & PS3, Orange Box) • VTF3 v8 (PS3, Portal 2 & CS:GO)	✅	✅
	WebP	✅	✅

(*) 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.

Gallery

Anything using the sourcepp parser set that I know of, directly or indirectly.

These are only the tools and games using sourcepp that I know of. If you would like to be listed here, email me or join my Discord server, I'd love to hear from you!

Tools

• fgptool: A tool to crack the filepath hashes in The Orange Box PS3 file groups.
• fOptimizer: A GUI-based collection of tools written in Python for cutting down on unnecessarily bloated Garry's Mod addon sizes.
• gimp-vtf: A GIMP plugin to load and save VTF files.
• gm_addon_optimization_tricks: A desktop tool to optimize Garry's Mod addons/maps.
• 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.
• MareTF: An open source MIT-licensed CLI/GUI tool that can create, extract from, preview the contents of and write to every variant of VTF file. Replicates the functionality of Valve's vtex.exe and VTFEdit.
• Myst IV: Revolution: Performs various fixes for the game Myst IV: Revelation.
• PBR-2-Source: A Python-powered GUI for converting PBR materials into materials compatible with the Source engine.
• QVTF++: A QImageIO plugin to load VTF textures, based on panzi's QVTF plugin.
• RectMaker: A freeware GUI tool that can create and modify .rect files used in Hammer++'s hotspotting algorithm.
• reloaded2ps3: Convert the PC version of Portal Reloaded to a playable PS3 game.
• Verifier: A small program that can build an index of a game's files, and validate existing files based on that index. Similar to Steam's "Verify integrity of game files" option, but without overwriting any files.
• VPKEdit: An open source MIT-licensed CLI/GUI tool that can create, extract from, preview the contents of and write to several pack file formats. Replicates the functionality of Valve's vpk.exe and GCFScape.
  • bsp-linux-fix: Patches maps which have improperly cased packed assets by repacking the assets, fixing an issue on Linux.
  • CS2-EomVotesFix: Fixes displaying workshop map names and thumbnails during end-of-match voting for LAN events.
  • dham: Modifies Dota 2 hero aliases based on a configuration file and packages the changes.
  • Linux BSP Case Folding Workaround: A bash script designed to resolve issues with improperly cased packed map assets in Source engine games on Linux. Extracting the assets allows the game to find them properly.
  • props_scaling_recompiler: Allows converting prop_scalable into a static prop, effectively implementing static prop scaling outside CS:GO.
  • rock:sail: CS2 client-side tool to use skins for free (only visible to the user of the tool).
  • vpk2wad_nd: Converts textures in a VPK to a WAD that can be used by Narbacular Drop maps.
• VTF Forge: A modern multiplatform recreation of VTFEdit, using Qt.
• WifeRadiant: The open-source, cross-platform level editor for idTech, Source Engine, and GoldSrc based games.

Games

	Local addon assets are packed with sourcepp. Verifier and VPKEdit are shipped with the game.
	Some bundled textures are created and/or compressed with MareTF. Some bundled assets are packed with VPKEdit.
	Game assets are packed with VPKEdit.

Special Thanks

• bsppp
  • Partial library redesign, lump compression and game lump parsing/writing support contributed by @Tholp.
• kvpp
  • Support for DMX srctools formats was contributed by @TeamSpen210.
• mdlpp
  • Most of the components of the parsers were contributed by @cueki.
• steampp
  • Based on the SteamAppPathProvider library by @Trico Everfire and Momentum Mod contributors.
• vpkpp
  • 007 parser is based on reverse-engineering work by Alhexx.
  • GCF parser was contributed by @eepycats and @ymgve.
  • HOG parser was contributed by @erysdren.
  • OL parser is based on reverse-engineering work by @erysdren.
  • ORE parser is based on reverse-engineering work by @erysdren.
  • VPP parser was contributed by @erysdren.
  • WAD3 parser/writer was contributed by @ozxybox.
• vtfpp
  • NICE/Lanczos-3 resize filter's initial implementation was contributed by @koerismo.
  • Big-endian support is based on work by @partyvan.
  • Distance to alpha support was contributed by @partyvan.
  • SHT parser/writer was contributed by @Trico Everfire.
  • Initial VTF write support was loosely based on work by @Trico Everfire.
  • HDRI to cubemap conversion code is modified from the HdriToCubemap library by @ivarout.