Tutorial · Sistemas de jogo

Como colocar animação no Roblox Studio com um script

No Roblox, quem toca uma animação é o Animator do personagem, não a própria animação. Este guia toca uma animação quando o jogador aperta uma tecla, liga e desliga uma dança, deixa uma animação em loop em um NPC e faz um golpe acertar no frame exato de um soco.

Atualizado em 14 de novembro de 20267 min de leituraEscrito por

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 Priority do track como Action, senão as animações de andar e de ficar parado podem cobrir a sua.
  • Carregue animações com Animator:LoadAnimation. O Humanoid:LoadAnimation está obsoleto.
Nesta página
  1. Como funciona
  2. 1. ID da animação
  3. 2. Tocar com uma tecla
  4. 3. Loop liga e desliga
  5. 4. Em um NPC
  6. 5. Eventos de animação
  7. Erros comuns
  8. Com o RoCode
  9. Perguntas frequentes
  10. Fontes e leitura extra

Como as animações tocam no Roblox

Quatro objetos participam. Você só cria um deles à mão: o script faz o resto.

Os objetos que tocam uma animação
ObjetoOnde ficaO que faz
AnimationCriada pelo seu scriptGuarda o AnimationId, o endereço do asset da animação. Sozinha, ela não toca nada.
AnimatorDentro do Humanoid do personagem (a Roblox adiciona)Carrega animações e toca elas nas juntas do rig.
AnimationTrackDevolvido por Animator:LoadAnimation()A cópia que dá para tocar: Play(), Stop(), Looped, Priority, Speed e os eventos.
O asset da animaçãoNa Roblox, publicado pelo Animation EditorOs 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 de animação, da mais baixa para a mais alta
PrioridadeUsada para
CoreA mais baixa. Qualquer outra cobre ela.
IdleFicar parado.
MovementAndar, correr, pular.
ActionEmotes, ataques, tools. A escolha comum para uma animação que você toca por script.
Action2 a Action4Uma 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.

  1. 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á.
  2. 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

  1. No Explorer, abra StarterPlayer, passe o mouse sobre StarterCharacterScripts, clique em + e insira um LocalScript.
  2. Renomeie para EmoteOnKey e cole o código abaixo.
  3. Aperte Play e depois E. O seu personagem acena.
LocalScript em StarterCharacterScripts chamado EmoteOnKey
-- 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 StarterCharacterScripts chamado DanceToggle
-- 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 em o modelo do NPC chamado NpcAnimation
-- 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 StarterCharacterScripts chamado PunchOnClick
-- 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.

Você digita

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.

O RoCode faz
  • 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

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.

Teste o RoCode no seu próprio jogo.

Créditos grátis todo dia, sem cartão. Instale o plugin, descreva o recurso e confira o que aparece no Studio.