3. Déplacer des accessoires

Certains des obstacles les plus faciles à franchir se déplacent simplement d'avant en arrière. Vous rencontrerez souvent ces obstacles dans les défis de plateforme, où vous devez synchroniser vos sauts et faire attention à vos mouvements sous peine de tomber.

Le déplacement d'une plateforme de cette manière est appelé translation ou changement de position de la transformation d'un objet. Dans cette section, vous apprendrez à créer des plateformes qui non seulement se déplacent d'avant en arrière, mais qui peuvent aussi se déplacer vers plusieurs points dans le monde, puis à les utiliser pour créer votre premier obstacle !

Créer des accessoires qui se déplacent

Procédez comme suit pour créer le code qui déplace vos plateformes :

1. Créez une nouvelle classe Verse nommée translating_prop qui hérite de movable_prop à l'aide de l'explorateur Verse. Ajoutez le spécificateur <concrete> à cette classe pour exposer ses propriétés à l'UEFN.

   Verse

        # A prop that moves (translates) toward either a Creative prop target
        # or a position in world space.
        translating_prop<public> := class<concrete>(movable_prop):

   Copy full snippet(3 lines long)

2. Ajoutez les instructions using { /Fortnite.com/Devices/CreativeAnimation } et using { /UnrealEngine.com/Temporary/SpatialMath } en haut du fichier pour importer ces modules. Vous en aurez besoin pour animer votre accessoire. Les infobulles utilisées dans cette section sont également répertoriées ici.

   Verse

        using { /Fortnite.com/Devices }
        using { /Fortnite.com/Devices/CreativeAnimation }
        using { /Verse.org/Simulation }
        using { /UnrealEngine.com/Temporary/SpatialMath }
   
        MovePositionTip<localizes>:message = "The optional position to move to World Space. Use this if you do not want to set a MoveTarget."
   
        # A prop that moves (translates) toward either a Creative prop target
        # or a position in world space.
        translating_prop<public> := class<concrete>(movable_prop):

   Copy full snippet(10 lines long)

3. Ajoutez les champs suivants au sommet de la définition de la classe translating_prop :

   1. Une matrice modifiable de creative_prop nommée MoveTargets. Il s'agit des accessoires en mode Créatif vers lesquels votre RootProp se déplacera pendant le jeu. En utilisant un autre accessoire plutôt qu'une transformation comme cible à atteindre, il est plus facile de visualiser la direction prise par vos accessoires. Plus tard, vous les rendrez invisibles pendant le jeu dans l'éditeur.

      Verse

                              # The Creative prop targets for the RootProp to move toward.
                              @editable {ToolTip := MoveTargetsTip}
                              var MoveTargets:[]creative_prop = array{}
      								        
      

      Copy full snippet(4 lines long)

   2. Une variable facultative vector3 modifiable nommée MovePosition. Si vous n'assignez pas d'accessoire MoveTarget, votre accessoire racine l'utilise pour savoir où se déplacer.

      Verse

                               # The position for the RootProp to move toward. Use this if you
                               # do not want to set a MoveTarget.
                               @editable {ToolTip := MovePositionTip}
                               var MovePosition:?vector3 = false
      								        
      

      Copy full snippet(5 lines long)

   3. Une variable vector3 nommée TargetPosition. Il s'agit de la position vers laquelle l'accessoire va effectivement se déplacer ; celle-ci sera configurée soit sur la position de la cible du déplacement, soit en fonction de la variable MovePosition.

      Verse

                               # The position the prop is currently targeting.
                               var TargetPosition:vector3 = vector3{}
      								        
      

      Copy full snippet(3 lines long)

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

      Verse

       # A prop that moves (translates) toward either a Creative prop target
       # or a position in world space.
       translating_prop<public> := class<concrete>(movable_prop):
      
           # The Creative prop targets for the RootProp to move toward.
           @editable {ToolTip := MoveTargetsTip}
           var MoveTargets:[]creative_prop = array{}
      
           # The optional position for the RootProp to move toward. Use this if you
           # do not want to set a MoveTarget.
      
      Expand code Copy full snippet(15 lines long)

