Tutorial · Basis van scripting

TweenService in Roblox: parts bewegen, draaien en laten verdwijnen

Een tween verandert een eigenschap vloeiend van de huidige waarde naar een doel in een vaste tijd: een platform glijdt, een kristal draait, een muur lost op. TweenService berekent zelf de tussenstappen, dus je hoeft geen loop te schrijven die een part elk frame verschuift. In deze handleiding: de drie regels die elke tween nodig heeft, wat elke instelling van TweenInfo doet, parts bewegen, draaien en laten verdwijnen, loops, wachten tot een tween klaar is en een truc om een hele model (Model) te tweenen.

Bijgewerkt 20 november 20266 min lezenAuteur:

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
  1. Hoe het werkt
  2. 1. TweenInfo
  3. 2. Draaien en verdwijnen
  4. 3. Loops
  5. 4. Models
  6. Server of client
  7. Common errors
  8. Met RoCode
  9. Veelgestelde vragen
  10. Bronnen en verder lezen

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 in Workspace met de naam Rise
-- 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.

Wat je wel en niet kunt tweenen
TypeVloeiend te tweenen?Voorbeelden
numberJaTransparency, Reflectance, Value van een NumberValue
Vector3, CFrameJaPosition, Size, CFrame, Orientation
Color3JaColor
UDim2, Vector2JaSize en Position van GUI
boolean, EnumItemSpringt om aan het eindCanCollide, Material
string, InstanceNeeGeeft 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.

TweenInfo.new(time, style, direction, repeatCount, reverses, delayTime)
WaardeStandaardWat het doet
time1Seconden voor één keer afspelen.
easingStyleQuadVorm van de beweging: Linear (constante snelheid), Sine, Quad, Cubic, Back (schiet iets door), Bounce, Elastic, Exponential.
easingDirectionOutOut begint snel en remt af; In begint langzaam; InOut doet allebei.
repeatCount0Hoe vaak hij herhaalt na de eerste keer. -1 herhaalt eindeloos.
reversesfalseNa elke keer afspelen terug naar het begin.
delayTime0Hoeveel seconden hij wacht voordat hij start.
Script in een part in Workspace met de naam Platform
-- 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 in Workspace met de naam FadingWall
-- 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 in Workspace met de naam FloatingGem
-- 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 in Workspace met de naam Elevator
-- 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.

Waar je een tween start
Start inWanneerVoorbeeld
Server-ScriptDe verandering is belangrijk voor de game of voor iedereen.Deuren, bewegende obstakels, een brug die uitklapt
LocalScriptAlleen 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.

Jij typt

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.

RoCode doet
  • 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

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.

Probeer RoCode in je eigen game.

Elke dag gratis credits, geen creditcard nodig. Installeer de plugin, beschrijf een functie en kijk wat er in Studio verschijnt.