Tutorial · Fundamentos de scripting

Tutorial de TweenService: mover, rotar y desvanecer partes

Un tween cambia una propiedad de forma suave desde su valor actual hasta un objetivo a lo largo del tiempo: una plataforma se desliza, una gema gira, una pared se desvanece. TweenService calcula los pasos intermedios por ti, así que nunca escribes un bucle que empuje una parte en cada frame. Esta guía cubre las tres líneas que necesita todo tween, qué hace cada ajuste de TweenInfo, cómo mover, rotar y desvanecer partes, los bucles, cómo esperar a que termine un tween y el truco para hacer un tween de un Model entero.

Actualizado el 12 de noviembre de 20266 min de lecturaEscrito por

La respuesta corta

Obtén el servicio con game:GetService("TweenService"), describe el movimiento con TweenInfo.new(time, easingStyle, easingDirection), luego llama a TweenService:Create(part, info, { Position = goal }) y haz :Play() del tween que devuelve. Se puede hacer tween de cualquier propiedad de tipo number, Vector3, CFrame, Color3, UDim2 o similar. Usa tween.Completed:Wait() para esperarlo, y dale a TweenInfo un número de repeticiones de -1 con reverses activado para un bucle de ida y vuelta.

  • Haz el tween de la parte en el servidor cuando todos los jugadores deban verlo; en el cliente, para efectos que solo necesita ese jugador.
  • Ancla las partes a las que haces tween, o la física pelea contra el tween.
  • Un Model no tiene Position ni CFrame para hacer tween: haz tween de un NumberValue y mueve el modelo con PivotTo.
En esta página
  1. Cómo funciona
  2. 1. TweenInfo
  3. 2. Rotar y desvanecer
  4. 3. Bucles
  5. 4. Modelos
  6. Servidor o cliente
  7. Errores comunes
  8. Con RoCode
  9. Preguntas frecuentes
  10. Fuentes y lecturas

Las tres líneas que necesita todo tween

Inserta una Part en Workspace, marca Anchored, luego pasa el ratón sobre ella, haz clic en + e inserta un Script. Esto sube la parte 10 studs en 2 segundos:

Script en una Part de Workspace llamado Rise
-- Script dentro de una Part.
local TweenService = game:GetService("TweenService")

local part = script.Parent :: BasePart

local info = TweenInfo.new(2) -- 2 segundos, easing por defecto
local goal = { Position = part.Position + Vector3.new(0, 10, 0) }

local tween = TweenService:Create(part, info, goal)
tween:Play()

El objetivo es una tabla con nombres de propiedades y los valores en los que deben terminar. Puedes hacer tween de varias propiedades a la vez: { Position = ..., Transparency = 1, Color = Color3.fromRGB(255, 0, 0) }. El tween empieza desde los valores que haya cuando llamas a Play, así que solo indicas el final.

Qué se puede y qué no se puede animar con un tween
Tipo¿Cambia de forma suave?Ejemplos
numberSíTransparency, Reflectance, el Value de un NumberValue
Vector3, CFrameSíPosition, Size, CFrame, Orientation
Color3SíColor
UDim2, Vector2SíSize y Position de una GUI
boolean, EnumItemCambia al finalCanCollide, Material
string, InstanceNoDa el error cannot be tweened due to type mismatch

Paso 1: todos los ajustes de TweenInfo

TweenInfo.new acepta hasta seis valores, en este orden. Puedes omitir los del final.

TweenInfo.new(time, style, direction, repeatCount, reverses, delayTime)
ValorPor defectoQué hace
time1Segundos de una reproducción.
easingStyleQuadLa forma del movimiento: Linear (velocidad constante), Sine, Quad, Cubic, Back (se pasa y vuelve), Bounce, Elastic, Exponential.
easingDirectionOutOut empieza rápido y frena; In empieza lento; InOut hace las dos cosas.
repeatCount0Reproducciones extra después de la primera. -1 repite para siempre.
reversesfalseVuelve al inicio después de cada reproducción.
delayTime0Segundos de espera antes de empezar.
Script en una Part de Workspace llamado Platform
-- Script dentro de una Part llamada Platform.
-- Se desliza 12 studs de ida y vuelta para siempre, suavizando en los dos extremos.
local TweenService = game:GetService("TweenService")

local platform = script.Parent :: BasePart

local info = TweenInfo.new(
	3, -- segundos en cada sentido
	Enum.EasingStyle.Sine,
	Enum.EasingDirection.InOut,
	-1, -- repetir para siempre
	true -- volver cada vez
)

TweenService:Create(platform, info, { Position = platform.Position + Vector3.new(12, 0, 0) }):Play()

