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
Priorityde la piste surAction, sinon les animations de marche et d'attente (idle) peuvent la recouvrir. - Charge les animations avec
Animator:LoadAnimation.Humanoid:LoadAnimationest obsolète (deprecated).
Sur cette page
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.
| Objet | Où il se trouve | Ce qu'il fait |
|---|---|---|
Animation | Créé par ton script | Contient l'AnimationId, l'adresse de l'asset d'animation. Il ne joue rien tout seul. |
Animator | Dans le Humanoid du personnage (Roblox l'ajoute) | Charge les animations et les joue sur les articulations du rig. |
AnimationTrack | Renvoyé par Animator:LoadAnimation() | La copie qu'on peut jouer : Play(), Stop(), Looped, Priority, Speed et les événements. |
| L'asset d'animation | Sur Roblox, publié depuis l'Animation Editor | Les 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.
| Priority | Utilisée pour |
|---|---|
Core | La plus basse. Tout le reste la recouvre. |
Idle | Rester immobile. |
Movement | Marcher, courir, sauter. |
Action | Emotes, attaques, outils. Le choix habituel pour une animation que tu joues depuis un script. |
Action2 à Action4 | Une 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.
- 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.
- 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
- Dans l'Explorer, ouvre StarterPlayer, survole StarterCharacterScripts, clique sur + et insère un LocalScript.
- Renomme-le
EmoteOnKeyet colle le code ci-dessous. - Appuie sur Play puis sur E. Ton personnage fait un signe de la main.
-- 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 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. 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 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.
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.
- É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
- Roblox Creator Docs : Use animations (en anglais). charger et jouer des animations depuis des scripts, propriété des animations
- Roblox Creator Docs : Animator (en anglais). LoadAnimation et réplication
- Roblox Creator Docs : AnimationTrack (en anglais). Play, Stop, Looped, Priority, GetMarkerReachedSignal
- Roblox Creator Docs : Animation Editor (en anglais). créer, publier et ajouter des événements d'animation
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.