Tutoriel · Systèmes de jeu

Comment jouer une animation sur Roblox Studio avec un script

Sur Roblox, une animation est jouée par l'Animator du personnage, pas par l'animation elle-même. Ce guide en joue une quand un joueur appuie sur une touche, active et coupe une danse, fait tourner une animation en boucle sur un PNJ, et cale un coup sur l'image exacte d'un coup de poing.

Mis à jour le 14 novembre 20267 min de lectureÉcrit par

En bref

Mets un LocalScript dans StarterPlayer > StarterCharacterScripts. Dedans, trouve le Humanoid du personnage et son Animator, crée une Animation avec ton AnimationId, charge-la avec animator:LoadAnimation(animation), puis appelle :Play() sur la piste qu'elle renvoie quand UserInputService.InputBegan signale ta touche. Une animation qu'un joueur joue ainsi sur son propre personnage est vue par tout le monde sur le serveur.

  • L'animation doit appartenir au propriétaire du jeu (toi ou ton groupe) ou à Roblox. Une animation publiée par quelqu'un d'autre ne se joue pas dans ton jeu.
  • Règle la Priority de la piste sur Action, sinon les animations de marche et d'attente (idle) peuvent la recouvrir.
  • Charge les animations avec Animator:LoadAnimation. Humanoid:LoadAnimation est obsolète (deprecated).
Sur cette page
  1. Fonctionnement
  2. 1. ID d'animation
  3. 2. Sur une touche
  4. 3. Boucle on/off
  5. 4. Sur un PNJ
  6. 5. Événements d'animation
  7. Problèmes courants
  8. Avec RoCode
  9. Questions fréquentes
  10. Sources et lectures

Comment les animations se jouent sur Roblox

Quatre objets entrent en jeu. Tu n'en crées qu'un seul à la main : le script fait le reste.

Les objets qui jouent une animation
ObjetOù il se trouveCe qu'il fait
AnimationCréé par ton scriptContient l'AnimationId, l'adresse de l'asset d'animation. Il ne joue rien tout seul.
AnimatorDans le Humanoid du personnage (Roblox l'ajoute)Charge les animations et les joue sur les articulations du rig.
AnimationTrackRenvoyé par Animator:LoadAnimation()La copie qu'on peut jouer : Play(), Stop(), Looped, Priority, Speed et les événements.
L'asset d'animationSur Roblox, publié depuis l'Animation EditorLes keyframes elles-mêmes. Son ID est ce qu'on met dans AnimationId.

Charge chaque animation une seule fois et garde la piste. Appeler LoadAnimation à chaque appui sur une touche crée une nouvelle piste à chaque fois, et elles s'accumulent.

Priorité des animations, de la plus basse à la plus haute
PriorityUtilisée pour
CoreLa plus basse. Tout le reste la recouvre.
IdleRester immobile.
MovementMarcher, courir, sauter.
ActionEmotes, attaques, outils. Le choix habituel pour une animation que tu joues depuis un script.
Action2 à Action4Une action qui doit en recouvrir une autre, par exemple un étourdissement par-dessus une attaque.

Quand deux pistes en cours bougent la même articulation, celle qui a la priorité la plus haute l'emporte sur cette articulation. Un salut Action qui ne bouge que le bras laisse les jambes continuer à marcher en dessous.

Étape 1 : trouver un ID d'animation utilisable

Roblox ne joue une animation dans ton jeu que si elle appartient au propriétaire du jeu, ou à Roblox. Ça exclut la plupart des ID copiés depuis le Creator Store ou une vidéo : ils appartiennent à quelqu'un d'autre et ne se chargent pas. Tu as deux bonnes sources.

  1. Fais la tienne. Dans Studio, ouvre l'onglet Avatar et choisis Animation Editor, sélectionne un rig (le Rig Builder du même onglet en insère un), place les poses sur la timeline, puis utilise le menu de l'éditeur pour Publish to Roblox. Publie-la sur le même compte ou le même groupe que celui à qui appartient ton jeu. Copie l'ID qu'il te donne.
  2. Prends celles de Roblox. Les emotes par défaut du script Animate de Roblox, comme le salut R15 (507770239) et la danse (507771019), appartiennent à Roblox, donc elles se jouent dans n'importe quel jeu. Ce guide les utilise pour que tu puisses tester tout de suite.

Écris l'ID sous la forme "rbxassetid://" suivi du nombre, par exemple "rbxassetid://507770239".

Étape 2 : jouer une animation quand on appuie sur une touche

  1. Dans l'Explorer, ouvre StarterPlayer, survole StarterCharacterScripts, clique sur + et insère un LocalScript.
  2. Renomme-le EmoteOnKey et colle le code ci-dessous.
  3. Appuie sur Play puis sur E. Ton personnage fait un signe de la main.
LocalScript dans StarterCharacterScripts nommé EmoteOnKey
-- LocalScript dans StarterPlayer > StarterCharacterScripts nommé EmoteOnKey.
-- Appuie sur E pour jouer une animation sur ton propre personnage. Tout le monde sur le serveur la voit.
local UserInputService = game:GetService("UserInputService")

local ANIMATION_ID = "rbxassetid://507770239" -- le salut R15 de Roblox ; mets ici l'ID de ton animation
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 -- au-dessus de la marche et de l'idle, donc les jambes marchent mais les bras saluent

local lastPlayed = -math.huge

UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
	-- gameProcessed vaut true pendant que le joueur tape dans le chat ou une zone de texte
	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) -- fondu d'entrée sur 0,1 seconde
end)

Les scripts de StarterCharacterScripts sont copiés dans le personnage à chaque apparition, donc script.Parent est le personnage et la piste est rechargée après chaque réapparition.

gameProcessed vaut true quand Roblox a déjà utilisé l'appui sur la touche, par exemple pendant que le joueur tape dans le chat. Le vérifier empêche l'emote de partir chaque fois que quelqu'un tape la lettre E.

Tout le monde voit le salut, pas seulement toi. Roblox réplique les animations qu'un joueur joue sur son propre personnage, tant que l'Animator a été créé par le serveur, ce qui est le cas de celui que Roblox met dans chaque personnage. C'est pour ça que ce script n'a jamais besoin d'un RemoteEvent.

Étape 3 : activer et couper une animation en boucle

Une danse ou une position assise doit continuer jusqu'à ce que le joueur l'arrête. Règle Looped sur true et joue ou arrête la même piste à chaque appui. Cette version arrête aussi la danse quand le joueur se met à marcher.

LocalScript dans StarterCharacterScripts nommé DanceToggle
-- LocalScript dans StarterPlayer > StarterCharacterScripts nommé DanceToggle.
-- Appuie sur G pour lancer une danse en boucle, appuie encore sur G (ou marche) pour l'arrêter.
local UserInputService = game:GetService("UserInputService")

local DANCE_ID = "rbxassetid://507771019" -- la danse R15 de Roblox ; mets ici l'ID de ton animation
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)

-- Arrête la danse quand le joueur se met à marcher
humanoid.Running:Connect(function(speed: number)
	if speed > 0.5 and track.IsPlaying then
		track:Stop(0.2)
	end
end)

Le nombre passé à Play et Stop est une durée de fondu en secondes. Un fondu court fait entrer et sortir la danse en douceur au lieu de sauter d'une pose à l'autre.

Étape 4 : jouer une animation sur un PNJ

Un PNJ n'appartient à aucun joueur, donc ses animations sont jouées par le serveur. Mets un Script (pas un LocalScript) dans le Model du PNJ. Un rig créé avec le Rig Builder a déjà un Humanoid, un HumanoidRootPart et un Animator.

Script dans le Model du PNJ nommé NpcAnimation
-- Script dans le Model du PNJ nommé NpcAnimation. Le PNJ a besoin d'un Humanoid et d'un HumanoidRootPart.
-- Joue une animation en boucle sur le PNJ depuis le serveur, donc chaque joueur la voit.
local ANIMATION_ID = "rbxassetid://507771019" -- la danse R15 de Roblox ; mets ici l'ID de ton animation

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

-- Un PNJ créé à partir d'un rig a souvent déjà un Animator ; on en crée un s'il n'y en a pas
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()

Étape 5 : caler une action sur un moment de l'animation

Un coup de poing doit faire des dégâts quand le poing touche, pas quand on appuie sur la touche. Dans l'Animation Editor, fais un clic droit sur la timeline à ce moment et ajoute un événement d'animation (animation event) nommé Hit, puis publie à nouveau l'animation. Dans le code, track:GetMarkerReachedSignal("Hit") se déclenche à cette image.

LocalScript dans StarterCharacterScripts nommé PunchOnClick
-- LocalScript dans StarterPlayer > StarterCharacterScripts nommé PunchOnClick.
-- Joue ton animation de coup de poing au clic et prévient le serveur au moment où le poing touche,
-- grâce à un événement d'animation nommé "Hit" que tu ajoutes dans l'Animation Editor.
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local UserInputService = game:GetService("UserInputService")

local PUNCH_ID = "rbxassetid://0" -- ta propre animation de coup de poing, avec un événement "Hit" au moment de l'impact
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() -- le serveur vérifie la portée et le temps de recharge avant d'infliger des dégâts
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)

