The core behavior of the minigame is defined in the verse_commander_minigame Verse device. This device starts the minigame, handles communication between the UI and the character, and runs the boards used in the game.
This device has the following fields that you can modify in the editor:
HUDController: A HUD Controller device to remove all default Fortnite HUD elements.
PlayVerseCommanderButton: The Button device that starts the minigame.
NPCSpawner: The NPC Spawner device to be able to spawn the character for the minigame.
Gameboards: The list of boards for the game. The boards are played in the order they appear in the list.
UICommandLimit: The max limit of commands that can be queued on screen at the bottom of the list.
The device also contains custom events to communicate with the character and pass info to the character: the list of the commands for the character to execute, and the transform for the character to teleport to when the board is reset.
# A Verse-authored creative device that can be placed in a level
verse_commander_minigame := class(creative_device):
# The HUD Controller device for the minigame.
@editable
HUDController<private>:hud_controller_device = hud_controller_device{}
# The button that starts the minigame.
@editable
PlayVerseCommanderButton:button_device = button_device{}
Starting the Minigame
The Verse Commander Minigame device waits for the player to interact with the Button device at the computer before starting the minigame for all players. This wait is in a loop. Once you finish all the levels you can replay the minigame as many times as you want.
# Runs when the device is started in a running game.
OnBegin<override>()<suspends>:void=
spawn{Cinematic.EnterCinematicModeForAll(GetPlayspace().GetPlayers())}
loop:
PlayVerseCommanderButton.InteractedWithEvent.Await()
Setup()
# Wait for all Gameboards to be set up.
Sleep(2.0)
Game Loop
The game loop starts by getting the current board. If it's the first time a player is on this board, the character teleports to the board's starting position and the board switches to its camera and plays its opening cinematic.
Then, there's a race between the level loop and waiting on the reset event from the UI. If either of those finish first, it cancels the other. The expressions in the loop then repeat and go back to getting the current board and starting the race again.
# Loops over the current gameboard and resets them.
GameLoop<private>()<suspends>:void=
# For the current board, swap to that gameboard's camera and reset the character to the gameboard's starting position.
loop:
if:
Gameboard := Gameboards[CurrentBoard]
then:
# If first time on this board, set up the board
# and move character to starting position.
if:
Level Loop
The LevelLoop() function manages the logic for the gameboard. It races between the command loop for the character and waiting on the board's end goal to be reached. Once the end goal is reached, the command loop is canceled and the next board in the list is called.
The command loop waits for the player to press the Execute button to receive the list of commands to perform. The buttons are deactivated, except for the reset button. The character is signaled to perform the commands and the Verse device waits to receive the finished signal before restarting the loop and waiting for more commands.
A defer is used in this loop to clean up the UI if the command loop or LevelLoop() function is canceled. The defer expression will call ResetUIForAllPlayers() right before exiting the scope to reset the button interactivity so they're enabled again and clear the list of commands at the bottom.
# Handles command logic for the current gameboard.
LevelLoop<private>(Gameboard:gameboard)<suspends>:void=
# On the current board, race between completing the board and looping player commands.
# The race expression will cancel whichever action doesn't finish first.
race:
loop:
defer:
# If the loop is canceled because the character reached the end goal of the level,
# Or the character finished performing their commands,
# reset the UI for all the players so they can interact with it and have no commands in the queue.
Resetting the Game
The AwaitReset() function waits for the player to select the reset button. Once they do, the board resets itself and tells the character to teleport to the starting position on the board.
# Waits for the Reset button to be selected, then resets the current gameboard
# and NPC.
AwaitReset<private>(Gameboard:gameboard)<suspends>:void=
ResetButtonSelected.Await()
# Reset the current gameboard, returning the game character to the starting position and
# resetting any barriers or triggers on the board.
BoardResetEvent.Signal(Gameboard.GetStartingCharacterPosition())
# Reset Gameboard
Next Step
This covers the main functionality of the Verse device for the minigame. You can find the full list of code to create the Verse Commander Minigame device in the next and final step.
