Tutorial · Gamesystemen

Een animatie afspelen in Roblox Studio met een script

Een animatie in Roblox wordt afgespeeld door de Animator van het personage, niet door de animatie zelf. In deze handleiding speel je een animatie af als de speler een toets indrukt, zet je een dans aan en uit, laat je een animatie in een lus lopen op een NPC en deel je een klap uit precies op het frame waarop de vuist raakt.

Bijgewerkt 20 november 20267 min lezenAuteur:

In het kort

Zet een LocalScript in StarterPlayer > StarterCharacterScripts. Zoek daarin de Humanoid van het personage en zijn Animator, maak een Animation met je eigen AnimationId, laad die met animator:LoadAnimation(animation) en roep :Play() aan op de track die je terugkrijgt zodra UserInputService.InputBegan jouw toets meldt. Een animatie die een speler zo op zijn eigen personage afspeelt, is voor iedereen op de server zichtbaar.

  • De animatie moet van de eigenaar van de game zijn (jij of je groep) of van Roblox. Een animatie die iemand anders heeft geüpload, speelt niet af in jouw game.
  • Zet de Priority van de track op Action, anders kunnen de loop- en staanimaties hem overschrijven.
  • Laad animaties met Animator:LoadAnimation. Humanoid:LoadAnimation is verouderd.
Op deze pagina
  1. Hoe het werkt
  2. 1. Animatie-ID
  3. 2. Met een toets
  4. 3. Dans in een lus
  5. 4. Op een NPC
  6. 5. Animatie-events
  7. Common errors
  8. Met RoCode
  9. Veelgestelde vragen
  10. Bronnen en verder lezen

Hoe animaties in Roblox worden afgespeeld

Er doen vier objecten mee. Je maakt er maar één zelf, de rest doet het script.

Objecten die een animatie afspelen
ObjectWaar het zitWat het doet
AnimationGemaakt door je scriptBevat de AnimationId, het adres van de animatie-asset. Speelt zelf niets af.
AnimatorIn de Humanoid van het personage (Roblox voegt hem toe)Laadt animaties en speelt ze af op de gewrichten van de rig.
AnimationTrackTeruggegeven door Animator:LoadAnimation()Een afspeelbare kopie: Play(), Stop(), Looped, Priority, Speed en events.
Animatie-assetOp Roblox, gepubliceerd vanuit de Animation EditorDe keyframes zelf. Het ID daarvan zet je in AnimationId.

Laad elke animatie één keer en bewaar de track. Als je LoadAnimation bij elke toetsaanslag aanroept, ontstaat er elke keer een nieuwe track en stapelen ze zich op.

Animatieprioriteiten, van laag naar hoog
PrioriteitWaarvoor
CoreDe laagste. Al het andere overschrijft hem.
IdleStilstaan.
MovementLopen, rennen, springen.
ActionEmotes, aanvallen, tools. De gebruikelijke keuze voor een animatie die je vanuit een script afspeelt.
Action2 tot Action4Een actie die een andere actie moet overschrijven, zoals een stun bovenop een aanval.

Als twee spelende tracks hetzelfde gewricht bewegen, wint op dat gewricht de track met de hoogste prioriteit. Een zwaai op Action die alleen de arm beweegt, laat de benen gewoon doorlopen.

Stap 1: Zoek een animatie-ID dat je kunt gebruiken

Roblox speelt een animatie in je game alleen af als die van de eigenaar van de game of van Roblox is. Daarom werken de meeste ID's die je uit de Creator Store of uit een video kopieert niet: ze zijn van iemand anders en laden niet. Er zijn twee goede bronnen.

  1. Maak je eigen. Open in Studio het tabblad Avatar en kies Animation Editor, selecteer een rig (Rig Builder op hetzelfde tabblad voegt er een in), zet poses op de tijdlijn en kies dan in het menu van de editor Publish to Roblox. Publiceer naar hetzelfde account of dezelfde groep die eigenaar is van de game. Kopieer het ID dat je krijgt.
  2. Gebruik animaties van Roblox. De standaard-emotes uit het Animate-script van Roblox, zoals de R15-zwaai (507770239) en de dans (507771019), zijn van Roblox en werken dus in elke game. Deze handleiding gebruikt ze, zodat je alles meteen kunt testen.

Schrijf het ID als "rbxassetid://" met het nummer erachter, bijvoorbeeld "rbxassetid://507770239".

Stap 2: Speel een animatie af met een toets

  1. Open in de Explorer StarterPlayer, ga met de muis over StarterCharacterScripts, klik op + en voeg een LocalScript toe.
  2. Hernoem het naar EmoteOnKey en plak de code hieronder.
  3. Klik op Play en druk op E. Je personage zwaait.
