Skip to content

Releases

SourceIO Forge 5.16.2 for Blender 5.2

Choose a tag to compare

@Tzeentchnet Tzeentchnet released this 16 Nov 00:50

SourceIO Forge 5.16.2 for Blender 5.2 and newer adds compiled animation support for legacy Half-Life 2 beta MDLs.

Highlights

  • MDL v32/v35/v36 animations: decodes the 92-byte legacy animation descriptors, fixed 32-byte per-bone records, and signed-16-bit {valid,total} RLE channels.
  • Transitional MDL v39 animations: parses the pre-v44 sequence layout and decodes sparse linked animation records through the shared SourceIO sparse/RLE path.
  • Blender Actions: imports decoded legacy clips as playable Actions with bone channels, keyframes, and frame ranges while preserving the model rest pose.
  • Versioned SourceIO structures: adds dedicated v32, v35/v36, and v39 sequence structures and validates descriptor, record, flag, link, and stream offsets explicitly.
  • Decoder hardening: malformed sparse links and RLE streams now fail with contextual errors instead of producing partial animation data.

Installation

Download the ZIP for your platform and choose Edit > Preferences > Get Extensions > Install from Disk... in Blender.

Platform Package
Windows x64 sourceio-5.16.2-windows_x64.zip
Linux x64 sourceio-5.16.2-linux_x64.zip
macOS Intel sourceio-5.16.2-macos_x64.zip
macOS Apple Silicon sourceio-5.16.2-macos_arm64.zip

SHA-256 checksums are provided in sourceio-5.16.2-sha256.txt.

Scope and validation

  • The full non-Blender suite passed 685 tests with 7 skips; the final release gate passed all 54 MDL tests, including 17 focused legacy-MDL tests.
  • A real v35 Helperbones clip was compared against 198 source-SMD poses with a maximum quaternion-component error of 0.00002779.
  • Blender 5.2.2 LTS and Blender 5.3.0 produced a validated 100-frame Action with 35 F-curves and 100 keys per curve.
  • All four archives passed Blender extension validation, ZIP CRC/integrity, manifest/version/platform checks, checksum verification, source-content exclusions, and platform-specific native-library pruning checks.
  • The Windows archive installed, enabled, registered, and loaded 637 SourceIO submodules in an isolated Blender 5.2.2 environment. Linux and macOS packages were validated structurally but were not executed on those platforms.
  • Movement tracks, IK rules, and autolayer playback are not yet implemented. Animated v39 corpus evidence remains limited, so v39 support is backed by the observed binary layout, shared decoder behavior, and regression fixtures rather than broad real-file playback coverage.
  • No proprietary corpus files are included in the packages or repository.

See the full comparison with 5.16.1.

SourceIO Forge 5.16.1 for Blender 5.2

Choose a tag to compare

@Tzeentchnet Tzeentchnet released this 15 Nov 22:28

SourceIO Forge 5.16.1 for Blender 5.2 and newer adds evidence-backed support for the reviewed Half-Life 2 beta asset corpus.

Highlights

  • Embedded beta MDLs: imports versions 32, 35, 36, and the transitional embedded-geometry version 39 without requiring VVD files.
  • Legacy VTX companions: supports VTX v6 two- and three-bone records plus .dx7_2bone.vtx companion fallback.
  • Beta physics: reads wrapperless PHY solids and imports collision trees whose root is not itself convex.
  • Beta materials: parses assignment-style $key = value VMTs and maps VertexLitTexture, AddTexture, BaseTimesVertexColor/MouthShader, and Eyeball to supported handlers.
  • SMD/VTA compatibility: recovers observed legacy exporter output with repeated indexed nodes and agreeing pose blocks, non-normalized vertex links, and vertex-animation-only VTAs.
  • Honest animation boundary: historical compiled sequence records in beta MDL versions 32, 35, and 39 remain unsupported; geometry, armatures, materials, skins, topology, and paired collision import normally.

Installation

Download the ZIP for your platform and choose Edit > Preferences > Get Extensions > Install from Disk... in Blender.

