Guide · Grunder i skriptning

TweenService i Roblox: flytta, rotera och tona ut parts

En tween ändrar en egenskap mjukt från dess nuvarande värde till ett mål under en given tid: en plattform glider, en kristall snurrar, en vägg tonas bort. TweenService räknar själv ut stegen däremellan, så du behöver inte skriva en loop som flyttar parten varje bildruta. I den här guiden: de tre rader som varje tween behöver, vad varje inställning i TweenInfo gör, att flytta, rotera och tona ut parts, loopar, att vänta tills en tween är klar och knepet för att tweena en hel modell (Model).

Uppdaterad 20 november 20266 min läsningSkriven av

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
  1. Så fungerar det
  2. 1. TweenInfo
  3. 2. Rotation och uttoning
  4. 3. Loopar
  5. 4. Modeller
  6. Server eller klient
  7. Common errors
  8. Med RoCode
  9. Vanliga frågor
  10. Källor och vidare läsning

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 i Part i Workspace med namnet Rise
-- 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.

Vad som kan och inte kan tweenas
TypTweenas mjukt?Exempel
numberJaTransparency, Reflectance, Value på ett NumberValue
Vector3, CFrameJaPosition, Size, CFrame, Orientation
Color3JaColor
UDim2, Vector2JaSize och Position på GUI
boolean, EnumItemVäxlar i slutetCanCollide, Material
string, InstanceNejGer 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.

TweenInfo.new(time, style, direction, repeatCount, reverses, delayTime)
VärdeStandardVad det gör
time1Sekunder för en uppspelning.
easingStyleQuadRörelsens form: Linear (konstant hastighet), Sine, Quad, Cubic, Back (skjuter förbi), Bounce, Elastic, Exponential.
easingDirectionOutOut börjar snabbt och saktar in; In börjar långsamt; InOut gör båda.
repeatCount0Hur många gånger den upprepas efter första uppspelningen. -1 upprepar för evigt.
reversesfalseGå tillbaka till början efter varje uppspelning.
delayTime0Hur många sekunder den väntar innan den startar.
Script i Part i Workspace med namnet Platform
-- 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 i Part i Workspace med namnet FadingWall
-- 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 i Part i Workspace med namnet FloatingGem
-- 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 i Model i Workspace med namnet Elevator
-- 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.

Var du kör tweenen
Kör iNärExempel
Script på servernÄndringen spelar roll för spelet eller för alla.Dörrar, rörliga hinder, en bro som fälls ut
LocalScriptBara 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.

Du skriver

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.

RoCode gör
  • 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

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.

Testa RoCode i ditt eget spel.

Gratis krediter varje dag, inget kort krävs. Installera pluginet, beskriv en funktion och kontrollera vad som dök upp i Studio.