Usar animações

Uma vez que você criou uma animação, você precisa usar scripts para incluí-los em sua experiência.Você pode either reproduzir animações manualmente a partir de scripts ou substituir animações padrão para personagens do jogador.

Jogue animações de scripts

Em alguns casos, você precisará reproduzir uma animação diretamente a partir de dentro de um script, como quando um usuário pressiona uma determinada tecla ou pega um item especial.

Humanóides

Para reproduzir uma animação em um modelo que contém um ObjetoHumanoid , como tipicamente personagens jogáveis, siga este padrão básico:

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

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

LocalScript - Reproduza 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 contém um Objeto"Animador"
local humanoid = character:WaitForChild("Humanoid")
local animator = humanoid:WaitForChild("Animator")

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

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

-- Reproduza a trilha de animação
kickAnimationTrack:Play()

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

Não-humanóides

Para reproduzir animações em rigs que não contêm não contenha um Humanoid , você deve criar um AnimationController com um filho Animator .Por exemplo, o seguinte Script (suposto ser um filho direto do rig / plataforma / equipamento) carrega uma animação "expulsar" e a toca.

Script - Reproduza animação personalizada no modelo de personagem
local rig = script.Parent

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

-- Crie um novo "Controlador de Animação" e "Animador"
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)

-- Reproduza a trilha de animação
kickAnimationTrack:Play()

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

Substituir animações padrão

Por padrão, os personagens de jogadores do 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 de recurso da nova animação da seguinte forma:

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

2. Na janela Explorer, adicione um novo Script a Serviço de Script de Servidor .

   1. Passe o mouse sobre Serviço de Script de Servidor e clique no botão ⊕.
   2. Do menu contextual, insira um Script .

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

   Script - Substituir animações de personagens padrão
   local Players = game:GetService("Players")
   
   local function onCharacterAdded(character)
   	-- Obter animador em humanoide
   	local humanoid = character:WaitForChild("Humanoid")
   	local animator = humanoid:WaitForChild("Animator")
   
   	-- Pare todas as faixas de animação
   	for _, playingTrack in animator:GetPlayingAnimationTracks() do
   		playingTrack:Stop(0)
   	end
   
   	local animateScript = character:WaitForChild("Animate")
   	--animateScript.executar.RunAnim.AnimationId = "rbxassetid://"
   	--animateScript.andar.WalkAnim.AnimationId = "rbxassetid://"
   	--animateScript.pular.JumpAnim.AnimationId = "rbxassetid://"
   	--animateScript. inativo.Animação1.AnimaçãoId = "rbxassetid://"
   	--animateScript. inativo.Animação2.AnimaçãoId = "rbxassetid://"
   	--animateScript.queda.FallAnim.AnimationId = "rbxassetid://"
   	--animateScript.nadar.Swim.AnimationId = "rbxassetid://"
   	--animateScript.swimidle.SwimIdle.AnimaçãoId = "rbxassetid://"
   	--animateScript.escalada.ClimbAnim.AnimationId = "rbxassetid://"
   end
   
   local function onPlayerAdded(player)
   	player.CharacterAppearanceLoaded:Connect(onCharacterAdded)
   end
   
   Players.PlayerAdded:Connect(onPlayerAdded)

4. Para cada linha que referencia uma animação de personagem padrão , descomente-a e cole o ID de substituição após .Por exemplo, para alterar a animação de execução padrão para a variante Ninja Run:

   Script - Substituir animações de personagens padrão
   local Players = game:GetService("Players")
   
   local function onCharacterAdded(character)
   	-- Obter animador em humanoide
   	local humanoid = character:WaitForChild("Humanoid")
   	local animator = humanoid:WaitForChild("Animator")
   
   	-- Pare 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.andar.WalkAnim.AnimationId = "rbxassetid://"
   	--animateScript.pular.JumpAnim.AnimationId = "rbxassetid://"
   	--animateScript. inativo.Animação1.AnimaçãoId = "rbxassetid://"
   	--animateScript. inativo.Animação2.AnimaçãoId = "rbxassetid://"
   	--animateScript.queda.FallAnim.AnimationId = "rbxassetid://"
   	--animateScript.nadar.Swim.AnimationId = "rbxassetid://"
   	--animateScript.swimidle.SwimIdle.AnimaçãoId = "rbxassetid://"
   	--animateScript.escalada.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 idle variações no código de amostra para substituir animações padrão.

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

• peso da animação / peso total de todas as animações de estado No seguinte exemplo, idle.Animation1 vai jogar ⅓ do tempo que o personagem está inativo, enquanto idle.Animation2 vai jogar ⅔ do tempo.

Script - Substituir animações de personagens padrão
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 de personagens padrão

A tabela a seguir contém todas as animações padrão de personagens que você pode substituir com animações de catálogo ou suas próprias animações personalizadas>.Observe que Inactivo tem duas variações que você pode pesar para jogar mais ou menos frequentemente.

Animações de 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ê quiser aplicar a animação Pulo de Ninja, use >.Observe que Inactivo tem várias variações.