4. Dans la mesure où vous avez déjà configuré la fonction Move() qui déplace votre accessoire dans movable_prop, vous pouvez la remplacer dans cette classe. Remplacez la fonction Move() dans votre classe translating_prop.

   Verse

        # Translate toward the MovePosition, or MoveTarget if one is set.
        Move<override>()<suspends>:void=

   Copy full snippet(2 lines long)

5. Dans Move(), dans une expression if, vérifiez si la variable MovePosition est définie et stockée dans la valeur NewPosition. Si c'est le cas, définissez TargetPosition sur NewPosition.

   Verse

        # Translate the RootProp toward the MoveTarget, or MovePosition if one is set.
        Move<override>()<suspends>:void=
            # Set the TargetPosition to the MovePosition if it is set.
            if:
                NewPosition := MovePosition?
            then:
                set TargetPosition = NewPosition

   Copy full snippet(7 lines long)

6. Votre fonction MoveToEase() doit disposer d'un animation_mode auquel elle sera transmise. Votre animation est lue une fois chaque fois que la fonction Move() est appelée, et le animation_mode contrôle ce qui se passe à la fin de votre animation. Appelez MoveToEase() pour transmettre les valeurs TargetPosition, MoveDuration et MoveEaseType, ainsi que animation_mode.OneShot. L'utilisation de ce mode d'animation signifie que votre animation s'arrêtera une fois que votre objet aura atteint sa cible. Il s'agit de la fonction surchargée MoveToEase() que vous avez configurée précédemment et qui ne prend pas en charge la rotation ou le changement d'échelle.

   Verse

        # Set the TargetPosition to the MovePosition if it is set.
        if:
            NewPosition := MovePosition?
        then:
            set TargetPosition = NewPosition
   		            
            # Call MoveToEase to start moving the prop. The OneShot animation mode will play the animation once.
            RootProp.MoveToEase(TargetPosition, MoveDuration, MoveEaseType, animation_mode.OneShot)
   

   Copy full snippet(8 lines long)

   Le mode d'animation OneShot est utile si l'on souhaite réinitialiser l'objet ou le maintenir en mouvement, mais qu'en est-il l'on souhaite le jouer en sens inverse ? Dans ce cas, vous pouvez utiliser le mode d'animation PingPong. L'animation sera jouée, puis jouée en sens inverse pour ramener l'accessoire à son point de départ. Il existe aussi le mode d'animation Loop, qui joue en boucle votre animation, mais qui exige que cette animation se termine à l'emplacement où elle a commencé. Choisissez le mode d'animation correspondant aux besoins de votre expérience.

7. Lorsque vous configurez vos accessoires, si vous n'avez pas défini MovePosition dans l'éditeur, vous devez définir une ou plusieurs MoveTargets vers lesquelles votre accessoire racine se déplacera. Pour gérer les MoveTargets dans une expression for, itérez à chaque cible dans MoveTargets. Vérifiez si MoveTarget est définie en appelant IsValid[]. Si tel est le cas, définissez la position cible TargetPosition sur le déplacement de la MoveTarget.

   Verse

        # Set the TargetPosition to the MovePosition if it is set.
        if:
            NewPosition := MovePosition?
        then:
            set TargetPosition = NewPosition
        else:
            for:
                MoveTarget:MoveTargets
            do:
                # Set the TargetPosition to the MoveTarget's position if the
   
   Expand code Copy full snippet(15 lines long)

8. Enfin, appelez MoveToEase(), toujours avec animation_mode.OneShot comme mode d'animation. En procédant de la sorte dans une expression for, vous déplacerez votre accessoire vers chacune des cibles à tour de rôle, en la réinitialisant à la fin ou en poursuivant le déplacement en fonction des paramètres que vous avez définis. Votre fonction `Move()` complète devrait ressembler à ceci :

   Verse

        # Translate the RootProp toward the MoveTarget, or MovePosition if one is set.
        Move<override>()<suspends>:void=
   
            # Set the TargetPosition to the MovePosition if it is set.
            if:
                NewPosition := MovePosition?
            then:
                set TargetPosition = NewPosition
   
                # Call MoveToEase to start moving the prop. The OneShot animation mode will play the animation once.
   
   Expand code Copy full snippet(25 lines long)

