Static Light Shaders

Overview

Static light shaders provide fixed-position stage lighting effects including projection mapping and realistic lens flares. These lights don’t include pan/tilt mechanics but offer the same projection and color control as moving lights.

Shader Paths

DMX Control

VRSL/Standard Static/Projection
VRSL/Standard Static/Lens Flare

AudioLink Control

VRSL/AudioLink/Standard Static/Projection
VRSL/AudioLink/Standard Static/Lens Flare

Projection Shader Properties

DMX Configuration

_DMXChannel

int

default:"0"

DMX fixture number/sector. Each static light uses 13 channels in standard mode or 5 channels in 5CH mode.

_NineUniverseMode

bool

default:"false"

Enable extended universe mode for up to 9 DMX universes.

_EnableDMX

bool

default:"false"

Enable DMX control via render texture.

_ChannelMode

enum

default:"0"

Channel mode:

0: 13CH - Full control (13 channels)
1: 5CH - Simplified control (5 channels: intensity + RGB)

_EnableCompatibilityMode

bool

default:"false"

Enable legacy DMX grid reading compatibility.

_EnableVerticalMode

bool

default:"false"

Switch to vertical DMX grid layout.

Intensity and Color

_FinalIntensity

float

default:"1"

Final intensity multiplier for the light output.

_GlobalIntensity

float

default:"1"

Global intensity shared across all fixtures.

_GlobalIntensityBlend

float

default:"1"

Blend between local and global intensity.

_UniversalIntensity

float

default:"1"

Universal scene intensity multiplier.

_Emission

color

default:"(1,1,1,1)"

Light color tint (HDR). Multiplied with DMX RGB values.

_FixtureMaxIntensity

float

default:"1"

Maximum light intensity output.

_RedMultiplier

float

default:"1"

Red channel multiplier for color correction.

_GreenMultiplier

float

default:"1"

Green channel multiplier.

_BlueMultiplier

float

default:"1"

Blue channel multiplier.

Projection Settings

_ProjectionMainTex

texture

default:"white"

GOBO texture for projection pattern.

_ProjectionMaxIntensity

float

default:"1"

Maximum projection intensity. Higher values create brighter projections.

_XOffset

float

default:"0"

Horizontal offset for projection in world space.

_YOffset

float

default:"0"

Vertical offset for projection in world space.

_ProjectionRange

float

default:"0"

Drawing range for projection. Scales the projection mesh.

_ProjectionRangeOrigin

vector

default:"(0, -0.07535, 0.12387, 0)"

Origin point for projection range scaling.

_ProjectionDistanceFallOff

float

default:"1"

Attenuation constant for distance-based falloff.

_Fade

float

default:"1"

Light range/falloff distance.

_FeatherOffset

float

default:"1"

Attenuation quadratic factor. Controls falloff curve.

_ProjectionUVMod

float

default:"0"

UV scale modifier for projection. Adjusts GOBO size.

_ModX

float

default:"1"

Projection UV X axis stretch.

_ModY

float

default:"1"

Projection UV Y axis stretch.

_ProjectionRotation

float

default:"0"

Static rotation angle for the projection in degrees.

_EnableSpin

bool

default:"false"

Enable automatic projection rotation animation.

_SpinSpeed

float

default:"0"

Speed of automatic projection rotation.

_UseWorldNorm

bool

default:"false"

Use world normals instead of view normals for projection.

_ConeWidth

float

default:"0"

Beam spread/specular strength.

Rendering Options

_RenderMode

enum

default:"1"

Transparency rendering mode:

1: Transparent
2: AlphaToCoverage

_BlendSrc

enum

default:"2"

Source blend mode.

_BlendDst

enum

default:"1"

Destination blend mode.

_BlendOp

enum

default:"0"

Blend operation.

_ZWrite

bool

default:"false"

Enable depth buffer writing.

_AlphaToCoverage

bool

default:"false"

Enable alpha to coverage for MSAA.

_ClippingThreshold

float

default:"0.5"

Alpha clipping threshold.

_AlphaProjectionIntensity

float

default:"0.5"

Alpha channel intensity for projection.

_MultiSampleDepth

bool

default:"true"

Enable multi-sample depth texture reading.

Advanced Options

_UseRawGrid

bool

default:"false"

Use raw unsmoothed DMX grid for instant response.

_EnableStrobe

bool

default:"false"

Enable strobe effect support.

_StrobeFreq

float

default:"1"

Strobe frequency in Hz.

Lens Flare Shader Properties

The Lens Flare shader creates realistic lens flare effects with depth-based occlusion.

Core Properties

_MainTex

texture

default:"white"

Lens flare texture. Typically a circular gradient or starburst pattern.

_FixtureMaxIntensity

float

default:"1"

Maximum light intensity for the lens flare.

_FixutreIntensityMultiplier

float

default:"1"

Intensity multiplier for bloom scaling. Higher values create more intense bloom effects.

_FadeAmt

float

default:"1"

Fade strength from center to edge.

_ColorSat

float

default:"1"

Color saturation strength. Lower values desaturate toward edges.

Scale and Distance

_ScaleFactor

float

default:"1"

Overall scale factor for the lens flare.

