Repository navigation
Export Nodes SourceIOEyeRefractVMTNode
Builds an EyeRefract material (VMT) for eyes: iris, cornea and AO textures plus eyeball radius, dilation and parallax strength.

| Input | VMT parameter | Group | Purpose |
|---|---|---|---|
| Iris texture | $iris |
Textures | Iris/pupil texture of the eye. |
| Cornea texture | $corneatexture |
Textures | Cornea (glossy surface layer) texture of the eye. |
| Ambient occlusion texture | $ambientoccltexture |
Textures | Ambient-occlusion map used to shade the eyeball. |
All inputs are VTF sockets (single link each, not multi-input) and are optional: an unconnected input simply omits its VMT parameter. Each one accepts the output of a VTF Output node. You can also drag a Texture socket straight onto one of these inputs; SourceIO then inserts a VTF Output node for you, named <vmt path without .vmt>_<suffix>.vtf (albedo for $basetexture, otherwise the parameter name without $) with Normal map (linear) enabled for $bumpmap/$normalmap. Any other link type is removed. At export, a linked input that does not resolve to a VTF recipe raises " must resolve to a VTF Output recipe".
| Output | Type | Description |
|---|---|---|
| Material | Material | The rendered VMT text plus every VTF it references. Connect it to the Materials multi-input of a Source 1 model output (many materials allowed), or to its Skin families input (SourceIO then inserts a Skin family node that lists this VMT's name). |
| Control | Meaning |
|---|---|
Blender material (mat) |
The Blender Material this VMT replaces. Required: the node raises "VMT requires a Blender Material binding" without it. Mesh slots that use this Blender Material are exported under this VMT's file name; a mesh slot whose Blender Material has no linked VMT node stops the export with "No linked VMT bound to ... slot". |
VMT path under materials (vmt_path) |
Output path of the .vmt, relative to the game's materials/ folder (default models/props/material.vmt). A leading materials/ and the .vmt extension are normalised; absolute paths, .., : and quotes are rejected. The file stem becomes the material name in the QC, and the folder is added to $cdmaterials automatically. |
| Sync VMT to disk (button) | Writes only this node's .vmt to the game root of every Source 1 model output the node feeds, without encoding textures (VTF paths are still referenced). Errors if the node is not connected to a model output. |
Each group below is a collapsible box in the node. Textures, Surface / Alpha, Normal and Shader-specific start expanded, the rest start collapsed. Collapsing a group also hides that group's unlinked texture inputs, so open the group to see and connect them; linked inputs always stay visible.
This group only lists the link state of the texture inputs; it has no value controls for this shader.
| Control | Meaning |
|---|---|
$model |
Written as "$model" "1" when enabled (default on). Required for materials used on models. |
$translucent |
Written as 1 when enabled. Alpha-blended transparency from the base texture alpha, so the base VTF needs an alpha-capable format (DXT5, RGBA8888, ...). |
$alphatest |
Written as 1 when enabled; pixels are cut out by alpha. |
$alphatestreference |
Only shown while $alphatest is on (0-1, default 0.5). Alpha cut-off, written as $alphatestreference. |
$nocull |
Written as 1 when enabled: draw both faces of every polygon. |
$selfillum |
Written as 1 when enabled: the surface glows independent of lighting. Uses the Self-illumination mask if linked, otherwise the base alpha (engine behaviour). |
$color2 |
RGB tint (0-1). Written as $color2 [r g b] only when it differs from white. |
| Control | Meaning |
|---|---|
$eyeballradius |
Radius of the eyeball in model units (default 0). Written only when not 0. |
$dilation |
Pupil dilation, 0-1 range as the engine interprets it (default 0). Written only when not 0. |
$parallaxstrength |
Depth of the iris parallax (default 0). Written only when not 0. |
| Control | Meaning |
|---|---|
Ordered raw VMT KV entries (raw_parameters) |
A Blender Text datablock whose content is KeyValues entries copied into the shader block verbatim and in order (duplicates and nested blocks are kept). Use it for any VMT parameter the node has no control for, e.g. "$surfaceprop" "metal". Parse errors abort the export; an entry that repeats a generated parameter (including a texture key of a linked input) is rejected as a conflict. |
Proxy KV entries (proxy_parameters) |
A Blender Text datablock holding entries for the Proxies block. Each entry must itself be a named KeyValues block (for example AnimatedTexture { ... }), otherwise the export fails with "Each Proxies entry must be a named KeyValues block". |
When a Source 1 model output builds the graph, this node produces one VMT: a "<shader>" block holding, in order, the texture parameters of linked inputs, then $model, $translucent, $alphatest, $nocull, $selfillum, $phong (those that are enabled), $alphatestreference, phong values, $envmap, $color2, the other typed parameters (detail, tint, UV transforms, shader-specific values), your raw entries and finally a Proxies block. The shader name is written in lower case. Parameters equal to their default are skipped so the file stays minimal. Every linked VTF is encoded by its VTF Output node and written to materials/<vtf path>.vtf next to the VMT under the model output's game root; two textures that map to the same path with different bytes, or two materials with the same VMT path and different text, abort the export.
Shader behaviour. EyeRefract renders an eye as a refracting cornea over a parallax iris. It exists only in engine branches that ship the shader; check that your target game has it. It uses the iris and cornea textures, an optional ambient-occlusion texture, the eyeball radius, pupil dilation and parallax strength. The node has no Base texture input: the iris texture takes its place.
Texture and colour-space behaviour. No colour conversion is done by this node. Iris and cornea are colour/data textures exported by their VTF Outputs (default Linear space: values written unchanged, no sRGB flag). The cornea texture normally carries data in its channels, so avoid colour-space conversions in front of it.
- Connect the iris image to Iris texture and the cornea map to Cornea texture; optionally an AO map to Ambient occlusion texture.
- In Shader-specific enter
$eyeballradius(the real eyeball radius in model units), tune$dilationfor the pupil and$parallaxstrengthfor iris depth. - Pick the Blender material of the eye mesh, set the VMT path (for example
models/characters/eyes/eye.vmt), connect Material to the model output and export.
- Only the shader and its parameters are written; the node does not verify the shader exists in the target game.
- There are no Phong, Environment or UV transforms groups; use Raw / Proxies for additional parameters such as
$irisu/$irisv. - Zero-valued parameters are not written, so a default node writes no
$eyeballradius: set it explicitly.