Ruchomy znacznik celu

Znaczniki celów są używane w wielu grach, aby poprowadzić gracza do następnego celu lub miejsca na mapie. W tym samouczku dowiesz się, jak utworzyć znacznik celu wielokrotnego użytku za pomocą urządzenia znacznika na mapie i Verse.

Używane funkcje języka Verse

• struct: Możesz grupować zmienne różnych typów w strukturę.

• Metoda rozszerzająca: Specjalny typ funkcji działającej na zasadzie elementu członkowskiego istniejącej klasy lub typu bez konieczności tworzenia nowego typu lub podklasy. Z tym poradnikiem utworzysz metodę rozszerzającą dla struktury.

• Nazwany argument: Argument, który jest przekazywany do wywołania funkcji z podaną nazwą parametru.

Używane interfejsy API Verse

• creative_prop API: creative_prop API dostarcza metod umożliwiających ruch rekwizytów.

• Właściwości edytowalne: Kilka właściwości służy zarówno do odwoływania się do urządzeń, jak i aktualizowania wartości zmiennych w celu szybkiego testowania.

Instrukcje

Wykonaj poniższe kroki, aby dowiedzieć się, jak skonfigurować pojedyncze urządzenie znacznika celu, które może poruszać się do wielu celów lub miejsc na mapie. Kompletne skrypty znajdują się na końcu niniejszego poradnika.

Ustawianie poziomu

W tym przykładzie wykorzystano następujące rekwizyty i urządzenia:

• 1 x rekwizyt budowli: Rekwizyt, który będzie używany do poruszania urządzeniem znacznika na mapie.

• 1x urządzenie wskaźnika na mapie: Urządzenie wyświetlające niestandardowe znaczniki na minimapie i mapie ogólnej.

• 1x urządzenie panelu startowego gracza: Dodaj je w pobliżu rekwizytu, aby gracz odradzał się przy nim.

### Korzystanie z API rekwizytu

Pierwszym krokiem do wprowadzenia urządzenia w ruch za pomocą Verse jest przeniesienie rekwizytu za pomocą API rekwizytu. Wykonaj poniższe kroki, aby poruszać rekwizytem w obrębie poziomu.

1. Utwórz nowe urządzenie Verse o nazwie objective_coordinator_device.

2. Pod domyślnymi wyrażeniami using na górze pliku Verse, dodaj wyrażenie using dla modułu SpatialMath. Ten moduł zawiera kod, który będzie używany do przenoszenia rekwizytów.

   Verse

        using { /UnrealEngine.com/Temporary/SpatialMath }
   

   Copy full snippet(1 line long)

3. Dodaj dwie edytowalne właściwości:

   • Stała creative_prop o nazwie RootProp do przechowywania odwołania do ruchomego rekwizytu.

   • Stała transform o nazwie Destination do przechowywania lokalizacji, do której rekwizyt będzie przenoszony.

     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. Jeśli uruchomisz ten kod i przeciągniesz urządzenie objective_coordinator_device na swój poziom, zobaczysz dwie właściwości w panelu Szczegóły.

5. Metoda TeleportTo[] jest tym, co faktycznie przenosi rekwizyt. Wywołaj ją w wyrażeniu if i użyj nawiasów kwadratowych zamiast okrągłych, ponieważ TeleportTo[] jest wyrażeniem zawodnym. Wyrażenie if stwarza kontekst niepowodzenia.

   Verse

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

   Copy full snippet(4 lines long)

6. Argumentami dla TeleportTo[] są Translacja i Obrót. Oba pochodzą z właściwości Cel.

7. Wróć do edytora i przeciągnij rekwizyt z Fortnite > Galerie > Rekwizyty w przeglądarce zawartości. Rekwizyt użyty w tym poradniku nazywa się Coastal Buoy 02B (Boja przybrzeżna 02B), ale każda pozycja z folderu Rekwizyty powinna działać.

8. Wybierz swoje urządzenie koordynatora celu w Outlinerze. W panelu Szczegóły ustaw w pozycji RootProp swój rekwizyt. W tym przykładzie w pozycji RootProp ustawiona jest boja przybrzeżna 02B.

   

