Tracker Devices

Use the Tracker device to create and track custom objectives that a player can complete, and send a signal to another device when the player completes a tracked objective.

You can track objectives set for individual players, a team, or multiple teams. For teams, you can also track persistence data for individual players from one session to the next. (For more on this, see Tracking Persistence Data below.

For help on how to find the Tracker device, see Using Devices.

You'll need a separate tracker for each objective you want to track.

If you're using multiple copies of a device on an island, it can be useful 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.

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 feature will reduce clutter in the Customize panel and make options easier to manage and navigate.

However, it may not be easy to recognize which options or values trigger contextual filtering. To help you identify them, in our device docs we use italic for any values that trigger contextual filtering. All options will be 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 that in the Description field for that option.

Device Options

This device has some basic functionality, like which stat is tracked, and the value for that stat when the target is met. There are also some advanced options, like whether completion progress is shared among team members or tracked individually.

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

You can configure this device with the following options.

Tracking Persistence Data

You can set the Tracker device to collect persistence data, meaning stats tracked across multiple sessions, with multiple players or teams.

Persistence is based on player data for a specific island, and will track multiple players for a single island.

For example, if you have a group quest where players have to collectively tame 200 wolves, but the group only manages to tame 100 before the session ends, a player can return the next day and continue taming the wolves. However, the player may be playing with a different group entirely, and that's where conflict resolution becomes important.

If the Resolves Conflict option is set to Average, in the new group, you might have one player with a persistent tracked value of 50, another with a value of 100, and a third player new to the game who starts with 0. In this case the starting value for each player would be 50+100+0/3, or 50 if you've selected Average.

The same tracked values set for Median would be 50, based on the median (middle) value: 0 - 50 - 100.

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 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 Event to bind the timer to an event that will trigger the function for the device.
3. If more than one device should be affected by a function, press the Add button and repeat.

Events

An event tells another device when 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 timer to a function for that device.
3. If more than one device is affected by the function, press the Add button and repeat.

Using the Tracker Device in Verse

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

using { /Fortnite.com/Devices }
using { /Verse.org/Simulation }
using { /Verse.org/Random }
using { /UnrealEngine.com/Temporary/Diagnostics }

# A Verse-authored creative device that can be placed in a level
tracker_device_verse_example := class(creative_device):

    # Reference to the Switch Device in the level.
    # In the Details panel for this Verse device,
    # set this property to your Switch Device.
    @editable
    MyTrackerDevice:tracker_device = tracker_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 the tracked value reaches `GetTarget` for an `agent`.
        # Sends the `agent` that reached `GetTarget` for their tracked value.
        MyTrackerDevice.CompleteEvent.Subscribe(OnObjectiveCompleted)

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

            # Sets the target value that must be achieved in order for `CompleteEvent` to trigger.
            # Clamped to `0 <= TargetValue <= 10000`.
            MyTrackerDevice.SetTarget(5)

            # Assign Tracker device to player.
            MyTrackerDevice.Assign(Player)

            # Get random integer value between 1 and 3.
            TargetValueIncrease:int = GetRandomInt(1,3)
            Print("Random target increase is {TargetValueIncrease}")
           
            # Increase this player's target value by the random integer.
            # `for (X := 1..TargetValueIncrease):` runs as many times as TargetValueIncrease
            for (X := 1..TargetValueIncrease):
                # Increases the target value for `Agent` by 1.
                MyTrackerDevice.IncreaseTargetValue(Player)

        # Wait for 10 seconds.
        Sleep(10.0)  
       
        # This example iterates through all players in the experience to show how to do operations per player on the device.
        for(Player : GetPlayspace().GetPlayers()):
            # Is true if `Agent` has reached the *TargetValue* for the tracker.
            # `not` operation inverts the result of HasReachedTarget function call
            if (not MyTrackerDevice.HasReachedTarget[Player]):
                Print("Player has not reached target.")
            else:
                Print("Player has reached target.")
                # Saves tracked progress for `Agent`. Only valid if *Use Persistence* is set to *Use*.
                MyTrackerDevice.Save(Player)
           
    # This function runs when the player reaches the target value for the Tracker device because it's an event handler for CompleteEvent.
    OnObjectiveCompleted(Agent:agent):void=
        Print("Objective for tracker device completed.")

        # Returns the current tracked value for `Agent`.
        TargetValue := MyTrackerDevice.GetValue(Agent)
        Print("Target for completed objective for agent is {TargetValue}")
Copy full snippet

using { /Fortnite.com/Devices } using { /Verse.org/Simulation } using { /Verse.org/Random } using { /UnrealEngine.com/Temporary/Diagnostics } # A Verse-authored creative device that can be placed in a level tracker_device_verse_example := class(creative_device): # Reference to the Switch Device in the level. # In the Details panel for this Verse device, # set this property to your Switch Device. @editable MyTrackerDevice:tracker_device = tracker_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 the tracked value reaches `GetTarget` for an `agent`. # Sends the `agent` that reached `GetTarget` for their tracked value. MyTrackerDevice.CompleteEvent.Subscribe(OnObjectiveCompleted) for(Player : GetPlayspace().GetPlayers()): # Sets the target value that must be achieved in order for `CompleteEvent` to trigger. # Clamped to `0 <= TargetValue <= 10000`. MyTrackerDevice.SetTarget(5) # Assign Tracker device to player. MyTrackerDevice.Assign(Player) # Get random integer value between 1 and 3. TargetValueIncrease:int = GetRandomInt(1,3) Print("Random target increase is {TargetValueIncrease}") # Increase this player's target value by the random integer. # `for (X := 1..TargetValueIncrease):` runs as many times as TargetValueIncrease for (X := 1..TargetValueIncrease): # Increases the target value for `Agent` by 1. MyTrackerDevice.IncreaseTargetValue(Player) # Wait for 10 seconds. Sleep(10.0) # This example iterates through all players in the experience to show how to do operations per player on the device. for(Player : GetPlayspace().GetPlayers()): # Is true if `Agent` has reached the *TargetValue* for the tracker. # `not` operation inverts the result of HasReachedTarget function call if (not MyTrackerDevice.HasReachedTarget[Player]): Print("Player has not reached target.") else: Print("Player has reached target.") # Saves tracked progress for `Agent`. Only valid if *Use Persistence* is set to *Use*. MyTrackerDevice.Save(Player) # This function runs when the player reaches the target value for the Tracker device because it's an event handler for CompleteEvent. OnObjectiveCompleted(Agent:agent):void= Print("Objective for tracker device completed.") # Returns the current tracked value for `Agent`. TargetValue := MyTrackerDevice.GetValue(Agent) Print("Target for completed objective for agent is {TargetValue}")

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

1. Drag a Tracker device onto your island.
2. Create a new Verse device named tracker_device_verse_example. See Create Your Own Device Using Verse for steps.
3. In Visual Studio Code, open tracker_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 Tracker 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.

Tracker Device Verse API

See the tracker_device API Reference for more information on using the Tracker device in Verse.