Utilizzare animazioni

Una volta che hai creato un'animazione, devi usare degli script per includerle nel tuo gioco. Puoi riprodurre animazioni manualmente dagli script o sostituire le animazioni predefinite per i personaggi dei giocatori.

Riprodurre animazioni dagli script

In alcuni casi, è necessario riprodurre un'animazione direttamente all'interno di uno script, ad esempio quando un utente preme un tasto specifico o raccoglie un oggetto speciale.

Umani

Per riprodurre un'animazione su un rig contenente un oggetto Humanoid, come i tipici personaggi giocabili, seguire questo schema di base:

1. Assicurati che il Humanoid del giocatore locale contenga un oggetto Animator.
2. Crea una nuova istanza di Animation con il corretto AnimationId.
3. Carica l'animazione tramite Animator:LoadAnimation() per creare un AnimationTrack.
4. Riproduci il brano con AnimationTrack:Play().

Ad esempio, il seguente LocalScript, quando posizionato in StarterPlayerScripts, carica un'animazione "calcio" sul personaggio del giocatore e la riproduce. Lo script utilizza anche il metodo GetMarkerReachedSignal() per rilevare quando si verifica un evento di animazione specifico.

LocalScript - Riproduci Animazione Personalizzata sul Personaggio del Giocatore
local Players = game:GetService("Players")

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

-- Assicurati che il "humanoid" del personaggio contenga un oggetto "Animator"
local humanoid = character:WaitForChild("Humanoid")
local animator = humanoid:WaitForChild("Animator")

-- Crea una nuova istanza di "Animation" e assegna un ID di asset dell'animazione
local kickAnimation = Instance.new("Animation")
kickAnimation.AnimationId = "rbxassetid://2515090838"

-- Carica l'animazione sull'animatore
local kickAnimationTrack = animator:LoadAnimation(kickAnimation)

-- Se è stato definito un evento nominato per l'animazione, collegalo a "GetMarkerReachedSignal()"
kickAnimationTrack:GetMarkerReachedSignal("KickEnd"):Connect(function(paramString)
	print(paramString)
end)

task.wait(4)

-- Riproduci il brano dell'animazione
kickAnimationTrack:Play()

Non-umani

Per riprodurre animazioni su rig che non contengono un Humanoid, devi creare un AnimationController con un Animator figlio. Ad esempio, il seguente Script (presunto essere un figlio diretto del rig) carica un'animazione "calcio" e la riproduce.

Script - Riproduci Animazione Personalizzata sul Rig del Personaggio
local rig = script.Parent

-- Crea una nuova istanza di "Animation" e assegna un ID di asset dell'animazione
local kickAnimation = Instance.new("Animation")
kickAnimation.AnimationId = "rbxassetid://2515090838"

-- Crea un nuovo "AnimationController" e "Animator"
local animationController = Instance.new("AnimationController")
animationController.Parent = rig

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

-- Carica l'animazione sull'animatore
local kickAnimationTrack = animator:LoadAnimation(kickAnimation)

-- Se è stato definito un evento nominato per l'animazione, collegalo a "GetMarkerReachedSignal()"
kickAnimationTrack:GetMarkerReachedSignal("KickEnd"):Connect(function(paramString)
	print(paramString)
end)

task.wait(4)

-- Riproduci il brano dell'animazione
kickAnimationTrack:Play()

Sostituire le animazioni predefinite

Per impostazione predefinita, i personaggi dei giocatori di Roblox includono animazioni comuni come correre, arrampicarsi, nuotare e saltare. Puoi sostituire queste animazioni predefinite con animazioni del catalogo o con le tue animazioni personalizzate.

1. Ottieni l'ID dell'asset della nuova animazione come segue:

   • Per un'animazione personalizzata creata con l'Animation Editor, segui le istruzioni sull'esportazione.
   • Copia un ID appropriato dalla riferimento alle animazioni del catalogo qui sotto. Ad esempio, per sostituire l'animazione di corsa predefinita con la variante Ninja Run, usa 656118852.

2. Nella finestra Esplora, aggiungi un nuovo Script a ServerScriptService.

   1. Passa il mouse su ServerScriptService e fai clic sul pulsante ⊕.
   2. Dal menu contestuale, inserisci uno Script.

3. Nel nuovo script, incolla il seguente codice:

   Script - Sostituire le Animazioni Predefinite del Personaggio
   local Players = game:GetService("Players")
   
   local function onCharacterAdded(character)
   	-- Ottieni l'animatore sul humanoid
   	local humanoid = character:WaitForChild("Humanoid")
   	local animator = humanoid:WaitForChild("Animator")
   
   	-- Ferma tutti i brani delle animazioni
   	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. Per ogni riga che fa riferimento a un'animazione predefinita del personaggio, decommenta e incolla l'ID di sostituzione dopo rbxassetid://. Ad esempio, per cambiare l'animazione di corsa predefinita nella variante Ninja Run:

   Script - Sostituire le Animazioni Predefinite del Personaggio
   local Players = game:GetService("Players")
   
   local function onCharacterAdded(character)
   	-- Ottieni l'animatore sul humanoid
   	local humanoid = character:WaitForChild("Humanoid")
   	local animator = humanoid:WaitForChild("Animator")
   
   	-- Ferma tutti i brani delle animazioni
   	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)

Impostare i pesi delle animazioni

Puoi usare più animazioni per la stessa azione. Ad esempio, ci sono due variazioni di idle nel campione di codice per sostituire le animazioni predefinite.

Quando esistono più animazioni per uno stato del personaggio, lo script Animate sceglie casualmente quale riprodurre, ma puoi influenzare il risultato impostando il valore Weight dell'animazione secondo la seguente formula:

• peso dell'animazione / peso totale di tutte le animazioni statali

Nel seguente esempio, idle.Animation1 verrà riprodotto ⅓ delle volte in cui il personaggio è inattivo, mentre idle.Animation2 verrà riprodotto ⅔ delle volte.

Script - Sostituire le Animazioni Predefinite del Personaggio
animateScript.idle.Animation1.AnimationId = "rbxassetid://656117400"
	animateScript.idle.Animation2.AnimationId = "rbxassetid://656118341"
	animateScript.idle.Animation1.Weight.Value = 5
	animateScript.idle.Animation2.Weight.Value = 10

Riferimenti sulle animazioni

Animazioni predefinite del personaggio

La seguente tabella contiene tutte le animazioni predefinite del personaggio che puoi sostituire con animazioni del catalogo o le tue animazioni personalizzate. Nota che Idle ha due variazioni che puoi pesare per riprodurre più o meno frequentemente.

Animazioni del catalogo

Quando usi pacchetti di animazione avatar per sostituire le animazioni predefinite, usa i seguenti riferimenti per gli ID degli asset rispettivi. Ad esempio, se vuoi applicare l'animazione Ninja Jump, usa 656117878. Nota che Idle ha più variazioni.