1. Создание перемещаемых объектов окружения с помощью Verse

Подготовка уровня

Для начала создайте новый проект на основе шаблона острова Стартовый набор Fall Guys. Этот начальный остров содержит готовую полосу, по которой может перемещаться игрок, и в этом уроке мы настроим её, заставив некоторые объекты двигаться.

Определение объектов окружения, способных перемещаться

Прежде чем перемещать объект окружения, необходимо определить, что же такое перемещаемый объект окружения. Вы можете использовать устройство Verse, чтобы перемещать объект окружения напрямую, но это может оказаться сложным, если нужно перемещать несколько объектов окружения одновременно. Вместо этого определим абстрактный класс movable_prop. Он будет содержать объект окружения, который требуется перемещать, и несколько других параметров для настройки логики и времени перемещения объекта.

Следуйте указаниям ниже, чтобы определить перемещаемый объект окружения:

1. Создайте новый класс Verse с помощью проводника Verse и назовите его movable_prop. Поскольку это класс Verse, а не устройство, создайте этот файл с помощью команды Создать пустой. И поскольку это будет абстрактный класс, на основе которого мы будем создавать подклассы различных типов перемещаемых объектов окружения, добавьте к этому классу спецификатор <abstract>. Чтобы узнать, как создать новый класс в Verse, см. раздел Измените и запустите свою первую программу на Verse.

   Verse

        # Defines a Creative prop that moves to a target or location using animation.
        movable_prop<public> := class<abstract>():
   

   Copy full snippet(2 lines long)

2. Добавьте пути импорта using { /Fortnite.com/Devices }, using { /Verse.org/Simulation }, и using { /UnrealEngine.com/Temporary/SpatialMath } в начало файла. Эти модули необходимо импортировать для выполнения вычислений, на основе которых будут перемещаться объекты окружения.

3. Каждое из полей этого класса также будет включать ToolTip. Добавление к редактируемым полям сообщения ToolTip позволяет отображать подсказку при наведении курсора на соответствующее поле в UEFN. Ниже приведены все подсказки, используемые в этом классе. Вы можете скопировать и вставить эти подсказки или определить свои собственные.

   Verse

        using { /Fortnite.com/Devices }
        using { /Verse.org/Simulation }
        using { /UnrealEngine.com/Temporary/SpatialMath }
   		
        MoveDurationTip<localizes>:message = "The amount of time the prop takes to move to its destination."
        MoveEaseTypeTip<localizes>:message = "The animation easing applied to the movement."
        MoveEndDelayTip<localizes>:message = "The delay after the movement finishes."
        MoveOnceAndStopTip<localizes>:message = "Whether the RootProp should stop in place after it finishes moving."
        MoveStartDelayTip<localizes>:message = "The delay before the movement starts."
        MoveTargetsTip<localizes>:message = "The array of CreativeProp to move toward. These targets can be children of the RootProp."
   
   Expand code Copy full snippet(15 lines long)

