Repository navigation
Releases
SourceIO Forge 5.16.2 for Blender 5.2
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
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.vtxcompanion fallback. - Beta physics: reads wrapperless PHY solids and imports collision trees whose root is not itself convex.
- Beta materials: parses assignment-style
$key = valueVMTs and mapsVertexLitTexture,AddTexture,BaseTimesVertexColor/MouthShader, andEyeballto 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
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
--skeletalexport 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
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
sourceioextension ID and Python package. - Blender 5.3 NPR materials: adds the closure-based
VertexLitGenericgraph 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-insensitivegame_writesearch-path keys ingameinfo.txtdeclaration 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
RGBA16161616FVTF 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_writeownership, 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
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
RGBA16161616FVTF 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
int32packed 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
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
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
- 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.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_framesand, 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:
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:
Known limitations
- Sprite sheets don't animate in Blender. Source 1 has no
SpriteCardshader 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-vtffor these; it writes one image per frame. - Textures stored as
.tth/.ttzpairs 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
mksheetandvtex:- Route 1 (whole image plus
.sht): every sheet came back byte for byte, with identical pixels. - Route 2 (
mksheetfrom the frame images): every sheet kept its sequences, loop settings, timing and frame pixels. effects/workshop/vistasmokev1is the only sheet flagged aspackmode rgb+a.
- Route 1 (whole image plus
- 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
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
- 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.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 thedotamap) 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.vfxshows 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.vfxis 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.
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
dotamap 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-cs2andrecompile-cs2command-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
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
- 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.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 thedotamap) 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.vfxshows 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.vfxis 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
dotamap 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-cs2andrecompile-cs2command-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
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.







