Skip to content

SourceIO Forge 5.12.0 for Blender 5.2

Choose a tag to compare

@Tzeentchnet Tzeentchnet released this 13 Oct 01:34
· 66 commits to master since this release

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

  1. Download the zip for your platform below. Each package contains only that platform's native library.
  2. 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.

The Flex controllers panel on TF2's high-detail Heavy, with an asymmetric smile shown as separate left (0.900) and right (0.350) 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.vfx is 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.vfx is 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.

Dota 2's Aegis, a Dire melee creep and Abaddon imported with the rebuilt hero shader

The Radiant base on the dota map with all 5,311 props loaded: the Ancient, barracks, towers and trees. Terrain and most stonework use multiblend.vfx, which is not shaded yet and renders white.

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.

ctf_2fort with its props loaded

Known limitations

  • Dota's terrain and cliff shader (multiblend.vfx), water_dota.vfx and crystal.vfx are 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 dota map 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-cs2 and recompile-cs2 command-line entry points.

See 5.11.1-blender5.2 for the previous release, or view the full comparison.