Platform Package
Windows x64 sourceio-5.16.1-windows_x64.zip
Linux x64 sourceio-5.16.1-linux_x64.zip
macOS Intel sourceio-5.16.1-macos_x64.zip
macOS Apple Silicon sourceio-5.16.1-macos_arm64.zip

SHA-256 checksums are provided in sourceio-5.16.1-sha256.txt.

Scope and validation

  • 678 Python tests passed with 7 skips.
  • The focused beta dispatch/material gate passed 4 tests and 26 subtests on both Blender 5.2.2 LTS and Blender 5.3.0.
  • All 13,982 SMD and 76 VTA files in the local review corpus parsed successfully, covering 2,543,108,642 bytes and 5,194,451 triangles.
  • Real v32, v35, and v39 beta models produced identical render, armature, material, and physics results on Blender 5.2.2 and 5.3.0.
  • All eight assignment-style beta VMTs and all six DX7/DX80 VTX companions passed the archive gate.
  • All four archives passed Blender extension validation, ZIP integrity, manifest/version checks, checksum verification, source-content exclusions, and platform-specific native-library pruning checks.
  • The Windows package installed and passed an isolated disable/enable lifecycle test on Blender 5.2.2. Linux and macOS packages were validated structurally but were not executed on those platforms.
  • No proprietary corpus files are included in the packages or repository.

See the full comparison with 5.16.0.

SourceIO Forge 5.16.0 for Blender 5.2

Choose a tag to compare

@Tzeentchnet Tzeentchnet released this 15 Nov 20:15

SourceIO Forge 5.16.0 for Blender 5.2 and newer expands the validated Source 1 authoring workflow from static props to typed model recipes and an opt-in skeletal reference slice.

Highlights

  • Source 1 collision and LOD authoring: tag Blender collections for deterministic static collision and any number of LOD replacements through the existing safe staging, manifest, and compiler pipeline.
  • SMD/VTA model API: adds a Blender-independent parser, validator, loader, and deterministic dumper for skeletal SMD and vertex-animation data.
  • Typed QC recipes: authors bodygroups and blank choices, skin families, attachments, and hitboxes without raw QC injection.
  • Skeletal references: opt-in --skeletal export captures a deterministic rest-pose hierarchy and normalized vertex weights while preserving Blender pose state.
  • Expanded Source 1 materials: adds typed self-illumination, envmap, rim-light, phong albedo tint, and explicit scalar PBR-to-phong conversion.
  • Preserved safety boundaries: skeletal collision, animation clips, flex authoring, DMX, and texture-driven PBR conversion remain explicit deferred errors rather than silent lossy fallbacks.

Installation

Download the ZIP for your platform and choose Edit > Preferences > Get Extensions > Install from Disk... in Blender.

Platform Package
Windows x64 sourceio-5.16.0-windows_x64.zip
Linux x64 sourceio-5.16.0-linux_x64.zip
macOS Intel sourceio-5.16.0-macos_x64.zip
macOS Apple Silicon sourceio-5.16.0-macos_arm64.zip

SHA-256 checksums are provided in sourceio-5.16.0-sha256.txt.

Scope and validation

  • 658 Python tests passed with 7 skips.
  • 310 Blender tests, 67 Blender subtests, and 8 separate skin tests passed with 2 skips on each of Blender 5.2.2 LTS and Blender 5.3.0.
  • The focused Source 1 authoring suite passed 67 parser/backend tests plus 13 Blender adapter tests on both supported Blender versions.
  • The renamed-package smoke imported 640/640 modules and passed register/unregister/register on both Blender versions.
  • Official TF2 VTEX/StudioMDL accepted the weighted skeletal reference, bodygroup, skin, attachment, hitbox, typed VMT, and scalar PBR fixture; generated bones were verified through MDL re-import.
  • Source SDK Base 2013 Singleplayer and Multiplayer both compiled, re-imported, and manifest-recompiled the disposable collision/LOD and typed-material fixture.
  • All four archives passed Blender extension validation, ZIP integrity, manifest/version checks, checksum verification, source-content exclusions, and platform-specific native-library pruning checks.
  • The Windows package installed and passed a disable/enable cycle in an isolated Blender 5.2.2 profile. Linux and macOS packages were validated structurally but were not executed on those platforms.

