DMX Static Component

Core DMX-controlled lighting fixture component for VR Stage Lighting

The VRStageLighting_DMX_Static component is the primary script for controlling DMX-enabled stage lighting fixtures in VRChat worlds. It provides industry-standard DMX channel control, fixture movement, intensity management, and visual properties.

Overview

This component enables fixtures to receive DMX data from external lighting control software through the VRSL Grid system. It supports both modern DMX channel addressing and legacy sector-based addressing.

Inspector Properties

DMX Settings

enableDMXChannels · bool · default: "true"

Enables DMX mode for this fixture. When enabled, the fixture will respond to DMX data from the grid.

fixtureID · int · default: "0"

Optional ID number for organizational purposes. Useful for identifying fixtures in Udon scripts and matching IDs from DMX software.

dmxChannel · int · default: "1"

The industry standard DMX channel this fixture begins on. Standard VRSL fixtures use 13 channels.

dmxUniverse · int · default: "1"

The Artnet universe to read DMX data from. Each universe contains 512 channels.

nineUniverseMode · bool · default: "false"

Enables 9-Universe mode for this fixture. The grid will be split by RGB channels with each section and color representing a universe. Only available on Vertical and Horizontal Grid nodes.

useLegacySectorMode · bool · default: "false"

Enables the legacy ‘Sector’ based method of assigning DMX Channels. Keep unchecked to use industry standard DMX channels.

singleChannelMode · bool · default: "false"

Enables single channel DMX mode for fixtures that only require one channel (e.g., Flasher fixtures).

sector · int · default: "0"

(Legacy Mode) Chooses the DMX address sector. A sector is every 13 channels (Sector 0 = channels 1-13, Sector 1 = channels 14-26, etc.).

Channel · int · default: "0"

(Single Channel Mode) Specifies which of the 13 channels of the current sector to sample from.

legacyGoboRange · bool · default: "false"

Uses legacy GOBO range values for compatibility with older setups.

General Settings

globalIntensity · float · default: "1"

Sets the overall intensity of the shader. Good for animating or scripting effects. Maximum value is controlled by finalIntensity.

finalIntensity · float · default: "1"

Sets the maximum brightness value of Global Intensity. Useful for user-controlled brightness settings via UI.

finalIntensityComponentMode · bool · default: "false"

Choose between setting Final Intensity for all meshes together, or individual mesh types separately.

finalIntensityVolumetric · float · default: "1"

Sets maximum brightness for volumetric meshes only (when Component Mode is enabled).

finalIntensityProjection · float · default: "1"

Sets maximum brightness for projection meshes only (when Component Mode is enabled).

finalIntensityFixture · float · default: "1"

Sets maximum brightness for fixture meshes only (when Component Mode is enabled).

lightColorTint · Color · default: "Color.white * 2.0f"

The main color tint of the light. Leave at default white for pure DMX color control.

Movement Settings

invertPan · bool · default: "false"

Inverts the pan values (Left/Right movement) for moving head fixtures.

invertTilt · bool · default: "false"

Inverts the tilt values (Up/Down movement) for moving head fixtures.

isUpsideDown · bool · default: "false"

Enable this if the moving head fixture is mounted upside down.

Fixture Settings

enableAutoSpin · bool · default: "true"

Enables projection spinning (Udon Override Only).

enableStrobe · bool · default: "true"

Enables strobe effects via DMX control.

tiltOffsetBlue · float · default: "90"

Tilt (Up/Down) offset/movement. Directly controls tilt in Udon Mode; acts as an offset in DMX mode.

panOffsetBlueGreen · float · default: "0"

Pan (Left/Right) offset/movement. Directly controls pan in Udon Mode; acts as an offset in DMX mode.

selectGOBO · int · default: "1"

Selects which projection pattern is displayed. This is overridden in DMX mode.

Mesh Settings

objRenderers · MeshRenderer[] · required

Array of mesh renderers that make up the light fixture. At least one mesh is required.

coneWidth · float · default: "2.5"

Controls the radius of the mover/spot light cone.

