1. Tworzenie ruchomych rekwizytów w Verse

Konfigurowanie poziomu

Na początek zainicjuj nowy projekt z szablonu wyspy Fall Guys – starter. Ta wyspa startowa zawiera gotową trasę, po której możesz nawigować. Dzięki informacjom z tego samouczka spersonalizujesz ją, dodając ruch.

Definiowanie ruchomych rekwizytów

Zanim zaczniesz poruszać rekwizytami, musisz zdefiniować, czym jest ruchomy rekwizyt. Możesz użyć Verse, aby bezpośrednio poruszać rekwizytem, ale jeśli chcesz poruszać wieloma rekwizytami naraz, sprawy się komplikują. Zamiast tego zdefiniujesz klasę abstrakcyjną movable_prop. Będzie ona zawierała rekwizyt, który ma się poruszać, i kilka innych wartości, których użyjesz, aby spersonalizować logikę i synchronizację czasową ruchu.

Wykonaj poniższe kroki, aby zdefiniować ruchomy rekwizyt:

1. Przy użyciu Eksploratora Verse utwórz nową klasę Verse o nazwie movable_prop. Jest to klasa Verse, a nie urządzenie, dlatego utwórz plik przy użyciu opcji Utwórz pusty. Będzie to klasa abstrakcyjna, z której wyprowadzisz różne typy podklas ruchomych rekwizytów, dlatego dodaj do niej specyfikator <abstract>. Aby dowiedzieć się, jak utworzyć nową klasę w Verse, patrz: Modyfikacja i uruchomienie pierwszego programu 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. Na początku pliku dodaj ścieżki importu using { /Fortnite.com/Devices }, using { /Verse.org/Simulation } i using { /UnrealEngine.com/Temporary/SpatialMath }. Musisz zaimportować te moduły, aby móc obsługiwać funkcje matematyczne, dzięki którym rekwizyty się poruszają.

3. Każde z pól tej klasy będzie zawierało podpowiedź ToolTip. Dodanie komunikatu ToolTip do edytowalnych pól powoduje wyświetlanie podpowiedzi, gdy kursor myszy znajduje się nad polem w UEFN. Poniżej znajdują się wszystkie podpowiedzi użyte w tej klasie. Możesz skopiować i wkleić te podpowiedzi lub zdefiniować własne.

   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. Zdefiniuj pola, których wymaga każdy ruchomy rekwizyt. Do definicji klasy movable_prop dodaj następujące pola:

   1. Edytowalne pole creative_prop o nazwie RootProp. Jest to rekwizyt Trybu kreatywnego, który będzie się poruszał podczas rozgrywki.

      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. Edytowalne pole float (wartość zmiennopozycyjna) o nazwie MoveDuration. Jest to ilość czasu, jaką zajmuje rekwizytowi przemieszczenie się do miejsca docelowego.

      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. Edytowalne pole float (wartość zmiennopozycyjna) o nazwie MoveStartDelay. Jest to czas w sekundach, przez który rekwizyt czeka, zanim zacznie się poruszać.

      Verse

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

      Copy full snippet(3 lines long)

   4. Edytowalne pole float (wartość zmiennopozycyjna) o nazwie MoveEndDelay. Jest to czas w sekundach, przez który rekwizyt czeka, gdy skończy się poruszać.

      Verse

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

      Copy full snippet(3 lines long)

   5. Edytowalne pole logic (wartość logiczna) o nazwie MoveOnceAndStop. Kontroluje, czy rekwizyt porusza się tylko raz, czy po zakończeniu powtarza ruch.

      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. Edytowalne pole logic (wartość logiczna) o nazwie ShouldReset. Kontroluje, czy rekwizyt powraca do pierwotnej pozycji, gdy skończy się ruszać.

      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. Przekształcenie zmiennej o nazwie StartingTransform. Jest to przekształcenie, w którym znajduje się RootProp w momencie, gdy zaczyna się ruszać.

      Verse

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

      Copy full snippet(2 lines long)

5. Gotowa definicja klasy powinna wyglądać następująco:

   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. Zanim rekwizyt się poruszy, musi wiedzieć, skąd zaczyna wykonywać ruch. W tym celu zdefiniujesz nową funkcję, aby przed wykonaniem ruchu ustawić StartingTransform:

   1. Dodaj nową metodę SetStartingTransform() do definicji klasy movable_prop.

   2. W SetStartingTransform() ustaw StartingTransform na przekształcenie RootProp przy użyciu GetTransform().

      Ukończona funkcja SetStartingTransform() powinna wyglądać następująco:

      Verse

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

      Copy full snippet(3 lines long)

7. Aby zacząć poruszać rekwizytem, zdefiniujesz nową funkcję Move():

   1. Dodaj nową metodę Move() do definicji klasy movable_prop.

   2. Dodaj modyfikator <suspends>, aby ta funkcja mogła działać asynchronicznie. Jest to wersja klasy bazowej tej funkcji i nie będzie używana, dlatego od razu zastosuj return.

      Ukończona funkcja Move() powinna wyglądać następująco:

      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. Jeśli po zakończeniu ruchu rekwizyt ma się resetować, musisz go teleportować z powrotem do pozycji początkowej. W tym celu dodaj nową metodę Reset() do definicji klasy movable_prop:

   1. Do tej funkcji dodaj modyfikatory <decides><transacts>, aby umożliwić wycofanie w razie niepowodzenia resetu. Może tak się stać, gdy w trakcie rozgrywki rekwizyt zostanie zniszczony.

   2. W Reset() teleportuj RootProp z powrotem do StartingTransform przy użyciu TeleportTo[].

      Ukończona funkcja Reset() powinna wyglądać następująco:

      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. Po zdefiniowaniu wielu funkcji czas je wszystkie połączyć. Aby zarządzać wszystkimi różnymi funkcjami ruchu, dodaj nową metodę ManageMovement() do definicji klasy movable_prop. Dodaj modyfikator <suspends>, aby ta funkcja mogła działać asynchronicznie.

   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. W ManageMovement() utwórz wyrażenie loop, które zarządza ruchem. Wewnątrz pętli najpierw wywołaj Sleep() w celu odczekania liczby sekund określonej w MoveStartDelay, a następnie wywołaj 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. Gdy platforma zakończy ruch, musi się poruszać dalej, zresetować pozycję lub zatrzymać się w miejscu. Aby obsłużyć zatrzymanie, w wyrażeniu if sprawdź, czy MoveOnceAndStop ma wartość true. Jeśli tak jest, wyjdź z pętli przy użyciu instrukcji break. Po zatrzymaniu ruchu wywołaj Sleep() w celu odczekania liczby sekund określonej w MoveEndDelay. Na koniec w innym wyrażeniu if sprawdź, czy ShouldReset ma wartość true. Jeśli tak jest, wywołaj Reset[]. Ukończona funkcja ManageMovement() powinna wyglądać następująco:

    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. W tej klasie nie ma funkcji OnBegin(), dlatego potrzebujesz sposobu, który pozwoli innym klasom wywołać ManageMovement(), aby rozpocząć ruch platformy. Dodaj nową funkcję Setup() do definicji klasy movable_prop. W Setup() najpierw wywołaj SetStartingTransform(), a następnie spawnuj funkcję ManageMovement(), aby wprawić platformę w ruch. Ukończona funkcja Setup() powinna wyglądać następująco

    Verse

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

    Copy full snippet(4 lines long)

Następne

Klasa abstrakcyjna jest gotowa. W kolejnym kroku dowiesz się, jak użyć animacji, aby wprawić rekwizyt w ruch!

• 

  2. Poruszanie rekwizytami przy użyciu animacji

  Dowiedz się, jak wykorzystać to potężne narzędzie do tworzenia własnych animacji i wprawiania rekwizytów w ruch!

Complete Code

Oto kompletny kod utworzony w tej sekcji:

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."