See the full comparison with 5.15.2.

SourceIO Forge 5.15.2 for Blender 5.2

Choose a tag to compare

@Tzeentchnet Tzeentchnet released this 12 Nov 00:34

SourceIO Forge 5.15.2 for Blender 5.2 and newer adds Blender 5.3 NPR material compatibility and exact Source 1 writable search-path support while preserving the Blender 5.2 and Principled defaults.

Highlights

  • SourceIO Forge identity: updates the public add-on name, repository links, and project branding while preserving the sourceio extension ID and Python package.
  • Blender 5.3 NPR materials: adds the closure-based VertexLitGeneric graph with light warp, $phongwarptexture, and renderer-specific EEVEE/Cycles outputs.
  • Blender 5.2 compatibility: retains the legacy NPR node asset byte-for-byte; the Principled material path remains the default on every supported Blender version.
  • Source 1 game_write: mounts exact, case-insensitive game_write search-path keys in gameinfo.txt declaration order so assets available only through writable roots can resolve.
  • Beta support documentation: prominently documents support for Source 1 beta layouts, shader aliases, and half-float RGBA16161616F VTF textures.

Installation

Download the ZIP for your platform and choose Edit > Preferences > Get Extensions > Install from Disk... in Blender.

Platform Package
Windows x64 sourceio-5.15.2-windows_x64.zip
Linux x64 sourceio-5.15.2-linux_x64.zip
macOS Intel sourceio-5.15.2-macos_x64.zip
macOS Apple Silicon sourceio-5.15.2-macos_arm64.zip

SHA-256 checksums are provided in sourceio-5.15.2-sha256.txt.

Scope and validation

  • 607 Python tests passed with 7 skips.
  • 301 Blender tests, 67 Blender subtests, and 8 separate skin tests passed with 2 skips on each of Blender 5.2.2 LTS and Blender 5.3.0.
  • The focused Source 1 material suite passed 44 tests and 30 subtests on both Blender versions.
  • The renamed-package smoke imported 639/639 modules and passed register/unregister/register on both Blender versions.
  • Controlled renders verified light-warp changes in EEVEE on both versions and the new phong-warp effect in Blender 5.3 EEVEE; the renderer-specific Cycles path remained unchanged.
  • All four archives passed Blender extension validation, ZIP integrity, manifest/version checks, checksum verification, source-content checks, and platform-specific native-library pruning checks.
  • The Windows package was installed and passed a disable/enable cycle in an isolated Blender 5.2.2 profile. Linux and macOS packages were validated structurally but were not executed on those platforms.
  • Synthetic coverage verifies game_write ownership, lookup, and precedence. Validation against an installed Half-Life 2: Episode Two corpus remains pending.

See the full comparison with 5.15.1.

SourceIO Forge 5.15.1 for Blender 5.2

Choose a tag to compare

@Tzeentchnet Tzeentchnet released this 10 Nov 05:29

SourceIO 5.15.1 for Blender 5.2 and newer improves compatibility with Portal-era Source 1 beta assets and incorporates upstream packed blend-index handling.

Highlights

  • Half-float HDR textures: decode Source 1 RGBA16161616F VTF images across legacy and resource-directory layouts, including mipmaps, frames, volume slices, and legacy cubemaps.
  • More reliable Source 1 models: resolve mesh and eye materials through MDL skin-family tables, including duplicate and remapped slots.
  • Split-model validation: reject mismatched MDL/VVD/VTX checksums and out-of-range topology before mesh creation, with checksum comparisons normalized across signed and unsigned headers.
  • Legacy material aliases: recognize beta-era SDK_*, sprite, SpriteCard, and eyeball shader names.
  • Source 2 blend indices: decode index-only signed int32 packed blend-index attributes consistently with the weighted path.

Installation

