Usar animações

Uma vez que você tenha criado uma animação, você precisa usar scripts para incluí-las em seu jogo. Você pode tocar animações manualmente a partir de scripts ou substituir animações padrão para personagens dos jogadores.

Tocar animações a partir de scripts

Em alguns casos, você precisará tocar uma animação diretamente de dentro de um script, como quando um usuário pressiona uma tecla específica ou pega um item especial.

Humanoides

Para tocar uma animação em um rig contendo um objeto Humanoid, como personagens jogáveis típicos, siga este padrão básico:

1. Certifique-se de que o Humanoid do jogador local contenha um objeto Animator.
2. Crie uma nova instância de Animation com o AnimationId adequado.
3. Carregue a animação via Animator:LoadAnimation() para criar uma AnimationTrack.
4. Toque a faixa com AnimationTrack:Play().

Por exemplo, o seguinte LocalScript, quando colocado em StarterPlayerScripts, carrega uma animação de "chute" no personagem do jogador e a toca. O script também utiliza o método GetMarkerReachedSignal() para detectar quando um evento de animação específico ocorre.

LocalScript - Tocar Animação Personalizada no Personagem do Jogador
local Players = game:GetService("Players")

local player = Players.LocalPlayer
local character = player.Character or player.CharacterAdded:Wait()

-- Certifique-se de que o humanoide do personagem contenha um objeto "Animator"
local humanoid = character:WaitForChild("Humanoid")
local animator = humanoid:WaitForChild("Animator")

-- Crie uma nova instância de "Animation" e atribua um ID de ativo de animação
local kickAnimation = Instance.new("Animation")
kickAnimation.AnimationId = "rbxassetid://2515090838"

-- Carregue a animação no animador
local kickAnimationTrack = animator:LoadAnimation(kickAnimation)

-- Se um evento nomeado foi definido para a animação, conecte-o a "GetMarkerReachedSignal()"
kickAnimationTrack:GetMarkerReachedSignal("KickEnd"):Connect(function(paramString)
	print(paramString)
end)

task.wait(4)

-- Tocar a faixa de animação
kickAnimationTrack:Play()

Não-humanóides

Para tocar animações em rigs que não contêm um Humanoid, você deve criar um AnimationController com um Animator filho. Por exemplo, o seguinte Script (assumido como um filho direto do rig) carrega uma animação de "chute" e a toca.

Script - Tocar Animação Personalizada no Rig do Personagem
local rig = script.Parent

-- Crie uma nova instância de "Animation" e atribua um ID de ativo de animação
local kickAnimation = Instance.new("Animation")
kickAnimation.AnimationId = "rbxassetid://2515090838"

-- Crie um novo "AnimationController" e "Animator"
local animationController = Instance.new("AnimationController")
animationController.Parent = rig

local animator = Instance.new("Animator")
animator.Parent = animationController

-- Carregue a animação no animador
local kickAnimationTrack = animator:LoadAnimation(kickAnimation)

-- Se um evento nomeado foi definido para a animação, conecte-o a "GetMarkerReachedSignal()"
kickAnimationTrack:GetMarkerReachedSignal("KickEnd"):Connect(function(paramString)
	print(paramString)
end)

task.wait(4)

-- Tocar a faixa de animação
kickAnimationTrack:Play()

Substituir animações padrão

Por padrão, os personagens dos jogadores no Roblox incluem animações comuns como correr, escalar, nadar e pular. Você pode substituir essas animações padrão por animações do catálogo ou por suas próprias animações personalizadas.

1. Obtenha o ID do ativo da nova animação da seguinte forma:

   • Para uma animação personalizada criada com o Animation Editor, siga as instruções de exportação.
   • Copie um ID apropriado da referência de animação do catálogo abaixo. Por exemplo, para substituir a animação de correr padrão pela variante Ninja Run, use 656118852.

2. Na janela do Explorer, adicione um novo Script ao ServerScriptService.

   1. Passe o mouse sobre ServerScriptService e clique no botão ⊕.
   2. No menu contextual, insira um Script.

