1. Créer des accessoires mobiles avec Verse

Configurer le niveau

Pour commencer, initialisez un nouveau projet à partir du modèle d’île de démarrage Fall Guys. Cette île de départ contient un cours prêt à l'emploi que vous pouvez consulter et personnaliser avec les mouvements dans ce tutoriel.

Définir des accessoires qui bougent

Avant de commencer à faire bouger vos accessoires, vous devez définir ce qu'est un accessoire mobile. Vous pouvez utiliser un appareil Verse pour déplacer directement un accessoire, mais cela peut s'avérer délicat si vous souhaitez déplacer plusieurs accessoires à la fois. Au lieu de cela, vous définirez une classe movable_prop abstraite. Elle contient l'accessoire que vous voulez déplacer et plusieurs autres valeurs que vous utiliserez pour personnaliser la logique et la synchronisation de votre mouvement.

Procédez comme suit pour définir votre accessoire mobile :

1. Créez une nouvelle classe Verse nommée movable_prop à l'aide de l'explorateur Verse. Étant donné qu'il s'agit d'une classe Verse et non d'un appareil, créez ce fichier en utilisant l'option Créer un fichier vide. Et puisque cette classe servira de classe abstraite à partir de laquelle vous dériverez différents types d’accessoires mobiles, ajoutez le spécificateur <abstract> à cette classe. Pour apprendre à créer une nouvelle classe dans Verse, consultez la rubrique Modifier et exécuter votre premier programme 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. Ajoutez les chemins d'importation using { /Fortnite.com/Devices }, using { /Verse.org/Simulation } et using { /UnrealEngine.com/Temporary/SpatialMath } en haut de votre fichier. Vous devrez importer ces modules pour gérer les calculs qui font bouger vos accessoires.

3. Chacun des champs de cette classe comprendra également une infobulle. Ajouter un message d’infobulle à un champ modifiable permet d’afficher une infobulle au survol de la souris dans l'UEFN. Toutes les infobulles utilisées dans cette classe sont répertoriées ci-dessous. Vous pouvez copier et coller ces infobulles ou définir les vôtres.

   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. Définissez les champs dont chaque accessoire mobile a besoin. Dans la définition de la classe movable_prop, ajoutez les champs suivants :

   1. Un accessoire creative_prop modifiable nommé RootProp. Il s'agit de l'accessoire en mode Créatif que vous déplacerez au cours du jeu.

      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 modifiable nommé MoveDuration. Il s'agit du temps que met l'accessoire pour atteindre sa destination.

      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 modifiable nommé MoveStartDelay. Il s'agit de la durée d'attente en secondes de l'accessoire avant son déplacement.

      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 modifiable nommé MoveEndDelay. Il s'agit du temps d'attente en secondes de l'accessoire après son déplacement.

      Verse

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

      Copy full snippet(3 lines long)

   5. Une logique modifiable nommée MoveOnceAndStop. Elle permet de déterminer si l'accessoire ne se déplace qu'une seule fois ou s'il répète le mouvement une fois celui-ci terminé.

      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. Une logique modifiable nommée ShouldReset. Cette fonction permet de déterminer si l'accessoire reprend sa position initiale une fois qu'il a fini de se déplacer.

      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. Une variable transform nommée StartingTransform. Il s'agit de la transformation de l’accessoire RootProp lorsqu'il commence à se déplacer.

      Verse

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

      Copy full snippet(2 lines long)

5. La définition finale de votre classe devrait ressembler à ceci :

   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. Avant de se déplacer, votre accessoire doit connaître son point de départ. Pour ce faire, vous allez créer une nouvelle fonction pour définir la StartingTransform (transformation de départ) avant le mouvement :

   1. Ajoutez une nouvelle méthode SetStartingTransform() à la définition de votre classe movable_prop.

   2. Dans SetStartingTransform(), définissez la StartingTransform sur la transformation de RootProp à l'aide de GetTransform().

      Votre fonction SetStartingTransform() complète devrait ressembler à ceci :

      Verse

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

      Copy full snippet(3 lines long)

7. Pour commencer à déplacer votre accessoire, vous allez définir une nouvelle fonction Move() :

   1. Ajoutez une nouvelle méthode Move() à la définition de votre classe movable_prop.

   2. Ajoutez le modificateur <suspends> afin que cette fonction puisse s'exécuter de manière asynchrone. Étant donné qu’il s’agit de la version de base de cette fonction et qu’elle ne sera pas utilisée, effectuez simplement un return immédiat.

      Votre fonction `Move()` complète devrait ressembler à ceci :

      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 vous voulez que votre accessoire se réinitialise lorsqu'il a fini de se déplacer, vous devez le téléporter à sa position de départ. Pour gérer cela, ajoutez une nouvelle méthode Reset() à la définition de votre classe movable_prop :

   1. Ajoutez les modificateurs <decides><transacts> à cette fonction pour lui permettre d’annuler l’opération en cas d'échec de la réinitialisation. Cela peut se produire si votre accessoire a été mis au rebut pendant le jeu.

   2. Dans Reset(), ramenez le RootProp à sa StartingTransform en utilisant TeleportTo[].

      Votre fonction Reset() complète devrait ressembler à ceci :

      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. Vous avez défini de nombreuses fonctions, et il est maintenant temps de les lier toutes ensemble. Pour gérer toutes les différentes fonctions de mouvement, ajoutez une nouvelle méthode ManageMovement() à la définition de votre classe movable_prop. Ajoutez le modificateur <suspends> pour permettre à cette fonction de s’exécuter de manière asynchrone.

   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. Dans ManageMovement(), créez une expression loop qui gère le mouvement. À l’intérieur de la boucle, commencez par exécuter Sleep() pendant MoveStartDelay secondes, puis appelez 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. Lorsque votre plateforme a fini de se déplacer, elle doit continuer à avancer, réinitialiser sa position ou s'arrêter sur place. Pour gérer l'arrêt, dans une expression if, vérifiez si MoveOnceAndStop est activé. Le cas échéant, utilisez break pour sortir de la boucle. Une fois le mouvement terminé, exécutez Sleep() pendant MoveEndDelay secondes. Enfin, dans une autre expression if, vérifiez si ShouldReset est activé et appelez Reset[] si c'est le cas. Votre fonction ManageMovement() complète devrait ressembler à ceci :

    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. Étant donné qu'il n'y a pas de fonction OnBegin() dans cette classe, il vous faut un moyen permettant à d'autres classes d'appeler ManageMovement() pour commencer à déplacer votre plateforme. Ajoutez une nouvelle fonction Setup() à la définition de votre classe movable_prop. Dans Setup(), appelez d'abord SetStartingTransform(), puis créez une fonction ManageMovement() pour faire bouger votre plateforme. Votre fonction Setup() complète devrait ressembler à ceci :

    Verse

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

    Copy full snippet(4 lines long)

Suivant

Votre classe abstraite étant terminée, l'étape suivante consistera à trouver un moyen de la faire bouger grâce à l'animation !

• 

  2. Déplacer des accessoires avec des animations

  Apprenez à utiliser ce puissant outil pour créer vos propres animations et faire bouger vos accessoires !

Code complet

Voici le code complet généré dans cette section :

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