Tutorial · Sistemi di gioco

Come riprodurre un'animazione in Roblox Studio con uno script

In Roblox un'animazione la riproduce l'Animator del personaggio, non l'animazione stessa. In questa guida riproduciamo un'animazione quando il giocatore preme un tasto, attiviamo e disattiviamo un ballo, mettiamo in loop un'animazione su un NPC e infliggiamo un colpo esattamente nel fotogramma in cui il pugno arriva sul bersaglio.

Aggiornato il 20 novembre 20266 min di letturaScritto da

In breve

Metti un LocalScript in StarterPlayer > StarterCharacterScripts. Al suo interno trova lo Humanoid del personaggio e il suo Animator, crea un Animation con il tuo AnimationId, caricalo con animator:LoadAnimation(animation) e chiama :Play() sulla traccia ottenuta quando UserInputService.InputBegan segnala il tuo tasto. Un'animazione che il giocatore riproduce così sul proprio personaggio la vedono tutti sul server.

  • L'animazione deve appartenere al proprietario del gioco (tu o il tuo gruppo) o a Roblox. Un'animazione caricata da qualcun altro nel tuo gioco non parte.
  • Imposta la Priority della traccia su Action, altrimenti le animazioni di camminata e di riposo possono coprirla.
  • Carica le animazioni con Animator:LoadAnimation. Humanoid:LoadAnimation è deprecato.
In questa pagina
  1. Come funziona
  2. 1. ID dell'animazione
  3. 2. Con un tasto
  4. 3. Ballo in loop
  5. 4. Su un NPC
  6. 5. Eventi dell'animazione
  7. Common errors
  8. Con RoCode
  9. Domande frequenti
  10. Fonti e letture

Come vengono riprodotte le animazioni in Roblox

Entrano in gioco quattro oggetti. A mano ne crei solo uno, il resto lo fa lo script.

Gli oggetti che riproducono un'animazione
OggettoDove si trovaCosa fa
AnimationLo crea il tuo scriptContiene l'AnimationId, l'indirizzo dell'asset dell'animazione. Da solo non riproduce nulla.
AnimatorDentro lo Humanoid del personaggio (lo aggiunge Roblox)Carica le animazioni e le riproduce sulle articolazioni del rig.
AnimationTrackRestituito da Animator:LoadAnimation()Una copia riproducibile: Play(), Stop(), Looped, Priority, Speed ed eventi.
Asset dell'animazioneSu Roblox, pubblicato dall'Animation EditorI fotogrammi chiave veri e propri. Il suo ID è quello che scrivi in AnimationId.

Carica ogni animazione una sola volta e conserva la traccia. Se chiami LoadAnimation a ogni pressione del tasto, ogni volta viene creata una nuova traccia e si accumulano.

Priorità delle animazioni, dalla più bassa alla più alta
PrioritàA cosa serve
CoreLa più bassa. Tutto il resto la copre.
IdleStare fermi.
MovementCamminare, correre, saltare.
ActionEmote, attacchi, strumenti. La scelta normale per un'animazione che riproduci da uno script.
Da Action2 a Action4Un'azione che deve coprire un'altra azione, per esempio uno stordimento sopra un attacco.

Quando due tracce in riproduzione muovono la stessa articolazione, su quell'articolazione vince la traccia con la priorità più alta. Un saluto con la mano su Action che muove solo il braccio lascia alle gambe la possibilità di continuare a camminare.

Passo 1: Trova un ID di animazione che puoi usare

Roblox riproduce un'animazione nel tuo gioco solo se appartiene al proprietario del gioco o a Roblox. Per questo la maggior parte degli ID copiati dal Creator Store o da un video non funziona: appartengono a qualcun altro e non si caricano. Ci sono due buone fonti.

  1. Creane una tua. In Studio apri la scheda Avatar e scegli Animation Editor, seleziona un rig (Rig Builder nella stessa scheda ne inserisce uno), disponi le pose sulla timeline, poi nel menu dell'editor scegli Publish to Roblox. Pubblica sullo stesso account o sullo stesso gruppo a cui appartiene il gioco. Copia l'ID che ottieni.
  2. Usa le animazioni di Roblox. Le emote standard dello script Animate di Roblox, come il saluto R15 (507770239) e il ballo (507771019), appartengono a Roblox, quindi funzionano in qualsiasi gioco. Questa guida usa queste, così puoi provare tutto subito.

Scrivi l'ID come "rbxassetid://" seguito dal numero, per esempio "rbxassetid://507770239".

