hub / github.com/REDxEYE/SourceIO

github.com/REDxEYE/SourceIO @5.5.3

repository ↗ · DeepWiki ↗ · release 5.5.3 ↗ · + Follow

35,036 symbols 91,498 edges 502 files 132 documented · 0%

What it actually does AI analysis from the code graph — generated when you open this

loading…

README

SourceIO

SourceIO is a Blender(3.6+) addon for importing source engine textures/models/maps Our Discord server https://discord.gg/SF82W6aZ67

Current TODO list -> TODO.md

Small WIKI -> WIKI

Usage

In order to find the import tools you simply need to go to File>Import>Source Engine Assets

Credits

datamodel.py by Artfunkel
ValveResourceFormat For initial research on Source2 file formats
BlenderVertexLitGeneric Shader nodegroup by syborg64
equilib Cubemap to equirectangular converter by haruishi43
HFSExtract HFS extractor that was used to write native decryptor by yretenai
Idea for better HWM expression handling by hisanimations

Supported formats (v5.3.0):

Source 1

File Type	Contents	Import	Export
.MDL	Model	:heavy_check_mark:	:x:
.BSP	Map Files (Compiled)	:heavy_check_mark:	Not Planned
.VMF	Map Files (Hammer Format)	Not Planned	Not Planned
.VTF	Textures	:heavy_check_mark:	:x:
.VMT	Materials	:heavy_check_mark:	:x:

Source 2

File Type	Contents	Import	Export
.VMDL	Model	:heavy_check_mark:	Not Planned
.VMAP	Map Files (Compiled)	:heavy_check_mark:	Not Planned
.VMAP	Map Files (Hammer Format)	Not Planned	Not Planned
.VTEX	Textures	:heavy_check_mark:	:x:
.VMAT	Materials	:heavy_check_mark:	:x:

Supported games

Game	Status
CSGO	Partial support: models, maps(not all entities), textures, materials
TF2	Full support
Source FilmMaker	Full support
Garry's Mod	Full support
HL2 and episodes	Full support
Portal 1/2	Full support
L4D2	Full support(expect infected materials)
Vindictus	Partial support: (models, maps(not all entities), textures, materials(not all shaders)
BlackMesa	Full support
Titanfall 1	Partial support: maps(not all entities), models, textures, materials
Counter Strike 2	Partial support: (models, maps(not all entities), textures, materials(not all shaders, require blender 3.4 or newer)
Half-Life: Alyx	Partial support: (models, maps(not all entities), textures, materials(not all shaders)
S&BOX	Partial support: Waiting for full release
Aperture Desk Job	Partial support: (models, maps(not all entities), textures, materials(not all shaders)

Core symbols most depended-on inside this repo

get

called by 25180

library/utils/file_utils.py

append

called by 1079

library/source2/keyvalues3/types.py

parse_source_value

called by 807

blender_bindings/source1/bsp/entities/bms_entity_classes.py

connect_nodes

called by 726

blender_bindings/material_loader/shader_base.py

parse_source_value

called by 657

blender_bindings/source1/bsp/entities/halflife2_entity_classes.py

parse_source_value

called by 630

blender_bindings/source1/bsp/entities/portal2_entity_classes.py

parse_source_value

called by 618

blender_bindings/source1/bsp/entities/left4dead2_entity_classes.py

parse_source_value

called by 596

blender_bindings/source1/bsp/entities/csgo_entity_classes.py

Shape

Method 27,875

Class 6,647

Function 514

Languages

Python100%

Modules by API surface

blender_bindings/source2/vwrld/entities/hlvr_entity_classes.py4,154 symbols

blender_bindings/source1/bsp/entities/bms_entity_classes.py3,078 symbols

blender_bindings/source2/vwrld/entities/cs2_entity_classes.py2,773 symbols

blender_bindings/source1/bsp/entities/halflife2_entity_classes.py2,707 symbols

blender_bindings/source1/bsp/entities/portal2_entity_classes.py2,424 symbols

blender_bindings/source1/bsp/entities/csgo_entity_classes.py2,409 symbols

blender_bindings/source1/bsp/entities/left4dead2_entity_classes.py2,342 symbols

blender_bindings/source2/vwrld/entities/base_entity_classes.py2,321 symbols

blender_bindings/source1/bsp/entities/tf_entity_classes.py2,313 symbols

blender_bindings/source1/bsp/entities/portal_entity_classes.py2,015 symbols

blender_bindings/source2/vwrld/entities/sbox_entity_classes.py1,971 symbols

blender_bindings/source1/bsp/entities/base_entity_classes.py1,716 symbols

For agents

$ claude mcp add SourceIO \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact