In het kort
Haal de service op met game:GetService("TweenService"), beschrijf de beweging met TweenInfo.new(time, easingStyle, easingDirection), roep dan TweenService:Create(part, info, { Position = goal }) aan en start de tween die je terugkrijgt met :Play(). Je kunt elke eigenschap van het type number, Vector3, CFrame, Color3, UDim2 en vergelijkbare tweenen. Om te wachten tot hij klaar is gebruik je tween.Completed:Wait(), en voor eindeloos heen en weer bewegen zet je in TweenInfo het aantal herhalingen op -1 en zet je reverses aan.
- Tween een part op de server als alle spelers hem moeten zien; op de client als het effect alleen voor die ene speler is.
- Zet parts die je tweent op Anchored, anders zit de physics de tween in de weg.
- Een Model heeft geen Position of CFrame om te tweenen: tween een NumberValue en verplaats de model met
PivotTo.
Op deze pagina
De drie regels die elke tween nodig heeft
Voeg een Part toe aan Workspace, vink Anchored aan, beweeg dan je muis erover, klik op + en voeg een Script toe. Dit script tilt de part in 2 seconden 10 studs omhoog:
-- Script in een Part.
local TweenService = game:GetService("TweenService")
local part = script.Parent :: BasePart
local info = TweenInfo.new(2) -- 2 seconden, standaard easing
local goal = { Position = part.Position + Vector3.new(0, 10, 0) }
local tween = TweenService:Create(part, info, goal)
tween:Play()
Het doel is een tabel met namen van eigenschappen en de waarden waarop ze moeten eindigen. Je kunt meerdere eigenschappen tegelijk tweenen: { Position = ..., Transparency = 1, Color = Color3.fromRGB(255, 0, 0) }. De tween begint bij de waarden die er zijn op het moment dat je Play aanroept, dus je geeft altijd alleen het eindpunt op.
| Type | Vloeiend te tweenen? | Voorbeelden |
|---|---|---|
| number | Ja | Transparency, Reflectance, Value van een NumberValue |
| Vector3, CFrame | Ja | Position, Size, CFrame, Orientation |
| Color3 | Ja | Color |
| UDim2, Vector2 | Ja | Size en Position van GUI |
| boolean, EnumItem | Springt om aan het eind | CanCollide, Material |
| string, Instance | Nee | Geeft de fout cannot be tweened due to type mismatch |
Stap 1: alle instellingen van TweenInfo
TweenInfo.new neemt tot zes waarden in deze volgorde. De laatste mag je weglaten.
| Waarde | Standaard | Wat het doet |
|---|---|---|
time | 1 | Seconden voor één keer afspelen. |
easingStyle | Quad | Vorm van de beweging: Linear (constante snelheid), Sine, Quad, Cubic, Back (schiet iets door), Bounce, Elastic, Exponential. |
easingDirection | Out | Out begint snel en remt af; In begint langzaam; InOut doet allebei. |
repeatCount | 0 | Hoe vaak hij herhaalt na de eerste keer. -1 herhaalt eindeloos. |
reverses | false | Na elke keer afspelen terug naar het begin. |
delayTime | 0 | Hoeveel seconden hij wacht voordat hij start. |
-- Script in een Part met de naam Platform.
-- Rijdt eindeloos 12 studs heen en weer, vloeiend aan beide kanten.
local TweenService = game:GetService("TweenService")
local platform = script.Parent :: BasePart
local info = TweenInfo.new(
3, -- seconden per richting
Enum.EasingStyle.Sine,
Enum.EasingDirection.InOut,
-1, -- eindeloos herhalen
true -- elke keer teruggaan
)
TweenService:Create(platform, info, { Position = platform.Position + Vector3.new(12, 0, 0) }):Play()
Moet het platform spelers die erop staan meenemen, let dan op: een geanchorde part met een tween beweegt onder ze door, maar neemt ze niet mee. Dat geval staat in de handleiding over een bewegend platform.
Stap 2: draaien, grootte en verdwijnen
Om een part te draaien tween je CFrame naar de huidige CFrame vermenigvuldigd met een rotatie. Een tween op Orientation werkt ook, maar met CFrame draait de part op zijn plek. Hier draait een muur bij het starten van het script, lost daarna op en krimpt, en wordt verwijderd zodra de tween klaar is:
-- Script in een Part met de naam FadingWall.
local TweenService = game:GetService("TweenService")
local wall = script.Parent :: BasePart
-- een kwartslag om de eigen verticale as in 1 seconde
local turn = TweenService:Create(wall, TweenInfo.new(1), {
CFrame = wall.CFrame * CFrame.Angles(0, math.rad(90), 0),
})
turn:Play()
turn.Completed:Wait() -- pas verder als het draaien klaar is
-- daarna tegelijk laten oplossen en krimpen
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 gaat af met een PlaybackState: Completed als de tween zijn doel heeft bereikt, of Cancelled als tween:Cancel() hem heeft gestopt. Wacht niet op Completed van een tween die eindeloos herhaalt: die wordt nooit klaar.
Stap 3: een zwevend en draaiend voorwerp
Twee tweens in een loop op verschillende eigenschappen lopen tegelijk. Een tween van een volle draai van 360 graden via CFrame doet niets, omdat begin en eind dezelfde rotatie zijn, dus het draaien tweent een NumberValue van 0 naar 360 en zet de CFrame op basis daarvan. Zet dit Script in een geanchorde part:
-- Script in een Part met de naam Gem. Zweeft eindeloos op en neer en draait.
local TweenService = game:GetService("TweenService")
local FLOAT_HEIGHT = 1.5 -- studs boven de plek waar je hem neerzette
local FLOAT_SECONDS = 1.2 -- per richting
local SPIN_SECONDS = 3 -- één volle draai
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()
Het draaien gebruikt Linear easing, dus hij draait met een constante snelheid, en elke ronde begint weer bij 0, wat dezelfde hoek is als 360, dus er is geen schok. De handleiding over munten verzamelen bouwt zulke voorwerpen in een game in.
Stap 4: een hele model tweenen
Een Model heeft geen eigenschap Position of CFrame, dus TweenService:Create(model, ...) heeft niets om te bewegen. Tween in plaats daarvan een NumberValue van 0 naar 1 en verplaats de model met PivotTo, dat alle parts erin samen verplaatst:
-- Script in een Model met de naam Elevator.
-- Beweegt de hele model 20 studs omhoog en terug, alle parts samen.
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()
Zet alle parts van de model op Anchored. De twee aan het eind van TweenInfo is de wachttijd voor elke keer afspelen, dus de lift blijft boven en onder even staan. De handleiding over deuren opent op dezelfde manier deuren die uit meerdere parts bestaan.
Server of client?
Een tween die in een server-Script start, verandert de part op de server, en de nieuwe waarden worden naar alle spelers gerepliceerd, dus iedereen ziet hem. Een tween in een LocalScript verandert de part alleen op het scherm van die speler.
| Start in | Wanneer | Voorbeeld |
|---|---|---|
| Server-Script | De verandering is belangrijk voor de game of voor iedereen. | Deuren, bewegende obstakels, een brug die uitklapt |
| LocalScript | Alleen die speler hoeft het te zien, of het is puur een visueel effect. | Een voorwerp dat oplost bij de speler die het oppakte, UI |
Replicatie stuurt vele keren per seconde updates, dus servertweens zien er voor de meeste spelers vloeiend uit, maar heel snelle of heel veel servertweens kunnen er bij een trage verbinding minder vloeiend uitzien. Voor veel decoratieve beweging (honderden draaiende munten) start je de tweens in een LocalScript op elke client.
Veelvoorkomende fouten en oplossingen
Open het venster Output (menu Window, dan Output) voordat je op Play drukt.
De part beweegt helemaal niet
Controleer of je :Play() op de tween hebt aangeroepen, of de naam van de eigenschap in het doel precies klopt (Position, niet position) en of het een Script is op een plek waar scripts draaien (in een part in Workspace of in ServerScriptService).
De part valt of trilt tijdens de tween
Hij is niet geanchord, dus zwaartekracht en botsingen zitten de tween in de weg. Vink Anchored aan.
TweenService:Create property cannot be tweened due to type mismatch
De doelwaarde heeft het verkeerde type, bijvoorbeeld een getal voor een eigenschap van het type Vector3. Zie de foutpagina (in het Engels).
Unable to cast to Dictionary of Unable to cast value to Object
De argumenten staan in de verkeerde volgorde of hebben het verkeerde type. De volgorde is altijd Create(instance, tweenInfo, goalTable). Zie Unable to cast value to Object (in het Engels).
Maken met RoCode
Heb je geen zin om tweens met de hand te schrijven, dan kan RoCode ze bouwen in de place die je open hebt. RoCode is een onafhankelijke AI-agent voor Roblox Studio, niet van Roblox: je beschrijft de wijziging in de webchat en de plugin voor Studio maakt de scripts in je Explorer, dus je hoeft geen code te plakken.
Laat de brugmodel in Workspace 15 studs opzij schuiven als de ronde begint, met een tween op een NumberValue en PivotTo, en laat tegelijk de rode barrièreparts in 1 seconde oplossen.
- Kan de juiste parts en models vinden met Search Game voordat het iets schrijft
- Schrijft het Script met Create Script en heeft de opdracht de compilatie te controleren met Check Script
- Zet een ongedaan-maakpunt voor en na elke reeks wijzigingen, dus Ctrl+Z draait telkens één reeks terug
Met plugin 3.9 of nieuwer kan RoCode een korte playtest draaien en de fouten lezen, maar beweging beoordeel je het makkelijkst met je eigen ogen, dus druk op Play en kijk. Hoe RoCode verbinding maakt met Studio.
Veelgestelde vragen
Hoe gebruik je TweenService in Roblox?
Haal de service op, maak een TweenInfo, roep TweenService:Create(object, info, { Property = goal }) aan en start het resultaat met :Play(). In het eerste onderdeel staat een voorbeeld van drie regels.
Hoe laat je een tween eindeloos herhalen?
Geef -1 als vierde waarde aan TweenInfo.new (repeatCount) en true als vijfde als hij heen en weer moet gaan.
Hoe wacht je tot een tween klaar is?
Roep tween.Completed:Wait() aan na tween:Play() of koppel een functie aan tween.Completed.
Kun je een Model tweenen?
Niet direct. Tween een NumberValue van 0 naar 1 en roep bij elke wijziging model:PivotTo(start:Lerp(goal, value)) aan, zoals in stap 4.
Hoe stop je een tween?
Roep tween:Cancel() aan om hem te stoppen en de part te laten waar hij is, of tween:Pause() om later verder te gaan met Play().
Bronnen en verder lezen
- Roblox Creator Docs: TweenService (in het Engels). Create, welke types te tweenen zijn en annuleren
- Roblox Creator Docs: TweenInfo (in het Engels)
- Roblox Creator Docs: Tween (in het Engels). Play, Pause, Cancel en Completed
- Roblox Creator Docs: UI animation and tweens (in het Engels). easingstijlen en -richtingen aan de hand van UI
- Roblox Creator Docs: PVInstance:PivotTo (in het Engels)
Hoe de code is gecontroleerd: elk script op deze pagina doorloopt een strikte Luau-typecontrole met de Roblox API-definities (luau-lsp, 20 november 2026). De typecontrole vangt fouten in API-namen en verkeerde types op, maar geen fouten in de gamelogica, dus test alles in Studio voordat je publiceert.