3. Adereços de translação

Alguns dos obstáculos mais fáceis se movem apenas para frente e para trás. Você geralmente os encontrará em desafios de plataforma, nos quais você precisa sincronizar seus saltos e fazer movimentos precisos para evitar cair.

Mover uma plataforma dessa maneira é chamado de translação, ou alteração da posição do transformar de um objeto. Neste seção, você aprenderá a criar plataformas que não só se movem para frente e para trás, como também se movem para vários pontos no mundo e, depois disso, usará elas para criar seu primeiro obstáculo!

Como criar adereços que transladam

Siga os passos abaixo para criar o código que translada suas plataformas:

1. Crie uma nova classe Verse chamada translating_prop que herda de movable_prop usando o Explorador do Verse. Adicione o especificador <concrete> a essa classe para expor suas propriedades ao 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. Adicione as declarações using { /Fortnite.com/Devices/CreativeAnimation } e using { /UnrealEngine.com/Temporary/SpatialMath } à parte superior do arquivo para importar esses módulos. Você precisará delas para animar seu adereço. Todas as dicas usadas nesta seção estão inclusas abaixo.

   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. No topo da definição da classe translating_prop, adicione os seguintes campos:

   1. Uma matriz editável de creative_prop chamada MoveTargets. Estes são os adereços de Modo Criativo para os quais seu RootProp se moverá durante o jogo. A utilização de outro adereço ao invés de um transformar como o alvo do movimento facilita a visualização de onde seus adereços estão indo. Você os tornará invisíveis durante o jogo no editor mais tarde.

      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. Uma variável vector3 editável opcional chamada MovePosition. Se você não atribuir um adereço MoveTarget, seu adereço raiz usará isso para saber para onde se mover.

      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. Uma variável vector3 chamada TargetPosition. Esta é a posição para a qual seu adereço de fato se moverá e será definida como a posição-alvo do movimento ou MovePosition.

      Verse

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

      Copy full snippet(3 lines long)

   4. Sua definição de classe deve ficar assim:

      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. Como você já configurou a função Move() que move seu adereço em movable_prop, pode substituí-la nessa classe. Substitua a função Move() na 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. Em Move(), em uma expressão if, verifique se MovePosition está definida e armazenada como um valor NewPosition. Caso esteja, defina TargetPosition como 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. Sua função MoveToEase() precisa de um animation_mode a ser passado para ela. Sua animação é reproduzida uma vez toda vez que Move() é chamada, e animation_mode controla o que acontece quando sua animação termina. Chame MoveToEase() para passar TargetPosition, MoveDuration, MoveEaseType e animation_mode.OneShot. Usar esse modo de animação significa que sua animação será interrompida assim que o seu objeto chega ao alvo. Esta é a função MoveToEase() sobrecarregada que você configurou anteriormente e que não usa uma rotação ou escala.

   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)

   Embora o modo de animação one-shot seja útil se você quiser restaurar seu objeto ou mantê-lo em movimento, e se você quiser reproduzi-lo ao contrário? Nesse caso, você pode usar o modo de animação PingPong. Isso reproduzirá sua animação primeiro no sentido normal e depois no sentido inverso, movendo seu adereço de volta até onde começou. Há também o modo de animação Loop, que faz um loop da sua animação, mas necessita que ela termine no mesmo local que começou. Escolha o modo de animação certo que seja adequado para a sua experiência.

7. Ao configurar seus adereços, se você não tiver definido MovePosition no editor, precisará definir um ou mais MoveTargets para os quais seu adereço raiz se moverá. Para lidar com MoveTargets em uma expressão for, itere por cada alvo em MoveTargets. Verifique se MoveTarget está definido chamando IsValid[]. Caso esteja, defina TargetPosition como a translação de 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. Por fim, chame MoveToEase(), novamente com animation_mode.OneShot como modo de animação. Ao fazer isso em uma expressão for, você moverá seu adereço para cada um dos alvos em sequência, restaurando ao final ou continuando com base nos parâmetros definidos por você. A função completa Move() deve ficar assim:

   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)

Como criar o dispositivo Verse

Agora que o seu código Verse está completo, você precisa de uma forma de chamá-lo dentro do nível. Você usará outro dispositivo Verse para coordenar seus adereços e configurar todos eles quando o jogo iniciar. Siga os passos abaixo para coordenar seus obstáculos e mover suas plataformas!

1. Crie um novo dispositivo Verse chamado prop_animator usando o Explorador do Verse. Este é o dispositivo que coordenará a movimentação dos seus adereços.

2. Em prop_animator, adicione uma matriz editável de translating_prop chamada TranslatingProps. Em seguida, em OnBegin(), utilizando uma expressão for, chame Setup() em cada adereço. Seu arquivo prop_animator completo deve ficar assim:

   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. Salve o código e compile-o.

4. Arraste seu dispositivo prop_animator para dentro do nível.

Como vincular adereços a dispositivos

De volta ao editor, exclua alguns dos adereços próximos ao início para criar um espaço vazio. Adicione dois adereços FG01 Plataforma de flutuação M ao seu nível. Como estas são as plataformas que você animará, chame-as de TranslatingPlatform. Em seguida, adicione vários adereços FG01 Bulbo de botão, que serão os alvos para os quais cada plataforma se moverá. Chame esses PlatformTarget. Coloque as plataformas sobre o espaço vazio e certifique-se de colocar os alvos onde quer que as plataformas cheguem. Você pode especificar vários alvos para cada plataforma.

Configuração de adereços de translação. Cada plataforma se move para frente e para trás entre dois alvos, conforme indicado pelas setas.

Arraste seu dispositivo prop_animator para dentro do nível e selecione-o. No Organizador, adicione um elemento de matriz em TranslatingProps para cada plataforma. Atribua cada adereço com os seguintes valores:

Clique em Inicializar sessão e veja suas plataformas animadas! Experimente variar MoveDuration, MoveEaseType e os atrasos de início e fim para criar cenários distintos.

Com isso, finalizamos a translação. Na próxima seção, você criará adereços que giram em diferentes direções!

A seguir

• 

  4. Como girar adereços

  Aprenda a girar obstáculos em sua pista do Fall Guys.

Código completo

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

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.