Passo 2: Riproduci un'animazione alla pressione di un tasto

  1. Nell'Explorer apri StarterPlayer, passa il mouse su StarterCharacterScripts, clicca su + e inserisci un LocalScript.
  2. Rinominalo EmoteOnKey e incolla il codice qui sotto.
  3. Premi Play e poi E. Il tuo personaggio saluterà con la mano.
LocalScript in StarterCharacterScripts chiamato EmoteOnKey
-- LocalScript in StarterPlayer > StarterCharacterScripts chiamato EmoteOnKey.
-- Premi E per riprodurre un'animazione sul tuo personaggio. La vedono tutti sul server.
local UserInputService = game:GetService("UserInputService")

local ANIMATION_ID = "rbxassetid://507770239" -- saluto R15 di Roblox stesso; incolla qui l'ID della tua animazione
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 -- sopra camminata e riposo, così le gambe continuano a camminare e le braccia salutano

local lastPlayed = -math.huge

UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
	-- gameProcessed è true mentre il giocatore scrive in chat o in una casella di testo
	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) -- comparsa graduale in 0.1 secondi
end)

Gli script in StarterCharacterScripts vengono copiati nel personaggio ogni volta che appare, quindi script.Parent è il personaggio e la traccia viene ricaricata dopo ogni respawn.

gameProcessed è true quando la pressione del tasto l'ha gestita prima Roblox, per esempio mentre il giocatore scrive in chat. Questo controllo evita che l'emote parta ogni volta che qualcuno digita la lettera E.

Il saluto lo vedono tutti, non solo tu. Roblox replica le animazioni che un giocatore riproduce sul proprio personaggio se l'Animator l'ha creato il server, e quello che Roblox mette in ogni personaggio è creato proprio così. Per questo a questo script non serve un RemoteEvent.

Passo 3: Attiva e disattiva un'animazione in loop

Un ballo o una posa seduta devono continuare finché il giocatore non li ferma. Imposta Looped su true e a ogni pressione del tasto avvia o ferma la stessa traccia. Questa versione ferma anche il ballo quando il giocatore inizia a camminare.

LocalScript in StarterCharacterScripts chiamato DanceToggle
-- LocalScript in StarterPlayer > StarterCharacterScripts chiamato DanceToggle.
-- Premi G per iniziare un ballo in loop, premi di nuovo G (o cammina) per fermarlo.
local UserInputService = game:GetService("UserInputService")

local DANCE_ID = "rbxassetid://507771019" -- ballo R15 di Roblox stesso; incolla qui l'ID della tua animazione
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)

-- Fermiamo il ballo quando il giocatore inizia a camminare
humanoid.Running:Connect(function(speed: number)
	if speed > 0.5 and track.IsPlaying then
		track:Stop(0.2)
	end
end)

Il numero passato a Play e Stop è la durata della transizione in secondi. Una breve transizione fa entrare e uscire il ballo in modo morbido, invece di far scattare il personaggio da una posa all'altra.

Passo 4: Riproduci un'animazione su un NPC

Un NPC non appartiene a nessun giocatore, quindi le sue animazioni le riproduce il server. Metti uno Script (non un LocalScript) dentro il modello dell'NPC. Un rig creato con Rig Builder ha già Humanoid, HumanoidRootPart e Animator.

Script in modello dell'NPC chiamato NpcAnimation
-- Script dentro il modello dell'NPC chiamato NpcAnimation. L'NPC ha bisogno di Humanoid e HumanoidRootPart.
-- Riproduce un'animazione in loop sull'NPC dal server, così la vede ogni giocatore.
local ANIMATION_ID = "rbxassetid://507771019" -- ballo R15 di Roblox stesso; incolla qui l'ID della tua animazione

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

-- Un NPC creato da un rig di solito ha già un Animator; se manca, lo creiamo
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: Collega un'azione a un momento dell'animazione

Un pugno deve infliggere danno quando il pugno arriva sul bersaglio, non quando viene premuto il tasto. Nell'Animation Editor clicca con il tasto destro sulla timeline in quel momento e aggiungi un animation event chiamato Hit, poi pubblica di nuovo l'animazione. Nel codice track:GetMarkerReachedSignal("Hit") scatta in quel fotogramma.

LocalScript in StarterCharacterScripts chiamato PunchOnClick
-- LocalScript in StarterPlayer > StarterCharacterScripts chiamato PunchOnClick.
-- Riproduce la tua animazione del pugno al clic e comunica al server il momento in cui il pugno arriva sul bersaglio,
-- tramite l'evento di animazione "Hit" che aggiungi nell'Animation Editor.
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local UserInputService = game:GetService("UserInputService")