9. W panelu Szczegóły rozwiń Cel. Cel ma przypisany typ transform, dlatego składa się z komponentów Skala, Obrót i Translacja. Aby przenieść rekwizyt, wystarczy zmienić ustawienie Translacja, więc je rozwiń. Ustaw pole kończące się na X na 5000.0.

   

   Podczas testowania kodu dobrym rozwiązaniem jest wprowadzanie dużych zmian w wartościach, aby efekty były oczywiste. Niewielkie zmiany mogą utrudnić stwierdzenie, czy kod robi to, czego oczekujesz.

   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. Kliknij Verse, następnie Skompiluj kod Verse, po czym kliknij Uruchom sesję. Na koniec kliknij Uruchom grę. Rekwizyt powinien się poruszyć.

Klasa bazowa i struktury

Masz teraz rekwizyt poruszający się po twoim poziomie, ale prawdziwym celem jest poruszanie się urządzenia znacznika na mapie, aby gracze mogli go użyć jako punktu nawigacyjnego. Wykonaj poniższe kroki, aby dodać rekwizyt budowli i urządzenie znacznika na mapie do poziomu, a następnie dołączyć je do rekwizytu budowli.

1. Kliknij prawym przyciskiem myszy wewnątrz przeglądarki zawartości, aby otworzyć menu kontekstowe.

2. Wybierz opcję Klasa Blueprintu z menu kontekstowego.

   

3. W oknie Wybierz klasę bazową kliknij Rekwizyt budowli.

   

4. W Przeglądarce zawartości pojawi się nowa klasa Blueprint. Zmień jej nazwę na BuildingProp.

   

5. Przeciągnij rekwizyt budowli na swój poziom. Ten rekwizyt nie ma siatki, więc zobaczysz tylko jego gizmo przekształcenia.

   

6. W panelu Outliner przeciągnij urządzenie znacznika na mapie na rekwizyt budowli. W ten sposób rekwizyt budowli staje się klasą bazową urządzenia znacznika na mapie. Teraz, gdy rekwizyt budowli się porusza, urządzenie znacznika na mapie porusza się wraz z nim.

   

Wiesz już, jak utworzyć urządzenie za pomocą Verse, ale możesz także tworzyć pliki Verse, które nie mają własnych urządzeń.

1. Utwórz nowy plik Verse i nazwij go objective_marker. Ten plik nie utworzy urządzenia. Zamiast tego będzie zawierał definicję struct, która będzie dostępna dla urządzenia Verse utworzonego wcześniej.

2. Zacznij od zadeklarowania elementu struct o nazwie objective_marker. Będzie on miał dwa elementy członkowskie: RootProp i MapIndicator. Oba powinny mieć specyfikator @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)

Metody rozszerzające i argumenty nazwane

Zadeklaruj pojedynczą metodę, MoveMarker, która przesunie element RootProp i dołączone do niego urządzenie znacznika na mapie. Metoda ta wprowadza dwie cechy języka: metody rozszerzające i argumenty nazwane.

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

• Metody rozszerzająca: Dodajesz metodę MoveMarker() do struktury objective_marker. Metoda rozszerzająca jest deklarowana przy użyciu nawiasów otaczających identyfikator i typ oddzielone dwukropkiem. W tym przypadku: (Marker : objective_marker).

• Argumenty nazwane: Drugi argument ?OverTime używa ? do wskazania, że musi być nazwany w wywołaniu funkcji MoveMarker. Pomaga to każdemu twórcy czytającemu lub piszącemu wywołanie MoveMarker zrozumieć, co robi argument float.

Funkcja MoveMarker() wywoła jedną z dwóch metod z API rekwizytu: TeleportTo[], która została użyta wcześniej, lub MoveTo(). Utwórz blok if..else, aby sprawdzić, czy parametr OverTime jest większy niż 0.0. Jeśli tak, wywołaj MoveTo(). Spowoduje to, że zamiast natychmiastowej teleportacji, twój cel przeniesiony zostanie do następnej lokalizacji w określonym przez ciebie czasie.

(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]

Jeśli teraz skompilujesz kod, powinno się to udać, ale nie zobaczysz nowego urządzenia w folderze CreativeDevices w przeglądarce zawartości. Dzieje się tak, ponieważ objective_marker jest obiektem struct, a nie klasą dziedziczącą po creative_device.

Aktualizacja urządzenia koordynatora celu

Teraz, gdy masz nowy typ do odwołania, musisz zaktualizować urządzenie objective_coordinator_device, aby się do niego odwoływać.

1. Usuń właściwość RootProp i zastąp ją właściwością o nazwie PickupMarker typu objective_marker. Jest to typ utworzony przez ciebie.

