Повторно используемый диспетчер игры

В этом уроке для реализации некоторых функций используется язык Verse. Воспользовавшись кодом Verse из этого урока, вы сможете:

• Периодически запускать и воспроизводить анимации для создания игровой механики.

• Обновляет информацию об очках игрока для всех игроков в мини-игре.

• Настраивайте задержки появления игроков и время периодического появления предметов.

Вы можете использовать этот код повторно, чтобы:

• Включать и отключать устройства, когда игра переходит из режима ЦЕНТРА в режим игрового процесса и обратно в режим ЦЕНТРА.

• Проверять счёт игроков, чтобы определить лучший результат и отобразить его в ЦЕНТРЕ.

• Завершить игру и телепортировать игроков обратно в ЦЕНТР по окончании мини-игры.

Настройка устройства Verse и редактируемых объектов

Выполните следующие действия, чтобы настроить устройство Verse и редактируемые объекты:

1. Создайте новое устройство Verse с именем tiltnboom и добавьте его на уровень. Порядок действий см. в разделе «Создание собственного устройства с помощью Verse».

2. Добавьте следующие модули в начале файла:

   Verse

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

   Copy full snippet(6 lines long)

3. Добавьте следующие поля в определение класса tiltnboom:

   1. Два редактируемых устройства trigger: ActivateGameTrigger и EndGameTrigger. ActivateGameTrigger используется для активации этой игры. Триггер может быть активирован чем угодно, например телепортом в игру или завершением вступительного видеоролика.

      EndGameTrigger используется для завершения мини-игры и последующего удаления всех камер и устройств управления у игроков.

   Verse

        @editable
        ActivateGameTrigger:trigger_device = trigger_device{}
   
        @editable
        EndGameTrigger:trigger_device = trigger_device{}
   

   Copy full snippet(5 lines long)

   1. Редактируемое устройство «Таймер» с именем GameTimer. Через определённое время завершает игру.

   2. Массив array устройств «Последовательность внутриигрового видео» с именем CannonballSequences. Каждое устройство в этом массиве воспроизводит попадание пушечного ядра в определённое место.

   3. Массив зон поражения с именем DamageVolumes, которые включаются и отключаются в зависимости от состояния игры.

   4. Массив генераторов предметов с именем ItemSpawners, которые случайным образом создают случайное количество предметов во время игры.

   5. Устройство «Область захвата» с именем CaptureArea. Начисляет игрокам очки за нахождение на плоту и включается/отключается в зависимости от состояния игры.

   6. Устройство «Панель управления счётом» с именем ScoreManager, которое сбрасывает счёт игроков в начале игры и определяет победителя в конце игры.

   7. Телепорт с именем HUBTeleporter, который возвращает всех игроков в ЦЕНТР по окончании игры.

   8. Устройство «Упоминание игрока» с именем PlayerReference, которое отображает победителя в ЦЕНТРЕ между играми.

      Verse

                                   @editable
                                   GameTimer:timer_device = timer_device{}
      								        
                                   @editable
                                   CannonballSequences:[]cinematic_sequence_device = array{}
      								        
                                   @editable
                                   DamageVolumes:[]damage_volume_device = array{}
      								
                                   @editable
      
      Expand code Copy full snippet(23 lines long)

4. Два редактируемых массива точек появления игроков с именами PlayerSpawners и HUBSpawners. Отключают появление и возвращают игроков в ЦЕНТР после завершения мини-игры.

   Verse

            @editable
            PlayerSpawners:[]player_spawner_device = array{}
   		
            @editable
            HUBSpawners:[]player_spawner_device = array{}
   

   Copy full snippet(5 lines long)

5. Две редактируемые переменные типа float с именами MinimumItemSpawnTime и MaximumItemSpawnTime. Это минимальное и максимальное время ожидания между появлением предметов на плоту.

   Verse

            @editable
            MinimumItemSpawnTime:float = 5.0
   		
            @editable
            MaximumItemSpawnTime:float = 10.0
   

   Copy full snippet(5 lines long)

6. Редактируемая переменная типа float с именем DelayAfterGame. Это задержка телепортации игроков обратно в ЦЕНТР после завершения игры.

   Verse

            @editable
            DelayAfterGame:float = 5.0
   

   Copy full snippet(2 lines long)

7. Переменная float с именем DelayBetweenCannonballSequences. Задержка появления пушечных ядер между последовательностями на протяжении всей мини-игры.

   Verse

        DelayBetweenCannonballSequences:float = 8.0
   

   Copy full snippet(1 line long)

8. Логическая переменная с именем GameActive, которая определяет активное или неактивное состояние игры.

   Verse

            var GameActive:logic = false
   

   Copy full snippet(1 line long)

