Skip to main content

​
Overview

The VRSL Manager Window (also known as the VRSL Control Panel) is the central hub for managing and configuring all VR Stage Lighting fixtures in your Unity scene. It provides a comprehensive interface for:
  • Managing DMX and AudioLink fixtures
  • Spawning lighting prefabs
  • Batch editing fixture properties
  • Configuring global lighting settings
  • Accessing CRT material settings

​
Accessing the Manager Window

1

Open from Unity Menu

Navigate to VRSL > Control Panel in the Unity menu bar.
2

Window Opens Centered

The Manager Window opens centered on your Unity editor with a minimum size of 925x700 pixels.
The VRSL Manager Window requires a VRSL_LocalUIControlPanel component in your scene to function. If none is found, some features will be disabled.

​
Main Interface Sections

Displays the VRSL logo and quick links to:
  • Discord - Join the VRSL community
  • Twitter - Follow AcChosen for updates
  • GitHub - Access the official repository
  • Version Number - Shows current VRSL version

​
DMX Fixtures Section

Manage all DMX-controlled fixtures in your scene.

​
Features

  • Fixtures are automatically organized by Universe (1-9)
  • Each universe can be expanded/collapsed independently
  • Fixtures are sorted by DMX channel within each universe
  • Shows total fixture count per universe
Each fixture foldout includes:
  • DMX Channel - Universe and channel assignment
  • Fixture ID - Unique identifier for patch data
  • Intensity Controls - Global and final intensity
  • Color Tint - Apply color correction
  • Movement Settings - Pan/tilt inversion and ranges
  • Special Features - Strobe, auto-spin, GOBO selection
  • Cone Dimensions - Width, length for volumetric effects
  • Apply/Reset Changes - Mass apply or reset fixture modifications
  • Mass Pan/Tilt Range - Set movement ranges for all fixtures
  • Mass Fixture IDs - Auto-assign sequential IDs based on prefab groups
  • Extended Universe Toggle - Enable/disable 9-universe mode
  • Copy/Paste Settings - Copy properties from one fixture to others

​
DMX Fixture Workflow

1

Select Fixtures

Expand universes to view fixtures. Click individual fixture foldouts to edit.
2

Edit Properties

Modify DMX channels, intensities, colors, or movement settings as needed.
3

Apply Changes

Click Apply Changes to commit modifications or Reset to revert.
4

Test in Scene

Changes update in real-time. Use Scene view to verify fixture behavior.
Use the Mass Fixture IDs button to automatically organize fixture IDs by prefab type, starting at ID 100 and incrementing by 100 for each prefab variant.
Manage AudioLink-reactive fixtures and lasers.

​
Features

  • Band Organization - Fixtures grouped by AudioLink frequency band (Bass, Low Mid, High Mid, Treble)
  • Band Settings - Configure frequency response and multipliers
  • Color Options - ColorChord, texture sampling, theme color sampling
  • Intensity Control - Global and final intensity per fixture
  • Laser-Specific Controls - Cone rotation, flatness, laser count, scroll speed
PropertyDescription
Enable AudioLinkToggle AudioLink reactivity
BandFrequency band to react to (Bass/Low Mid/High Mid/Treble)
DelayFrame delay for synchronization (0-127)
Band MultiplierIntensity multiplier for frequency response
ColorChordEnable procedural color generation from audio
Texture SamplingSample colors from a texture at specific UV coordinates
Theme ColorsUse AudioLink theme color slots

​
Fixture Spawning Section

Screenshot would show: The fixture spawning interface with categorized prefab buttons for DMX and AudioLink fixtures.

​
DMX Fixture Prefabs

Spawn DMX-controlled lighting fixtures:
  • Spotlight - Moving head with narrow beam (Horizontal/Vertical/Legacy modes)
  • Washlight - Moving head with wide beam
  • Blinder - High-intensity audience blinder
  • Flasher - Strobe/flash effects
  • PAR Light - Static color wash
  • Lightbar - Multi-fixture bar
  • Disco Ball - Rotating mirror ball effect
  • Laser - DMX-controlled laser effects
GI Variants: If VRSL-DMX-GI addon is installed, enable the “VRSL GI” toggle to spawn Global Illumination variants that interact with Unity’s GI system.
Spawn audio-reactive fixtures:
  • All standard fixture types with “_a” suffix
  • Laser (AudioLink) - Audio-reactive laser grid