LocalScript in StarterCharacterScripts met de naam EmoteOnKey
-- LocalScript in StarterPlayer > StarterCharacterScripts met de naam EmoteOnKey.
-- Druk op E om een animatie op je eigen personage af te spelen. Iedereen op de server ziet hem.
local UserInputService = game:GetService("UserInputService")

local ANIMATION_ID = "rbxassetid://507770239" -- R15-zwaai van Roblox zelf; zet hier het ID van je eigen animatie
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 -- boven lopen en stilstaan, dus de benen lopen door en de armen zwaaien

local lastPlayed = -math.huge

UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
	-- gameProcessed is true zolang de speler in de chat of in een tekstveld typt
	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) -- vloeiend infaden in 0.1 seconde
end)

Scripts in StarterCharacterScripts worden bij elke spawn naar het personage gekopieerd, dus script.Parent is het personage en de track wordt na elke respawn opnieuw geladen.

gameProcessed is true als Roblox de toetsaanslag eerst zelf heeft afgehandeld, bijvoorbeeld terwijl de speler in de chat typt. Die controle voorkomt dat de emote afgaat telkens als iemand de letter E typt.

Iedereen ziet de zwaai, niet alleen jij. Roblox repliceert animaties die een speler op zijn eigen personage afspeelt als de server de Animator heeft gemaakt, en de Animator die Roblox in elk personage zet, is precies zo gemaakt. Daarom heeft dit script geen RemoteEvent nodig.

Stap 3: Zet een animatie in een lus aan en uit

Een dans of zitanimatie moet doorgaan tot de speler hem stopt. Zet Looped op true en start of stop bij elke toetsaanslag dezelfde track. Deze versie stopt de dans ook als de speler begint te lopen.

LocalScript in StarterCharacterScripts met de naam DanceToggle
-- LocalScript in StarterPlayer > StarterCharacterScripts met de naam DanceToggle.
-- Druk op G om een dans in een lus te starten, druk nog eens op G (of loop) om hem te stoppen.
local UserInputService = game:GetService("UserInputService")

local DANCE_ID = "rbxassetid://507771019" -- R15-dans van Roblox zelf; zet hier het ID van je eigen animatie
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)

-- Stop de dans als de speler begint te lopen
humanoid.Running:Connect(function(speed: number)
	if speed > 0.5 and track.IsPlaying then
		track:Stop(0.2)
	end
end)

Het getal dat je aan Play en Stop meegeeft, is de overgangstijd in seconden. Een korte overgang zet de dans vloeiend aan en uit, in plaats van het personage van pose naar pose te laten springen.

Stap 4: Speel een animatie af op een NPC

Een NPC is van geen enkele speler, dus de server speelt zijn animaties af. Zet een Script (geen LocalScript) in het model van de NPC. Een rig die je met Rig Builder hebt gemaakt, heeft al een Humanoid, HumanoidRootPart en Animator.

Script in NPC-model met de naam NpcAnimation
-- Script in het NPC-model met de naam NpcAnimation. De NPC heeft een Humanoid en HumanoidRootPart nodig.
-- Speelt vanaf de server een animatie in een lus af op de NPC, dus elke speler ziet hem.
local ANIMATION_ID = "rbxassetid://507771019" -- R15-dans van Roblox zelf; zet hier het ID van je eigen animatie

local npc = script.Parent :: Model
local humanoid = npc:WaitForChild("Humanoid") :: Humanoid

-- Een NPC uit een rig heeft meestal al een Animator; zo niet, dan maken we er een
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()

Stap 5: Koppel een actie aan een moment in de animatie

Een klap moet schade doen op het moment dat de vuist raakt, niet op het moment dat de toets wordt ingedrukt. Klik in de Animation Editor op dat moment met de rechtermuisknop op de tijdlijn en voeg een animation event toe met de naam Hit, en publiceer de animatie daarna opnieuw. In de code gaat track:GetMarkerReachedSignal("Hit") op dat frame af.

LocalScript in StarterCharacterScripts met de naam PunchOnClick
-- LocalScript in StarterPlayer > StarterCharacterScripts met de naam PunchOnClick.
-- Speelt je klap-animatie af bij een klik en meldt de server het moment waarop de vuist raakt,
-- via het animatie-event "Hit" dat je in de Animation Editor toevoegt.
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local UserInputService = game:GetService("UserInputService")

local PUNCH_ID = "rbxassetid://0" -- je klap-animatie met een event "Hit" op het moment van raken
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() -- de server controleert afstand en cooldown voordat hij schade doet
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)

