Движущийся маркер цели

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

Используемые возможности языка Verse

• структура: вы можете группировать переменные разного типа в структуру.

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

• именованный аргумент: аргумент, который передаётся при вызове функции с указанным именем параметра.

Используемые API Verse

• creative_prop API: API creative_prop предоставляет методы для перемещения объектов окружения.

• Редактируемые свойства: несколько свойств используются как для ссылки на устройство, так и для обновления значений переменных в целях быстрого тестирования.

Указания

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

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

В этом примере используются следующие объекты окружения и устройства.

• 1 объект-здание: объект окружения для перемещения устройства «Указатель на карте».

• 1 x устройство «Индикатор на карте»: устройство, которое отображает пользовательские маркеры на мини-карте и обзорной карте.

• 1 устройство «Точка появления игрока»: разместите его около объекта окружения, чтобы игрок появился рядом с ним.

Использование API объекта окружения

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

1. Создайте новое устройство Verse и назовите его objective_coordinator_device.

2. После выражений using по умолчанию в начале файла Verse добавьте выражение using для модуля SpatialMath. Этот модуль содержит код, который вы будете использовать для перемещения объектов окружения.

   Verse

        using { /UnrealEngine.com/Temporary/SpatialMath }
   

   Copy full snippet(1 line long)

3. Добавьте два редактируемых свойства:

   • Константу creative_prop с именем RootProp для хранения ссылки на движущийся объект окружения.

   • Константу transform с именем Назначение для хранения местоположения, куда будет перемещаться объект окружения.

     Verse

       objective_coordinator_device<public> := class<concrete>(creative_device):
     
           @editable
           RootProp<public> : creative_prop = creative_prop{}
     
           @editable
           Destination<public> : transform = transform{}

     Copy full snippet(7 lines long)

4. Если вы запустите этот код и перетащите устройство objective_coordinator_device на уровень, оба свойства будут отображаться на панели Сведения.

5. Фактическое перемещение объекта окружения обеспечивается методом TeleportTo[]. Вызовите его в выражении if и используйте квадратные скобки вместо круглых, потому что TeleportTo[] — это выражение с неоднозначным результатом. Оператор if создаёт контекст, допускающий неоднозначность.

   Verse

        if(RootProp.TeleportTo[Destination.Translation, Destination.Rotation]):
            Print("Prop move successful")
        else:
            Print("Prop move failed")
   

   Copy full snippet(4 lines long)

6. Аргументами метода TeleportTo[] являются Перенос и Вращение. Оба они связаны со свойством Назначение.

7. Вернитесь в редактор и перетащите объект окружения из Fortnite > Наборы > Объекты окружения в Каталог ресурсов. В данном руководстве мы используем объект окружения Береговой буй 02B, но отлично подойдёт и любой объект из папки «Объекты окружения».

8. Выберите устройство «Координатор цели» в окне Структура. На панели Сведения задайте значение RootProp для своего объекта окружения. В данном примере для параметра RootProp задано значение «Береговой буй 02B».

   

9. На панели Сведения разверните Назначение. Поскольку свойство Назначение имеет тип transform, оно включает в себя Масштаб, Вращение и Перенос. Чтобы переместить объект окружения, достаточно изменить параметр Перенос, поэтому разверните его. Установите в поле, название которого заканчивается на X, значение 5000,0.

   

   При тестировании кода рекомендуется существенно изменять значения, чтобы эффект был очевиден. При небольших изменениях вы не сможете узнать, выполняется ли ваш код так, как ожидалось.

   Verse

    using { /Verse.org/Simulation }
    using { /Fortnite.com/Devices }
    using { /UnrealEngine.com/Temporary/SpatialMath }
   
    objective_coordinator_device<public> := class<concrete>(creative_device):
   
        @editable
        RootProp<public> : creative_prop = creative_prop{}
   
        # Where the marker will be moved to
   
   Expand code Copy full snippet(19 lines long)

10. Нажмите Verse > Создать код Verse > Запустить сеанс. Наконец, нажмите Начать игру. Вы увидите, как объект окружения перемещается.

Родительские элементы и структуры