Download the ZIP for your platform and choose Edit > Preferences > Get Extensions > Install from Disk... in Blender.

Platform Package
Windows x64 sourceio-5.15.1-windows_x64.zip
Linux x64 sourceio-5.15.1-linux_x64.zip
macOS Intel sourceio-5.15.1-macos_x64.zip
macOS Apple Silicon sourceio-5.15.1-macos_arm64.zip

SHA-256 checksums are provided in sourceio-5.15.1-sha256.txt.

Scope and validation

  • 606 Python tests passed with 7 skips.
  • 295 Blender tests and 67 Blender subtests passed with 2 skips under Blender 5.2.3 LTS.
  • A Portal-era beta corpus audit covered 779 MDL, 1,863 VTX, 733 VVD, 543 PHY, 2,811 VTF, 2,335 VMT, 352 BSP, and 10 VPK indexes. The only incomplete bundles were repeated appearances of two confirmed archive defects.
  • Eleven representative beta assets spanning MDL 44/45/46/48/49, half-float HDR VTF, legacy VMT, and BSP 20/21/25 were imported, saved as .blend, and reopened successfully.
  • All four release archives passed Blender extension validation, ZIP integrity checks, manifest/version checks, source-content checks, and platform-specific native-library pruning checks.
  • The Windows package was installed and passed a disable/enable cycle in an isolated Blender 5.2.3 profile. Linux and macOS packages were validated structurally but were not executed on those platforms.

See the full comparison with 5.15.0.

SourceIO Forge 5.15.0 for Blender 5.2

Choose a tag to compare

@Tzeentchnet Tzeentchnet released this 27 Oct 03:29

SourceIO 5.15.0 for Blender 5.2 and newer adds Source 1 static-asset authoring, expands CS2 material authoring, and improves import fidelity and speed.

Highlights

  • Source 1 static authoring: export editable SMD, QC, VMT and texture sources, with optional VTEX and StudioMDL compilation and manifest-based recompile. The documented validation targets include TF2 and both Source SDK Base 2013 profiles.
  • CS2 Workshop authoring: support normal maps, roughness, metalness and alpha-tested materials in the static-asset workflow.
  • More accurate Source 1 materials: updates to phong, Fresnel, environment maps, detail textures and VTF clamp behavior.
  • Faster imports: compatible single-frame DXT1/DXT5 VTFs can use default-enabled DDS staging, with the existing decoded-PNG path retained for unsupported or transformed inputs. Source 2 imports also reuse compatible draw-call materials and batch aggregate models.
  • Texture metadata and flex controls: preserve reconstructed VTF metadata for TTH/TTZ imports and resolve a unique flex-enabled child mesh when its armature is active.
  • Linux compatibility: ship a manylinux_2_28 native library with statically linked C++ runtimes.

Installation

Download the ZIP for your platform and choose Edit > Preferences > Get Extensions > Install from Disk... in Blender.

Platform Package
Windows x64 sourceio-5.15.0-windows_x64.zip
Linux x64 sourceio-5.15.0-linux_x64.zip
macOS Intel sourceio-5.15.0-macos_x64.zip
macOS Apple Silicon sourceio-5.15.0-macos_arm64.zip

SHA-256 checksums are provided in sourceio-5.15.0-sha256.txt.

Scope and validation

  • Authoring targets static assets; skeletal animation, flex, physics and world authoring are not included. CS2 true alpha blending and emission are not yet supported by the authoring workflow.
  • All four archives passed Blender extension validation, ZIP integrity and source-content checks, and native-architecture checks.
  • Focused validation passed: 71 Python tests, 57 Blender tests, and 3 Blender subtests.
  • The Windows package was installed and enabled in an isolated Blender 5.2.2 profile, passed a disable/enable cycle, and imported a sample model through the installed CLI. The sample's referenced materials were unavailable.
  • Linux and macOS packages were validated structurally but were not executed on those platforms for this release.

See the authoring guide and full comparison with 5.14.0.

SourceIO Forge 5.14.0 for Blender 5.2