Ce script a besoin d'un RemoteEvent nommé PunchHit dans ReplicatedStorage, et de ta propre animation de coup de poing avec un événement Hit à la place de rbxassetid://0.

Le client dit seulement « mon coup a touché ». Un Script serveur qui écoute PunchHit.OnServerEvent décide si quelqu'un était à portée et combien de dégâts infliger, avec son propre temps de recharge, pour qu'un joueur qui déclenche l'événement à la main ne puisse pas frapper depuis l'autre bout de la carte. Le guide des RemoteEvents montre comment vérifier une requête comme celle-ci sur le serveur.

Problèmes courants

Ouvre d'abord la fenêtre Output (menu Window, puis Output). La plupart des problèmes d'animation y écrivent une ligne.

Rien ne se passe et Output dit que l'animation n'a pas pu se charger

L'animation appartient à quelqu'un d'autre que le propriétaire du jeu. Publie ta propre copie depuis l'Animation Editor sur le compte ou le groupe à qui appartient le jeu, et utilise cet ID.

L'animation se joue mais seuls les bras bougent, ou elle a l'air à moitié finie

Une autre piste avec une priorité plus haute bouge les mêmes articulations. Règle la Priority de ta piste sur Action (ou plus), ou publie l'animation avec cette priorité depuis l'Animation Editor.

Rien ne se passe et il n'y a pas d'erreur

Vérifie le type de rig : une animation R15 ne fait rien sur un personnage R6. Vérifie aussi que le script est un LocalScript dans StarterCharacterScripts ; un LocalScript dans le Workspace ne s'exécute pas.

Le PNJ ne s'anime pas

Ses parts sont ancrées, ou son Humanoid n'a pas d'Animator. Ancre seulement le HumanoidRootPart ; le script de l'étape 4 crée un Animator s'il en manque un.

Les autres joueurs ne voient pas mon animation

L'animation a été jouée sur un personnage qui n'appartient pas au joueur, ou sur un Animator créé par un LocalScript. Joue les animations de ton propre personnage depuis un LocalScript, et tout le reste (PNJ, autres joueurs) depuis un Script serveur.

Le faire avec RoCode

RoCode est un agent IA qui travaille dans Roblox Studio grâce à un plugin. Tu décris le mouvement, et il écrit les scripts dans le jeu que tu as ouvert.

Tu écris

Ajoute un emote de salut sur E et une danse que je peux activer et couper avec G, et fais que le PNJ marchand salue les joueurs qui s'approchent de lui.

RoCode fait
  • Écrit les LocalScripts et le Script du PNJ et les place là où ils doivent aller
  • Peut construire des mouvements simples comme un salut, un coup de poing ou une danse en code, donc il n'y a pas d'animation à publier
  • Vérifie dans Studio les scripts qu'il a écrits avant de terminer

Tu dois quand même appuyer sur Play et vérifier que le mouvement ressemble à ce que tu veux. Comment RoCode se connecte à Studio.

Questions fréquentes

Est-ce que je peux utiliser n'importe quel ID d'animation trouvé en ligne ?

Non. Une animation ne se joue que dans un jeu dont le propriétaire la possède, ou quand elle appartient à Roblox. Utilise tes propres animations, ou celles de Roblox par défaut.

Une animation jouée par un LocalScript est-elle répliquée aux autres joueurs ?

Oui, quand le joueur la joue sur son propre personnage via l'Animator que Roblox donne au personnage. Les animations des PNJ doivent être jouées depuis un Script serveur.

Comment faire une animation en boucle ?

Règle track.Looped = true avant de la jouer, ou coche Loop dans l'Animation Editor avant de publier.

Comment arrêter une animation ?

Appelle track:Stop() sur la piste que tu as jouée. Passe un nombre, comme track:Stop(0.2), pour la faire disparaître en fondu sur autant de secondes.

Pourquoi utiliser Animator plutôt que Humanoid:LoadAnimation ?

Humanoid:LoadAnimation est obsolète. Animator:LoadAnimation fait la même chose et c'est celle que Roblox documente.

Sources et lectures

Comment le code a été vérifié : chaque script de cette page passe le vérificateur de types strict de Luau avec les définitions de l'API Roblox (luau-lsp, 14 novembre 2026). Une vérification de types repère les API mal écrites et les mauvais types, pas la logique du jeu : teste dans Studio avant de publier.

Essaie RoCode sur ton propre jeu.

Des crédits gratuits chaque jour, sans carte. Installe le plugin, décris la fonctionnalité et vérifie ce qui arrive dans Studio.