4. Определите поля, необходимые для каждого перемещаемого объекта окружения. Добавьте следующие поля в определении своего класса movable_prop:

   1. Редактируемое поле типа creative_prop с названием RootProp. Это объект окружения творческого режима, который вы будете перемещать во время игры.

      Verse

                               # The Creative prop associated with this class.
                               # This should be the root prop of the object you want to move.
                               @editable {ToolTip := RootPropTip}
                               RootProp:creative_prop = creative_prop{}
      

      Copy full snippet(4 lines long)

   2. Редактируемая переменная типа float с названием MoveDuration. Это время, необходимое объекту окружения, чтобы достичь места назначения.

      Verse

       # The duration in seconds it takes for the prop to move to its destination.
       @editable {ToolTip := MoveDurationTip}
       MoveDuration:float = 3.0
      

      Copy full snippet(3 lines long)

   3. Редактируемая переменная типа float с названием MoveStartDelay. Это время в секундах, в течение которого объект окружения ждёт перед началом перемещения.

      Verse

       # The duration in seconds to wait before movement begins.
       @editable {ToolTip := MoveStartDelayTip}
       MoveStartDelay:float = 0.0
      

      Copy full snippet(3 lines long)

   4. Редактируемая переменная типа float с названием MoveEndDelay. Это время в секундах, в течение которого объект окружения ждёт после завершения перемещения.

      Verse

       # The duration in seconds to wait after movement ends.
       @editable {ToolTip := MoveEndDelayTip}
       MoveEndDelay:float = 0.0
      

      Copy full snippet(3 lines long)

   5. Редактируемая переменная типа logic с названием MoveOnceAndStop. Определяет, будет ли объект окружения перемещаться только один раз или повторять перемещение после его завершения.

      Verse

       # Whether the RootProp should stop in place when it finishes moving.
       @editable {ToolTip := MoveOnceAndStopTip}
       MoveOnceAndStop:logic = false
      

      Copy full snippet(3 lines long)

   6. Редактируемая переменная типа logic с названием ShouldReset. Определяет, будет ли объект окружения возвращаться в исходное положение после завершения перемещения.

      Verse

       # Whether the RootProp should reset back to the starting position when it
       # finishes moving.
       @editable {ToolTip := ShouldResetTip}
       ShouldReset:logic = false
      

      Copy full snippet(4 lines long)

   7. Переменная StartingTransform типа transform. Это преобразование, в котором находится RootProp, когда начинает перемещение.

      Verse

       # The starting transform of the RootProp.
       var StartingTransform:transform = transform{}
      

      Copy full snippet(2 lines long)

5. Окончательное определение класса должно выглядеть следующим образом:

   Verse

        using { /Fortnite.com/Devices }
        using { /Fortnite.com/Devices/CreativeAnimation }
        using { /Verse.org/Simulation }
        using { /UnrealEngine.com/Temporary/SpatialMath }    
   		
        MoveDurationTip<localizes>:message = "The amount of time in seconds the prop takes to move to its destination."
        MoveEaseTypeTip<localizes>:message = "The animation easing applied to the movement."
        MoveEndDelayTip<localizes>:message = "The delay after the movement finishes."
        MoveOnceAndStopTip<localizes>:message = "Whether the RootProp should stop in place after it finishes moving."
        MoveStartDelayTip<localizes>:message = "The delay before the movement starts."
   
   Expand code Copy full snippet(45 lines long)

6. Прежде чем объект окружения начнёт перемещение, ему нужно знать, откуда он будет перемещаться. Для этого необходимо определить новую функцию, задающую StartingTransform перед началом перемещения:

   1. Добавьте новый метод SetStartingTransform() в определение класса movable_prop.

   2. В методе SetStartingTransform() установите в качестве StartingTransform преобразование RootProp с помощью функции GetTransform().

      Готовая функция SetStartingTransform() должна выглядеть следующим образом:

      Verse

       # Sets the StartingTransform to the current transform of the RootProp.
       SetStartingTransform():void=
           set StartingTransform = RootProp.GetTransform()
      

      Copy full snippet(3 lines long)

7. Чтобы начать перемещать объект окружения, нужно определить новую функцию Move():

   1. Добавьте новый метод Move() в определение класса movable_prop.

   2. Добавьте к этой функции модификатор <suspends>, чтобы она могла выполняться асинхронно. Поскольку это версия функции из базового класса и она не будет использоваться, просто сразу же вернём значение с помощью return.

      Готовая функция Move() должна выглядеть следующим образом:

      Verse

       # Move the RootProp to its target. This is the base class
       # version of this function and should not be used.
       Move()<suspends>:void=
           return
      

      Copy full snippet(4 lines long)

