Utiliser des animations

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

Jouer des animations à partir de scripts

Dans certains cas, vous devrez jouer une animation directement à partir d'un script, comme lorsqu'un utilisateur appuie sur une certaine touche ou prend un itemspécial.

Humanoïdes

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

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

Par exemple, la suivante LocalScript, lorsqu'elle est placée dans StarterPlayerScripts, charge une animation "exclure" sur le personnage du joueur et la joue.Le script utilise également la méthode 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 le humanoïde du personnage contient un objet "Animateur"
local humanoid = character:WaitForChild("Humanoid")
local animator = humanoid:WaitForChild("Animator")

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

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

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

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

Non-humanoïdes

Pour jouer des animations sur des racks qui ne contiennent pas pas de Humanoid, vous devez créer un AnimationController avec un enfant Animator.Par exemple, la suivante Script (qui est supposée être un enfant direct du plateforme) charge une animation "exclure" 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 attribuer un ID de ressource d'animation
local kickAnimation = Instance.new("Animation")
kickAnimation.AnimationId = "rbxassetid://2515090838"

-- Créer un nouveau "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)

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

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

Remplacer les animations par défaut

Par défaut, les personnages de joueur Roblox incluent des animations communes comme la course, l'escalade, la natation et le saut.Vous pouvez remplacer ces animations par défaut par des animations du catalogue ou avec vos propres animations personnalisées.

1. Obtenez l'ID de la ressource de la nouvelle animation comme suivant :

   • Pour une animation personnalisée construite avec le éditeur d'animation, suivez les instructions d'exportation exportation.
   • Copiez un ID approprié de la référence d'animation du catalogue ci-dessous.Par exemple, pour remplacer l'animation d'exécution par défaut par la variante course de ninja, utilisez 656118852.

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

   1. Passez la souris sur 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 de caractères par défaut
   local Players = game:GetService("Players")
   
   local function onCharacterAdded(character)
   	-- Obtenir un animateur sur humanoid
   	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.lancer.RunAnim.AnimationId = "rbxassetid://"
   	--animateScript.marche.WalkAnim.AnimationId = "rbxassetid://"
   	--animateScript.sauter.JumpAnim.AnimationId = "rbxassetid://"
   	--animateScript.inactif.Animation1.AnimationId = "rbxassetid://"
   	--animateScript.inactif.Animation2.AnimationId = "rbxassetid://"
   	--animateScript.chute.FallAnim.AnimationId = "rbxassetid://"
   	--animateScript.nage.Swim.AnimationId = "rbxassetid://"
   	--animateScript.swimidle.SwimIdle.AnimationId = "rbxassetid://"
   	--animateScript.escalader.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 de caractère par défaut, désactivez-la et collez l'ID de remplacement après rbxassetid://.Par exemple, pour changer l'animation d'exécution par défaut en variante course de ninja :

   Script - Remplacer les animations de caractères par défaut
   local Players = game:GetService("Players")
   
   local function onCharacterAdded(character)
   	-- Obtenir un animateur sur humanoid
   	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.marche.WalkAnim.AnimationId = "rbxassetid://"
   	--animateScript.sauter.JumpAnim.AnimationId = "rbxassetid://"
   	--animateScript.inactif.Animation1.AnimationId = "rbxassetid://"
   	--animateScript.inactif.Animation2.AnimationId = "rbxassetid://"
   	--animateScript.chute.FallAnim.AnimationId = "rbxassetid://"
   	--animateScript.nage.Swim.AnimationId = "rbxassetid://"
   	--animateScript.swimidle.SwimIdle.AnimationId = "rbxassetid://"
   	--animateScript.escalader.ClimbAnim.AnimationId = "rbxassetid://"
   end
   
   local function onPlayerAdded(player)
   	player.CharacterAppearanceLoaded:Connect(onCharacterAdded)
   end
   
   Players.PlayerAdded:Connect(onPlayerAdded)

Définir les poids d'animation

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

Lorsqu'il existe plusieurs animations pour un état de caractère, le script Animer choisit aléatoirement celle à jouer, mais vous pouvez influencer le résultat en définissant la valeur de l'animation Weight sous la formule suivante :

• poids de l'animation / poids total de toutes les animations d'état Dans l'exemple suivant, idle.Animation1 jouera ⅓ du temps que le personnage est inactif, tandis que idle.Animation2 jouera ⅔ du temps.

Script - Remplacer les animations de caractères par défaut
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 de caractère par défaut

La table suivante contient toutes les animations de caractères par défaut que vous pouvez remplacer par des animations de catalogue ou vos propres animations personnalisées .Notez que Inactif a deux variations que vous pouvez pondérer pour jouer plus ou moins fréquemment.

Animations de catalogue

Lors de l'utilisation de packages d'animation d'avatar pour remplacer les animations par défaut, utilisez les références suivantes pour les ID d'actif respectifs.Par exemple, si vous voulez appliquer l'animation saut de ninja , utilisez ».Notez que Inactif a plusieurs variations.