3. Создание игрового цикла

Игровой цикл — это код, который выполняется многократно (циклически), чтобы реагировать на ввод данных (взаимодействие игрока с помощью контроллера или мыши), обновлять состояние игры, а также выполнять действия, когда игрок повлиял на состояние игры, например нажал кнопку и включил свет. Цикл обычно заканчивается, когда игра завершается успешно, например игрок достигает цели, или неуспешно, например истекает время, отведённое на достижение цели.

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

Ниже приведён псевдокод цикла игры «Гонка на время: Доставка пиццы»:

loop:
    race:
        loop:
            SelectNextPickupZone
            WaitForPlayerToCompletePickupZone
        block:
            WaitForFirstPickup
            SelectNextDeliveryZone
            WaitForPlayerToCompleteDeliveryZone

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

Создание основного игрового цикла

Внесите следующие изменения в файл game_coordinator_device.verse:

1. Создайте метод с именем PickupDeliveryLoop() и спецификаторами private и suspends. Переместите цикл, который вы до этого создали в OnBegin(), в этот новый метод.

   Verse

        OnBegin<override>;()<suspends> : void =
            SetupZones()
   		
            PickupDeliveryLoop()
   		
        PickupDeliveryLoop<private>()<suspends> : void =
            var PickupLevel : int = 0
   		
            loop:
                if (PickupZone : base_zone = PickupZoneSelectors[PickupLevel].SelectNext[]):
   
   Expand code Copy full snippet(24 lines long)

2. Определите максимальное количество уровней подбора по длине массива тегов и увеличивайте уровень PickupLevel каждый раз, когда игрок завершает зону подбора, пока уровень подбора не превысит максимальное количество уровней подбора.

   Verse

        OnBegin<override>;()<suspends> : void =
            SetupZones()
   
            PickupDeliveryLoop()
   
        PickupDeliveryLoop<private>()<suspends> : void =
            PickupZonesTags : []pickup_zone_tag = array{pickup_zone_level_1_tag{}, pickup_zone_level_2_tag{}, pickup_zone_level_3_tag{}}
            MaxPickupLevel := PickupZonesTags.Length - 1
   
            var PickupLevel : int = 0
   
   Expand code Copy full snippet(23 lines long)

3. Зона доставки должна активироваться после того, как игрок совершит первый подбор, при этом игрок должен иметь возможность при желании подобрать предметы перед тем, как отправиться в зону доставки. Для этого код зоны подбора и зоны доставки должен выполняться одновременно. В этом примере используется выражение одновременного выполнения race, так как:

   • Блок доставки должен отменять цикл зоны подбора, когда игрок завершает доставку.

   • Цикл зоны подбора должен отменять блок доставки при возникновении проблемы с циклом подбора.

   Вам также потребуется немного изменить процесс деактивации зоны. Метод DeactivateZone() не должен вызываться при отмене цикла или блока доставки, если сценарий ожидал завершения зоны.

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

4. Это можно исправить выражением defer. defer откладывает выполнение содержащихся в нём выражений до завершения области видимости, в которой встречается defer. Блок defer запускается, когда управление программой передаётся за пределы области видимости. Это может быть в результате стандартного выхода из области видимости (завершение работы функции), досрочного выхода (например использования операторов return или break) либо отмены любой параллельной задачи или асинхронного выражения (например, race). Это похоже на постановку в очередь операций, которые будут выполнены в самом конце независимо от того, что произойдёт. Поместите каждый вызов метода DeactivateZone в блок defer и вызывайте его перед соответствующим вызовом ZoneCompletedEvent.Await().

   Verse

        PickupDeliveryLoop<private>()<suspends>; : void =
            PickupZonesTags : []pickup_zone_tag = array{pickup_zone_level_1_tag{}, pickup_zone_level_2_tag{}, pickup_zone_level_3_tag{}}
            MaxPickupLevel := PickupZonesTags.Length - 1
   
            var PickupLevel : int = 0
   
            race:
                loop:
                    if (PickupZone : base_zone = PickupZoneSelectors[PickupLevel].SelectNext[]):
                        PickupZone.ActivateZone()
   
   Expand code Copy full snippet(35 lines long)

