3. Перенос объектов окружения

Некоторые простейшие препятствия просто перемещаются туда и обратно. Подобные препятствия, когда нужно вовремя прыгать и осторожно перемещаться, чтобы не упасть, часто встречаются в играх в жанре «платформер».

Такое перемещение платформы называется переносом, или изменением положения в преобразовании объекта. В этом разделе вы узнаете, как создавать платформы, которые не только перемещаются туда и обратно, но также могут перемещаться в несколько точек в мире, а затем используете их, чтобы создать своё первое препятствие!

Создание переносимых объектов окружения

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

1. С помощью проводника Verse создайте новый класс Verse, наследующийся от movable_prop, и назовите его translating_prop. Добавьте спецификатор <concrete> в этот класс, чтобы вывести его свойства в интерфейс UEFN.

   Verse

        # A prop that moves (translates) toward either a Creative prop target
        # or a position in world space.
        translating_prop<public> := class<concrete>(movable_prop):

   Copy full snippet(3 lines long)

2. Добавьте выражения using { /Fortnite.com/Devices/CreativeAnimation } и using { /UnrealEngine.com/Temporary/SpatialMath } в начало файла, чтобы импортировать эти модули. Они потребуются для анимирования вашего объекта окружения. Также ниже приведены подсказки, используемые в данном разделе.

   Verse

        using { /Fortnite.com/Devices }
        using { /Fortnite.com/Devices/CreativeAnimation }
        using { /Verse.org/Simulation }
        using { /UnrealEngine.com/Temporary/SpatialMath }
   
        MovePositionTip<localizes>:message = "The optional position to move to World Space. Use this if you do not want to set a MoveTarget."
   
        # A prop that moves (translates) toward either a Creative prop target
        # or a position in world space.
        translating_prop<public> := class<concrete>(movable_prop):

   Copy full snippet(10 lines long)

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

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

      Verse

                              # The Creative prop targets for the RootProp to move toward.
                              @editable {ToolTip := MoveTargetsTip}
                              var MoveTargets:[]creative_prop = array{}
      								        
      

      Copy full snippet(4 lines long)

   2. Редактируемая переменная vector3 типа option с названием MovePosition. Если объект MoveTarget не присвоен, то наш корневой объект окружения будет перемещаться в точку, определяемую этой переменной.

      Verse

                               # The position for the RootProp to move toward. Use this if you
                               # do not want to set a MoveTarget.
                               @editable {ToolTip := MovePositionTip}
                               var MovePosition:?vector3 = false
      								        
      

      Copy full snippet(5 lines long)

   3. Переменная типа vector3 с названием TargetPosition. Это положение, в которое фактически будет перемещаться наш объект окружения, и оно определяется либо как положение цели перемещения, либо как MovePosition.

      Verse

                               # The position the prop is currently targeting.
                               var TargetPosition:vector3 = vector3{}
      								        
      

      Copy full snippet(3 lines long)

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

      Verse

       # A prop that moves (translates) toward either a Creative prop target
       # or a position in world space.
       translating_prop<public> := class<concrete>(movable_prop):
      
           # The Creative prop targets for the RootProp to move toward.
           @editable {ToolTip := MoveTargetsTip}
           var MoveTargets:[]creative_prop = array{}
      
           # The optional position for the RootProp to move toward. Use this if you
           # do not want to set a MoveTarget.
      
      Expand code Copy full snippet(15 lines long)

4. Поскольку мы уже определили функцию Move(), которая перемещает объект окружения в movable_prop, её можно переопределить в этом классе. Переопределите функцию Move() в классе translating_prop.

   Verse

        # Translate toward the MovePosition, or MoveTarget if one is set.
        Move<override>()<suspends>:void=

   Copy full snippet(2 lines long)

5. В функции Move(), в выражении if проверим, задано ли положение MovePosition и сохранено ли оно в виде NewPosition. Если да, установим положение TargetPosition равным NewPosition.

   Verse

        # Translate the RootProp toward the MoveTarget, or MovePosition if one is set.
        Move<override>()<suspends>:void=
            # Set the TargetPosition to the MovePosition if it is set.
            if:
                NewPosition := MovePosition?
            then:
                set TargetPosition = NewPosition

   Copy full snippet(7 lines long)

6. В функцию MoveToEase() необходимо передавать animation_mode. Анимация воспроизводится один раз при каждом вызове Move(), а параметр animation_mode определяет, что происходит после завершения воспроизведения анимации. Вызовем функцию MoveToEase(), передав в неё TargetPosition, MoveDuration, MoveEaseType и animation_mode.OneShot. Использование этого режима анимации означает, что анимация остановится, как только объект достигнет цели. Это перегруженная функция MoveToEase(), которую мы определили ранее, в которую не требуется передавать вращение и масштаб.

   Verse

        # Set the TargetPosition to the MovePosition if it is set.
        if:
            NewPosition := MovePosition?
        then:
            set TargetPosition = NewPosition
   		            
            # Call MoveToEase to start moving the prop. The OneShot animation mode will play the animation once.
            RootProp.MoveToEase(TargetPosition, MoveDuration, MoveEaseType, animation_mode.OneShot)
   

   Copy full snippet(8 lines long)

   Режим однократного воспроизведения анимации пригодится, если требуется вернуть объект в исходное положение или продолжить его перемещение, но что делать, если нужно переместить объект в обратном порядке? В этом случае можно использовать режим анимации PingPong. В данном режиме анимация воспроизводится сначала в прямом, а затем в обратном порядке, и объект окружения возвращается в исходное положение. Также есть режим анимации Loop, который обеспечивает воспроизведение анимации в цикле, при этом она завершается в том же месте, в котором началась. Выбирайте режим анимации в соответствии с требованиями вашей игры.

