Resumo
Coloque um LocalScript em StarterPlayer > StarterCharacterScripts. Nele, ache o Humanoid do personagem e o Animator dele, crie uma Animation com o seu AnimationId, carregue com animator:LoadAnimation(animation) e chame :Play() no track que ele devolve quando o UserInputService.InputBegan avisar que a sua tecla foi apertada. Uma animação que o jogador toca no próprio personagem desse jeito é vista por todo mundo no servidor.
- A animação precisa pertencer a quem é dono do jogo (você ou o seu grupo) ou à Roblox. Uma animação que outra pessoa enviou não toca no seu jogo.
- Defina a
Prioritydo track comoAction, senão as animações de andar e de ficar parado podem cobrir a sua. - Carregue animações com
Animator:LoadAnimation. OHumanoid:LoadAnimationestá obsoleto.
Nesta página
Como as animações tocam no Roblox
Quatro objetos participam. Você só cria um deles à mão: o script faz o resto.
| Objeto | Onde fica | O que faz |
|---|---|---|
Animation | Criada pelo seu script | Guarda o AnimationId, o endereço do asset da animação. Sozinha, ela não toca nada. |
Animator | Dentro do Humanoid do personagem (a Roblox adiciona) | Carrega animações e toca elas nas juntas do rig. |
AnimationTrack | Devolvido por Animator:LoadAnimation() | A cópia que dá para tocar: Play(), Stop(), Looped, Priority, Speed e os eventos. |
| O asset da animação | Na Roblox, publicado pelo Animation Editor | Os keyframes em si. O ID dele é o que vai no AnimationId. |
Carregue cada animação uma vez e guarde o track. Chamar LoadAnimation toda vez que uma tecla é apertada cria um track novo a cada vez, e eles vão se acumulando.
| Prioridade | Usada para |
|---|---|
Core | A mais baixa. Qualquer outra cobre ela. |
Idle | Ficar parado. |
Movement | Andar, correr, pular. |
Action | Emotes, ataques, tools. A escolha comum para uma animação que você toca por script. |
Action2 a Action4 | Uma ação que precisa cobrir outra ação, por exemplo um atordoamento por cima de um ataque. |
Quando dois tracks tocando movem a mesma junta, o de prioridade mais alta ganha naquela junta. Um aceno em Action que só move o braço deixa as pernas continuarem andando por baixo.
Passo 1: Pegue um ID de animação que você pode usar
A Roblox só toca uma animação no seu jogo quando o dono do jogo é dono dela, ou quando ela é da Roblox. Isso elimina a maioria dos IDs copiados da Creator Store ou de um vídeo: eles pertencem a outra pessoa e não carregam. Você tem duas boas fontes.
- Faça a sua. No Studio, abra a aba Avatar e escolha Animation Editor, selecione um rig (o Rig Builder, na mesma aba, insere um), faça as poses na linha do tempo e depois use o menu do editor para Publish to Roblox. Publique na mesma conta ou grupo que é dono do seu jogo. Copie o ID que ele te dá.
- Use as da Roblox. Os emotes padrão do script Animate da Roblox, como o aceno R15 (
507770239) e a dança (507771019), pertencem à Roblox, então tocam em qualquer jogo. Este guia usa esses dois para você testar na hora.
Escreva o ID como "rbxassetid://" seguido do número, por exemplo "rbxassetid://507770239".
Passo 2: Toque uma animação quando uma tecla for apertada
- No Explorer, abra StarterPlayer, passe o mouse sobre StarterCharacterScripts, clique em + e insira um LocalScript.
- Renomeie para
EmoteOnKeye cole o código abaixo. - Aperte Play e depois E. O seu personagem acena.
-- LocalScript em StarterPlayer > StarterCharacterScripts chamado EmoteOnKey.
-- Aperte E para tocar uma animação no seu próprio personagem. Todos no servidor veem.
local UserInputService = game:GetService("UserInputService")
local ANIMATION_ID = "rbxassetid://507770239" -- o aceno R15 da própria Roblox; coloque aqui o ID da sua animação
local KEY = Enum.KeyCode.E
local COOLDOWN_SECONDS = 1
local character = script.Parent :: Model
local humanoid = character:WaitForChild("Humanoid") :: Humanoid
local animator = humanoid:WaitForChild("Animator") :: Animator
local animation = Instance.new("Animation")
animation.AnimationId = ANIMATION_ID
local track = animator:LoadAnimation(animation)
track.Priority = Enum.AnimationPriority.Action -- acima de andar e ficar parado, então as pernas continuam andando e os braços acenam
local lastPlayed = -math.huge
UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
-- gameProcessed é true enquanto o jogador digita no chat ou em uma caixa de texto
if gameProcessed or input.KeyCode ~= KEY then
return
end
if humanoid.Health <= 0 or os.clock() - lastPlayed < COOLDOWN_SECONDS then
return
end
lastPlayed = os.clock()
track:Play(0.1) -- aparece aos poucos em 0.1 segundo
end)
Scripts no StarterCharacterScripts são copiados para o personagem toda vez que ele nasce, então script.Parent é o personagem e o track é carregado de novo depois de cada respawn.
gameProcessed é true quando o Roblox usou o aperto da tecla primeiro, por exemplo enquanto o jogador digita no chat. Conferir isso impede que o emote dispare toda vez que alguém digita a letra E.
Todo mundo vê o aceno, não só você. A Roblox replica animações que um jogador toca no próprio personagem, desde que o Animator tenha sido criado pelo servidor, e o que a Roblox coloca em todo personagem é. Por isso este script nunca precisa de um RemoteEvent.
Passo 3: Ligue e desligue uma animação em loop
Uma dança ou um sentar deve continuar até o jogador parar. Defina Looped como true e toque ou pare o mesmo track a cada aperto da tecla. Esta versão também para a dança quando o jogador começa a andar.
-- LocalScript em StarterPlayer > StarterCharacterScripts chamado DanceToggle.
-- Aperte G para começar uma dança em loop, aperte G de novo (ou ande) para parar.
local UserInputService = game:GetService("UserInputService")
local DANCE_ID = "rbxassetid://507771019" -- a dança R15 da própria Roblox; coloque aqui o ID da sua animação
local KEY = Enum.KeyCode.G
local character = script.Parent :: Model
local humanoid = character:WaitForChild("Humanoid") :: Humanoid
local animator = humanoid:WaitForChild("Animator") :: Animator
local animation = Instance.new("Animation")
animation.AnimationId = DANCE_ID
local track = animator:LoadAnimation(animation)
track.Priority = Enum.AnimationPriority.Action
track.Looped = true
UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
if gameProcessed or input.KeyCode ~= KEY then
return
end
if track.IsPlaying then
track:Stop(0.2)
else
track:Play(0.2)
end
end)
-- Para de dançar quando o jogador começa a andar
humanoid.Running:Connect(function(speed: number)
if speed > 0.5 and track.IsPlaying then
track:Stop(0.2)
end
end)
O número passado para Play e Stop é um tempo de transição em segundos. Uma transição curta mistura a dança na entrada e na saída em vez de pular de uma pose para outra.
Passo 4: Toque uma animação em um NPC
Um NPC não pertence a nenhum jogador, então quem toca as animações dele é o servidor. Coloque um Script (não um LocalScript) dentro do modelo do NPC. Um rig feito com o Rig Builder já tem um Humanoid, uma HumanoidRootPart e um Animator.
-- Script dentro do modelo do NPC chamado NpcAnimation. O NPC precisa de um Humanoid e de uma HumanoidRootPart.
-- Toca uma animação em loop no NPC pelo servidor, então todos os jogadores veem.
local ANIMATION_ID = "rbxassetid://507771019" -- a dança R15 da própria Roblox; coloque aqui o ID da sua animação
local npc = script.Parent :: Model
local humanoid = npc:WaitForChild("Humanoid") :: Humanoid
-- Um NPC feito a partir de um rig normalmente já tem um Animator; cria um se não tiver
local animator = humanoid:FindFirstChildOfClass("Animator")
if not animator then
local newAnimator = Instance.new("Animator")
newAnimator.Parent = humanoid
animator = newAnimator
end
assert(animator, "the NPC has no Animator")
local animation = Instance.new("Animation")
animation.AnimationId = ANIMATION_ID
local track = animator:LoadAnimation(animation)
track.Looped = true
track:Play()
Passo 5: Sincronize algo com um momento da animação
Um soco deve dar dano quando o punho acerta, não quando a tecla é apertada. No Animation Editor, clique com o botão direito na linha do tempo nesse momento e adicione um animation event chamado Hit, depois publique a animação de novo. No código, track:GetMarkerReachedSignal("Hit") dispara naquele frame.
-- LocalScript em StarterPlayer > StarterCharacterScripts chamado PunchOnClick.
-- Toca a sua animação de soco com um clique e avisa o servidor no momento em que o punho acerta,
-- usando um animation event chamado "Hit" que você adiciona no Animation Editor.
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local UserInputService = game:GetService("UserInputService")
local PUNCH_ID = "rbxassetid://0" -- a sua própria animação de soco, com um evento "Hit" no momento do impacto
local COOLDOWN_SECONDS = 0.6
local punchHit = ReplicatedStorage:WaitForChild("PunchHit") :: RemoteEvent
local character = script.Parent :: Model
local humanoid = character:WaitForChild("Humanoid") :: Humanoid
local animator = humanoid:WaitForChild("Animator") :: Animator
local animation = Instance.new("Animation")
animation.AnimationId = PUNCH_ID
local track = animator:LoadAnimation(animation)
track.Priority = Enum.AnimationPriority.Action
track:GetMarkerReachedSignal("Hit"):Connect(function()
punchHit:FireServer() -- o servidor confere a distância e o cooldown antes de dar dano
end)
local lastPunch = -math.huge
UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
if gameProcessed or input.UserInputType ~= Enum.UserInputType.MouseButton1 then
return
end
if os.clock() - lastPunch < COOLDOWN_SECONDS then
return
end
lastPunch = os.clock()
track:Play(0.05)
end)
Este script precisa de um RemoteEvent chamado PunchHit no ReplicatedStorage, e da sua própria animação de soco com um evento Hit no lugar de rbxassetid://0.
O cliente só diz "o meu soco acertou". Um Script de servidor que escuta o PunchHit.OnServerEvent decide se alguém estava perto o bastante e quanto dano dar, com o próprio cooldown, então um jogador que dispara o evento na mão não consegue acertar do outro lado do mapa. O guia de RemoteEvents mostra como conferir um pedido assim no servidor.
Erros comuns e como resolver
Abra a janela Output primeiro (menu Window, depois Output). A maioria dos problemas de animação imprime uma linha lá.
Nada acontece e o Output diz que a animação falhou ao carregar
A animação pertence a outra pessoa, não ao dono do jogo. Publique a sua própria cópia pelo Animation Editor na conta ou no grupo que é dono do jogo, e use esse ID.
A animação toca, mas só os braços se mexem, ou ela parece pela metade
Outro track com prioridade mais alta está movendo as mesmas juntas. Defina a Priority do seu track como Action (ou mais alta), ou publique a animação com essa prioridade pelo Animation Editor.
Nada acontece e não aparece erro
Confira o tipo de rig: uma animação R15 não faz nada em um personagem R6. Confira também se o script é um LocalScript no StarterCharacterScripts; um LocalScript no Workspace não roda.
O NPC não anima
As parts dele estão ancoradas, ou ele não tem um Animator no Humanoid. Ancore só a HumanoidRootPart; o script do Passo 4 cria um Animator se estiver faltando.
Os outros jogadores não veem a minha animação
A animação foi tocada em um personagem que não é do jogador, ou em um Animator criado por um LocalScript. Toque as animações do seu próprio personagem por um LocalScript, e todo o resto (NPCs, outros jogadores) por um Script de servidor.
Crie com o RoCode
O RoCode é um agente de IA que trabalha dentro do Roblox Studio por meio de um plugin. Você descreve o movimento, e ele escreve os scripts no place que você tem aberto.
Adicione um emote de aceno no E e uma dança que eu possa ligar e desligar com G, e faça o NPC vendedor acenar para os jogadores que chegarem perto dele.
- Escreve os LocalScripts e o Script do NPC e coloca cada um no lugar certo
- Consegue montar movimentos simples, como um aceno, um soco ou uma dança, em código, então não há animação para enviar
- Confere dentro do Studio os scripts que escreveu antes de terminar
Você ainda aperta Play e confere se o movimento ficou do jeito que você quer. Como o RoCode se conecta ao Studio.
Perguntas frequentes
Posso usar qualquer ID de animação que eu achar?
Não. Uma animação só toca em um jogo cujo dono é dono dela, ou quando ela é da Roblox. Use as suas próprias animações, ou as padrão da Roblox.
Animação tocada em LocalScript aparece para os outros jogadores?
Sim, quando o jogador toca no próprio personagem pelo Animator que a Roblox dá ao personagem. Animações em NPCs devem ser tocadas por um Script de servidor.
Como deixar uma animação em loop no Roblox?
Defina track.Looped = true antes de tocar, ou marque Loop no Animation Editor antes de publicar.
Como parar uma animação?
Chame track:Stop() no track que você tocou. Passe um número, como track:Stop(0.2), para ela sumir aos poucos durante essa quantidade de segundos.
Por que usar o Animator em vez de Humanoid:LoadAnimation?
O Humanoid:LoadAnimation está obsoleto. O Animator:LoadAnimation faz o mesmo trabalho e é o que a Roblox documenta.
Fontes e leitura extra
- Roblox Creator Docs: Use animations (em inglês). carregar e tocar animações por script, e quem precisa ser dono
- Roblox Creator Docs: Animator (em inglês). LoadAnimation e replicação
- Roblox Creator Docs: AnimationTrack (em inglês). Play, Stop, Looped, Priority, GetMarkerReachedSignal
- Roblox Creator Docs: Animation Editor (em inglês). criar, publicar e eventos de animação
Como o código foi verificado: todo script desta página passa no verificador de tipos estrito do Luau com as definições da API do Roblox (luau-lsp, 14 de novembro de 2026). A verificação de tipos pega APIs com nome errado e tipos incorretos, não a lógica do jogo, então teste no Studio antes de publicar.