Теперь у вас есть объект окружения, который перемещается по уровню. Однако наша конечная цель — это перемещение устройства «Указатель на карте», чтобы игроки могли использовать его в качестве путевой точки. Выполните следующие шаги, чтобы добавить постройку и устройство «Указатель на карте» на уровень и присоединить его к постройке.

1. Нажмите правой кнопкой мыши в Каталоге ресурсов, чтобы открыть контекстное меню.

2. Выберите Класс Blueprint в контекстном меню.

   

3. В окне Выбрать родительский класс нажмите Объект-здание.

   

4. В каталоге ресурсов появится новый класс Blueprint. Переименуйте его в BuildingProp.

   

5. Перетащите постройку на уровень. У этого объекта окружения нет сетки, поэтому будет отображаться только его графический ориентир.

   

6. В «Окне сборки» перетащите устройство «Указатель на карте» на постройку. Это сделает постройку родительским элементом для устройства «Указатель на карте». Теперь при перемещении постройки устройство «Указатель на карте» будет перемещаться вместе с ним.

   

Вы уже знаете, как создать устройство с помощью Verse, при этом можно создавать файлы Verse, которые не имеют собственных устройств.

1. Создайте новый файл Verse и назовите его objective_marker. Этот файл не будет создавать устройство. Вместо этого он будет содержать определение структуры struct, доступной для устройства Verse, созданного вами ранее.

2. Сначала объявите структуру struct с именем objective_marker. Она будет содержать две составляющих: RootProp и MapIndicator. Обе должны иметь спецификатор @editable.

   Verse

        objective_marker<public> := struct<concrete>:
   
        @editable
        RootProp<public> : creative_prop = creative_prop{}
   
        @editable
        MapIndicator<public> : map_indicator_device = map_indicator_device{}

   Copy full snippet(7 lines long)

Методы расширения и именованные аргументы

Объявите единственный метод MoveMarker, который будет перемещать составляющую RootProp и присоединённое к ней устройство «Указатель на карте». Этот метод отражает две особенности языка: методы расширения и именованные аргументы.

(Marker : objective_marker).MoveMarker<public>(Transform : transform, ?OverTime : float)<suspends> : void =

• Методы расширения: вы добавляете метод MoveMarker() в структуру objective_marker. При объявлении метода расширения необходимо указать в круглых скобках идентификатор и тип, разделённые двоеточием. В данном случае: (Marker : objective_marker).

• Именованные аргументы: во втором аргументе ?OverTime используется символ ? для указания того, что он должен быть именован при вызове функции MoveMarker. Это позволяет любому разработчику, читающему или пишущему вызов MoveMarker, понять назначение аргумента типа float.

MoveMarker() будет вызывать один из двух методов с помощью API объекта окружения: TeleportTo[], который вы использовали ранее, или MoveTo(). Создайте блок if..else для проверки того, что параметр OverTime больше 0.0. Если это так, вызовите MoveTo(). В результате ваша цель переместится в следующее место за указанное вами время, вместо того чтобы телепортироваться мгновенно.

(Marker : objective_marker).MoveMarker<public>(Transform : transform, ?OverTime : float)<suspends> : void =

 if (OverTime > 0.0):
        Marker.RootProp.MoveTo(Transform.Translation, Transform.Rotation, OverTime)
    else:
        if:
            Marker.RootProp.TeleportTo[Transform.Translation, Transform.Rotation]

Если теперь вы скомпилируете код, всё должно получиться, но вы не увидите новое устройство в папке CreativeDevices в Каталоге ресурсов. Причина в том, что objective_marker является структурой, а не классом, который наследуется от creative_device.

Обновление устройства «Координатор цели»

Теперь, когда у вас есть новый тип, на который можно ссылаться, необходимо создать ссылку на устройство objective_coordinator_device.

1. Удалите свойство RootProp и замените его свойством с именем PickupMarker типа objective_marker. Это тип, который вы создали.

2. Для MoveMarker() требуется аргумент типа float. Создайте такой аргумент в виде редактируемого свойства с именем MoveTime.

3. Удалите вызов TeleportTo[]. Вместо этого вызовите метод MoveMarker(), который вы создали для objective_marker. Ему требуется именованный аргумент ?OverTime.

   Verse

        objective_coordinator_device<public> := class<concrete>(creative_device):
   
            @editable
            PickupMarker<public> : objective_marker = objective_marker{}
   
            # Where the marker will be moved to
            @editable
            Destination<public> : transform = transform{}
   
            # How much time the marker should take to reach its new location
   
   Expand code Copy full snippet(16 lines long)

