Usar animaciones

Una vez que hayas creado una animación, necesitas usar scripts para incluirlas en tu juego. Puedes reproducir animaciones manualmente desde scripts o reemplazar animaciones predeterminadas para los personajes de los jugadores.

Reproducir animaciones desde scripts

En algunos casos, necesitarás reproducir una animación directamente desde dentro de un script, como cuando un usuario presiona una determinada tecla o recoge un objeto especial.

Humanoides

Para reproducir una animación en un rig que contiene un objeto Humanoid, como los personajes jugables típicos, sigue este patrón básico:

1. Asegúrate de que el Humanoid del jugador local contenga un objeto Animator.
2. Crea una nueva instancia de Animation con el AnimationId apropiado.
3. Carga la animación a través de Animator:LoadAnimation() para crear un AnimationTrack.
4. Reproduce la pista con AnimationTrack:Play().

Por ejemplo, el siguiente LocalScript, cuando se coloca en StarterPlayerScripts, carga una animación de "patada" en el personaje del jugador y la reproduce. El script también utiliza el método GetMarkerReachedSignal() para detectar cuándo ocurre un evento de animación específico.

LocalScript - Reproducir Animación Personalizada en el Personaje del Jugador
local Players = game:GetService("Players")

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

-- Asegúrate de que el humanoide del personaje contenga un objeto "Animator"
local humanoid = character:WaitForChild("Humanoid")
local animator = humanoid:WaitForChild("Animator")

-- Crear una nueva instancia de "Animation" y asignar un ID de activo de animación
local kickAnimation = Instance.new("Animation")
kickAnimation.AnimationId = "rbxassetid://2515090838"

-- Cargar la animación en el animador
local kickAnimationTrack = animator:LoadAnimation(kickAnimation)

-- Si se definió un evento nombrado para la animación, conéctalo a "GetMarkerReachedSignal()"
kickAnimationTrack:GetMarkerReachedSignal("KickEnd"):Connect(function(paramString)
	print(paramString)
end)

task.wait(4)

-- Reproducir la pista de animación
kickAnimationTrack:Play()

No-humanoides

Para reproducir animaciones en rigs que no contienen un Humanoid, debes crear un AnimationController con un Animator hijo. Por ejemplo, el siguiente Script (asumido como hijo directo del rig) carga una animación de "patada" y la reproduce.

Script - Reproducir Animación Personalizada en el Rig del Personaje
local rig = script.Parent

-- Crear una nueva instancia de "Animation" y asignar un ID de activo de animación
local kickAnimation = Instance.new("Animation")
kickAnimation.AnimationId = "rbxassetid://2515090838"

-- Crear un nuevo "AnimationController" y "Animator"
local animationController = Instance.new("AnimationController")
animationController.Parent = rig

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

-- Cargar la animación en el animador
local kickAnimationTrack = animator:LoadAnimation(kickAnimation)

-- Si se definió un evento nombrado para la animación, conéctalo a "GetMarkerReachedSignal()"
kickAnimationTrack:GetMarkerReachedSignal("KickEnd"):Connect(function(paramString)
	print(paramString)
end)

task.wait(4)

-- Reproducir la pista de animación
kickAnimationTrack:Play()

Reemplazar animaciones predeterminadas

De forma predeterminada, los personajes de los jugadores de Roblox incluyen animaciones comunes como correr, escalar, nadar y saltar. Puedes reemplazar estas animaciones predeterminadas con animaciones del catálogo o con tus propias animaciones personalizadas.

1. Obtén el ID de activo de la nueva animación de la siguiente manera:

   • Para una animación personalizada creada con el Animation Editor, sigue las instrucciones de exportación.
   • Copia un ID apropiado del referencia de animación del catálogo a continuación. Por ejemplo, para reemplazar la animación de correr predeterminada con la variante Ninja Run, usa 656118852.

2. En la ventana de Explorer, agrega un nuevo Script a ServerScriptService.

   1. Pasa el mouse sobre ServerScriptService y haz clic en el botón ⊕.
   2. En el menú contextual, inserta un Script.

3. En el nuevo script, pega el siguiente código:

   Script - Reemplazar Animaciones Predeterminadas del Personaje
   local Players = game:GetService("Players")
   
   local function onCharacterAdded(character)
   	-- Obtener animador en humanoide
   	local humanoid = character:WaitForChild("Humanoid")
   	local animator = humanoid:WaitForChild("Animator")
   
   	-- Detener todas las pistas de animación
   	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. Para cada línea que haga referencia a una animación predeterminada del personaje, descoméntala y pega el ID de reemplazo después de rbxassetid://. Por ejemplo, para cambiar la animación de correr predeterminada a la variante Ninja Run:

   Script - Reemplazar Animaciones Predeterminadas del Personaje
   local Players = game:GetService("Players")
   
   local function onCharacterAdded(character)
   	-- Obtener animador en humanoide
   	local humanoid = character:WaitForChild("Humanoid")
   	local animator = humanoid:WaitForChild("Animator")
   
   	-- Detener todas las pistas de animación
   	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)

Establecer pesos de animación

Puedes usar múltiples animaciones para la misma acción. Por ejemplo, hay dos variaciones de idle en el ejemplo de código para reemplazar las animaciones predeterminadas.

Cuando existen múltiples animaciones para un estado de personaje, el script Animate elige aleatoriamente cuál reproducir, pero puedes influir en el resultado estableciendo el valor de Weight de la animación bajo la siguiente fórmula:

• peso de la animación / peso total de todas las animaciones de estado

En el siguiente ejemplo, idle.Animation1 se reproducirá ⅓ del tiempo que el personaje esté inactivo, mientras que idle.Animation2 se reproducirá ⅔ del tiempo.

Script - Reemplazar Animaciones Predeterminadas del Personaje
animateScript.idle.Animation1.AnimationId = "rbxassetid://656117400"
	animateScript.idle.Animation2.AnimationId = "rbxassetid://656118341"
	animateScript.idle.Animation1.Weight.Value = 5
	animateScript.idle.Animation2.Weight.Value = 10

Referencias de animación

Animaciones predeterminadas del personaje

La siguiente tabla contiene todas las animaciones predeterminadas del personaje que puedes reemplazar con animaciones del catálogo o con tus propias animaciones personalizadas. Ten en cuenta que Idle tiene dos variaciones que puedes pesar para que se reproduzcan con más o menos frecuencia.

Animaciones del catálogo

Al utilizar paquetes de animación de avatar para reemplazar animaciones predeterminadas, utiliza las siguientes referencias para los respectivos ID de activos. Por ejemplo, si deseas aplicar la animación Ninja Jump, usa 656117878. Ten en cuenta que Idle tiene múltiples variaciones.