Choose a tag to compare

@Tzeentchnet Tzeentchnet released this 15 Oct 23:34

SourceIO for Blender 5.2: a fork of REDxEYE/SourceIO. This release reads Source 1 particle sprite sheets and the other metadata a VTF carries, and adds Export for External Editing. It writes a VTF out for Photoshop or any other image editor, together with the files Valve's mksheet and vtex need to build it back into a VTF.

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.14.0-windows_x64.zip
Linux x64 sourceio-5.14.0-linux_x64.zip
macOS Apple Silicon sourceio-5.14.0-macos_arm64.zip
macOS Intel sourceio-5.14.0-macos_x64.zip

VTF sprite sheets: import, export, edit, rebuild

Particle textures (SpriteCard materials) pack many frames into one VTF, plus a sprite sheet that says which rectangle is which frame of which animation sequence. Until now SourceIO imported only the pixels.

1. Import

Import a VTF as before: File > Import > Source Engine Assets, drag and drop, or through a material on a model or map. The Blender image now also stores:

  • sourceio_vtf_version, sourceio_vtf_flags, sourceio_vtf_frames and, for sheets, sourceio_sprite_sheet_sequences;
  • sourceio_vtf_metadata: JSON with the header and every resource. That covers the sprite sheet (sequences, loop setting, frame timing and rectangles), LOD clamp, CRC, VTFLib keyvalues and Strata Source hotspot rectangles.

Blender has no Image Editor panel for an image's custom properties. Read them in the Python console, for example bpy.data.images["flamepuff"]["sourceio_vtf_metadata"], or export the image and open name.vtf.json.

2. Export for editing

In the Image Editor, with an image imported from a VTF, choose Image > Export for External Editing..., pick a folder, and choose TGA or PNG. To work on .vtf files directly, without opening Blender's UI:

blender -c sourceio extract-vtf --output DIR [--format tga|png] [--overwrite] FILE.vtf [FILE.vtf ...]

For a texture named name the folder gets:

File Contents
name.tga The whole texture, ready for Photoshop. HDR textures are written as .exr.
name.sht The sheet exactly as stored in the VTF.
name_NNN.tga One image per sheet frame, each written once even when several sequences use it.
name.mks The sequences, loop settings and frame timing, in mksheet's format.
name.vtf.json The header, every resource, and each frame's pixel rectangle and file.

A texture without a sheet gets only the image and the JSON.

3. Edit and rebuild

SourceIO's own Export to VTF can't write a sprite sheet, so the edited texture is compiled with vtex (and mksheet) from a game's bin folder. Team Fortress 2 and the Source SDK ship both. Pick one route:

Route 1: keep the layout and edit the whole image. Paint over name.tga, keeping each frame inside its cell, then:

vtex name.tga

vtex finds name.sht next to the image and attaches it unchanged, so the sheet comes back byte for byte.

Route 2: change the frames. Edit name_NNN.tga (frames may change size), or edit name.mks to change timing, looping, or which frames a sequence uses. Then:

mksheet name.mks
vtex name.tga

mksheet packs the frames into a new name.tga and name.sht in its own layout. It replaces both files, so edit either the frames or the whole image, not both.

vtex expects its input inside the game's materialsrc folder. Pass -outdir DIR (and -game <game folder> if vtex can't find gameinfo.txt) to compile from anywhere else.

Examples

These come from TF2 textures exported with extract-vtf. In the first, flamepuff was rebuilt both ways with TF2's own tools:

flamepuff.vtf exported for editing. Top: flamepuff.tga with its 18 frames outlined and numbered, the whole-image route. Middle: the first nine of the frame images flamepuff_000.tga to flamepuff_017.tga, and the start of flamepuff.mks. Bottom: the atlas mksheet built from those frames: the same 18 frames in mksheet's own 1024 x 512 layout.

animated_cow.vtf: a 128 x 128 sheet with one looping sequence of 16 frames, outlined and numbered, and the start of its .mks file.

animated_cow.mks as exported:

// Sprite sheet of animated_cow.vtf, written by SourceIO.
// 'mksheet animated_cow.mks' packs these frames into animated_cow.tga and animated_cow.sht for vtex,
// replacing both. To keep the original layout, edit animated_cow.tga instead and skip mksheet.

sequence 0
loop
frame animated_cow_000.tga 1
frame animated_cow_001.tga 1
...

Sheets made with packmode rgb+a

mksheet's packmode rgb+a packs the color frames and the alpha frames separately, so the two layers overlap in the atlas. The sheet doesn't record which sequence is color and which is alpha, so each exported frame image mixes the two. The export detects the overlap and warns, in Blender, on the command line, and at the top of the .mks. Use route 1 for these sheets. One of TF2's 273 sheets, effects/workshop/vistasmokev1, is packed this way:

vistasmokev1.vtf, RGB and alpha side by side. The color frames use a 341-pixel grid (blue) and the alpha frames a 170-pixel grid (orange) over the same pixels.

Known limitations

  • Sprite sheets don't animate in Blender. Source 1 has no SpriteCard shader and no particle (.pcf) import yet.
  • Export for External Editing writes the one image Blender holds. For a multi-frame (animated) VTF that is only the first frame when the VTF was imported directly. When a material imported it as an image sequence, the menu item refuses it. Use extract-vtf for these; it writes one image per frame.
  • Textures stored as .tth/.ttz pairs don't get the metadata yet.

Testing

  • Rebuilt with Valve's tools: every one of TF2's 273 sprite-sheet textures was exported and rebuilt with TF2's own mksheet and vtex:
    • Route 1 (whole image plus .sht): every sheet came back byte for byte, with identical pixels.
    • Route 2 (mksheet from the frame images): every sheet kept its sequences, loop settings, timing and frame pixels.
    • effects/workshop/vistasmokev1 is the only sheet flagged as packmode rgb+a.
  • Python suite: 523 pass / 4 skip, including 15 new tests for VTF metadata and export.
  • Blender suite: 222 pass / 1 skip, including 3 new tests: import tagging, and the export operator matching the direct VTF export file for file.
  • Renamed-package smoke: 617/617 modules, with register/unregister/register succeeding.
  • Sample imports: 87 PASS / 6 KNOWN / 0 FAIL.
  • Packages: all four release archives passed Blender extension validation and contain only their declared platform's native library. The Windows package installed and enabled in an isolated Blender profile, ran extract-vtf, completed a disable/enable cycle, and registered Export for External Editing.
  • Not yet tried by hand: the Image > Export for External Editing menu item and its folder picker were tested headless (the operator itself) but not clicked through in an open Blender window.

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

SourceIO Forge 5.13.1 for Blender 5.2

Choose a tag to compare

@Tzeentchnet Tzeentchnet released this 13 Oct 07:07

SourceIO for Blender 5.2: a fork of REDxEYE/SourceIO. This release shades Dota 2's terrain, cliffs, crystals and water, which rendered white in 5.12.0, keeps Dota's destroyed-base layers from being drawn over the intact bases, imports Source 1 characters with all of their animations by default, and gives CS2's nameless map models readable names. It replaces 5.13.0, which made Dota terrain and props reflect the sky (see Fixes).

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.13.1-windows_x64.zip
Linux x64 sourceio-5.13.1-linux_x64.zip
macOS Apple Silicon sourceio-5.13.1-macos_arm64.zip
macOS Intel sourceio-5.13.1-macos_x64.zip