local PUNCH_ID = "rbxassetid://0" -- la tua animazione del pugno con l'evento "Hit" nel momento dell'impatto
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() -- il server controlla distanza e cooldown prima di infliggere danno
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)

Questo script ha bisogno di un RemoteEvent chiamato PunchHit in ReplicatedStorage e della tua animazione del pugno con l'evento Hit al posto di rbxassetid://0.

Il client comunica solo "il mio pugno ha colpito". Uno Script sul server che ascolta PunchHit.OnServerEvent decide se c'era qualcuno vicino e quanto danno infliggere, con un proprio cooldown, così un giocatore che lancia l'evento a mano non può colpire da un capo all'altro della mappa. La guida ai RemoteEvent mostra come verificare una richiesta del genere sul server.

Errori comuni e soluzioni

Per prima cosa apri la finestra Output (menu Window, poi Output). La maggior parte dei problemi con le animazioni scrive lì una riga.

Non succede nulla e l'Output dice che l'animazione non si è caricata

L'animazione non appartiene al proprietario del gioco, ma a qualcun altro. Pubblica una tua copia dall'Animation Editor sull'account o sul gruppo a cui appartiene il gioco e usa quell'ID.

L'animazione parte, ma si muovono solo le braccia, oppure sembra incompleta

Un'altra traccia con priorità più alta muove le stesse articolazioni. Imposta la Priority della tua traccia su Action (o più alta) oppure pubblica l'animazione con quella priorità dall'Animation Editor.

Non succede nulla e non c'è nessun errore

Controlla il tipo di rig: un'animazione R15 non fa nulla su un personaggio R6. Controlla anche che lo script sia un LocalScript in StarterCharacterScripts; un LocalScript in Workspace non viene eseguito.

L'NPC non si anima

Le sue parti sono ancorate, oppure nel suo Humanoid non c'è un Animator. Ancora solo l'HumanoidRootPart; lo script del passo 4 crea l'Animator se manca.

Gli altri giocatori non vedono la mia animazione

L'animazione è stata riprodotta su un personaggio che il giocatore non possiede, oppure su un Animator creato da un LocalScript. Riproduci le animazioni del tuo personaggio da un LocalScript e tutto il resto (NPC, altri giocatori) da uno Script sul server.

Farlo con RoCode

RoCode è un agente IA che lavora dentro Roblox Studio tramite un plugin. Tu descrivi il movimento e lui scrive gli script nel place che hai aperto.

Tu scrivi

Aggiungi un'emote di saluto con la mano sul tasto E e un ballo che posso attivare e disattivare con G, e fai in modo che l'NPC venditore saluti i giocatori che si avvicinano.

RoCode fa
  • Scrive il LocalScript e lo Script per l'NPC e li mette dove devono stare
  • Può costruire movimenti semplici, come un saluto, un pugno o un ballo, direttamente nel codice, così non serve caricare un'animazione
  • Controlla gli script che ha scritto dentro Studio prima di finire

Devi comunque premere Play e controllare che il movimento sia come lo vuoi. Come RoCode si collega a Studio.

Domande frequenti

Posso usare qualsiasi ID di animazione che ho trovato?

No. Un'animazione parte solo in un gioco il cui proprietario la possiede, o se la possiede Roblox. Usa animazioni tue o le animazioni standard di Roblox.

Gli altri giocatori vedono un'animazione avviata da un LocalScript?

Sì, se il giocatore la riproduce sul proprio personaggio tramite l'Animator che Roblox dà al personaggio. Le animazioni sugli NPC vanno riprodotte da uno Script sul server.

Come si mette in loop un'animazione in Roblox?

Imposta track.Looped = true prima di avviarla, oppure attiva Loop nell'Animation Editor prima di pubblicarla.

Come si ferma un'animazione?

Chiama track:Stop() sulla traccia che hai avviato. Passa un numero, per esempio track:Stop(0.2), per farla sfumare in quel numero di secondi.

Perché Animator e non Humanoid:LoadAnimation?

Humanoid:LoadAnimation è deprecato. Animator:LoadAnimation fa la stessa cosa ed è quello descritto dalla documentazione di Roblox.

Fonti e letture

Come è stato controllato il codice: ogni script di questa pagina supera il controllo dei tipi rigoroso di Luau con le definizioni dell'API di Roblox (luau-lsp, 20 novembre 2026). Il controllo dei tipi trova API scritte male e tipi sbagliati, non la logica del gioco, quindi provalo in Studio prima di pubblicare.

Prova RoCode nel tuo gioco.

Crediti gratis ogni giorno, senza carta. Installa il plugin, descrivi la funzione e controlla cosa compare in Studio.