2. Funkcja MoveMarker() wymaga argumentu typu float, więc utwórz go jako edytowalną właściwość o nazwie MoveTime.

3. Usuwa wywołanie TeleportTo[]. Zamiast tego wywołaj metodę MoveMarker() utworzoną dla objective_marker. Wymaga ona podania argumentu ?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)

Skompiluj ten kod i sprawdź szczegóły urządzenia koordynatora celu. Widoczne powinny być właściwości PickupMarker i MoveTime, a właściwość PickupMarker powinna zawierać elementy RootProp i MapIndicator.

1. Ustaw pole RootProp na BuildingProp, a pole MapIndicator na Urządzenie znacznika na mapie

   

2. Skompiluj swój kod i kliknij Uruchom sesję. Na minimapie powinien pojawić się znacznik, który poruszy się wkrótce po rozpoczęciu gry. Wypróbuj go z MoveTime ustawionym na różne wartości, w tym 0.0. Zastanów się, który ruch byłby najlepszy dla różnych scenariuszy.

GetPlayers() i ActivateObjectivePulse()

Istnieje sposób na zapewnienie graczom dodatkowej pomocy w dotarciu do następnego celu. Nazywa się on impulsem celu. Gdy funkcja ta jest aktywna, pokazuje kropkowaną linię, która przesuwa się od gracza w kierunku urządzenia znacznika na mapie. Postępuj zgodnie z poniższymi instrukcjami, aby dodać impuls celu do urządzenia koordynatora celu.

Metoda potrzebna do aktywacji impulsu celu nazywa się ActivateObjectivePulse() i wymaga jednego argumentu typu agent. Zacznij od stworzenia metody pobierającej instancję agent reprezentującą postać gracza.

1. Zadeklaruj funkcję o nazwie FindPlayer() ustawioną na <private>, z wartością zwracaną void.

2. Pobierz tablicę z wszystkimi graczami na twoim poziomie za pomocą Self.GetPlayspace().GetPlayers(). Przechowaj tablicę w zmiennej o nazwie AllPlayers.

   Verse

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

   Copy full snippet(3 lines long)

3. Aby uzyskać odwołanie tylko do jednego gracza na poziomie, przypisz pierwszy element tablicy do jego własnej zmiennej. Uzyskanie dostępu do tablicy jest wyrażeniem zawodnym, więc umieść je w wyrażeniu if.

   Verse

        if (FirstPlayer := AllPlayers[0]):
   

   Copy full snippet(1 line long)

4. Przypisanie player do zmiennej może się nie powieść, dlatego należy użyć zmiennej typu option podczas odwoływania się do gracza w kodzie. Zadeklaruj opcjonalną zmienną gracza ?player. Powinna być ona zgodna z innymi zmiennymi elementami członkowskimi.

   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. Ustaw nową zmienną i utwórz blok else z wyrażeniem Print(), które poinformuje cię, jeśli gracz nie został znaleziony. Twoja funkcja FindPlayer() jest teraz ukończona.

   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)

Wracając do funkcji OnBegin(), musisz wprowadzić jeszcze dwie zmiany:

1. Wywołaj funkcję FindPlayer().

   Verse

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

   Copy full snippet(3 lines long)

2. Po wywołaniu MoveMarker() użyj kolejnego wyrażenia if, aby ustawić opcjonalną zmienną gracza na nową zmienną i przekaż ją jako argument do PickupMarker.MapIndicator.ActivateObjectivePulse()

   Verse

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

   Copy full snippet(2 lines long)

Jeśli uruchomisz teraz swój kod, zobaczysz impuls celu skierowany od twojej postaci do lokalizacji znacznika celu na poziomie!

Kompletne skrypty

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

Praca własna

Pamiętaj, że napisany tutaj kod ruchu działa dla każdego rekwizytu. Jeśli ruchomy rekwizyt stanie się elementem nadrzędnym urządzenia, to urządzenie będzie poruszać się wraz z nim. Spróbuj poruszać innymi rekwizytami i urządzeniami oraz sprawdź, czy uda ci się wymyślić inne gry, w których można by wykorzystać te efekty.

Kolejne kroki

Jeśli korzystasz z tego poradnika do stworzenia gry bazującej na odbiorze i dostarczeniu, następnym krokiem jest nauczenie się, jak utworzyć funkcję licznika czasu odliczania.