atrblizzard/vtmb-sbox-mounter

This project is a content mounter that lets you load assets from the 2004 game Vampire the Masquerade: Bloodlines inside s&box, a sandbox game made by Facepunch (the studio behind Garry's Mod) that runs on Valve's Source 2 engine. The author calls it a mount, which is the s&box term for a plugin that exposes another game's files (models, textures, sounds) so you can spawn and play with them in the sandbox. The mounter reads Bloodlines' VPK archive files, plus any loose files in the game's models, materials, and sound folders, and optionally the contents of the community Unofficial Patch if that is installed. It auto-detects the Bloodlines install through Steam, so the player does not have to point it at anything by hand. Once it is in place, the assets show up in the s&box asset browser under a vtmb mount, and you can spawn props, NPCs, and player models from there. On the technical side, the README lists which Source-engine file formats are understood: MDL model files version 2531 with skeleton and bone support, body groups (the toggle that swaps mesh variants), vertex weights, and ragdoll physics from .phy files. Textures use Troika's custom TTZ and TTF formats, which the mounter reads directly without needing a separate conversion step. Material files (VMT) are translated into s&box's shader, including base textures, normal maps, transparency, and self-illumination. A few caveats are called out in the Notes section. Materials are converted using a flat PBR default (metalness 0, roughness 1) because the original Source materials predate PBR. Physics collision shapes are simplified to keep the meshes manageable. Skin families, which are material color variants, are wired up in code but currently do not switch correctly at runtime because of a limitation in s&box itself. Installation is one step: drop the mounter's Editor folder into your s&box project with Bloodlines already installed.