coneLength · float · default: "8.5"

Controls the length of the cone of a mover/spot light.

maxConeLength · float · default: "1"

Controls the mesh length of the cone of a mover/spot light.

maxMinPan · float · default: "180"

Maximum pan angle range for the fixture.

maxMinTilt · float · default: "-180"

Maximum tilt angle range for the fixture.

Configuration Steps

Basic DMX Setup

1. Add the VRStageLighting_DMX_Static component to your fixture GameObject
2. Assign the fixture’s mesh renderers to the objRenderers array
3. Set the dmxChannel to the starting channel for this fixture
4. Set the dmxUniverse to match your DMX grid configuration
5. Ensure enableDMXChannels is checked

Legacy Sector Mode

If you’re using older VRSL setups:

1. Enable useLegacySectorMode
2. Set the sector value instead of dmxChannel
3. Each sector represents 13 channels (Sector 0 = Ch 1-13, Sector 1 = Ch 14-26, etc.)

Movement Configuration

For moving head fixtures:

1. Adjust panOffsetBlueGreen and tiltOffsetBlue to correct the default position
2. Use invertPan and invertTilt if movement directions are reversed
3. Enable isUpsideDown if the fixture is mounted inverted
4. Adjust maxMinPan and maxMinTilt to limit movement ranges

Example Setup

Standard Moving Head

DMX Settings:
  enableDMXChannels: true
  dmxChannel: 1
  dmxUniverse: 1
  
General Settings:
  globalIntensity: 1
  finalIntensity: 1
  lightColorTint: (2, 2, 2, 1)
  
Movement Settings:
  tiltOffsetBlue: 90
  panOffsetBlueGreen: 0
  
Fixture Settings:
  coneWidth: 2.5
  coneLength: 8.5

Single Channel Flasher

DMX Settings:
  enableDMXChannels: true
  singleChannelMode: true
  dmxChannel: 100
  dmxUniverse: 1
  
General Settings:
  globalIntensity: 1
  finalIntensity: 1

Integration with Other Components

VRSL Grid

The DMX Static component reads data from the VRSL Grid system:

• Grid nodes must be configured with matching universe settings
• Use Horizontal or Vertical grid modes for multi-universe setups
• Enable nineUniverseMode on both grid and fixtures for RGB universe splitting

Local UI Control Panel

The component integrates with VRSL_LocalUIControlPanel for:

• Global intensity control
• Quality settings for volumetric and projection meshes
• DMX mode switching (Horizontal/Vertical/Legacy)
• Per-mesh-type intensity control when using Component Mode

Audio Link Integration

While this is the DMX component, you can switch fixtures between DMX and AudioLink modes using:

• The Control Panel to enable/disable DMX rendering
• Udon scripts to toggle enableDMXChannels at runtime

Public Methods

_UpdateInstancedProperties()

Forces an update of all material properties. Call this after changing properties via Udon script.

_SetProps()

Initializes the MaterialPropertyBlock. Called automatically on Start.

Udon Script Properties

Access these properties from Udon scripts:

• LightColorTint - Get/Set the light color
• GlobalIntensity - Get/Set global intensity (0-1)
• FinalIntensity - Get/Set maximum intensity (0-1)
• ConeWidth - Get/Set cone radius
• ConeLength - Get/Set cone length
• SelectGOBO - Get/Set selected projection (1-8)
• Pan - Get/Set pan angle (0-360)
• Tilt - Get/Set tilt angle (0-360)
• IsDMX - Get/Set DMX enabled state
• InvertPan - Get/Set pan inversion
• InvertTilt - Get/Set tilt inversion

Performance Notes

• Supports up to 5 mesh renderers per fixture for optimal performance
• Uses MaterialPropertyBlock for GPU instancing
• Component Mode allows separate intensity control for volumetric, projection, and fixture meshes
• Strobe effects can be disabled globally via Control Panel for performance

See Also

• AudioLink Static Component - AudioLink-controlled fixtures
• Grid Reader - OSC communication for DMX data
• Local UI Control Panel - User controls and settings