Si la plataforma debe llevar a los jugadores que están encima, una parte anclada con tween se mueve debajo de ellos pero no se los lleva. La guía de plataformas móviles (en inglés) cubre ese caso.

Paso 2: rotar, cambiar el tamaño y desvanecer

Para rotar, haz tween de CFrame hacia el CFrame actual multiplicado por una rotación. Hacer tween de Orientation también funciona, pero CFrame mantiene la parte en su sitio mientras gira. Aquí una pared se desvanece y se encoge cuando se ejecuta el script, y se elimina cuando termina el tween:

Script en una Part de Workspace llamado FadingWall
-- Script dentro de una Part llamada FadingWall.
local TweenService = game:GetService("TweenService")

local wall = script.Parent :: BasePart

-- gira un cuarto de vuelta sobre el propio eje vertical de la parte en 1 segundo
local turn = TweenService:Create(wall, TweenInfo.new(1), {
	CFrame = wall.CFrame * CFrame.Angles(0, math.rad(90), 0),
})
turn:Play()
turn.Completed:Wait() -- continúa solo cuando haya terminado

-- luego se desvanece y se encoge a la vez
local fade = TweenService:Create(wall, TweenInfo.new(0.8, Enum.EasingStyle.Quad, Enum.EasingDirection.In), {
	Transparency = 1,
	Size = wall.Size * 0.2,
})
fade:Play()
fade.Completed:Wait()
wall:Destroy()

Completed se dispara con un PlaybackState: Completed cuando llegó al objetivo, o Cancelled cuando lo detuvo tween:Cancel(). No esperes a Completed en un tween que se repite para siempre: nunca termina.

Paso 3: un objeto que flota y gira

Dos tweens en bucle sobre propiedades distintas se ejecutan a la vez. Hacer tween de 360 grados completos con CFrame no hace nada, porque el inicio y el final son la misma rotación, así que el giro hace tween de un NumberValue de 0 a 360 y pone el CFrame a partir de él. Pon este Script dentro de una parte anclada:

Script en una Part de Workspace llamado FloatingGem
-- Script dentro de una Part llamada Gem. Flota arriba y abajo y gira para siempre.
local TweenService = game:GetService("TweenService")

local FLOAT_HEIGHT = 1.5 -- studs por encima de donde la colocaste
local FLOAT_SECONDS = 1.2 -- en cada sentido
local SPIN_SECONDS = 3 -- una vuelta completa

local gem = script.Parent :: BasePart
gem.Anchored = true
local baseCFrame = gem.CFrame

local height = Instance.new("NumberValue")
local angle = Instance.new("NumberValue")

local function apply()
	gem.CFrame = baseCFrame * CFrame.new(0, height.Value, 0) * CFrame.Angles(0, math.rad(angle.Value), 0)
end
height.Changed:Connect(apply)
angle.Changed:Connect(apply)

TweenService:Create(height, TweenInfo.new(FLOAT_SECONDS, Enum.EasingStyle.Sine, Enum.EasingDirection.InOut, -1, true), {
	Value = FLOAT_HEIGHT,
}):Play()

TweenService:Create(angle, TweenInfo.new(SPIN_SECONDS, Enum.EasingStyle.Linear, Enum.EasingDirection.In, -1), {
	Value = 360,
}):Play()

El giro usa easing Linear para girar a velocidad constante, y vuelve a empezar en 0 en cada vuelta, que es el mismo ángulo que 360, así que no hay salto. La guía de recoger monedas (en inglés) pone objetos como este en un juego.

Paso 4: tween de un Model entero

Un Model no tiene propiedad Position ni CFrame, así que TweenService:Create(model, ...) no tiene nada que mover. En su lugar, haz tween de un NumberValue de 0 a 1 y mueve el modelo con PivotTo, que mueve juntas todas las partes que contiene:

Script en un Model de Workspace llamado Elevator
-- Script dentro de un Model llamado Elevator.
-- Sube el modelo entero 20 studs y lo baja, con todas las partes juntas.
local TweenService = game:GetService("TweenService")

local elevator = script.Parent :: Model
local startPivot = elevator:GetPivot()
local endPivot = startPivot * CFrame.new(0, 20, 0)

local progress = Instance.new("NumberValue")
progress.Changed:Connect(function(alpha: number)
	elevator:PivotTo(startPivot:Lerp(endPivot, alpha))
end)

local info = TweenInfo.new(4, Enum.EasingStyle.Quad, Enum.EasingDirection.InOut, -1, true, 2)
TweenService:Create(progress, info, { Value = 1 }):Play()

Ancla todas las partes del modelo. El 2 del final de TweenInfo es la espera antes de cada reproducción, así que el ascensor se detiene arriba y abajo. La guía de puertas (en inglés) usa el mismo patrón para abrir puertas hechas de varias partes.

¿En el servidor o en el cliente?

Un tween que se reproduce en un Script de servidor cambia la parte en el servidor, y los nuevos valores se replican a todos los jugadores, así que todos lo ven. Un tween en un LocalScript cambia la parte solo en la pantalla de ese jugador.

Dónde reproducir un tween
Reprodúcelo enCuándoEjemplo
Un Script de servidorEl cambio importa para el juego o para todos.Puertas, obstáculos móviles, un puente que se abre
Un LocalScriptSolo este jugador debe verlo, o es puramente un efecto visual.Un objeto que se desvanece para el jugador que lo recogió, la UI

La replicación envía actualizaciones muchas veces por segundo, así que los tweens del servidor se ven suaves para la mayoría de los jugadores, pero los tweens de servidor muy rápidos o muy numerosos pueden verse menos suaves en conexiones lentas. Para mucho movimiento decorativo (cientos de monedas girando), reproduce los tweens en un LocalScript en cada cliente.

Errores comunes y soluciones

Abre la ventana Output (menú Window y luego Output) antes de pulsar Play.

La parte no se mueve nada

Comprueba que llamaste a :Play() en el tween, que el nombre de la propiedad del objetivo está escrito exactamente (Position, no position) y que es un Script en un lugar donde se ejecutan los scripts (dentro de una parte en Workspace, o en ServerScriptService).

La parte se cae o tiembla durante el tween

No está anclada, así que la gravedad y las colisiones pelean contra el tween. Marca Anchored.

TweenService:Create property cannot be tweened due to type mismatch

El valor del objetivo es del tipo equivocado, por ejemplo un número para una propiedad Vector3. Consulta la página de este error (en inglés).

Unable to cast to Dictionary o Unable to cast value to Object

Los argumentos están en el orden equivocado o son del tipo equivocado. Siempre es Create(instance, tweenInfo, goalTable). Consulta Unable to cast value to Object (en inglés).

Constrúyelo con RoCode

Si prefieres no escribir los tweens a mano, RoCode puede construirlos en el place que tienes abierto. RoCode es un agente de IA independiente para Roblox Studio, no lo hace Roblox: describes el cambio en un chat web y su plugin de Studio crea los scripts en tu Explorer, así que no hay código que pegar.

Tú escribes

Haz que el modelo del puente en Workspace se deslice 15 studs hacia un lado cuando empiece la ronda, usando un tween de un NumberValue y PivotTo, y que a la vez las partes rojas de la barrera se desvanezcan en 1 segundo.

RoCode hace
  • Puede encontrar las partes y modelos a los que te refieres con Search Game antes de escribir nada
  • Escribe el Script con Create Script y tiene la instrucción de comprobar que compila con Check Script
  • Pone un punto de deshacer antes y después de cada lote de cambios, así que Ctrl+Z retrocede un lote cada vez

Con el plugin 3.9 o posterior RoCode puede hacer una prueba corta y leer los errores, pero el movimiento se juzga mejor con tus propios ojos, así que pulsa Play y míralo. Cómo se conecta RoCode a Studio.

Preguntas frecuentes

¿Cómo se usa TweenService en Roblox?

Obtén el servicio, crea un TweenInfo, llama a TweenService:Create(object, info, { Property = goal }) y haz :Play() del resultado. La primera sección tiene un ejemplo de tres líneas.

¿Cómo hago que un tween se repita para siempre?

Pasa -1 como cuarto valor de TweenInfo.new (repeatCount), y true como quinto si debe ir y volver.

¿Cómo espero a que termine un tween?

Llama a tween.Completed:Wait() después de tween:Play(), o conecta una función a tween.Completed.

¿Puedo hacer un tween de un Model?

No directamente. Haz tween de un NumberValue de 0 a 1 y llama a model:PivotTo(start:Lerp(goal, value)) cuando cambie, como en el paso 4.

¿Cómo detengo un tween?

Llama a tween:Cancel() para detenerlo y dejar la parte donde está, o a tween:Pause() para reanudarlo más tarde con Play().

Fuentes y lecturas

Cómo se comprobó el código: cada script de esta página pasa el verificador de tipos estricto de Luau con las definiciones de la API de Roblox (luau-lsp, 12 de noviembre de 2026). Una verificación de tipos detecta APIs mal escritas y tipos incorrectos, no la lógica del juego, así que pruébalo en Studio antes de publicar.

Prueba RoCode en tu propio juego.

Créditos gratis cada día, sin tarjeta. Instala el plugin, describe la función y revisa lo que aparece en Studio.