5. В предыдущем примере зона доставки активируется одновременно с зоной подбора, однако активация зоны доставки должна происходить только после выполнения первого подбора. Для этого добавьте событие и сделайте так, чтобы зона доставки ожидала это событие, прежде чем активироваться.

   Verse

        OnBegin<override>;()<suspends> : void =
            SetupZones()
   
            PickupDeliveryLoop()
   
        PickupDeliveryLoop<private>()<suspends> : void =
            PickupZonesTags : []pickup_zone_tag = array{pickup_zone_level_1_tag{}, pickup_zone_level_2_tag{}, pickup_zone_level_3_tag{}}
            MaxPickupLevel := PickupZonesTags.Length - 1
            FirstPickupZoneCompletedEvent := event(){}
   
   
   Expand code Copy full snippet(49 lines long)

6. Создайте цикл, в котором выражение `race` для зоны подбора/доставки выполняется до завершения игры, чтобы игрок мог продолжать подбирать и доставлять предметы.

   Verse

         OnBegin<override>;()<suspends> : void =
            SetupZones()
   
            PickupDeliveryLoop()
   
        PickupDeliveryLoop<private>()<suspends> : void =
            PickupZonesTags : []pickup_zone_tag = array{pickup_zone_level_1_tag{}, pickup_zone_level_2_tag{}, pickup_zone_level_3_tag{}}
            MaxPickupLevel := PickupZonesTags.Length - 1
            FirstPickupZoneCompletedEvent := event(){}
   
   
   Expand code Copy full snippet(45 lines long)

7. Ваш файл game_coordinator_device.verse сейчас должен выглядеть следующим образом:

   Verse

        using { /Verse.org/Simulation }
        using { /Fortnite.com/Devices }
        using { /Fortnite.com/Vehicles }
        using { /Fortnite.com/Characters }
        using { /Fortnite.com/Playspaces }
        using { /Verse.org/Random }
        using { /UnrealEngine.com/Temporary/Diagnostics }
        using { /UnrealEngine.com/Temporary/SpatialMath }
        using { /UnrealEngine.com/Temporary/Curves }
        using { /Verse.org/Simulation/Tags }
   
   Expand code Copy full snippet(77 lines long)

Сохраните файлы Verse, скомпилируйте код и протестируйте уровень в игре.

Во время тестирования уровня одно из устройств «Генератор предметов» активируется в начале игры, а также после того, как игрок подберёт предмет. После того как игрок подберёт первый предмет, устройство «Генератор предметов» будет деактивировано, а затем активируется устройство «Область захвата». Данный цикл будет работать, пока вы не завершите игру вручную.

Определение состояний успешного и неуспешного завершения игрового цикла

Вы создали основной игровой цикл. Самое время определить состояния успешного и неуспешного завершения игрового цикла. Игра должна завершаться при одном из следующих условий:

• Когда завершается отсчёт таймер или

• Когда что-то идёт не так в игровом цикле.

Выполните следующие действия, чтобы задать состояния успешного и неуспешного завершения игры:

1. Создайте экземпляр класса countdown_timer внутри класса game_coordinator_device со спецификатором private. game_coordinator_device<public> := class(creative_device): @editable EndGame<public> : end_game_device = end_game_device{} var CountdownTimer<private> : countdown_timer = countdown_timer{}

   Verse

   game_coordinator_device<public> := class(creative_device): @editable EndGame<public> : end_game_device = end_game_device{} var CountdownTimer<private> : countdown_timer = countdown_timer{}

   Copy full snippet(1 line long)