8. Если вы хотите, чтобы объект окружения возвращался в исходное положение после завершения перемещения, его необходимо телепортировать обратно в исходное положение. Для решения этой задачи добавьте новый метод Reset() в определение класса movable_prop:

   1. Добавьте к этой функции модификаторы <decides><transacts>, чтобы разрешить её откат в случае неудачного выполнения. Это может произойти, если объект окружения был удалён во время игры.

   2. В функции Reset() телепортируйте RootProp обратно в StartingTransform с помощью TeleportTo[].

      Готовая функция Reset() должна выглядеть следующим образом:

      Verse

       # Reset the RootProp by teleporting it back to its Starting Transform.
       Reset()<decides><transacts>:void=
           RootProp.TeleportTo[StartingTransform]
      

      Copy full snippet(3 lines long)

9. Мы определили множество функций, и теперь нужно объединить их в одно целое. Чтобы управлять всеми различными функциями перемещения, добавим новый метод ManageMovement() в определение класса movable_prop. Добавьте к этой функции модификатор <suspends>, чтобы она могла работать асинхронно.

   Verse

   
        # Loops moving the RootProp to its target by calling Move(), and handles
        # any logic when the movement begins and ends.
        ManageMovement()<suspends>:void=
   

   Copy full snippet(4 lines long)

10. В функции ManageMovement() создайте выражение loop, которое будет обрабатывать перемещение. Внутри цикла сначала подождём с помощью функции Sleep() в течение MoveStartDelay секунд, а затем вызовем Move().

    Verse

         # Loops moving the RootProp to its target by calling Move(), and handles
         # any logic when the movement begins and ends.
         ManageMovement()<suspends>:void=
             loop:
                 Sleep(MoveStartDelay)
    		
                 Move()
    

    Copy full snippet(7 lines long)

11. Когда ваша платформа завершит перемещение, она должна продолжить перемещение, вернуться в исходное положение или остановиться. Чтобы обработать остановку, с помощью выражения if проверим, имеет ли MoveOnceAndStop значение true. Если да, то выходим из цикла c помощью break. После завершения перемещения подождём с помощью функции Sleep() в течение MoveEndDelay секунд. Наконец, в другом выражении if проверим, имеет ли ShouldReset значение true, и вызовем Reset[], если это так. Готовая функция ManageMovement() должна выглядеть следующим образом:

    Verse

         # Loops moving the RootProp to its target by calling Move(), and handles
         # any logic when the movement begins and ends.
         ManageMovement()<suspends>:void=
             loop:
                 Sleep(MoveStartDelay)
    
                 Move()
    
                 # If the prop should only move once and stop, then exit the loop.
                 if:
    
    Expand code Copy full snippet(20 lines long)

12. Так как в этом классе нет функции OnBegin(), нужен способ, позволяющий другим классам вызывать ManageMovement() для запуска перемещения платформы. Добавим новую функцию Setup() в определение класса movable_prop. Внутри Setup() сначала вызовем SetStartingTransform(), а затем создадим функцию ManageMovement(), чтобы начать перемещать платформу. Готовая функция Setup() должна выглядеть следующим образом:

    Verse

     # Set the StartingTransform, then begin movement by spawning ManageMovement.
     Setup():void=
         SetStartingTransform()
         spawn{ManageMovement()}
    

    Copy full snippet(4 lines long)

Далее

Абстрактный класс готов, и на следующем шаге мы разберёмся, как реализовать перемещение объектов с помощью анимации!

• 

  2. Перемещение объектов окружения с помощью анимаций

  Узнайте, как использовать этот эффективный инструмент для создания собственных анимаций и перемещения объектов окружения!

Полный код

Ниже приведён полный код, написанный в этом разделе:

movable_prop.verse

using { /Fortnite.com/Devices }
using { /Fortnite.com/Devices/CreativeAnimation }
using { /Verse.org/Simulation }
using { /UnrealEngine.com/Temporary/SpatialMath }

MoveDurationTip<localizes>:message = "The amount of time in seconds the prop takes to move to its destination."
MoveEaseTypeTip<localizes>:message = "The animation easing applied to the movement."
MoveEndDelayTip<localizes>:message = "The delay after the movement finishes."
MoveOnceAndStopTip<localizes>:message = "Whether the RootProp should stop in place after it finishes moving."
MoveStartDelayTip<localizes>:message = "The delay before the movement starts."