DMX Quick Start

Get started using the DMX workflow to manage live events and digital installations.

This Quick Start guide describes how to use the basic DMX features to help you get started creating your own visual installation or live event using Unreal Engine.

Enabling the DMX Plugins

To fully leverage the whole DMX feature set, you need to navigate to Edit > Plugins and enable the following plugins in your project.

Base Plugins

The following are the main DMX plugins that you need to enable to use DMX in your project.

  • DMX Engine: Enables the core DMX engine functionality.

  • DMX Protocol: Enables the DMX communication protocols.

Extra Plugins

The following are optional plugins that provide extra features and functionality.

  • DMX Fixtures: Provides example content of DMX-enabled light fixtures Blueprints you can use to spawn MVR.

  • DMX Control Console: Enables a DMX control console that sends DMX to a specific patch or raw DMX address.

  • DMX PixelMapping: Converts pixel information from Textures, Materials, Render Targets, or UMG widgets into DMX signals.

  • Datasmith MVR: Provides MVR support for Datasmith importers.

  • DMX Display Cluster: Enables proper synchronization of DMX data, and Lightcard control across your nDisplay cluster.

  • DMX Remote Control Protocol: Enables DMX support for the Remote Control plugin.

Project Settings

When you look at the DMX section under Edit > Project Settings, you will see we categorized them in two sections.

The DMX project settings

Communication Settings

We consolidated the DMX protocol, adapter, and universe configuration settings under a concept called Ports, which applies to both DMX input and output data. There are no limits to the quantity of ports you can create, which means you can use ports to easily and properly separate various universes across multiple protocols and adapters.

Shared Settings

Most of the Ports settings function the same way for both input and output ports. These are defined in the table below.



Port Name

Define a custom name for easy identification.

Protocol Name

Choose between Art-Net or sACN.

Auto Complete Network Interface Card IP Address

Automatically selects an appropriate IP address. See below for details.

Network Interface Card IP Address

Specify the IP of the particular network adapter you are using.

Local Universe Start

The ID number for the first Universe where Unreal Engine should start listening or writing.

We start at Universe 1 for both supported protocols. Should you want to send to Universe 0, this is only possible for Art-Net and you can achieved this by setting the External Universe Start to 0.

Amount of Universes

How many Universes to set up.

Extern Universe Start

An offset value you can apply to Universes externally. For example, a value of 100 here would mean that Universe 1 was numbered as Universe 100 in the external output.

Auto-selection of IP addresses based on string search

You can auto-select IP addresses by enabling the Auto Complete Network Interface Card IP Address checkbox.

The autocomplete checkbox and options.

The system selects the most appropriate IP Address based on the input in the IP address field. This feature supports wildcards.





Input Ports

The Input Ports section is where you define the configuration for your local inputs. By default, this is an array with 3 elements, but you can add or remove elements as needed.

Define the DMX input ports.

Output Ports

The Output Ports section is where you define your output configuration. Like the Input Ports section, by default this is an array with 3 elements that you can add or remove elements from as needed. However, the Output Ports section also has unique settings.

Define the DMX output ports.

The following properties are unique to the Output Ports settings.



Communication Type

Provides a choice between broadcast and unicast output.

Input into Engine

Enabling this checkbox sends the output internally to Unreal Engine as well. This does not show as input in the Activity Monitor.


Adds a time delay to output. See below for details.

Output delay

You can use the Output delay functionality to add a fixed time delay to your output. The default time scale is in seconds, but you can set the delay according to various fps options instead.

Set up your output delay.

The output delay options.

Console Commands

You can change any of the Ports settings using console commands.

For example, the following command sets the delay of OutputA to 5 seconds: DMX.SetOutputPortDelay OutputA 5

You can set all the Ports properties this way:

The DMX port properties list.

Check the the DMX namespace in the console to get help using these commands:

For example, if you enter DMX.SetInputPortDeviceAddress, the system prompts a question mark, which implies that DMX.SetInputPortDeviceAddress ? is the correct syntax.

You can specify this further. Entering DMX.SetInputPortDeviceAddress MyInputPort logs your current settings for the port.

General Ports Settings

In addition to the specific Input and Output Ports settings, there are general settings that apply to all ports.

DMX general port settings.



DMX Send Rate

The rate in Hertz (Hz) at which DMX data is sent.

Send DMX by default

Determines whether DMX data is sent to the network.

Receive DMX by default

Determines whether DMX data is received from the network.

All Fixture Patches receive DMX in Editor

When enabled, all fixture patches receive DMX data in the Editor, overriding their local settings.

Fixture Settings

DMX fixture settings are categorized in two sections.

  • Fixture Categories

  • Fixture Attributes

Both sections are arrays with set elements you can add or remove as necessary

DMX fixture settings

Fixture Categories

The DMX Fixture Categories can be referenced in the DMX Library for convenience, which helps you better organize your various fixtures.

DMX fixture categories

Fixture Attributes

We organized the DMX Fixture Attributes in a user-defined lookup table that provides us with a way to match the existing fixture terminology from the GDTF specifications to our internal functions.

DMX fixture attributes

The DMX dropdown menu consolidates the DMX UI panels and features for quick and easy access.

DMX UI and features dropdown menu

Channel Monitor

The DMX Channel Monitor is a debugging tool for visualizing DMX input and output for a specific Universe.

Activity Monitor

The DMX Activity Monitor is a debugging tool for visualizing DMX input and output across all Universes at once. It displays all incoming and outgoing data.

Control Console

The DMX Control Console is an editor tool for setting, testing and sending DMX data for a given selection of DMX Libraries and Patches through the use of easy to use faders.

Patch Tool

The DMX Patch Tool is a small utility widget that conveniently allows you to batch patch a selection of Actors in your level.

Receive DMX

Sets whenever DMX is received from the Network.

Send DMX

Sets whenever DMX is sent to the Network.

DMX Assets

DMX Library

This asset consolidates all data related to DMX and MVR, such as manually created or GDTF imported fixtures, attribute or channel settings, and finally patching information.

DMX Library option in the menu.

DMX Pixel Mapping

This asset consolidates all data related to Pixel Mapping, such as input binding, referenced DMX Library and patches, 2D positioning grid, color management, and various other settings.

Help shape the future of Unreal Engine documentation! Tell us how we're doing so we can serve you better.
Take our survey