Dota 2: terrain, crystals and water

  • Terrain and cliffs. multiblend.vfx (Dota's terrain, cliffs and most rocks; 14 materials on the dota map) blends up to four layers where the mapper painted them. Each layer shows where its painted amount passes its reveal mask, softened by the painted softness and tinted per layer and by the painted tint; normals and specular blend the same way. This follows VRF's port of the shader. Dota's painted vertex data also no longer gets corrupted on import (two of its three streams were flipped like texture coordinates).
  • Crystals. crystal.vfx shows its interior cube map on the back faces and the exterior one blended over the front, with the shader's tint and Fresnel terms.
  • Water. water_dota.vfx is a tinted, refracting surface with the shader's world-space normals and reflection highlight.
  • Crystal and water have no VRF port; both were rebuilt from the game's compiled shaders.

The Radiant base on the dota map with all 5,311 props loaded: grass, sand and stone paths now blend where the mapper painted them. In 5.12.0 the same ground rendered white.

Dota 2: world layers

Map geometry and entities that belong to a world layer go into a collection per layer under the map's world_layers collection. Layers the game doesn't show when the map starts (world_layer_dire_destruction and world_layer_radiant_destruction: the scorched ground, lava cracks and rubble of a fallen base) are excluded from the view layer; tick a layer's checkbox in the outliner to show it. Before, both states were drawn on top of each other.

Source 1: all of a character's animations

With Load animations on, animations in a model's include models now load by default, and each animation is its own action, as with Source 2 (Compact animations is now off by default; turn it on for the old one-action-per-model layout). The HL2 dog gets all 134 of its animations from dog_animations.mdl and its other include models; before, only @ragdoll came in. The armature is left in its rest pose instead of on the last animation imported, which was often a delta pose that twisted the model on its own (the TF2 sentry's d.a_pitch_up).

CS2: readable names for nameless map models

Models the map compiler generates are already named after what they were made for. Those whose compiled name says nothing (nomerge3, mesh_cm00_lp<hash>) are now renamed after their material when Load Entity loads them: de_dust2's 14 skybox cloud cards become nuke_clouds_002 instead of nomerge1 to nomerge44. Models with several materials keep their name.

Fixes

  • Dota terrain and props no longer reflect the sky. In 5.13.0, Dota's terrain (multiblend.vfx) and most props (global_lit_simple.vfx) read their specular texture as physical reflectance, about 12 times too strong, so grass and stone shone like wet stone and whole terrain tiles showed a pale haze. The game uses that texture only to scale a highlight from the map's sun, so it is now read the way the hero shader reads its specular mask. Its green channel no longer makes surfaces glow: no version of either shader uses it.

Known limitations

  • Dota water doesn't flow: where the flow map sits is set by the game at runtime, so its average strength is used. In EEVEE the riverbed doesn't show through the water (Cycles refracts it); Source 1 water behaves the same way.
  • The crystal shader's sun highlight and bloom aren't reproduced. Multiblend parallax, scrolling UVs and world-space UVs aren't handled.

Testing

  • Python suite: 508 pass / 4 skip.
  • Blender suite: 219 pass / 1 skip, plus the separately run skin tests (8/8).
  • Renamed-package smoke: 614/614 modules, with register/unregister/register succeeding.
  • Sample imports: 87 PASS / 6 KNOWN / 0 FAIL.
  • Dota 2 with every prop placeholder loaded: 7 PASS / 0 FAIL; the dota map loads 5,311/5,311 props with no unsupported shaders, and its two destruction layers start excluded. The Dota 2 Workshop Tools round trip compiles and re-imports a generated model, material and texture.
  • TF2 and CS2 were run on 5.13.0 (5.13.1 changes only the two Dota shaders): TF2 13 PASS / 0 FAIL with every placeholder loaded (ctf_2fort 2,320/2,320, cp_badlands 1,308/1,308, koth_harvest_final 673/673, pl_upward 1,332/1,332 props); CS2 12 PASS / 0 FAIL, and de_dust2 with every placeholder loaded: 698/698 props, 53 of its 54 nameless world models named after their material (the other uses three materials).
  • All four release archives passed Blender extension validation and contain only their declared platform's native library.
  • 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.12.0-blender5.2 for the previous full release, or view the full comparison.

SourceIO Forge 5.13.0 for Blender 5.2

Choose a tag to compare

@Tzeentchnet Tzeentchnet released this 13 Oct 06:25

Known issue, fixed in 5.13.1: Dota 2 terrain and most props reflect the sky far too strongly in this release, which shows as a pale haze over whole terrain tiles. Use 5.13.1 instead.

