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
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 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.
| Tipo | ¿Cambia de forma suave? | Ejemplos |
|---|---|---|
| number | Sí | Transparency, Reflectance, el Value de un NumberValue |
| Vector3, CFrame | Sí | Position, Size, CFrame, Orientation |
| Color3 | Sí | Color |
| UDim2, Vector2 | Sí | Size y Position de una GUI |
| boolean, EnumItem | Cambia al final | CanCollide, Material |
| string, Instance | No | Da 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.
| Valor | Por defecto | Qué hace |
|---|---|---|
time | 1 | Segundos de una reproducción. |
easingStyle | Quad | La forma del movimiento: Linear (velocidad constante), Sine, Quad, Cubic, Back (se pasa y vuelve), Bounce, Elastic, Exponential. |
easingDirection | Out | Out empieza rápido y frena; In empieza lento; InOut hace las dos cosas. |
repeatCount | 0 | Reproducciones extra después de la primera. -1 repite para siempre. |
reverses | false | Vuelve al inicio después de cada reproducción. |
delayTime | 0 | Segundos de espera antes de empezar. |
-- 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 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 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 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.
| Reprodúcelo en | Cuándo | Ejemplo |
|---|---|---|
| Un Script de servidor | El cambio importa para el juego o para todos. | Puertas, obstáculos móviles, un puente que se abre |
| Un LocalScript | Solo 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.
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.
- 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
- Roblox Creator Docs: TweenService (en inglés). Create, tipos que admiten tween y cancelar
- Roblox Creator Docs: TweenInfo (en inglés)
- Roblox Creator Docs: Tween (en inglés). Play, Pause, Cancel y Completed
- Roblox Creator Docs: UI animation and tweens (en inglés). estilos y direcciones de easing, mostrados en UI
- Roblox Creator Docs: PVInstance:PivotTo (en inglés)
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.