I korthet
Hämta tjänsten med game:GetService("TweenService"), beskriv rörelsen med TweenInfo.new(time, easingStyle, easingDirection), anropa sedan TweenService:Create(part, info, { Position = goal }) och kör :Play() på tweenen du får tillbaka. Du kan tweena vilken egenskap som helst av typen number, Vector3, CFrame, Color3, UDim2 och liknande. För att vänta tills den är klar använder du tween.Completed:Wait(), och för en rörelse fram och tillbaka utan slut sätter du antalet upprepningar till -1 i TweenInfo och slår på reverses.
- Tweena en part på servern när alla spelare ska se den; på klienten när effekten bara behövs för den spelaren.
- Gör parts som du tweenar Anchored, annars stör fysiken tweenen.
- En Model har ingen Position eller CFrame att tweena: tweena ett NumberValue och flytta modellen med
PivotTo.
På den här sidan
De tre rader som varje tween behöver
Lägg in en Part i Workspace, kryssa i Anchored, för sedan muspekaren över den, klicka på + och lägg in ett Script. Det här skriptet lyfter parten 10 studs på 2 sekunder:
-- Script inuti 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 är en tabell med egenskapsnamn och de värden de ska sluta på. Du kan tweena flera egenskaper samtidigt: { Position = ..., Transparency = 1, Color = Color3.fromRGB(255, 0, 0) }. Tweenen startar från de värden som finns när Play anropas, så du anger alltid bara slutet.
| Typ | Tweenas mjukt? | Exempel |
|---|---|---|
| number | Ja | Transparency, Reflectance, Value på ett NumberValue |
| Vector3, CFrame | Ja | Position, Size, CFrame, Orientation |
| Color3 | Ja | Color |
| UDim2, Vector2 | Ja | Size och Position på GUI |
| boolean, EnumItem | Växlar i slutet | CanCollide, Material |
| string, Instance | Nej | Ger felet cannot be tweened due to type mismatch |
Steg 1: alla inställningar i TweenInfo
TweenInfo.new tar upp till sex värden i den här ordningen. De sista kan du utelämna.
| Värde | Standard | Vad det gör |
|---|---|---|
time | 1 | Sekunder för en uppspelning. |
easingStyle | Quad | Rörelsens form: Linear (konstant hastighet), Sine, Quad, Cubic, Back (skjuter förbi), Bounce, Elastic, Exponential. |
easingDirection | Out | Out börjar snabbt och saktar in; In börjar långsamt; InOut gör båda. |
repeatCount | 0 | Hur många gånger den upprepas efter första uppspelningen. -1 upprepar för evigt. |
reverses | false | Gå tillbaka till början efter varje uppspelning. |
delayTime | 0 | Hur många sekunder den väntar innan den startar. |
-- Script inuti en Part med namnet Platform.
-- Åker fram och tillbaka 12 studs för evigt, mjukt i båda ändarna.
local TweenService = game:GetService("TweenService")
local platform = script.Parent :: BasePart
local info = TweenInfo.new(
3, -- sekunder åt varje håll
Enum.EasingStyle.Sine,
Enum.EasingDirection.InOut,
-1, -- upprepa för evigt
true -- vänd tillbaka varje gång
)
TweenService:Create(platform, info, { Position = platform.Position + Vector3.new(12, 0, 0) }):Play()
Om plattformen ska bära spelare som står på den, tänk på att en tweenad Anchored-part rör sig under dem men inte tar med dem. Det fallet går vi igenom i guiden om rörliga plattformar.
Steg 2: rotation, storlek och uttoning
För att vrida en part tweenar du CFrame mot den nuvarande CFrame multiplicerad med en rotation. Att tweena Orientation fungerar också, men med CFrame vrids parten på stället. Här vrids en vägg när skriptet startar, tonas sedan bort och krymper, och tas bort när tweenen är klar:
-- Script inuti en Part med namnet FadingWall.
local TweenService = game:GetService("TweenService")
local wall = script.Parent :: BasePart
-- vrid ett kvarts varv runt sin egen lodräta axel 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() -- fortsätt först när vridningen är klar
-- tona sedan ut och krymp samtidigt
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 ett PlaybackState: Completed om tweenen nådde målet, eller Cancelled om den stoppades av tween:Cancel(). Vänta inte på Completed för en tween som upprepas för evigt: den blir aldrig klar.
Steg 3: ett svävande, snurrande föremål
Två loopade tweens på olika egenskaper körs samtidigt. En tween av ett helt varv på 360 grader via CFrame gör ingenting, eftersom start och slut är samma rotation, så snurret tweenar ett NumberValue från 0 till 360 och sätter CFrame utifrån det. Lägg det här Script i en Anchored-part:
-- Script inuti en Part med namnet Gem. Svävar upp och ner och snurrar för evigt.
local TweenService = game:GetService("TweenService")
local FLOAT_HEIGHT = 1.5 -- studs ovanför där du placerade den
local FLOAT_SECONDS = 1.2 -- åt varje håll
local SPIN_SECONDS = 3 -- ett helt varv
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()
Snurret använder Linear easing, så det roterar med konstant hastighet, och varje varv börjar om från 0, som är samma vinkel som 360, så det blir inget ryck. Guiden om att samla mynt bygger in sådana föremål i ett spel.
Steg 4: tweena en hel modell
En Model har ingen egenskap Position eller CFrame, så TweenService:Create(model, ...) har inget att flytta. Tweena i stället ett NumberValue från 0 till 1 och flytta modellen med PivotTo, som flyttar alla parts i den tillsammans:
-- Script inuti en Model med namnet Elevator.
-- Flyttar hela modellen 20 studs upp och tillbaka, alla parts tillsammans.
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()
Gör alla parts i modellen Anchored. Tvåan i slutet av TweenInfo är en fördröjning före varje uppspelning, så hissen stannar uppe och nere. Guiden om dörrar öppnar dörrar av flera parts på samma sätt.
Server eller klient?
En tween som körs i ett Script på servern ändrar parten på servern, och de nya värdena replikeras till alla spelare, så alla ser den. En tween i ett LocalScript ändrar parten bara på den spelarens skärm.
| Kör i | När | Exempel |
|---|---|---|
| Script på servern | Ändringen spelar roll för spelet eller för alla. | Dörrar, rörliga hinder, en bro som fälls ut |
| LocalScript | Bara den spelaren ska se det, eller det är en ren visuell effekt. | Ett föremål som tonas bort för spelaren som plockade upp det, UI |
Replikeringen skickar uppdateringar många gånger per sekund, så tweens på servern ser mjuka ut för de flesta spelare, men mycket snabba eller väldigt många tweens på servern kan se mindre mjuka ut på en långsam anslutning. För mycket dekorativ rörelse (hundratals snurrande mynt) kör du tweens i ett LocalScript på varje klient.
Vanliga fel och lösningar
Öppna fönstret Output (menyn Window, sedan Output) innan du trycker på Play.
Parten rör sig inte alls
Kontrollera att du anropade :Play() på tweenen, att egenskapsnamnet i målet är exakt rätt stavat (Position, inte position) och att det är ett Script på ett ställe där skript körs (inuti en part i Workspace eller i ServerScriptService).
Parten faller eller skakar under tweenen
Den är inte Anchored, så gravitation och kollisioner stör tweenen. Kryssa i Anchored.
TweenService:Create property cannot be tweened due to type mismatch
Målvärdet har fel typ, till exempel ett tal för en egenskap av typen Vector3. Se sidan om felet (på engelska).
Unable to cast to Dictionary eller Unable to cast value to Object
Argumenten är i fel ordning eller har fel typ. Ordningen är alltid Create(instance, tweenInfo, goalTable). Se Unable to cast value to Object (på engelska).
Gör det med RoCode
Om du inte vill skriva tweens för hand kan RoCode bygga dem i din öppna place. RoCode är en oberoende AI-agent för Roblox Studio, inte från Roblox: du beskriver ändringen i webbchatten, och dess Studio-plugin skapar skripten i din Explorer, så du behöver inte klistra in någon kod.
Få bromodellen i Workspace att glida 15 studs åt sidan när rundan börjar, med en tween av ett NumberValue och PivotTo, och tona samtidigt ut de röda barriärparts på 1 sekund.
- Kan hitta rätt parts och modeller med Search Game innan den skriver något
- Skriver Script med Create Script, och den är instruerad att kontrollera att det kompilerar med Check Script
- Sätter en ångrapunkt före och efter varje omgång ändringar, så Ctrl+Z ångrar en omgång i taget
Med plugin 3.9 eller senare kan RoCode köra ett kort speltest och läsa felen, men rörelse bedömer du enklast med egna ögon, så tryck på Play och titta. Så ansluter RoCode till Studio.
Vanliga frågor
Hur använder man TweenService i Roblox?
Hämta tjänsten, skapa ett TweenInfo, anropa TweenService:Create(object, info, { Property = goal }) och kör :Play() på resultatet. I första avsnittet finns ett exempel på tre rader.
Hur loopar jag en tween för evigt?
Skicka -1 som fjärde värde till TweenInfo.new (repeatCount) och true som femte om den ska gå fram och tillbaka.
Hur väntar jag tills en tween är klar?
Anropa tween.Completed:Wait() efter tween:Play(), eller koppla en funktion till tween.Completed.
Kan man tweena en Model?
Inte direkt. Tweena ett NumberValue från 0 till 1 och anropa model:PivotTo(start:Lerp(goal, value)) vid varje ändring, som i steg 4.
Hur stoppar jag en tween?
Anropa tween:Cancel() för att stoppa den och lämna parten där den är, eller tween:Pause() för att fortsätta senare med Play().
Källor och vidare läsning
- Roblox Creator Docs: TweenService (på engelska). Create, vilka typer som kan tweenas och avbrott
- Roblox Creator Docs: TweenInfo (på engelska)
- Roblox Creator Docs: Tween (på engelska). Play, Pause, Cancel och Completed
- Roblox Creator Docs: UI animation and tweens (på engelska). easing-stilar och riktningar med UI som exempel
- Roblox Creator Docs: PVInstance:PivotTo (på engelska)
Så kontrollerades koden: varje skript på den här sidan klarar strikt Luau-typkontroll mot Roblox API-definitionerna (luau-lsp, 20 november 2026). Typkontrollen fångar felstavade API-namn och fel typer, men inte fel i spellogiken, så testa allt i Studio innan du publicerar.