Скомпилируйте этот код и проверьте «Свойства» устройства «Координатор цели». Вы должны увидеть свойства PickupMarker и MoveTime, а свойство PickupMarker должно содержать RootProp и MapIndicator.

1. Выберите в поле RootProp значение BuildingProp, а в поле MapIndicator значение Устройство «Указатель на карте»

   

2. Скомпилируйте свой код и нажмите на кнопку Запустить сеанс. Вы должны увидеть маркер на мини-карте, который начнёт перемещаться вскоре после начала игры. Попробуйте поиграть со значениями MoveTime, в том числе с 0.0. Подумайте, какое перемещение лучше всего подходит для разных сценариев.

GetPlayers() и ActivateObjectivePulse()

Существует способ немного помочь игрокам в достижении следующей цели. Это так называемая пульсация цели, и, когда она активна, отображается пунктирная линия, движущаяся от игрока в направлении Устройства «Указатель на карте». Выполните следующие шаги, чтобы добавить пульсацию цели к устройству «Координатор цели».

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

1. Объявите функцию FindPlayer(), определённую как <private>, с возвращаемым значением void.

2. Получите массив всех игроков на уровне с помощью Self.GetPlayspace().GetPlayers(). Сохраните массив в переменной под названием AllPlayers.

   Verse

        FindPlayer<private>() : void =
   
            AllPlayers := Self.GetPlayspace().GetPlayers()

   Copy full snippet(3 lines long)

3. Чтобы получить ссылку на нужного игрока на уровне, присвойте первый элемент массива собственной переменной. Доступ к массиву — это выражение с неоднозначным результатом, поэтому поместите его в выражение if.

   Verse

        if (FirstPlayer := AllPlayers[0]):
   

   Copy full snippet(1 line long)

4. Поскольку присвоение переменной значения player может привести к ошибке, при ссылке на игрока в коде нужно использовать переменную типа option. Объявите опциональную переменную игрока ?player. Она должна использоваться совместно с другими переменными-составляющими.

   Verse

        objective_coordinator_device<public> := class<concrete>(creative_device):
   
        var PlayerOpt<private> : ?player = false
   
        @editable
        PickupMarker<public> : objective_marker = objective_marker{}
   
        # Where the marker will be moved to
        @editable
        Destination<public> : transform = transform{}
   
   Expand code Copy full snippet(14 lines long)

5. Определите новую переменную и создайте блок else с выражением Print(), которое сообщит вам, если игрок не будет найден. Ваша функция FindPlayer() готова.

   Verse

        FindPlayer<private>() : void =
   
            # Since this is a single player experience, the first player [0]
            # should be the only one available.
   
            AllPlayers := Self.GetPlayspace().GetPlayers()
   
            if (FirstPlayer := AllPlayers[0]):
                set PlayerOpt = option{FirstPlayer}
                Print("Player found")
   
   Expand code Copy full snippet(13 lines long)

В функции OnBegin() нужно внести ещё два изменения:

1. Вызовите функцию FindPlayer().

   Verse

        OnBegin<override>()<suspends> : void =
   
            FindPlayer()

   Copy full snippet(3 lines long)

2. После вызова MoveMarker() используйте ещё одно выражение if, чтобы установить опциональную переменную игрока на новую переменную, и передайте её в качестве аргумента в PickupMarker.MapIndicator.ActivateObjectivePulse()

   Verse

        if (FoundPlayer := PlayerOpt?):
            PickupMarker.MapIndicator.ActivateObjectivePulse(FoundPlayer)
   

   Copy full snippet(2 lines long)

Если вы запустите код сейчас, то увидите линию пульсации цели, направленную от персонажа к месту расположения маркера цели на уровне!

Полные сценарии

Objective_marker.verse

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

objective_marker<public> := struct<concrete>:

    # The prop that will be moved
    @editable
    RootProp<public> : creative_prop = creative_prop{}

Objective_coordinator_device.verse

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

objective_coordinator_device<public> := class<concrete>(creative_device):

    var PlayerOpt<private> : ?player = false

    @editable

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

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

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

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