Dit script heeft een RemoteEvent met de naam PunchHit in ReplicatedStorage nodig, en je eigen klap-animatie met een event Hit in plaats van rbxassetid://0.

De client meldt alleen "mijn klap raakte". Een server-Script dat naar PunchHit.OnServerEvent luistert, beslist of er iemand in de buurt was en hoeveel schade er komt, met een eigen cooldown, zodat een speler die het event met de hand afvuurt niet over de hele map kan slaan. De handleiding over RemoteEvent laat zien hoe je zo'n verzoek op de server controleert.

Veelvoorkomende fouten en oplossingen

Open eerst het venster Output (menu Window, dan Output). De meeste problemen met animaties schrijven daar een regel.

Er gebeurt niets en Output zegt dat de animatie niet geladen is

De animatie is niet van de eigenaar van de game maar van iemand anders. Publiceer je eigen kopie vanuit de Animation Editor naar het account of de groep die eigenaar is van de game, en gebruik dat ID.

De animatie speelt, maar alleen de armen bewegen, of hij ziet er onaf uit

Een andere track met hogere prioriteit beweegt dezelfde gewrichten. Zet de Priority van je track op Action (of hoger) of publiceer de animatie met die prioriteit vanuit de Animation Editor.

Er gebeurt niets en er is geen fout

Controleer het type rig: een R15-animatie doet niets op een R6-personage. Controleer ook of het script een LocalScript in StarterCharacterScripts is; een LocalScript in Workspace draait niet.

De NPC animeert niet

Zijn parts zijn geanchord, of er zit geen Animator in zijn Humanoid. Anchor alleen de HumanoidRootPart; het script uit stap 4 maakt een Animator als die ontbreekt.

Andere spelers zien mijn animatie niet

De animatie is afgespeeld op een personage dat niet van de speler is, of op een Animator die vanuit een LocalScript is gemaakt. Speel animaties van je eigen personage af vanuit een LocalScript, en al het andere (NPC's, andere spelers) vanuit een server-Script.

Bouwen met RoCode

RoCode is een AI-agent die via een plugin in Roblox Studio werkt. Jij beschrijft de beweging en hij schrijft de scripts in de place die je open hebt.

Jij typt

Voeg een zwaai-emote toe op E en een dans die ik met G aan en uit kan zetten, en laat een verkoper-NPC zwaaien naar spelers die naar hem toe lopen.

RoCode doet
  • Schrijft de LocalScripts en het Script voor de NPC en zet ze waar ze horen
  • Kan eenvoudige bewegingen, zoals een zwaai, een klap of een dans, direct in code bouwen, zodat je geen animatie hoeft te uploaden
  • Controleert de scripts die hij schrijft in Studio voordat hij klaar is

Je moet nog steeds zelf op Play klikken en controleren of de beweging eruitziet zoals jij wilt. Hoe RoCode verbinding maakt met Studio.

Veelgestelde vragen

Kan ik elk animatie-ID gebruiken dat ik vind?

Nee. Een animatie speelt alleen af in een game waarvan de eigenaar ook eigenaar is van de animatie, of als Roblox de eigenaar is. Gebruik je eigen animaties of de standaardanimaties van Roblox.

Zien andere spelers een animatie uit een LocalScript?

Ja, als de speler hem op zijn eigen personage afspeelt via de Animator die Roblox het personage geeft. Animaties op NPC's moet je vanuit een server-Script afspelen.

Hoe laat ik een animatie in Roblox in een lus lopen?

Zet track.Looped = true voordat je hem start, of zet Loop aan in de Animation Editor voordat je publiceert.

Hoe stop ik een animatie?

Roep track:Stop() aan op de track die je hebt gestart. Geef een getal mee, zoals track:Stop(0.2), om hem in zoveel seconden vloeiend te laten uitfaden.

Waarom Animator en niet Humanoid:LoadAnimation?

Humanoid:LoadAnimation is verouderd. Animator:LoadAnimation doet hetzelfde, en die beschrijft de documentatie van Roblox.

Bronnen en verder lezen

Hoe de code is gecontroleerd: elk script op deze pagina doorloopt een strikte Luau-typecontrole met de Roblox API-definities (luau-lsp, 20 november 2026). De typecontrole vangt fouten in API-namen en verkeerde types op, maar geen fouten in de gamelogica, dus test alles in Studio voordat je publiceert.

Probeer RoCode in je eigen game.

Elke dag gratis credits, geen creditcard nodig. Installeer de plugin, beschrijf een functie en kijk wat er in Studio verschijnt.