Kort fortalt
Hent tjenesten med game:GetService("TweenService"), beskriv bevegelsen med TweenInfo.new(time, easingStyle, easingDirection), kall så TweenService:Create(part, info, { Position = goal }) og start den med :Play() på tweenen du får tilbake. Du kan tweene alle egenskaper av typen number, Vector3, CFrame, Color3, UDim2 og lignende. For å vente til den er ferdig bruker du tween.Completed:Wait(), og for bevegelse frem og tilbake uten stopp setter du antall gjentakelser til -1 i TweenInfo og slår på reverses.
- Tween parten på serveren når alle spillere skal se den, og på klienten når effekten bare gjelder denne spilleren.
- Gjør parts du tweener Anchored, ellers vil fysikken forstyrre tweenen.
- En Model har ingen Position eller CFrame å tweene: tween en NumberValue og flytt modellen med
PivotTo.
På denne siden
De tre linjene hver tween trenger
Sett inn en Part i Workspace, huk av Anchored, hold så musepekeren over den, klikk på + og sett inn et Script. Dette skriptet løfter parten 10 studs på 2 sekunder:
-- Script inne i en Part.
local TweenService = game:GetService("TweenService")
local part = script.Parent :: BasePart
local info = TweenInfo.new(2) -- 2 sekunder, standard easing
local goal = { Position = part.Position + Vector3.new(0, 10, 0) }
local tween = TweenService:Create(part, info, goal)
tween:Play()
Målet er en tabell med egenskapsnavn og verdiene de skal ende på. Du kan tweene flere egenskaper samtidig: { Position = ..., Transparency = 1, Color = Color3.fromRGB(255, 0, 0) }. Tweenen starter fra verdiene som gjelder i det øyeblikket du kaller Play, så du oppgir alltid bare sluttpunktet.
| Type | Tweenes jevnt? | Eksempler |
|---|---|---|
| number | Ja | Transparency, Reflectance, Value på en NumberValue |
| Vector3, CFrame | Ja | Position, Size, CFrame, Orientation |
| Color3 | Ja | Color |
| UDim2, Vector2 | Ja | Size og Position på GUI |
| boolean, EnumItem | Skifter på slutten | CanCollide, Material |
| string, Instance | Nei | Gir feilen cannot be tweened due to type mismatch |
Steg 1: alle innstillingene i TweenInfo
TweenInfo.new tar opptil seks verdier i denne rekkefølgen. De siste kan du utelate.
| Verdi | Standard | Hva den gjør |
|---|---|---|
time | 1 | Sekunder per avspilling. |
easingStyle | Quad | Formen på bevegelsen: Linear (konstant fart), Sine, Quad, Cubic, Back (skyter litt over), Bounce, Elastic, Exponential. |
easingDirection | Out | Out starter raskt og bremser ned; In starter sakte; InOut gjør begge deler. |
repeatCount | 0 | Hvor mange ganger den gjentas etter første avspilling. -1 gjentar uendelig. |
reverses | false | Gå tilbake til start etter hver avspilling. |
delayTime | 0 | Hvor mange sekunder den venter før start. |
-- Script inne i en Part med navnet Platform.
-- Kjører uendelig frem og tilbake 12 studs, jevnt i begge ender.
local TweenService = game:GetService("TweenService")
local platform = script.Parent :: BasePart
local info = TweenInfo.new(
3, -- sekunder hver vei
Enum.EasingStyle.Sine,
Enum.EasingDirection.InOut,
-1, -- gjenta uendelig
true -- gå tilbake hver gang
)
TweenService:Create(platform, info, { Position = platform.Position + Vector3.new(12, 0, 0) }):Play()
Hvis plattformen skal frakte spillere som står på den, må du vite dette: en anchored part med tween beveger seg under dem, men tar dem ikke med seg. Det tilfellet er forklart i guiden om bevegelige plattformer.
Steg 2: rotasjon, størrelse og fading
For å rotere en part tweener du CFrame mot nåværende CFrame ganget med en rotasjon. Å tweene Orientation fungerer også, men med CFrame roterer parten på stedet. Her roterer veggen når skriptet starter, så fader den ut og krymper, og etter at tweenen er ferdig blir den slettet:
-- Script inne i en Part med navnet FadingWall.
local TweenService = game:GetService("TweenService")
local wall = script.Parent :: BasePart
-- en kvart omdreining rundt sin egen loddrette akse på 1 sekund
local turn = TweenService:Create(wall, TweenInfo.new(1), {
CFrame = wall.CFrame * CFrame.Angles(0, math.rad(90), 0),
})
turn:Play()
turn.Completed:Wait() -- fortsetter først når rotasjonen er ferdig
-- fader så ut og krymper samtidig
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 utløses med en PlaybackState: Completed hvis tweenen nådde målet, eller Cancelled hvis den ble stoppet av tween:Cancel(). Ikke vent på Completed for en tween som gjentas uendelig: den blir aldri ferdig.
Steg 3: en gjenstand som svever og roterer
To tweens i løkke på forskjellige egenskaper kjører samtidig. En tween av en hel omdreining på 360 grader via CFrame gjør ingenting, fordi start og slutt er den samme rotasjonen, så rotasjonen tweener en NumberValue fra 0 til 360 og setter CFrame ut fra den. Legg dette Script i en anchored part:
-- Script inne i en Part med navnet Gem. Svever opp og ned og roterer uendelig.
local TweenService = game:GetService("TweenService")
local FLOAT_HEIGHT = 1.5 -- studs over stedet der du plasserte den
local FLOAT_SECONDS = 1.2 -- hver vei
local SPIN_SECONDS = 3 -- én hel omdreining
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()
Rotasjonen bruker Linear easing, så den snurrer med konstant fart, og hver runde starter på nytt fra 0, som er samme vinkel som 360, så det blir ikke noe rykk. Guiden om å samle mynter bygger slike gjenstander inn i et spill.
Steg 4: tween en hel modell
En Model har ingen egenskap Position eller CFrame, så TweenService:Create(model, ...) har ingenting å flytte. Tween i stedet en NumberValue fra 0 til 1 og flytt modellen med PivotTo, som flytter alle parts i den samtidig:
-- Script inne i en Model med navnet Elevator.
-- Flytter hele modellen 20 studs opp og tilbake, alle parts sammen.
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()
Gjør alle parts i modellen Anchored. Tallet 2 sist i TweenInfo er pausen før hver avspilling, så heisen står stille øverst og nederst. Guiden om dører åpner dører av flere parts på samme måte.
Server eller klient?
En tween som startes i et Script på serveren endrer parten på serveren, og de nye verdiene replikeres til alle spillere, så alle ser den. En tween i et LocalScript endrer parten bare på skjermen til denne spilleren.
| Start i | Når | Eksempel |
|---|---|---|
| Et Script på serveren | Endringen betyr noe for spillet eller for alle. | Dører, bevegelige hindringer, en bro som foldes ut |
| LocalScript | Bare denne spilleren skal se det, eller det er en ren visuell effekt. | En gjenstand som fader ut for spilleren som plukket den opp, UI |
Replikering sender oppdateringer mange ganger i sekundet, så tweens på serveren ser jevne ut for de fleste spillere, men svært raske eller svært mange tweens på serveren kan se mindre jevne ut på en treg tilkobling. Til mye dekorativ bevegelse (hundrevis av mynter som snurrer) starter du tweens i et LocalScript på hver klient.
Vanlige feil og løsninger
Åpne Output-vinduet (menyen Window, deretter Output) før du trykker Play.
Parten beveger seg ikke i det hele tatt
Sjekk at du kalte :Play() på tweenen, at egenskapsnavnet i målet er skrevet helt riktig (Position, ikke position), og at det er et Script på et sted der skript kjører (inne i en part i Workspace eller i ServerScriptService).
Parten faller eller rister under tweenen
Den er ikke anchored, så tyngdekraft og kollisjoner forstyrrer tweenen. Huk av Anchored.
TweenService:Create property cannot be tweened due to type mismatch
Målverdien har feil type, for eksempel et tall for en egenskap av typen Vector3. Se feilsiden (på engelsk).
Unable to cast to Dictionary eller Unable to cast value to Object
Argumentene står i feil rekkefølge eller har feil type. Rekkefølgen er alltid Create(instance, tweenInfo, goalTable). Se Unable to cast value to Object (på engelsk).
Gjør det med RoCode
Hvis du ikke vil skrive tweens for hånd, kan RoCode sette dem opp i placen du har åpen. RoCode er en uavhengig AI-agent for Roblox Studio, ikke laget av Roblox: du beskriver endringen i en webchat, og pluginen for Studio lager skriptene i Explorer for deg, så du slipper å lime inn kode.
Få bromodellen i Workspace til å gli 15 studs til siden når en runde starter, med en tween av en NumberValue og PivotTo, og fade samtidig ut de røde barriere-partene på 1 sekund.
- Kan finne de riktige partene og modellene med Search Game før den skriver noe
- Skriver et Script med Create Script, og er bedt om å sjekke at det kompilerer med Check Script
- Setter et angrepunkt før og etter hver pakke med endringer, så Ctrl+Z ruller tilbake én pakke om gangen
Med plugin 3.9 eller nyere kan RoCode kjøre en kort playtest og lese feilene, men bevegelse er lettest å vurdere med egne øyne, så trykk Play og se. Slik kobler RoCode seg til Studio.
Ofte stilte spørsmål
Hvordan bruker man TweenService i Roblox?
Hent tjenesten, lag en TweenInfo, kall TweenService:Create(object, info, { Property = goal }) og start resultatet med :Play(). Første del har et eksempel på tre linjer.
Hvordan får jeg en tween til å gå i løkke for alltid?
Gi -1 som fjerde verdi i TweenInfo.new (repeatCount) og true som femte hvis den skal gå frem og tilbake.
Hvordan venter jeg til en tween er ferdig?
Kall tween.Completed:Wait() etter tween:Play(), eller koble en funksjon til tween.Completed.
Kan jeg tweene en Model?
Ikke direkte. Tween en NumberValue fra 0 til 1 og kall model:PivotTo(start:Lerp(goal, value)) ved hver endring, som i steg 4.
Hvordan stopper jeg en tween?
Kall tween:Cancel() for å stoppe den og la parten bli der den er, eller tween:Pause() for å fortsette senere med Play().
Kilder og videre lesing
- Roblox Creator Docs: TweenService (på engelsk). Create, hvilke typer som kan tweenes, og avbryting
- Roblox Creator Docs: TweenInfo (på engelsk)
- Roblox Creator Docs: Tween (på engelsk). Play, Pause, Cancel og Completed
- Roblox Creator Docs: UI animation and tweens (på engelsk). easing-stiler og -retninger vist med UI
- Roblox Creator Docs: PVInstance:PivotTo (på engelsk)
Slik ble koden sjekket: hvert skript på denne siden går gjennom streng Luau-typesjekk med Roblox API-definisjonene (luau-lsp, 20. november 2026). Typesjekken fanger feil i API-navn og feil typer, men ikke feil i spillogikken, så test alt i Studio før du publiserer.