2. Поскольку конструктор класса countdown_timer требует ссылки на игрока, добавьте опциональную переменную игрока для хранения ссылки на него в этой одиночной игре, а также создайте функцию FindPlayer() для получения ссылки на игрока. Вызовите функцию FindPlayer() в методе OnBegin() перед настройкой зон. 

   Verse

   game_coordinator_device<public> := class(creative_device): @editable EndGame<public> : end_game_device = end_game_device{} var CountdownTimer<private> : countdown_timer = countdown_timer{} var MaybePlayer<private> : ?player = false OnBegin<override>()<suspends> : void = FindPlayer() SetupZones() FindPlayer<private>() : void = # Since this is a single player experience, the first player (at index 0) # should be the only one available. if (FirstPlayer := GetPlayspace().GetPlayers()[0]): set MaybePlayer = option{FirstPlayer} Logger.Print("Player found") else: # Log an error if we can't find a player. # This shouldn't happen because at least one player is always present. Logger.Print("Can't find valid player", ?Level := log_level.Error)

   Copy full snippet(1 line long)

3. Создайте функцию под названием HandleCountdownEnd(), которая будет ожидать завершения отсчёта таймера и активировать устройство завершения игры. 

   Verse

   HandleCountdownEnd<private>(InPlayer : agent)<suspends> : void = CountdownTimer.CountdownEndedEvent.Await() EndGame.Activate(InPlayer)

   Copy full snippet(1 line long)

4. Создайте функцию StartGame() и вызовите её после SetupZones() в OnBegin(). Эта функция должна выполнять следующее:

   • Инициализировать таймер. 

     Verse

     game_coordinator_device<public> := class(creative_device): # How long the countdown timer will start counting down from. @editable InitialCountdownTime<public> : float = 30.0 @editable EndGame<public> : end_game_device = end_game_device{} OnBegin<override>()<suspends> : void = FindPlayer() SetupZones() StartGame() StartGame<private>()<suspends> : void = Logger.Print("Trying to start the game...") <# We construct a new countdown_timer that'll countdown from InitialCountdownTime once started. The countdown_timer requires a player to show their UI to. We should have a valid player by now. #> if (ValidPlayer := MaybePlayer?): Logger.Print("Valid player, starting game...") set CountdownTimer = MakeCountdownTimer(InitialCountdownTime, ValidPlayer) CountdownTimer.StartCountdown() else: Logger.Print("Can't find valid player. Aborting game start", ?Level := log_level.Error)

     Copy full snippet(1 line long)

   • Используйте выражение race как для вызова HandleCountdownEnd(ValidPlayer), так и для вызова PickupDeliveryLoop(), чтобы добиться следующего:

     • Игровой цикл останавливается при завершении отсчёта таймера или

     • Отсчёт времени прекращается при остановке игрового цикла.  

     Verse

     StartGame<private>()<suspends> : void = Logger.Print("Trying to start the game...") <# We construct a new countdown_timer that'll countdown from InitialCountdownTime once started. The countdown_timer requires a player to show their UI to. We should have a valid player by now. #> if (ValidPlayer := MaybePlayer?): Logger.Print("Valid player, starting game...") set CountdownTimer = MakeCountdownTimer(InitialCountdownTime, ValidPlayer)
     CountdownTimer.StartCountdown() # We wait for the countdown to end. # At the same time, we also run the Pickup and Delivery game loop that constitutes the core gameplay. race: HandleCountdownEnd(ValidPlayer) PickupDeliveryLoop() else: Logger.Print("Can't find valid player. Aborting game start", ?Level := log_level.Error)

     Copy full snippet(2 lines long)

5. Ваш файл game_coordinate_device.verse сейчас должен выглядеть следующим образом:

   Verse

        using { /Verse.org/Simulation }
        using { /Fortnite.com/Devices }
        using { /Fortnite.com/Vehicles }
        using { /Fortnite.com/Characters }
        using { /Fortnite.com/Playspaces }
        using { /Verse.org/Random }
        using { /UnrealEngine.com/Temporary/Diagnostics }
        using { /UnrealEngine.com/Temporary/SpatialMath }
        using { /UnrealEngine.com/Temporary/Curves }
        using { /Verse.org/Simulation/Tags }
   
   Expand code Copy full snippet(129 lines long)

6. Сохраните файлы Verse, скомпилируйте код и протестируйте уровень в игре.

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

Следующий шаг

• 

  4. Управление и отображение счёта

  Создайте игру на Verse, в которой игрокам нужно будет забирать и доставлять пиццу до того, как истечёт время!