Начало игры

Когда начинается мини-игра, включается несколько устройств и счёт игрока сбрасывается на 0.

1. Перед определением класса tiltnboom добавьте канал записи в журнал сообщений, относящихся к мини-игре. Затем добавьте средство ведения журнала в определение класса для использования с каналом ведения журнала.

   Verse

        tiltnboom_log_channel := class(log_channel){}
   		
        # A Verse-authored creative device that can be placed in a level
        tiltnboom := class(creative_device):
   		
            Logger:log = log{Channel := tiltnboom_log_channel}
   

   Copy full snippet(6 lines long)

2. Добавьте новый метод OnTriggered в определение класса titnboom, который принимает значение InitiatingAgent и запускает игру. Добавьте выражение if в метод, чтобы он возвращал управление, если игра уже активна, поскольку нам не нужно запускать игру, если она уже запущена.

   Verse

            OnTriggered(InitiatingAgent:?agent):void=
                if (GameActive?):
                    return
   		
                spawn{StartGame()}
   

   Copy full snippet(5 lines long)

3. В OnBegin() подпишите событие TriggeredEvent в ActivateGameTrigger на функцию OnTriggered, чтобы запускать игру. Любое устройство, которое необходимо включить в начале мини-игры, будет подписано на это событие и включится при возникновении события OnTrigger.

   Verse

            OnBegin<override>()<suspends>:void=
   
                ActivateGameTrigger.TriggeredEvent.Subscribe(OnTriggered)

   Copy full snippet(3 lines long)

4. Добавьте новый метод StartGame(), управляющий логикой запуска игры. Добавьте модификатор <suspends> к этой функции, чтобы она могла запускаться асинхронно.

   Сначала задайте для GameActive значение true, чтобы сигнализировать о том, что игра активна, а затем включите CaptureArea и каждую зону DamageVolume в массиве DamageVolumes.

   Сбросьте на ноль счёт каждого игрока, у которого он больше 0. Для этого начислите такому игроку количество очков, противоположное текущему; в результате счёт станет равен 0.

   Затем в выражении race задайте конкурентное выполнение завершения отсчёта таймера, последовательностей запуска пушечных ядер и появления случайных предметов. Последовательность запуска пушечных ядер и появление случайных предметов выполняются в бесконечных циклах, но они прерываются, как только таймер завершает отсчёт.

   По завершении игры вызовите функцию OnGameFinished(), чтобы выполнить очистку.

   Verse

        StartGame()<suspends>:void=
            Logger.Print("Starting game.")
            set GameActive = true
   
            CaptureArea.Enable()
   
            for (DamageVolume : DamageVolumes):
                DamageVolume.Enable()
   
            for:
   
   Expand code Copy full snippet(23 lines long)

Создание цикла пушечного ядра

В этом разделе мы создадим функцию, которая воспроизводит последовательности внутриигрового видео для пушечных ядер.

1. Добавьте в определение класса tiltnboom новый метод StartCannonSequence(), который воспроизводит видеоряды для пушечных ядер и использует цикл для выполнения выражения задержки между анимациями пушечных ядер. Добавьте модификатор <suspends> к этой функции, чтобы она могла запускаться асинхронно.

   В цикле выберите случайную последовательность из массива CannonballSequences, определив индекс элемента с помощью GetRandomInt(). Воспроизведите последовательность, а затем вставьте задержку (Sleep) длительностью DelayBetweenCannonballSequences, прежде чем воспроизводить другую последовательность.

   Verse

        StartCannonSequence()<suspends>:void=
            loop:
   
                RandomCannonballSequence:int = GetRandomInt(0, CannonballSequences.Length - 1)
   
                if (CannonballSequence := CannonballSequences[RandomCannonballSequence]):
                    Logger.Print("Set CannonballSequence to {RandomCannonballSequence}")
   
                    CannonballSequence.Play()
   
   
   Expand code Copy full snippet(11 lines long)

Создание циклов случайного появления предметов

Этот раздел посвящён созданию функции, которая обеспечивает повторное появление случайных предметов в случайных местах на плоту, что может повышать или понижать шансы игроков на победу в мини–игре.

1. В определении класса titlnboom добавьте новый метод SpawnRandomItems. Этот метод управляет появлением предметов на плоту.

2. Получите количество элементов в массиве ItemSpawners, а затем переберите элементы массива в цикле. Используйте случайное число int, чтобы получить случайный генератор предметов из массива, а затем активируйте его. Вставьте случайную задержку (Sleep) между появлением предметов.

