Utiliser des animations

Une fois que vous avez créé une animation, vous devez utiliser des scripts pour les inclure dans votre jeu. Vous pouvez soit jouer des animations manuellement à partir de scripts, soit remplacer les animations par défaut pour les personnages des joueurs.

Jouer des animations depuis des scripts

Dans certains cas, vous devrez jouer une animation directement depuis un script, par exemple lorsqu'un utilisateur presse une certaine touche ou ramasse un objet spécial.

Humanoïdes

Pour jouer une animation sur un rig contenant un objet Humanoid, comme les personnages jouables typiques, suivez ce modèle de base :

1. Assurez-vous que le Humanoid du joueur local contient un objet Animator.
2. Créez une nouvelle instance Animation avec le bon AnimationId.
3. Chargez l'animation via Animator:LoadAnimation() pour créer un AnimationTrack.
4. Jouez la piste avec AnimationTrack:Play().

Par exemple, le LocalScript suivant, lorsqu'il est placé dans StarterPlayerScripts, charge une animation "coup de pied" sur le personnage du joueur et la joue. Le script utilise également la méthode GetMarkerReachedSignal() pour détecter quand un événement d'animation spécifique se produit.

LocalScript - Jouer une animation personnalisée sur le personnage du joueur
local Players = game:GetService("Players")

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

-- Assurez-vous que l'humanoïde du personnage contient un objet "Animator"
local humanoid = character:WaitForChild("Humanoid")
local animator = humanoid:WaitForChild("Animator")

-- Créer une nouvelle instance "Animation" et assigner un ID d'asset d'animation
local kickAnimation = Instance.new("Animation")
kickAnimation.AnimationId = "rbxassetid://2515090838"

-- Charger l'animation sur l'animateur
local kickAnimationTrack = animator:LoadAnimation(kickAnimation)

-- Si un événement nommé a été défini pour l'animation, connectez-le à "GetMarkerReachedSignal()"
kickAnimationTrack:GetMarkerReachedSignal("KickEnd"):Connect(function(paramString)
	print(paramString)
end)

task.wait(4)

-- Jouer la piste d'animation
kickAnimationTrack:Play()

Non-humanoïdes

Pour jouer des animations sur des rigs qui ne contiennent pas de Humanoid, vous devez créer un AnimationController avec un enfant Animator. Par exemple, le Script suivant (supposé être un enfant direct du rig) charge une animation "coup de pied" et la joue.

Script - Jouer une animation personnalisée sur le rig du personnage
local rig = script.Parent

-- Créer une nouvelle instance "Animation" et assigner un ID d'asset d'animation
local kickAnimation = Instance.new("Animation")
kickAnimation.AnimationId = "rbxassetid://2515090838"

-- Créer un nouvel "AnimationController" et "Animator"
local animationController = Instance.new("AnimationController")
animationController.Parent = rig

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

-- Charger l'animation sur l'animateur
local kickAnimationTrack = animator:LoadAnimation(kickAnimation)

-- Si un événement nommé a été défini pour l'animation, connectez-le à "GetMarkerReachedSignal()"
kickAnimationTrack:GetMarkerReachedSignal("KickEnd"):Connect(function(paramString)
	print(paramString)
end)

task.wait(4)

-- Jouer la piste d'animation
kickAnimationTrack:Play()

Remplacer les animations par défaut

Par défaut, les personnages joueurs de Roblox incluent des animations courantes comme courir, grimper, nager et sauter. Vous pouvez remplacer ces animations par défaut par des animations du catalogue ou par vos propres animations personnalisées.

1. Obtenez l'ID d'asset de la nouvelle animation comme suit :

   • Pour une animation personnalisée créée avec l'éditeur d'animation, suivez les instructions d'exportation.
   • Copiez un ID approprié à partir de la référence d'animation du catalogue ci-dessous. Par exemple, pour remplacer l'animation de course par défaut par le variant Ninja Run, utilisez 656118852.

2. Dans la fenêtre Explorer, ajoutez un nouveau Script à ServerScriptService.

   1. Survolez ServerScriptService et cliquez sur le bouton ⊕.
   2. Dans le menu contextuel, insérez un Script.

3. Dans le nouveau script, collez le code suivant :

   Script - Remplacer les animations par défaut du personnage
   local Players = game:GetService("Players")
   
   local function onCharacterAdded(character)
   	-- Obtenez l'animateur sur l'humanoïde
   	local humanoid = character:WaitForChild("Humanoid")
   	local animator = humanoid:WaitForChild("Animator")
   
   	-- Arrêter toutes les pistes d'animation
   	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. Pour chaque ligne qui fait référence à une animation par défaut du personnage, décommentez-la et collez l'ID de remplacement après rbxassetid://. Par exemple, pour changer l'animation de course par défaut pour le variant Ninja Run :

   Script - Remplacer les animations par défaut du personnage
   local Players = game:GetService("Players")
   
   local function onCharacterAdded(character)
   	-- Obtenez l'animateur sur l'humanoïde
   	local humanoid = character:WaitForChild("Humanoid")
   	local animator = humanoid:WaitForChild("Animator")
   
   	-- Arrêter toutes les pistes d'animation
   	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)

Définir les poids des animations

Vous pouvez utiliser plusieurs animations pour la même action. Par exemple, il existe deux variations idle dans l'exemple de code pour remplacer les animations par défaut.

Lorsque plusieurs animations existent pour un état de personnage, le script Animate choisit aléatoirement laquelle jouer, mais vous pouvez influencer le résultat en définissant la valeur Weight de l'animation selon la formule suivante :

• poids de l'animation / poids total de toutes les animations de l'état

Dans l'exemple suivant, idle.Animation1 sera joué ⅓ du temps que le personnage est inactif, tandis que idle.Animation2 sera joué ⅔ du temps.

Script - Remplacer les animations par défaut du personnage
animateScript.idle.Animation1.AnimationId = "rbxassetid://656117400"
	animateScript.idle.Animation2.AnimationId = "rbxassetid://656118341"
	animateScript.idle.Animation1.Weight.Value = 5
	animateScript.idle.Animation2.Weight.Value = 10

Références d'animation

Animations par défaut du personnage

Le tableau suivant contient toutes les animations par défaut du personnage que vous pouvez remplacer par des animations de catalogue ou vos propres animations personnalisées. Notez que Idle a deux variations que vous pouvez peser pour les faire jouer plus ou moins fréquemment.

Animations du catalogue

Lors de l'utilisation de paquets d'animation d'avatar pour remplacer les animations par défaut, utilisez les références suivantes pour les ID d'asset respectifs. Par exemple, si vous souhaitez appliquer l'animation Ninja Jump, utilisez 656117878. Notez que Idle a plusieurs variations.