Verse Detonation Template

The Verse Detonation Template shows you how to create a game where two teams battle to arm and disarm bomb sites.

This tutorial uses the Verse device and basic devices such as the Map Indicator device to perform gameplay mechanics like making beacons show depending on conditions.

This template demonstrates Verse concepts like:

• Enums

• Concurrency

  • Race

  • Await

Overview

The following is an overview of the steps you'll need to recreate this island in the ideal sequence:

1. Create a new project and modify Island Settings to set up the game.

2. Set up devices.

3. Add the Verse Script.

4. Set up the Verse device.

Creating a New Project and Setting Up the Game

1. Open UEFN and create a new empty project.

2. Select the IslandSettings device in the Outliner and locate User Options - Game Rules.

   

3. Modify the User Options as shown below.

Setting up the Devices

This tutorial uses the following devices:

• 8 x Explosive

• 2 x Timed Objectives

• 4 x Map Indicators

• 1 x End Game

• ~ x Player Spawn Pad

• 1 x Verse

Explosive Device

Use the Explosive device to cause the explosion for detonated timers. On opposite sides of the map, copy and place a group of four Explosive devices.

To set up this device, configure the User Options as follows:

Timed Objective

The Time Objective device serves as the detonator for each site. Place a Timed Objective device on both groups of Explosive devices.

To set up this device, configure the User Options as follows:

Map Indicator Device

Use the Map Indicator device to create custom markers on the minimap. For each explosive site place two Map Indicator devices above it, one for each team.

To set up this device, configure the User Options as follows:

End Game Device

Use the End Game device to end the round upon successfully disarming the bomb or if 30 seconds elapses and it explodes via Verse script.

To set up this device, configure the User Options as follows:

Player Spawn Pad Device

Group the team's Player Spawn Pad devices on opposite sides of your map. Each team will have its own spawners with Team 1 arming the bomb and Team 2 disarming the bomb. Teams will swap each round.

To set up this device, configure the User Options as follows:

Adding the Verse Scripts

Add the following Verse scripts, starting by referencing devices with the @editable function.

You can copy the code in the order it's written. Comments are added within the script for clarity.

    # enum to determine the state of the bombs

    bomb_state<public>:= enum {AllUnarmed, BombAArmed, BombBArmed}
Copy full snippet

# enum to determine the state of the bombs bomb_state<public>:= enum {AllUnarmed, BombAArmed, BombBArmed}

The above code defines an enumeration to track the state of the bombs.

      search_and_destroy := class(creative_device):

        Logger:log = log{Channel:=log_search_and_destroy}

        @editable

        TimedObjectiveA: timed_objective_device = timed_objective_device{}

        @editable

        TimedObjectiveB: timed_objective_device = timed_objective_device{}

        @editable

        ExplosiveBarrelsA: []explosive_device = array{}

        @editable

        ExplosiveBarrelsB: []explosive_device = array{}

        @editable

        EndGameDevice: end_game_device = end_game_device{}

        @editable

        BombAMapIndicators: []map_indicator_device = array{}

        @editable

        BombBMapIndicators: []map_indicator_device = array{}

        @editable

        BombABeaconArm: beacon_device = beacon_device{}

        @editable

        BombABeaconDisarm: beacon_device = beacon_device{}

        @editable

        BombBBeaconArm: beacon_device = beacon_device{}

        @editable

        BombBBeaconDisarm: beacon_device = beacon_device{}

        var BombState:bomb_state = bomb_state.AllUnarmed
Copy full snippet

search_and_destroy := class(creative_device): Logger:log = log{Channel:=log_search_and_destroy} @editable TimedObjectiveA: timed_objective_device = timed_objective_device{} @editable TimedObjectiveB: timed_objective_device = timed_objective_device{} @editable ExplosiveBarrelsA: []explosive_device = array{} @editable ExplosiveBarrelsB: []explosive_device = array{} @editable EndGameDevice: end_game_device = end_game_device{} @editable BombAMapIndicators: []map_indicator_device = array{} @editable BombBMapIndicators: []map_indicator_device = array{} @editable BombABeaconArm: beacon_device = beacon_device{} @editable BombABeaconDisarm: beacon_device = beacon_device{} @editable BombBBeaconArm: beacon_device = beacon_device{} @editable BombBBeaconDisarm: beacon_device = beacon_device{} var BombState:bomb_state = bomb_state.AllUnarmed

You can use @editable to reference the devices.

    # Runs when the device is started in a running game

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

            # The race expression is used to run a block of two or more async expressions concurrently (simultaneously). When the fastest expression completes, it "wins the race".

            # https://www.fortnite.com/en-US/creative/docs/uefn/race-in-verse

            race:

                block:

                    # Wait for Bomb A to be armed

                    ArmingPlayer:= TimedObjectiveA.StartedEvent.Await()

                    Print("Bomb A Armed",?Duration:=5.0)

                   

                    # Used to know which beacons to enable and barrels need to explode

                    set BombState = bomb_state.BombAArmed

                   

                    # Disable the other Timed Objective device

                    TimedObjectiveB.Disable(ArmingPlayer)

                   

                    # Disable map indicators for Bomb B

                    for (MapIndicator : BombBMapIndicators):

                        MapIndicator.Disable()
Copy full snippet

