1. Cómo crear elementos móviles con Verse

Cómo configurar el nivel

Para empezar, inicializa un nuevo proyecto a partir de la plantilla de isla Inicio de Fall Guys. Esta isla inicial incluye un curso prediseñado por el que podrás navegar, y en este tutorial aprenderás a personalizarlo con movimientos.

Cómo definir elementos que se mueven

Antes de empezar a mover los elementos, debes definir qué es un elemento que se puede mover. Podrías utilizar un dispositivo de Verse para mover un elemento directamente, pero podría resultar complicado en el caso de que quisieras mover varios elementos a la vez. En su lugar, definirás una clase movable_prop abstracta. Esta contendrá el objeto que quieres mover y algunos otros valores que utilizarás para personalizar la lógica y el tiempo del movimiento.

Sigue los pasos que se indican a continuación para definir el elemento que se puede mover:

1. Crea una nueva clase de Verse con el nombre movable_prop utilizando el explorador de Verse. Como se trata de una clase de Verse y no de un dispositivo, crea este archivo utilizando Crear desde cero. Y como esta será la clase abstracta de la que subclasificarás los diferentes tipos de elementos móviles, añade el especificador <abstract> a esta clase. Para aprender a crear una nueva clase en Verse, consulta Cómo modificar y ejecutar tu primer programa en 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. Añade las rutas de importación using { /Fortnite.com/Devices }, using { /Verse.org/Simulation } y using { /UnrealEngine.com/Temporary/SpatialMath } al principio de tu archivo. Necesitarás importar estos módulos para poder controlar las matemáticas que permiten el movimiento de los elementos.

3. Cada uno de los campos de esta clase también incluirá un mensaje de tipo ToolTip. Al añadir un mensaje de tipo ToolTip a los campos editables, aparecerá un consejo al pasar el ratón por encima del campo en UEFN. A continuación se incluyen todos los consejos utilizados en esta clase. Puedes copiar y pegar estos consejos o definir los tuyos propios.

   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. Define los campos que necesita cada elemento que se puede mover. En la definición de la clase movable_prop, añade los siguientes campos:

   1. Un creative_prop editable con el nombre RootProp. Este es el elemento del modo Creativo que moverás durante el juego.

      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. Un float editable con el nombre MoveDuration. Es la cantidad de tiempo que tarda el elemento en llegar a su 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. Un float editable con el nombre MoveStartDelay. Es el tiempo en segundos que espera el elemento antes de moverse.

      Verse

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

      Copy full snippet(3 lines long)

   4. Un float editable con el nombre MoveEndDelay. Es el tiempo en segundos que espera el elemento después de moverse.

      Verse

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

      Copy full snippet(3 lines long)

   5. Un logic editable con el nombre MoveOnceAndStop. Esto controla si el elemento solo se mueve una vez o si repite el movimiento una vez finalizado.

      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. Un logic editable con el nombre ShouldReset. Controla si el elemento vuelve a su posición original una vez finalizado el movimiento.

      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. Una variable transform denominada StartingTransform. Esta es la transformación en la que se encuentra el RootProp cuando inicia el movimiento.

      Verse

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

      Copy full snippet(2 lines long)

5. La definición final de la clase debería tener este aspecto:

   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 que el elemento se mueva, necesita saber desde dónde lo hace. Para ello, definirás una nueva función para establecer StartingTransform antes del movimiento:

   1. Añade un nuevo método SetStartingTransform() a la definición de tu clase movable_prop.

   2. Dentro de SetStartingTransform(), establece StartingTransform como la transformación de RootProp utilizando GetTransform().

      Tu función SetStartingTransform() completa debería tener este aspecto:

      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 empezar a mover el elemento, definirás una nueva función Move():

   1. Añade un nuevo método Move() a la definición de tu clase movable_prop.

   2. Añade el modificador <suspends> para que esta función se pueda ejecutar de forma asíncrona. Como esta es la versión de la clase base de esta función y no se utilizará, simplemente vuelve mediante return inmediatamente.

      Tu función Move() completa debería tener este aspecto:

      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. Si quieres que el elemento se restablezca al finalizar su movimiento, tendrás que teletransportarlo a su posición inicial. Para controlarlo, añade un nuevo método Reset() a la definición de tu clase movable_prop:

   1. Añade los modificadores <decides><transacts> a esta función para permitir que se revierta en caso de que falle el restablecimiento. Esto podría ocurrir si el elemento se elimina durante el juego.

   2. Dentro de Reset(), teletransporta RootProp de vuelta a su StartingTransform mediante TeleportTo[].

      Tu función Reset() completa debería tener el siguiente aspecto:

      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. Ahora que has definido un montón de funciones, ha llegado el momento de unirlas. Para controlar las diferentes funciones de movimiento, añade un nuevo método, ManageMovement(), a la definición de tu clase movable_prop. Añade el modificador <suspends> para que esta función se pueda ejecutar de forma así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. ManageMovement(), crea una expresión loop que se encarga de gestionar el movimiento. Dentro del bucle, primero añade Sleep() durante MoveStartDelay segundos, y después llama a 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. Una vez que la plataforma finaliza su movimiento, tiene que seguir avanzando, volver a su posición o detenerse en el sitio. Para controlar la detención, en una expresión if, comprueba si se activa MoveOnceAndStop. Si es así, sal del bucle con break. Cuando el movimiento se detiene, Sleep() se activa durante MoveEndDelay segundos. Por último, en otra expresión if, comprueba si ShouldReset se activa y llama a Reset[] en caso de ser así. Tu función ManageMovement() completa debería tener este aspecto:

    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 no existe la función OnBegin() en esta clase, necesitas una forma para que otras clases puedan llamar a ManageMovement() para empezar a mover la plataforma. Añade una nueva función Setup() a la definición de tu clase movable_prop. Dentro de Setup(), primero llama a SetStartingTransform() y después genera una función ManageMovement() para poner en marcha la plataforma. Tu función Setup() completa debería tener este aspecto:

    Verse

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

    Copy full snippet(4 lines long)

Siguiente

Ahora que ya has completado tu clase abstracta, en el siguiente paso descubrirás cómo hacer que se muevan con animaciones.

• 

  2. Cómo mover el elemento con animaciones

  Más información sobre cómo utilizar esta potente herramienta para construir tu propia animación y poner tus elementos en movimiento.

Código completo

A continuación encontrarás el código completo creado en esta sección:

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