SourceIO Forge is a Blender extension for importing assets from GoldSrc, Source, and Source 2 games. It handles models, maps, materials, textures, animations, physics, and Source 2 sounds, with game-specific support for titles including Team Fortress 2, Counter-Strike 2, and Dota 2.
This repository is the Blender 5.2+ SourceIO Forge fork of REDxEYE/SourceIO. For Blender 4.x, use the upstream add-on. The linked Discord server is also maintained by the upstream project.
Note
Validated Source 1 beta assets are supported. This includes embedded
geometry and armatures, legacy model physics and materials, beta shader
aliases, half-float RGBA16161616F VTF textures, and historical compiled
animations. MDL v32/v35 use fixed per-bone RLE records; transitional v39
uses sparse animation records and its pre-v44 sequence layout.
- Import GoldSrc, Source 1, and Source 2 models and maps.
- Build Blender materials from common Source 1 and Source 2 shaders.
- Import Source 1 and Source 2 animations, including Source 2 animation-graph clips.
- Preserve VTF metadata and export textures and sprite sheets for external editing.
- Extract Source 2 audio.
- Author and optionally compile static assets for CS2 Workshop Tools and Source 1 toolchains, including Source 1 collision meshes and LODs.
- Use the same workflows from Blender's UI, drag and drop, or the command line.
Compared with the upstream baseline this fork started from, it adds:
- Faster imports: indexed material/texture caches, default-enabled direct
DDS staging for compatible Source 1 VTFs, faster PNG staging, and batched
Source 2 aggregate models. Measured warm-cache gates improved TF2
ctf_2fortby 49%, with DDS staging cutting a later controlled A/B by another 29%, and fully loaded CS2de_dust2by 24%. - Broader Source 2 coverage: animation groups and graph clips, more texture formats and subresources, VSND audio, CS2 map lighting/skyboxes, and extensive CS2 and Dota 2 shader support.
- More accurate materials: corrected Source 1 phong, Fresnel, envmap, tint, alpha, sampler, and normal-map behavior, plus richer CS2 character, world, blend, decal, and unlit materials.
- Editable authoring workflows: verified static-asset export, Source 1 collision and LOD authoring, official compiler integration, manifests, and recompile for CS2 Workshop Tools and Source 1 toolchains, including both Source SDK Base 2013 profiles.
- Blender 5.2-native packaging and testing: split-platform extensions, manylinux-compatible binaries, public sample tests, installed-game gates, and official-tool round trips.
See Changes in this fork and the validation baseline for details and measurements.
SourceIO Forge requires Blender 5.2 or newer.
- Download the package for your platform from Releases.
- In Blender, open Edit > Preferences > Get Extensions.
- Choose Install from Disk... and select the downloaded zip.
Packages are available for Windows x64, Linux x64, macOS x64, and macOS arm64. Installing the repository as a legacy add-on remains supported for development checkouts. See Development and testing to build packages from source.
Open File > Import > Source Engine Assets and choose an asset. Most common
formats can also be dragged into Blender, including .mdl, .bsp, .vtf,
.vmt, .vmdl_c, .vmat_c, .vtex_c, .vphys_c, .vmap_c, map .vpk
files, .vsnd_c, and camera .dmx files.
Imported maps initially contain placeholders for referenced models and merged world geometry. Select the placeholders you need and use Load Entity to expand them.
Use File > Export for the supported CS2 Workshop static-asset and Source 1 asset workflows. Source 1 supports static props and an opt-in skeletal reference slice. SourceIO Forge writes editable source files and can optionally invoke the official compilers; it does not silently replace those tools with custom binary writers.
See Asset authoring for supported material graphs, target setup, compilation, and recompile behavior.
With the extension enabled, Blender can run SourceIO Forge without opening the UI:
blender -c sourceio import --output scene.blend ASSET
Import, extraction, authoring, and recompile commands are documented in the user guide.
- User guide — importing, drag and drop, map handling, texture caching, command-line commands, and VTF editing.
- Asset authoring — CS2 Workshop and Source 1 authoring, compiler integration, material limits, and reconstruction exports.
- Supported formats and game coverage.
- Development and testing — building packages, test suites, installed-game gates, and experimental boundaries.
- Changes in this fork — modernization background, major additions, and notable fixes.
- Improvement backlog and validation baseline.
SourceIO Forge aims to produce useful, editable Blender scenes rather than emulate an entire game engine. Shader behavior, map entities, and compiled formats vary between games, so unrecognized games and uncommon assets may receive generic or partial handling.
Static reconstruction from compiled Source 2 resources is intentionally lossy, and current authoring workflows target static assets. SourceIO Forge does not execute AnimGraphs, simulate a Source 2 particle renderer, or claim one-to-one runtime renderer parity.
- SourceIO and its original authors: REDxEYE/SourceIO.
- datamodel.py by Artfunkel.
- ValveResourceFormat for Source 2 format research and attributed MIT-licensed ports.
- BlenderVertexLitGeneric by syborg64.
- equilib by haruishi43.
- HFSExtract by yretenai.
- Better HWM expression handling by hisanimations.