# Runs when the device is started in a running game OnBegin<override>()<suspends>:void= # The race expression is used to run a block of two or more async expressions concurrently (simultaneously). When the fastest expression completes, it "wins the race". # https://www.fortnite.com/en-US/creative/docs/uefn/race-in-verse race: block: # Wait for Bomb A to be armed ArmingPlayer:= TimedObjectiveA.StartedEvent.Await() Print("Bomb A Armed",?Duration:=5.0) # Used to know which beacons to enable and barrels need to explode set BombState = bomb_state.BombAArmed # Disable the other Timed Objective device TimedObjectiveB.Disable(ArmingPlayer) # Disable map indicators for Bomb B for (MapIndicator : BombBMapIndicators): MapIndicator.Disable()

The first section of code shows concurrency using race to determine if Bomb A or Bomb B was armed first.

         block:

                    # Wait for Bomb B to be armed

                    ArmingPlayer:= TimedObjectiveB.StartedEvent.Await()

                    Print("Bomb B Armed",?Duration:=5.0)

                   

                    # Used to know which beacons to enable and barrels need to explode

                    set BombState = bomb_state.BombBArmed

                   

                    # Disable the other Timed Objective device

                    TimedObjectiveA.Disable(ArmingPlayer)

                     # Disable map indicators for Bomb A

                    for (MapIndicator : BombAMapIndicators):

                        MapIndicator.Disable()

           

            # Enable the correct Beacon Devices now a bomb is armed

            UpdateBeacons()

           

            # Wait for the TimedObjective to Complete or be Stopped

            race:

                block:

                    BombDetonated(TimedObjectiveA.CompletedEvent.Await())

                block:

                    BombDetonated(TimedObjectiveB.CompletedEvent.Await())

               

                block:

                    DisarmingPlayer:= TimedObjectiveA.StoppedEvent.Await()

                    Print("Bomb Disarmed", ?Duration:=5.0)

                    EndGameDevice.Activate(DisarmingPlayer)

                block:

                    DisarmingPlayer:= TimedObjectiveB.StoppedEvent.Await()

                    Print("Bomb Disarmed", ?Duration:=5.0)

                    EndGameDevice.Activate(DisarmingPlayer)
Copy full snippet

block: # Wait for Bomb B to be armed ArmingPlayer:= TimedObjectiveB.StartedEvent.Await() Print("Bomb B Armed",?Duration:=5.0) # Used to know which beacons to enable and barrels need to explode set BombState = bomb_state.BombBArmed # Disable the other Timed Objective device TimedObjectiveA.Disable(ArmingPlayer) # Disable map indicators for Bomb A for (MapIndicator : BombAMapIndicators): MapIndicator.Disable() # Enable the correct Beacon Devices now a bomb is armed UpdateBeacons() # Wait for the TimedObjective to Complete or be Stopped race: block: BombDetonated(TimedObjectiveA.CompletedEvent.Await()) block: BombDetonated(TimedObjectiveB.CompletedEvent.Await()) block: DisarmingPlayer:= TimedObjectiveA.StoppedEvent.Await() Print("Bomb Disarmed", ?Duration:=5.0) EndGameDevice.Activate(DisarmingPlayer) block: DisarmingPlayer:= TimedObjectiveB.StoppedEvent.Await() Print("Bomb Disarmed", ?Duration:=5.0) EndGameDevice.Activate(DisarmingPlayer)

The above code shows concurrency where the script waits for Timed Objective to either complete or be stopped.

        # Disable the unarmed Beacons and enable the Beacon over the armed bomb

        UpdateBeacons():void=

            BombABeaconArm.Disable()

            BombBBeaconArm.Disable()

           

            if:

                BombState = bomb_state.BombAArmed

            then:

                BombABeaconDisarm.Enable()

            else:

                BombBBeaconDisarm.Enable()
Copy full snippet

# Disable the unarmed Beacons and enable the Beacon over the armed bomb UpdateBeacons():void= BombABeaconArm.Disable() BombBBeaconArm.Disable() if: BombState = bomb_state.BombAArmed then: BombABeaconDisarm.Enable() else: BombBBeaconDisarm.Enable()

The above code updates the state of the beacons depending on which bomb is armed.

     BombDetonated(Agent:agent):void=

            Print("Bomb Detonated", ?Duration:=5.0)

            # Determine which set barrels should explode

            if:

                BombState = bomb_state.BombAArmed

            then:

                ExplodeBarrels(ExplosiveBarrelsA, Agent)

            else:

                ExplodeBarrels(ExplosiveBarrelsB, Agent)

            EndGameDevice.Activate(Agent)
Copy full snippet

BombDetonated(Agent:agent):void= Print("Bomb Detonated", ?Duration:=5.0) # Determine which set barrels should explode if: BombState = bomb_state.BombAArmed then: ExplodeBarrels(ExplosiveBarrelsA, Agent) else: ExplodeBarrels(ExplosiveBarrelsB, Agent) EndGameDevice.Activate(Agent)

The above method is called when the Timed Objective device completes. It determines which barrels should explode and end the game.

      ExplodeBarrels(Barrels:[]explosive_device, Agent:agent):void=

            for (Barrel : Barrels):

                Barrel.Explode(Agent)
Copy full snippet

ExplodeBarrels(Barrels:[]explosive_device, Agent:agent):void= for (Barrel : Barrels): Barrel.Explode(Agent)

The above for loop to explode each barrel at the correct bomb site.

Verse Device

Compile your Verse script then find your device in the Content Drawer. Drag the Verse device onto an unseen area of your map to customize the settings.

Use this device to link direct event binding to the needed devices so they can be referenced by the Verse script.

In the device's Details panel, configure the settings to match each referenced device like the photo above.

To set up this device, configure the User Options as follows:

Select Launch Session to test out your completed level.