​
Screen/Controller Prefabs

  • OSC Grid Reader - TekOSC-based DMX reader (Horizontal/Vertical)
  • uDesktop - Desktop Duplication DMX screens (requires addon)
  • USharpVideo - Video player-based DMX (requires addon)
  • ProTV - ProTV integration (requires addon)
  • VideoTXL - VideoTXL integration (requires addon)
  • AudioLink Controller - AudioLink control interface
  • Depth Light - Directional light for depth texture

​
Stencil Mask Objects

Spawn geometry to mask/block VRSL volumetric and projection effects:
  • Cube, Cylinder, Capsule, Sphere masks

​
Options & Global Settings

​
Scene Settings

  • Toggle: Enable/disable depth texture requirement
  • Purpose: Allows Quest compatibility by removing depth light dependency
  • Effect: Disables projection/disco ball meshes when off
  • Toggle: Enable/disable 3D noise on volumetric shaders
  • Purpose: Improves performance on Quest/lower-end hardware
  • Effect: Switches from 3D to 2D noise patterns
  • Options: High, Medium, Low
  • Purpose: Adjust mesh complexity for performance
  • Requires: VRSL Manager Window Settings file with alternate mesh references
  • Toggle: Enable 9-universe mode (vs 4-universe)
  • Range: Channels 1-4096 (9 universes) or 1-2048 (4 universes)
  • Note: Must match DMX reader configuration
  • Options: None, Channel Only, Universe + Channel
  • Purpose: Display DMX addressing in Scene view
  • Location: Fixture gizmos in 3D space

​
CRT Material Editor

Screenshot would show: The CRT material editor with dropdown for selecting different interpolation materials.
Edit Custom Render Texture materials directly from the Control Panel:
  • Material Selector: Choose from DMX or AudioLink CRT materials
  • Categories:
    • Intensity+Color (Horizontal/Vertical/Legacy)
    • Movement (Horizontal/Vertical/Legacy)
    • Spin (Horizontal/Vertical/Legacy)
    • Strobe Timing (Horizontal/Vertical/Legacy)
    • Strobe Output (Horizontal/Vertical/Legacy)
    • AudioLink Interpolation
Use Cases:
  • Adjust movement smoothing ranges
  • Configure strobe speed min/max
  • Modify DMX interpolation behavior
  • Fine-tune signal detection thresholds
Changes to CRT materials affect ALL fixtures using that material. Test thoroughly after modifications.

​
Advanced Features

​
Pan/Tilt Range Configuration

Configure movement limits for moving head fixtures:
1

Set Pan Range

Enter desired pan range (e.g., 180° for 180° left/right)
2

Set Tilt Range

Enter desired tilt range (e.g., -180° for 180° up/down)
3

Apply to All Fixtures

Click Mass Apply Pan Range or Mass Apply Tilt Range
Quick preset buttons available: 90°, 180°, 270°, 540°

​
Copy/Paste Fixture Settings

1

Select Source Fixture

Open the fixture foldout you want to copy from
2

Copy Settings

Click the Copy button in the fixture controls
3

Select Target Fixture(s)

Open target fixture foldouts
4

Paste Settings

Click Paste to apply copied settings
Copy/paste respects fixture type. DMX properties only copy to DMX fixtures, AudioLink properties only to AudioLink fixtures.

​
Scene Hierarchy Monitoring

The Manager Window automatically:
  • Detects new fixtures added to the scene
  • Removes references to deleted fixtures
  • Updates fixture lists when hierarchy changes
  • Refreshes on play mode state changes

​
Keyboard Shortcuts

None by default. Access via menu: VRSL > Control Panel

​
Performance Considerations

  • The Manager Window queries all scene objects on open and hierarchy changes
  • Large scenes (100+ fixtures) may experience slight lag on refresh
  • Close the window when not actively editing to free editor resources
  • CRT material modifications are global and permanent until reverted

​
Troubleshooting

  • Verify VRSL_LocalUIControlPanel exists in scene
  • Check “Use DMX” or “Use AudioLink” toggles on the control panel
  • Ensure fixtures have VRSL scripts attached
  • Click Refresh or reopen the Manager Window
  • Click Apply Changes button explicitly
  • Check for script errors in Console
  • Verify fixtures are not in prefab edit mode
  • Ensure scene is not in play mode (some operations disabled)
  • Check Console for missing GUID errors
  • Verify VRSL package is properly installed via VCC
  • Ensure required addons are installed for addon prefabs
  • Try reimporting VRSL package
  • Verify CRT materials exist in package
  • Check material assignments on control panel
  • Reinstall VRSL package if materials missing

Build docs developers (and LLMs) love

Get started for freeTalk to us