3. No novo script, cole o seguinte código:

   Script - Substituir Animações Padrão do Personagem
   local Players = game:GetService("Players")
   
   local function onCharacterAdded(character)
   	-- Obter animador no humanoide
   	local humanoid = character:WaitForChild("Humanoid")
   	local animator = humanoid:WaitForChild("Animator")
   
   	-- Parar todas as faixas de animação
   	for _, playingTrack in animator:GetPlayingAnimationTracks() do
   		playingTrack:Stop(0)
   	end
   
   	local animateScript = character:WaitForChild("Animate")
   	--animateScript.run.RunAnim.AnimationId = "rbxassetid://"
   	--animateScript.walk.WalkAnim.AnimationId = "rbxassetid://"
   	--animateScript.jump.JumpAnim.AnimationId = "rbxassetid://"
   	--animateScript.idle.Animation1.AnimationId = "rbxassetid://"
   	--animateScript.idle.Animation2.AnimationId = "rbxassetid://"
   	--animateScript.fall.FallAnim.AnimationId = "rbxassetid://"
   	--animateScript.swim.Swim.AnimationId = "rbxassetid://"
   	--animateScript.swimidle.SwimIdle.AnimationId = "rbxassetid://"
   	--animateScript.climb.ClimbAnim.AnimationId = "rbxassetid://"
   end
   
   local function onPlayerAdded(player)
   	player.CharacterAppearanceLoaded:Connect(onCharacterAdded)
   end
   
   Players.PlayerAdded:Connect(onPlayerAdded)

4. Para cada linha que faz referência a uma animação de personagem padrão, descomente-a e cole o ID de substituição após rbxassetid://. Por exemplo, para mudar a animação de correr padrão para a variante Ninja Run:

   Script - Substituir Animações Padrão do Personagem
   local Players = game:GetService("Players")
   
   local function onCharacterAdded(character)
   	-- Obter animador no humanoide
   	local humanoid = character:WaitForChild("Humanoid")
   	local animator = humanoid:WaitForChild("Animator")
   
   	-- Parar todas as faixas de animação
   	for _, playingTrack in animator:GetPlayingAnimationTracks() do
   		playingTrack:Stop(0)
   	end
   
   	local animateScript = character:WaitForChild("Animate")
   	animateScript.run.RunAnim.AnimationId = "rbxassetid://656118852"
   	--animateScript.walk.WalkAnim.AnimationId = "rbxassetid://"
   	--animateScript.jump.JumpAnim.AnimationId = "rbxassetid://"
   	--animateScript.idle.Animation1.AnimationId = "rbxassetid://"
   	--animateScript.idle.Animation2.AnimationId = "rbxassetid://"
   	--animateScript.fall.FallAnim.AnimationId = "rbxassetid://"
   	--animateScript.swim.Swim.AnimationId = "rbxassetid://"
   	--animateScript.swimidle.SwimIdle.AnimationId = "rbxassetid://"
   	--animateScript.climb.ClimbAnim.AnimationId = "rbxassetid://"
   end
   
   local function onPlayerAdded(player)
   	player.CharacterAppearanceLoaded:Connect(onCharacterAdded)
   end
   
   Players.PlayerAdded:Connect(onPlayerAdded)

Definir pesos de animação

Você pode usar várias animações para a mesma ação. Por exemplo, existem duas variações de idle no exemplo de código para substituir animações padrão.

Quando várias animações existem para um estado do personagem, o script Animate escolhe aleatoriamente qual tocar, mas você pode influenciar o resultado definindo o valor de Weight da animação sob a seguinte fórmula:

• peso da animação / peso total de todas as animações de estado

No exemplo a seguir, idle.Animation1 será tocada ⅓ do tempo que o personagem estiver parado, enquanto idle.Animation2 será tocada ⅔ do tempo.

Script - Substituir Animações Padrão do Personagem
animateScript.idle.Animation1.AnimationId = "rbxassetid://656117400"
	animateScript.idle.Animation2.AnimationId = "rbxassetid://656118341"
	animateScript.idle.Animation1.Weight.Value = 5
	animateScript.idle.Animation2.Weight.Value = 10

Referências de animação

Animações padrão do personagem

A tabela a seguir contém todas as animações padrão do personagem que você pode substituir por animações do catálogo ou por suas próprias animações personalizadas. Note que Idle tem duas variações que você pode pesar para tocar com mais ou menos frequência.

Animações do catálogo

Ao usar pacotes de animação de avatar para substituir animações padrão, use as seguintes referências para os respectivos IDs de ativos. Por exemplo, se você deseja aplicar a animação Ninja Jump, use 656117878. Note que Idle tem várias variações.