Input Trigger Devices

The Input Trigger device is a way to trigger events when players press or release a particular control input. You can use the device to capture when an input is pressed, and which player pressed it.

Response time for input defined in the input trigger device is dependent on the round-trip time between the player's client and the server. Because of this, input can take up to a second depending on the player's internet connection, so keep this in mind when using the input trigger device for your game.

You can use event binding in the Creative toolset, connections in the Details panel in UEFN, or Verse code, to trigger other device functions such as blowing up a barrel, changing cameras, or other gameplay that is triggerable.

For help finding the Input Trigger device, see Using Devices.

If you're using multiple copies of a device on an island, it can be helpful to rename them. Choosing names that relate to a device's purpose makes it easier to remember what each one does, and easier to find a specific device when using the Event Browser.

How the Creative Input Option Works

When you customize the Input Trigger device options, you'll see the Creative Input option listed first. This option's values correspond to a number of new input actions that can be configured by players. The way this works is a little complicated, so this section provides a more detailed explanation than the Device Options table has room for.

Players can find and rebind these inputs in the Creative Input Action section of the Keyboard Controls and Controller Mapping tabs in the Settings Menu.

Open the sidebar, click the gear icon to open the Setting Menu, then click either the Keyboard Controls or the Controller Mapping icons. You can find the Creative Input Action section of the settings by scrolling down the list in the left navigation area. This is where players can change which actions map to which controls. These settings apply across all of your Fortnite experiences.

For people on mobile platforms, these inputs always appear as new buttons displayed on the screen. The Input Trigger device has options you can use to customize the icon and color of this button, and whether you want it to display text.

Contextual Filtering

Some devices are affected by a feature called contextual filtering. This feature hides or displays options depending on the values selected for certain related options. This reduces clutter in the Customize panel and makes options easier to manage and navigate. To help identify them, values that trigger contextual filtering are in italic.

All options are listed, including those affected by contextual filtering; if they are hidden or displayed based on a specific option's value, there will be a note about it in the Description field for that option.

Device Options

Default values are bold. Values that trigger contextual filtering are italic.

You can configure this device with the following options.

Direct Event Binding

Following are the direct event binding options for this device.

Functions

A function listens for an event on a device then performs an action.

1. For any function, click the option, then Select Device to access and select from the Device dropdown menu.

2. Once you've selected a device, click Select Event and select the event that triggers this function.

3. If more than one device or event triggers a function, press the Add button to add a line and repeat these steps.

Events

Direct event binding uses events as transmitters. An event tells another device to perform a function.

1. For any event option, click the option, then Select Device to access and select from the Device dropdown menu.

2. Once you've selected a device, click Select Function to bind the event to a function for that device.

3. If more than one function is triggered by the event, press the Add button and repeat.

Using the Input Trigger Device in Verse

You can use the code below to control an Input Trigger device in Verse. This code shows how to use events and functions in the Input Trigger device API. Modify it to fit the needs of your experience.

using { /Fortnite.com/Devices }

using { /UnrealEngine.com/Temporary/Diagnostics }

using { /Verse.org/Simulation }

# A Verse-authored creative device that can be placed in a level

input_trigger_device_verse_example := class(creative_device):

    # Reference to the Input Trigger device in the level.

    # In the Details panel for this Verse device,

    # set this property to your Input Trigger device.

    @editable

    MyInputTriggerDevice:input_trigger_device = input_trigger_device{}

    # Reference to a VFX Spawner device in the level.

    # In the Details panel for this Verse device,

    # set this property to your VFX Spawner device.

    @editable

    VFXSpawnerDevice:vfx_spawner_device = vfx_spawner_device{}

    # Runs when the device is started in a running game

    OnBegin<override>()<suspends>:void=

        # Example for subscribing to an event on the Creative device.

        # Signaled when a player presses the specified input on the device.

        MyInputTriggerDevice.PressedEvent.Subscribe(OnInputPressed)

        # Example for subscribing to an event on the Creative device.

        # Signaled when a player releases the specified input on the device.

        MyInputTriggerDevice.ReleasedEvent.Subscribe(OnInputReleased)

        # This example iterates through all players in the experience to show how to do operations per player on the device.

        for (Player : GetPlayspace().GetPlayers()):

            # Adds `Agent` to the registered player list.

            MyInputTriggerDevice.Register(Player)

    # This function runs when a player presses the input specified in the Input Trigger device because it's an event handler for PressedEvent.

    OnInputPressed(Agent:agent):void=

        VFXSpawnerDevice.Enable()

    # This function runs when a player releases the input specified in the Input Trigger device because it's an event handler for ReleasedEvent.

    OnInputReleased(Agent:agent, InputHeldDuration:float):void=

        VFXSpawnerDevice.Disable()

        Print("Input held for {InputHeldDuration} seconds.")

Copy full snippet

using { /Fortnite.com/Devices } using { /UnrealEngine.com/Temporary/Diagnostics } using { /Verse.org/Simulation } # A Verse-authored creative device that can be placed in a level input_trigger_device_verse_example := class(creative_device): # Reference to the Input Trigger device in the level. # In the Details panel for this Verse device, # set this property to your Input Trigger device. @editable MyInputTriggerDevice:input_trigger_device = input_trigger_device{} # Reference to a VFX Spawner device in the level. # In the Details panel for this Verse device, # set this property to your VFX Spawner device. @editable VFXSpawnerDevice:vfx_spawner_device = vfx_spawner_device{} # Runs when the device is started in a running game OnBegin<override>()<suspends>:void= # Example for subscribing to an event on the Creative device. # Signaled when a player presses the specified input on the device. MyInputTriggerDevice.PressedEvent.Subscribe(OnInputPressed) # Example for subscribing to an event on the Creative device. # Signaled when a player releases the specified input on the device. MyInputTriggerDevice.ReleasedEvent.Subscribe(OnInputReleased) # This example iterates through all players in the experience to show how to do operations per player on the device. for (Player : GetPlayspace().GetPlayers()): # Adds `Agent` to the registered player list. MyInputTriggerDevice.Register(Player) # This function runs when a player presses the input specified in the Input Trigger device because it's an event handler for PressedEvent. OnInputPressed(Agent:agent):void= VFXSpawnerDevice.Enable() # This function runs when a player releases the input specified in the Input Trigger device because it's an event handler for ReleasedEvent. OnInputReleased(Agent:agent, InputHeldDuration:float):void= VFXSpawnerDevice.Disable() Print("Input held for {InputHeldDuration} seconds.")

To use this code in your UEFN experience, follow these steps.

1. Drag an Input Trigger device onto your island.

2. Create a new Verse device named input_trigger_device_verse_example. See Create Your Own Device Using Verse for steps.

3. In Visual Studio Code, open input_trigger_device_verse_example.verse in Visual Studio Code and paste the code above.

4. Compile your code and drag your Verse-authored device onto your island. See Adding Your Verse Device to Your Level for steps.

5. Add a reference for the Input Trigger device on your island to your Verse device. See Adding a Verse Reference to a Creative Device in Your Level for steps.

6. Save your project and click **Launch Session** to playtest.

### Input Trigger Device Verse API

See the input_trigger_device API Reference for more information on using the Input Trigger device in Verse.