Créer l'appareil Verse

Maintenant que votre code Verse est complet, vous avez besoin d'un moyen de l'appeler dans le niveau. Vous utiliserez un autre appareil Verse pour coordonner vos accessoires et les configurer au début de la partie. Procédez comme suit pour coordonner vos obstacles et déplacer vos plateformes !

1. Créez un nouvel appareil Verse nommé prop_animator en utilisant l'explorateur Verse. Il s'agit de l'appareil qui coordonnera le déplacement de vos accessoires.

2. Dans prop_animator, ajoutez une matrice modifiable de translating_prop nommée TranslatingProps. Ensuite, dans OnBegin(), dans une expression for, appelez Setup() sur chaque accessoire. Votre fichier prop_animator complet devrait ressembler à ceci :

   Verse

        using { /Fortnite.com/Devices }
        using { /Verse.org/Simulation }
        using { /UnrealEngine.com/Temporary/Diagnostics }
   
        TranslatingPropsTip<localizes>:message = "The props that translate (move) using animation."
        # Coordinates moving props through animation by calling each moveable_prop's Setup() method.
   
        prop_animator := class(creative_device):
   
            # Array of moveable_props that translate using animation.
   
   Expand code Copy full snippet(20 lines long)

3. Enregistrez votre code et compilez-le.

4. Faites glisser votre appareil prop_animator dans le niveau.

Lier des accessoires aux appareils

De retour dans l'éditeur, supprimez certains des accessoires situés près du début pour créer un vide. Ajoutez deux accessoires FG01 Plaque de lévitation M à votre niveau. Étant donné qu'il s'agit des plateformes que vous allez animer, nommez-les TranslatingPlatform. Ajoutez ensuite plusieurs accessoires FG01 Bouton Ampoule, qui seront les cibles vers lesquelles chaque plateforme se déplacera. Nommez-les PlatformTarget. Placez les plateformes dans le vide créé et assurez-vous de placer les cibles là où vous voulez que les plateformes aillent. Vous pouvez spécifier plusieurs cibles pour chaque plateforme.

Configuration du déplacement d'accessoires. Chaque plateforme se déplace d'avant en arrière entre deux cibles de déplacement, comme indiqué par les flèches.

Faites glisser votre appareil prop_animator dans le niveau et sélectionnez-le. Dans l'organiseur, ajoutez un élément de matrice à TranslatingProps pour chaque plateforme. Assignez à chaque accessoire les valeurs suivantes :

Cliquez sur Lancer la session et voyez vos plateformes s'animer ! Essayez de varier les valeurs MoveDuration et MoveEaseType, ainsi que les délais de début et de fin pour créer différents scénarios.

Maintenant que nous avons discuté de la translation, dans la section suivante, vous allez créer des accessoires qui tournent dans différentes directions !

Suivant

• 

  4. Rotation des accessoires

  Apprenez à faire tourner des obstacles sur votre course Fall Guys.

Code complet

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

translating_prop.verse

using { /Fortnite.com/Devices }
using { /Fortnite.com/Devices/CreativeAnimation }
using { /Verse.org/Simulation }
using { /UnrealEngine.com/Temporary/SpatialMath }

MovePositionTip<localizes>:message = "The optional position to move to World Space. Use this if you do not want to set a MoveTarget."

# A prop that moves (translates) toward either a Creative prop target
# or a position in world space.
translating_prop<public> := class<concrete>(movable_prop):

prop_animator.verse

using { /Fortnite.com/Devices }
using { /Verse.org/Simulation }
using { /UnrealEngine.com/Temporary/Diagnostics }

TranslatingPropsTip<localizes>:message = "The props that translate (move) using animation."

# Coordinates moving props through animation by calling each moveable_prop's Setup() method.
prop_animator := class(creative_device):

    # Array of moveable_props that translate using animation.