Skip to content

About

Blender 5.2+ SourceIO fork for importing GoldSrc, Source, and Source 2 assets, with CS2 materials, animations, and static-asset authoring.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

Blender Upstream Discord

SourceIO Forge for Blender 5.2+

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.

Highlights

  • 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.

Improvements over upstream

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_2fort by 49%, with DDS staging cutting a later controlled A/B by another 29%, and fully loaded CS2 de_dust2 by 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.

Installation

SourceIO Forge requires Blender 5.2 or newer.

  1. Download the package for your platform from Releases.
  2. In Blender, open Edit > Preferences > Get Extensions.
  3. 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.

Quick start

Import

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.

Export

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.

Command line

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.

Documentation

Scope

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.

Credits

About

Blender 5.2+ SourceIO fork for importing GoldSrc, Source, and Source 2 assets, with CS2 materials, animations, and static-asset authoring.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages