1. Como criar adereços móveis com Verse

Como configurar o nível

Para começar, inicialize um novo projeto do modelo de Ilha Inicial Fall Guys. Essa ilha inicial contém uma pista pronta para uso para você percorrer, e você a personalizará com movimento neste tutorial.

Como definir adereços que se movem

Antes de começar a adicionar movimento aos seus adereços, você precisa definir o que um adereço móvel é. Você poderia usar um dispositivo Verse para mover um adereço diretamente, mas isso pode se tornar complicado caso você queira mover vários adereços ao mesmo tempo. Em vez disso, você definirá uma classe abstract movable_prop. Isso conterá o adereço que você quer mover e diversos outros valores que você usará para personalizar a lógica e o tempo do seu movimento.

Siga os passos abaixo para definir seu adereço móvel:

1. Crie uma nova classe Verse chamada movable_prop usando o Explorador do Verse. Como esta é uma classe Verse e não um dispositivo, crie este arquivo usando Criar Vazio. E como esta será a classe abstract da qual você criará subclasses para diferentes tipos de adereços móveis, adicione o especificador <abstract> a esta classe. Para aprender a criar uma nova classe em Verse, confira Como modificar e executar seu primeiro programa em 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. Adicione os caminhos de importação using { /Fortnite.com/Devices }, using { /Verse.org/Simulation } e using { /UnrealEngine.com/Temporary/SpatialMath } à parte superior do seu arquivo. Você precisará importar esses módulos para lidar com os cálculos que fazem seus adereços se moverem.

3. Cada um dos campos nesta classe também incluirá uma ToolTip. Adicionar uma mensagem de ToolTip aos seus campos editáveis exibe uma dica quando você passa o mouse sobre o campo no UEFN. Todas as dicas usadas nesta classe estão inclusas abaixo. Você pode copiar e colar essas dicas, ou definir suas próprias.

   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. Defina os campos de que cada adereço móvel precisa. Na sua definição de classe movable_prop, adicione os seguintes campos:

   1. Um creative_prop editável chamado RootProp. Este é o adereço de Modo Criativo que você moverá durante o jogo.

      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. Um float editável chamado MoveDuration. É a quantidade de tempo que o adereço leva para chegar ao seu destino.

      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. Um float editável chamado MoveStartDelay. Este é o tempo, em segundos, que o adereço aguarda antes de se mover.

      Verse

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

      Copy full snippet(3 lines long)

   4. Um float editável chamado MoveEndDelay. Este é o tempo, em segundos, que o adereço aguarda após se mover.

      Verse

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

      Copy full snippet(3 lines long)

   5. Um logic editável chamado MoveOnceAndStop. Controla se o seu adereço se move apenas uma vez ou se repete o movimento após finalizar.

      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. Um logic editável chamada ShouldReset. Controla se o seu adereço é restaurado para sua posição inicial após o término do movimento.

      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. Uma variável transform chamada StartingTransform. Este é o transformar em que o RootProp está quando começa o movimento.

      Verse

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

      Copy full snippet(2 lines long)

5. A sua definição de classe final deve ficar assim:

   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. Antes de o seu adereço se mover, ele precisa saber de onde está se movendo. Para fazer isso, você criará uma nova função para definir o StartingTransform antes do movimento:

   1. Adicione um novo método SetStartingTransform() à sua definição de classe movable_prop.

   2. Em SetStartingTransform(), defina StartingTransform como o transformar do RootProp usando GetTransform().

      A função completa SetStartingTransform() deve ficar assim:

      Verse

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

      Copy full snippet(3 lines long)

7. Para começar a mover seu adereço, você definirá uma nova função Move():

   1. Adicione um novo método Move() à sua definição de classe movable_prop.

   2. Adicione o modificador <suspends> a essa função para permitir que ela possa ser executada de maneira assíncrona. Como esta é a versão de classe base dessa função e ela não será usada, apenas use return imediatamente.

      A função completa Move() deve ficar assim:

      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. Se você quer que seu adereço seja restaurado quando ele terminar o movimento, precisa teletransportá-lo de volta para sua posição inicial. Para fazer isso, adicione um novo método Reset() à sua definição de classe movable_prop:

   1. Adicione os modificadores <decides><transacts> a esta função para permitir que ela seja revertida caso o reset falhe. Isso pode ocorrer se o seu adereço for descartado durante o jogo.

   2. Em Reset(), teletransporte o RootProp de volta à sua StartingPosition usando TeleportTo[].

      A função completa Reset() deve ficar assim:

      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. Você definiu várias funções e agora é hora de conectá-las umas às outras. Para gerenciar todas as diferentes funções de movimento, adicione um novo método, ManageMovement(), à sua definição de classe movable_prop. Adicione o modificador <suspends> para permitir que a função seja executada de forma assíncrona.

   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. Em ManageMovement(), crie uma expressão de loop que gerencia o movimento. Dentro do loop, primeiro adicione Sleep() por MoveStartDelay segundos e, em seguida, chame 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. Quando sua plataforma termina o movimento, ela precisa continuar se movendo, restaurar sua posição ou parar no lugar. Para cuidar da ação de parar, em uma expressão if, verifique se MoveOnceAndStop é true. Caso seja, interrompa o loop. Após o término do movimento, adicione Sleep() durante MoveEndDelay segundos. Por fim, em outra expressão if, verifique se ShouldReset é true e chame Reset[] caso seja. A função completa ManageMovement() deve ficar assim:

    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. Como não há uma função OnBegin() nesta classe, você precisa de uma maneira para outras classes chamarem ManageMovement() para começar a mover sua plataforma. Adicione uma nova função Setup() à sua definição de classe movable_prop. Em Setup(), primeiro chame SetStartingTransform() e, em seguida, invoque uma função ManageMovement() para fazer a plataforma funcionar. A função Setup() completa deve ficar assim:

    Verse

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

    Copy full snippet(4 lines long)

A seguir

Com sua classe abstract completa, no próximo passo, você descobrirá como fazer com que se movam por meio de animação.

• 

  2. Como mover adereços com animações

  Aprenda a usar esta ferramenta poderosa para criar suas próprias animações e adicionar movimento aos seus adereços!

Código completo

Aqui está o código completo feito nesta seção:

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