7. Если при настройке объектов окружения вы не задали MovePosition в редакторе, нужно будет установить одну или несколько целей MoveTargets для перемещения корневого объекта окружения. Чтобы обработать MoveTargets в выражении for, нужно перебрать все цели в массиве MoveTargets. Проверим, установлена ли цель MoveTarget, вызвав IsValid[]. Если да, установим положение TargetPosition равным переносу MoveTarget.

   Verse

        # Set the TargetPosition to the MovePosition if it is set.
        if:
            NewPosition := MovePosition?
        then:
            set TargetPosition = NewPosition
        else:
            for:
                MoveTarget:MoveTargets
            do:
                # Set the TargetPosition to the MoveTarget's position if the
   
   Expand code Copy full snippet(15 lines long)

8. Наконец, вызовем MoveToEase(), снова передав режим анимации animation_mode.OneShot. Выполнение этой процедуры в выражении for обеспечит последовательное перемещение объекта окружения к каждой из целей, при этом в зависимости от установленных параметров в конце объект вернётся в исходное положение или продолжит перемещение. Готовая функция Move() должна выглядеть следующим образом:

   Verse

        # Translate the RootProp toward the MoveTarget, or MovePosition if one is set.
        Move<override>()<suspends>:void=
   
            # Set the TargetPosition to the MovePosition if it is set.
            if:
                NewPosition := MovePosition?
            then:
                set TargetPosition = NewPosition
   
                # Call MoveToEase to start moving the prop. The OneShot animation mode will play the animation once.
   
   Expand code Copy full snippet(25 lines long)

Создание устройства Verse

Теперь, когда код Verse готов, нужен способ, чтобы вызывать этот код на уровне. Используем ещё одно устройство Verse для координации объектов окружения и их настройки в начале игры. Выполните следующие действия, чтобы координировать препятствия и перемещать платформы!

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

2. В prop_animator добавьте редактируемый массив элементов translating_prop с названием TranslatingProps. Затем в функции OnBegin(), в выражении for, вызовите функцию Setup() для каждого объекта окружения. Готовый файл prop_animator должен выглядеть следующим образом:

   Verse

        using { /Fortnite.com/Devices }
        using { /Verse.org/Simulation }
        using { /UnrealEngine.com/Temporary/Diagnostics }
   
        TranslatingPropsTip<localizes>:message = "The props that translate (move) using animation."
        # Coordinates moving props through animation by calling each moveable_prop's Setup() method.
   
        prop_animator := class(creative_device):
   
            # Array of moveable_props that translate using animation.
   
   Expand code Copy full snippet(20 lines long)

3. Сохраните свой код и скомпилируйте его.

4. Перетащите своё устройство prop_animator на уровень.

Привязка объектов окружения к устройствам

Вернувшись в редактор, удалите некоторые объекты окружения в начале уровня, чтобы создать пропасть. Добавьте на уровень два объекта окружения Аэроплатформа (средняя) FG01. Так как это платформы, которые мы будем анимировать, назовите их TranslatingPlatform. После этого добавьте несколько объектов Кнопка-луковица FG01, которые будут целями, к которым будет перемещаться каждая платформа. Назовите их PlatformTarget. Поместите платформы над пропастью и убедитесь, что цели размещены там, куда должны перемещаться платформы. Вы можете установить для каждой платформы несколько целей.

Настройка переносимых объектов окружения. Каждая платформа перемещается вперёд и назад между двумя целями перемещения, как обозначено стрелками.

Перетащите своё устройство prop_animator на уровень и выберите его. На панели Структура добавьте в массив TranslatingProps элемент, соответствующий каждой платформе. Задайте следующие параметры для каждого объекта окружения:

Нажмите Запуск сеанса, и ваши платформы начнут анимироваться! Попробуйте менять MoveDuration, MoveEaseType, а также начальную и конечную задержки, чтобы создавать различные сценарии.

Перенос готов, и в следующем разделе мы создадим объекты окружения, вращающиеся в разных направлениях!

Далее

• 

  4. Вращение объектов окружения

  Узнайте, как поворачивать препятствия на полосе Fall Guys.

Полный код

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

translating_prop.verse

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

MovePositionTip<localizes>:message = "The optional position to move to World Space. Use this if you do not want to set a MoveTarget."

# A prop that moves (translates) toward either a Creative prop target
# or a position in world space.
translating_prop<public> := class<concrete>(movable_prop):

prop_animator.verse

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

TranslatingPropsTip<localizes>:message = "The props that translate (move) using animation."

# Coordinates moving props through animation by calling each moveable_prop's Setup() method.
prop_animator := class(creative_device):

    # Array of moveable_props that translate using animation.