Value Setter

The Value Setter (V-SET) device is the glue that allows gameplay events to control the state of Patchwork systems, such as enabling a new section of music when a specific gameplay stage is reached.

When the Value Setter receives a signal from another device, it sets the value of your choosing on any Patchwork parameter.

Device Options

Other Device Options

In Create mode, walk up to the device and press E to open the Customize panel. Some device options mirror the controls you can manipulate with the Patchwork tool. They are present so that you can use the event binding system to trigger changes to how those controls behave, although you can choose to change them here instead of using the knobs. The Allow Cable Access option can only be modified using the Customize panel.

Configuration

Depending on what you choose to connect the Value Setter to, the Value Knob could become a carousel or a toggle.

VFX Preview

The VFX preview for the Value Setter shows the moment a new value is set. When a delay is set, a ring will appear when the Value Setter is triggered, then shrink over the length of the delay until the value is set.

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 Value Setter in Verse

You can use the code below to control a Value Setter device in Verse. This code uses all features of the Value Setter device API. Modify it to fit the needs of your experience.

using { /Fortnite.com/Devices }

using { /Verse.org/Simulation }

using { /UnrealEngine.com/Temporary/Diagnostics }

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

value_setter_example := class(creative_device):

    @editable

    ValueSetter:patchwork_value_setter_device = patchwork_value_setter_device{}

    # Runs when the device is started in a running game

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

        

        Sleep(5.0)

        ValueSetter.Disable()

        Print("Device Disabled")

        Sleep(5.0)

        ValueSetter.Enable()

        Print("Device Enabled")

Copy full snippet

using { /Fortnite.com/Devices } using { /Verse.org/Simulation } using { /UnrealEngine.com/Temporary/Diagnostics } # A Verse-authored creative device that can be placed in a level value_setter_example := class(creative_device): @editable ValueSetter:patchwork_value_setter_device = patchwork_value_setter_device{} # Runs when the device is started in a running game OnBegin<override>()<suspends>:void= Sleep(5.0) ValueSetter.Disable() Print("Device Disabled") Sleep(5.0) ValueSetter.Enable() Print("Device Enabled")

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

1. Drag a Value Setter device onto your island.

2. Create a new Verse device named value_setter_example. To learn how to create a new device in Verse, see Create Your Own Device Using Verse.

3. Open Verse Explorer and double-click value_setter_example.verse to open the script in Visual Studio Code.

4. Paste in the code above, compile, and drag the Verse-authored device onto your island.

5. Select your Verse device in the Outliner.

6. In the device’s Details panel, assign the object reference for the ValueSetter to the Value Setter device on your island. You can use the eyedropper to pick the device in the viewport, or use the dropdown and search for the device.

7. Save your project and click Launch Session.

Value Setter API

See the value_setter_device API Reference for more information on using the Value Setter device in Verse.

Patch Ideas

Connect Value Setters to the Page Knob, then trigger them when you want to jump to specific pages. You can use the Delay Carousel on the Value Setter to make sure the current page completes before jumping to the new one.

Connect Value Setters to the Volume Knob, then trigger them based on gameplay. For example, you could have an intense drum pattern that’s always playing, but only audible when players are in combat.

Connect Value Setters to the Mix Knob to adjust the impact of the effect at different points in a song.