Gebruik animaties

Zodra je een animatie hebt gemaakt, moet je scripts gebruiken om ze in je spel op te nemen. Je kunt animaties ofwel handmatig afspelen vanuit scripts of standaardanimaties vervangen voor spelerspersonages.

Animaties afspelen vanuit scripts

In sommige gevallen moet je een animatie rechtstreeks vanuit een script afspelen, bijvoorbeeld wanneer een gebruiker een bepaalde toets indrukt of een speciaal item oppakt.

Humanoïden

Om een animatie af te spelen op een rig die een Humanoid object bevat, zoals typische speelbare personages, volg je dit basispatroon:

1. Zorg ervoor dat de Humanoid van de lokale speler een Animator object bevat.
2. Maak een nieuwe Animation instantie met de juiste AnimationId.
3. Laad de animatie via Animator:LoadAnimation() om een AnimationTrack te creëren.
4. Speel de track af met AnimationTrack:Play().

Bijvoorbeeld, de volgende LocalScript, wanneer geplaatst in StarterPlayerScripts, laadt een "kick" animatie op het personage van de speler en speelt deze af. Het script maakt ook gebruik van de GetMarkerReachedSignal() methode om te detecteren wanneer een specifieke animatie-evenement plaatsvindt.

local Players = game:GetService("Players")

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

-- Zorg ervoor dat het humanoïde van het personage een "Animator" object bevat
local humanoid = character:WaitForChild("Humanoid")
local animator = humanoid:WaitForChild("Animator")

-- Maak een nieuwe "Animation" instantie en wijs een animatie asset ID toe
local kickAnimation = Instance.new("Animation")
kickAnimation.AnimationId = "rbxassetid://2515090838"

-- Laad de animatie op de animator
local kickAnimationTrack = animator:LoadAnimation(kickAnimation)

-- Als er een benoemd evenement is gedefinieerd voor de animatie, verbind het met "GetMarkerReachedSignal()"
kickAnimationTrack:GetMarkerReachedSignal("KickEnd"):Connect(function(paramString)
	print(paramString)
end)

task.wait(4)

-- Speel de animatietrack af
kickAnimationTrack:Play()

Niet-humanoïden

Om animaties af te spelen op rigs die geen Humanoid bevatten, moet je een AnimationController maken met een kind Animator. Bijvoorbeeld, de volgende Script (aangenomen dat het een directe kind van de rig is) laadt een "kick" animatie en speelt deze af.

local rig = script.Parent

-- Maak een nieuwe "Animation" instantie en wijs een animatie asset ID toe
local kickAnimation = Instance.new("Animation")
kickAnimation.AnimationId = "rbxassetid://2515090838"

-- Maak een nieuwe "AnimationController" en "Animator"
local animationController = Instance.new("AnimationController")
animationController.Parent = rig

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

-- Laad de animatie op de animator
local kickAnimationTrack = animator:LoadAnimation(kickAnimation)

-- Als er een benoemd evenement is gedefinieerd voor de animatie, verbind het met "GetMarkerReachedSignal()"
kickAnimationTrack:GetMarkerReachedSignal("KickEnd"):Connect(function(paramString)
	print(paramString)
end)

task.wait(4)

-- Speel de animatietrack af
kickAnimationTrack:Play()

Standaardanimaties vervangen

Standaard bevatten Roblox-spelerspersonages veelvoorkomende animaties zoals rennen, klimmen, zwemmen en springen. Je kunt deze standaardanimaties vervangen door animaties uit de catalogus of door je eigen aangepaste animaties.

1. Verkrijg de asset ID van de nieuwe animatie als volgt:

   • Voor een aangepaste animatie gemaakt met de Animatie-editor, volg de export instructies.
   • Kopieer een geschikte ID uit de catalogus animatie referentie hieronder. Bijvoorbeeld, om de standaard loopanimatie te vervangen door de Ninja Run variant, gebruik 656118852.

2. Voeg in het Explorer venster een nieuwe Script toe aan ServerScriptService.

   1. Beweeg over ServerScriptService en klik op de ⊕ knop.
   2. Kies in het contextmenu een Script.

3. Plak in het nieuwe script de volgende code:

   Script - Vervang Standaard Personage Animaties

   local Players = game:GetService("Players")
   
   local function onCharacterAdded(character)
   	-- Verkrijg animator op humanoïde
   	local humanoid = character:WaitForChild("Humanoid")
   	local animator = humanoid:WaitForChild("Animator")
   
   	-- Stop alle animatietracks
   	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. Voor elke regel die verwijst naar een standaard personage animatie, verwijder de commentaar en plak de vervangings-ID na rbxassetid://. Bijvoorbeeld, om de standaard loopanimatie te veranderen naar de Ninja Run variant:

   Script - Vervang Standaard Personage Animaties

   local Players = game:GetService("Players")
   
   local function onCharacterAdded(character)
   	-- Verkrijg animator op humanoïde
   	local humanoid = character:WaitForChild("Humanoid")
   	local animator = humanoid:WaitForChild("Animator")
   
   	-- Stop alle animatietracks
   	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)

Stel animatiewaarden in

Je kunt meerdere animaties voor dezelfde actie gebruiken. Bijvoorbeeld, er zijn twee idle variaties in de codevoorbeeld voor het vervangen van standaardanimaties.

Wanneer meerdere animaties bestaan voor een karakterstatus, kiest het Animate script willekeurig welke af te spelen, maar je kunt de uitkomst beïnvloeden door de Weight waarde van de animatie in te stellen volgens de volgende formule:

• animatiegewicht / totaal gewicht van alle statusanimaties

In het volgende voorbeeld zal idle.Animation1 ⅓ van de tijd afspelen wanneer het karakter idle is, terwijl idle.Animation2 ⅔ van de tijd zal afspelen.

animateScript.idle.Animation1.AnimationId = "rbxassetid://656117400"
	animateScript.idle.Animation2.AnimationId = "rbxassetid://656118341"
	animateScript.idle.Animation1.Weight.Value = 5
	animateScript.idle.Animation2.Weight.Value = 10

Animatiereferenties

Standaard personage animaties

De volgende tabel bevat alle standaard personage animaties die je kunt vervangen met catalogus animaties of je eigen aangepaste animaties. Let op dat Idle twee variaties heeft die je kunt wegen om vaker of minder vaak af te spelen.

Catalogus animaties

Bij het gebruik van avatar animatiebundels om standaardanimaties te vervangen, gebruik de volgende referenties voor de respectieve asset ID's. Bijvoorbeeld, als je de Ninja Jump animatie wilt toepassen, gebruik dan 656117878. Let op dat Idle meerdere variaties heeft.