3. В цикле случайным образом определяется, сколько предметов нужно создать, и случайным образом выбирается предмет для создания NumberOfItemsToSpawn раз. DelayBetweenItemSpawns задаёт неопределённое время ожидания между появлением предметов.

   Verse

            SpawnRandomItems()<suspends>:void=
                ItemSpawnerCount:int = ItemSpawners.Length - 1
   
                loop:
   
                    NumberOfItemsToSpawn:int = GetRandomInt(0, ItemSpawnerCount)
   
                    # Spawn a randomly selected item, as many times as NumberOfItemsToSpawn.
                    for:
                        CurrentItemSpawnNumber := 0..NumberOfItemsToSpawn
   
   Expand code Copy full snippet(17 lines long)

Завершение игры

В конце мини-игры нужно отправить результат победителя в ЦЕНТР, отключить устройства и телепортировать игроков обратно в ЦЕНТР.

1. В определении класса tiltnboom добавьте новый метод OnGameFinished. Когда игра закончится, эта функция переведёт её в неактивный режим и отключит соответствующие устройства.

   ~~~(verse) OnGameFinished()<suspends>:void= Logger.Print("Конец игры.") set GameActive = false

   CaptureArea.Disable()

   for (PlayerSpawner : PlayerSpawners): PlayerSpawner.Disable()

   for (DamageVolume : DamageVolumes): DamageVolume.Disable() ~~~

2. Добавьте переменную HighestScore типа int для отслеживания игрока с лучшим счётом и переменную-ссылку WinningPlayer типа option на этого игрока.

   Verse

                var HighestScore:int = -1
                var WinningPlayer:?agent = false
   

   Copy full snippet(2 lines long)

3. В выражении for/do получите всех игроков в игровом пространстве, а затем получите FortCharacter для каждого из них. Запретите игроку перемещаться с помощью PutInStasis(), передав новый набор stasis_args, позволяющий проявлять эмоции и поворачиваться, чтобы игроки могли повеселиться в игре.

   Verse

                for:
                    Player : GetPlayspace().GetPlayers()
                    FortCharacter := Player.GetFortCharacter[]
                do:
                    FortCharacter.PutInStasis(stasis_args{AllowTurning := true, AllowEmotes := true})
   

   Copy full snippet(5 lines long)

4. С помощью выражения if проверьте счёт каждого игрока, чтобы найти и сохранить лучший счёт в устройстве «Упоминание игрока» в ЦЕНТРЕ.

   Verse

                    if (ScoreManager.GetCurrentScore(Player) > HighestScore):
   		                
                        set HighestScore = ScoreManager.GetCurrentScore(Player)
                        set WinningPlayer = option{Player}
   

   Copy full snippet(4 lines long)

5. Наконец, в другом выражении if вызовите TeleportPlayersToHUB(), чтобы телепортировать всех игроков обратно в ЦЕНТР, когда лучший счёт будет определён.

   Verse

                if(Winner := WinningPlayer?):
                    PlayerReference.Register(Winner)
   		
                TeleportPlayersToHUB()
   

   Copy full snippet(4 lines long)

Телепортация игроков обратно в ЦЕНТР

Когда будет определён счёт всех игроков и объявлен победитель, все игроки должны телепортироваться обратно в ЦЕНТР.

1. Добавьте новый метод TeleportPlayersToHUB() в определении класса tiltnboom. Этот метод включает все генераторы игроков в ЦЕНТРЕ, а затем ждёт несколько секунд, прежде чем телепортировать всех обратно в ЦЕНТР. Также этот метод должен активировать EndGameTrigger, чтобы удалить камеру и устройства управления у игроков.

   Verse

            TeleportPlayersToHUB()<suspends>:void=
   
                for (HUBSpawner : HUBSpawners):
                    HUBSpawner.Enable()
   
                Sleep(DelayAfterGame)
   
                EndGameTrigger.Trigger()

   Copy full snippet(8 lines long)

2. В выражении for телепортируйте каждого игрока обратно в HUBTeleporter и освободите его из стазиса.

   Verse

                for:
                    Player : GetPlayspace().GetPlayers()
                    FortCharacter := Player.GetFortCharacter[]
                do:
                    HUBTeleporter.Teleport(Player)
   		
                    Sleep(1.0)
   		
                    FortCharacter.ReleaseFromStasis()
   

   Copy full snippet(9 lines long)

Самостоятельная работа

Измените этот код, чтобы использовать устройство «Таймер» для решения других задач. Вместо того чтобы определять продолжительность мини-игры, можно использовать устройство «Таймер» для задания времени конкурентного выполнения.

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

    tiltnboom_log_channel := class(log_channel){}

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