SourceIO for Blender 5.2: a fork of REDxEYE/SourceIO. This release shades Dota 2's terrain, cliffs, crystals and water, which rendered white in 5.12.0, keeps Dota's destroyed-base layers from being drawn over the intact bases, imports Source 1 characters with all of their animations by default, and gives CS2's nameless map models readable names.

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.13.0-windows_x64.zip
Linux x64 sourceio-5.13.0-linux_x64.zip
macOS Apple Silicon sourceio-5.13.0-macos_arm64.zip
macOS Intel sourceio-5.13.0-macos_x64.zip

Dota 2: terrain, crystals and water

  • Terrain and cliffs. multiblend.vfx (Dota's terrain, cliffs and most rocks; 14 materials on the dota map) blends up to four layers where the mapper painted them. Each layer shows where its painted amount passes its reveal mask, softened by the painted softness and tinted per layer and by the painted tint; normals and specular blend the same way. This follows VRF's port of the shader. Dota's painted vertex data also no longer gets corrupted on import (two of its three streams were flipped like texture coordinates).
  • Crystals. crystal.vfx shows its interior cube map on the back faces and the exterior one blended over the front, with the shader's tint and Fresnel terms.
  • Water. water_dota.vfx is a tinted, refracting surface with the shader's world-space normals and reflection highlight.
  • Crystal and water have no VRF port; both were rebuilt from the game's compiled shaders.

Dota 2: world layers

Map geometry and entities that belong to a world layer go into a collection per layer under the map's world_layers collection. Layers the game doesn't show when the map starts (world_layer_dire_destruction and world_layer_radiant_destruction: the scorched ground, lava cracks and rubble of a fallen base) are excluded from the view layer; tick a layer's checkbox in the outliner to show it. Before, both states were drawn on top of each other.

Source 1: all of a character's animations

With Load animations on, animations in a model's include models now load by default, and each animation is its own action, as with Source 2 (Compact animations is now off by default; turn it on for the old one-action-per-model layout). The HL2 dog gets all 134 of its animations from dog_animations.mdl and its other include models; before, only @ragdoll came in. The armature is left in its rest pose instead of on the last animation imported, which was often a delta pose that twisted the model on its own (the TF2 sentry's d.a_pitch_up).

CS2: readable names for nameless map models

Models the map compiler generates are already named after what they were made for. Those whose compiled name says nothing (nomerge3, mesh_cm00_lp<hash>) are now renamed after their material when Load Entity loads them: de_dust2's 14 skybox cloud cards become nuke_clouds_002 instead of nomerge1 to nomerge44. Models with several materials keep their name.

Known limitations

  • Dota water doesn't flow: where the flow map sits is set by the game at runtime, so its average strength is used. In EEVEE the riverbed doesn't show through the water (Cycles refracts it); Source 1 water behaves the same way.
  • The crystal shader's sun highlight and bloom aren't reproduced. Multiblend parallax, scrolling UVs and world-space UVs aren't handled.

Testing

  • Python suite: 508 pass / 4 skip.
  • Blender suite: 219 pass / 1 skip, plus the separately run skin tests (8/8).
  • Renamed-package smoke: 614/614 modules, with register/unregister/register succeeding.
  • Sample imports: 87 PASS / 6 KNOWN / 0 FAIL.
  • Installed-game imports:
    • TF2, every prop placeholder loaded: 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, every prop placeholder loaded: 7 PASS / 0 FAIL; the dota map loads 5,311/5,311 props with no unsupported shaders, and its two destruction layers start excluded.
    • CS2: 12 PASS / 0 FAIL. de_dust2 with every placeholder loaded: 698/698 props, and 53 of its 54 nameless world models take their material's name (the other uses three materials).
  • All four release archives passed Blender extension validation and contain only their declared platform's native library.
  • 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.12.0-blender5.2 for the previous release, or view the full comparison.

SourceIO Forge 5.12.0 for Blender 5.2

Choose a tag to compare

@Tzeentchnet Tzeentchnet released this 13 Oct 01:34

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.