_ReferenceDistance

float

default:"2"

Reference distance for scaling calculations.

_UVScale

float

default:"1"

UV scale for the flare texture.

Depth Occlusion

_UseDepthLight

bool

default:"true"

Enable depth-based occlusion testing. Flare fades when objects are in front.

_LightSourceViewSpaceRadius

float

default:"0.05"

Radius for depth occlusion sampling in view space.

_DepthOcclusionTestZBias

float

default:"-0.001"

Z-bias for depth comparison. Adjust to prevent self-occlusion.

Distance Fade

_StartFadeinDistanceWorldUnit

float

default:"0.05"

Distance where flare starts to fade in (world units).

_EndFadeinDistanceWorldUnit

float

default:"0.5"

Distance where flare is fully visible (world units).

Visual Polish

_RemoveTextureArtifact

float

default:"0"

Removes texture artifacts by subtracting a small value.

_CurveMod

float

default:"5"

Light intensity curve modifier. Adjusts brightness response curve.

_UsePreMultiplyAlpha

bool

default:"false"

Enable premultiplied alpha blending. Requires texture with correct alpha.

Flicker Animation (Optional)

_ShouldDoFlicker

bool

default:"true"

Enable flickering animation for the lens flare.

_FlickerAnimSpeed

float

default:"5"

Speed of the flicker animation.

_FlickResultIntensityLowestPoint

float

default:"0.5"

Minimum intensity during flicker. 1.0 = no flicker.

Channel Modes

The lens flare supports multiple DMX channel modes:

_ChannelMode

enum

default:"2"

0: 1CH - Intensity only
1: 4CH - Intensity + RGB
2: 5CH - Intensity + RGB + Strobe
3: 13CH - Full control

Usage Examples

Static Projection Light

Create a projection mesh (cone or pyramid)
Assign VRSL/Standard Static/Projection shader
Set DMX channel with _DMXChannel
Assign GOBO texture to _ProjectionMainTex
Adjust _ProjectionRange to fit the scene
Set _ProjectionMaxIntensity for desired brightness

Lens Flare Setup

Create a quad facing the camera
Assign VRSL/Standard Static/Lens Flare shader
Assign lens flare texture to _MainTex
Set _DMXChannel to match the fixture
Adjust _ScaleFactor for appropriate size
Enable _UseDepthLight for realistic occlusion

Performance Tips

For Projection:

Use lower _ProjectionRange to reduce overdraw
Disable _MultiSampleDepth on mobile platforms
Use simpler GOBO textures (lower resolution)

For Lens Flares:

The depth occlusion test (COUNT = 8) performs 289 depth samples per flare
Disable _UseDepthLight for better performance if occlusion isn’t needed
Reduce _FixutreIntensityMultiplier to decrease bloom overhead
Use _AlphaToCoverage mode for cleaner edges on MSAA

Technical Details

Depth Occlusion Algorithm

The lens flare uses a grid-based depth sampling approach:

#define COUNT 8  // Creates a 17x17 grid (COUNT*2+1)²

for(int x = -COUNT; x <= COUNT; x++)
{
    for(int y = -COUNT; y <= COUNT ; y++)
    {
        // Sample depth texture at grid point
        // Compare with flare depth
        // Accumulate visibility
    }
}

This provides smooth occlusion transitions as objects pass in front of the light.

Mirror Correction

Both shaders include mirror depth correction for VRChat mirrors using frustum correction calculations.

Scripts

Shaders

Editor Tools

Overview

Shader Paths

DMX Control

AudioLink Control

Projection Shader Properties

DMX Configuration

Intensity and Color

Projection Settings

Rendering Options

Advanced Options

Lens Flare Shader Properties

Core Properties

Scale and Distance

Depth Occlusion

Distance Fade

Visual Polish

Flicker Animation (Optional)

Channel Modes

Usage Examples

Static Projection Light

Lens Flare Setup

Performance Tips

Technical Details

Depth Occlusion Algorithm

Mirror Correction

See Also

Build docs developers (and LLMs) love

Scripts

Shaders

Editor Tools

​Overview

​Shader Paths

​DMX Control

​AudioLink Control

​Projection Shader Properties

​DMX Configuration

​Intensity and Color

​Projection Settings

​Rendering Options

​Advanced Options

​Lens Flare Shader Properties

​Core Properties

​Scale and Distance

​Depth Occlusion

​Distance Fade

​Visual Polish

​Flicker Animation (Optional)

​Channel Modes

​Usage Examples

​Static Projection Light

​Lens Flare Setup

​Performance Tips

​Technical Details

​Depth Occlusion Algorithm

​Mirror Correction

​See Also

Build docs developers (and LLMs) love

Overview

Shader Paths

DMX Control

AudioLink Control

Projection Shader Properties

DMX Configuration

Intensity and Color

Projection Settings

Rendering Options

Advanced Options

Lens Flare Shader Properties

Core Properties

Scale and Distance

Depth Occlusion

Distance Fade

Visual Polish

Flicker Animation (Optional)

Channel Modes

Usage Examples

Static Projection Light

Lens Flare Setup

Performance Tips

Technical Details

Depth Occlusion Algorithm

Mirror Correction

See Also