Repository navigation
SourceIO Forge 5.12.0 for Blender 5.2
SourceIO for Blender 5.2: a fork of REDxEYE/SourceIO. This release adds Dota 2 map and hero support, Source Filmmaker-style flex controller editing, and a first Counter-Strike 2 Workshop authoring workflow, and fixes prop loading on Source 1 maps and the size of Source 2 entity props.
Install
- Download the zip for your platform below. Each package contains only that platform's native library.
- In Blender 5.2: Edit > Preferences > Get Extensions, open the dropdown in the top right, choose Install from Disk..., and select the zip.
| Platform | File |
|---|---|
| Windows x64 | sourceio-5.12.0-windows_x64.zip |
| Linux x64 | sourceio-5.12.0-linux_x64.zip |
| macOS Apple Silicon | sourceio-5.12.0-macos_arm64.zip |
| macOS Intel | sourceio-5.12.0-macos_x64.zip |
New: SFM-style flex controllers
Stereo (left/right) controllers now edit like Source Filmmaker. Dragging the combined slider adds a change on top of the current left and right values, weighted by the L/R balance, instead of overwriting both sides, so an asymmetric pose such as a one-sided smile survives further edits. Release, Enter or numpad Enter commits; Esc, right-click or leaving the window restores the values from before the drag. With auto-keying on, only the sides that actually changed get keys, and a cancelled or zero-length drag keys nothing. Each controller can still be expanded into its separate left and right sliders.
New: Dota 2 maps and heroes
- Dota 2 is detected as Dota 2. It was previously reported with Counter-Strike's app ID and imported through the CS2 entity handler. It is now also found when you point SourceIO at the install root.
- Dota map entities. A dedicated handler places buildings (towers, barracks, Ancients, shops, fountains), trees, ambient creatures and client-side props as loadable models, triggers as their brush models, and particle systems, spawners, fog-of-war helpers and world layers as labelled markers, each in its own collection. Each imported map gets an entity report (handled, represented, deferred and unsupported classes) on its collection and in the log.
- Hero shader.
hero.vfxis rebuilt from Dota's packed masks: detail layers, metalness, self-illumination, specular, rim light, tint-by-base specular and the specular exponent as roughness.global_lit_simple.vfxis new. - Correct Dota normal maps. Dota stores normal maps with X in the alpha channel; they were decoded as flat, tilted normals and are now reconstructed properly.
New: CS2 Workshop static authoring
File > Export > CS2 Workshop static asset writes the selected meshes (or the active collection or scene) into a CS2 Workshop addon as editable FBX, ModelDoc VMDL, csgo_complex.vfx VMAT and TGA source files, with a preflight report and a manifest. Compile after export runs your installed Resource Compiler; SourceIO never writes compiled Source 2 files itself. The same workflow is available from the command line as blender -c sourceio export-cs2 and recompile-cs2. The supported material subset is deliberately narrow (an existing VMAT, or an opaque Principled BSDF with a constant or single-image base color); anything else is reported in preflight instead of guessed. See the README for details.
Fixes
- Props load on Source 1 maps again. Load Entity on TF2 and other Source 1 maps (MDL v44–v52) failed with
'ModelOptions' object has no attribute 'debug_stereo_balance'(REDxEYE/SourceIO#478). Every prop on the TF2 test maps now loads. - Source 2 entity props are the right size. Props placed by entities (CS2
prop_dynamic/prop_physics, Dota buildings) were scaled twice and came out at 2.5% of their size. Static props from world nodes were not affected.
Known limitations
- Dota's terrain and cliff shader (
multiblend.vfx),water_dota.vfxandcrystal.vfxare not supported yet and render white.
Testing
- Python suite: 507 pass / 4 skip.
- Blender suite: 204 pass / 1 skip, plus the separately run skin tests (8/8).
- Renamed-package smoke: 612/612 modules, with register/unregister/register succeeding.
- Sample imports: 87 PASS / 6 KNOWN / 0 FAIL.
- Installed-game imports with every prop placeholder loaded:
- TF2: 13 PASS / 0 FAIL; ctf_2fort 2,320/2,320, cp_badlands 1,308/1,308, koth_harvest_final 673/673 and pl_upward 1,332/1,332 props.
- Dota 2: 7 PASS / 0 FAIL; the
dotamap loads 5,311/5,311 props. - CS2: 12 PASS / 0 FAIL; de_dust2 698/698, de_inferno 1,365/1,365 and cs_office 647/647 props.
- All four release archives passed Blender extension validation and contain only their declared platform's native payload.
- The Windows package installed and enabled in an isolated Blender profile, completed a disable/enable cycle, and exposed the
export-cs2andrecompile-cs2command-line entry points.
See 5.11.1-blender5.2 for the previous release, or view the full comparison.



