Tutorial · Grunnleggende scripting

TweenService i Roblox: flytt, roter og skjul parts

En tween endrer en egenskap jevnt fra nåværende verdi til et mål i løpet av en gitt tid: en plattform glir, en krystall roterer, en vegg forsvinner. TweenService regner ut stegene imellom selv, så du slipper å skrive en løkke som flytter parten hver frame. I denne guiden: de tre linjene ingen tween klarer seg uten, hva hver innstilling i TweenInfo gjør, flytting, rotasjon og fading av parts, løkker, venting til en tween er ferdig, og et triks for å tweene en hel modell (Model).

Oppdatert 20. november 20266 min lesingSkrevet av

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
  1. Slik fungerer det
  2. 1. TweenInfo
  3. 2. Rotasjon og fading
  4. 3. Løkker
  5. 4. Modeller
  6. Server eller klient
  7. Common errors
  8. Med RoCode
  9. Ofte stilte spørsmål
  10. Kilder og videre lesing

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 i en part i Workspace med navnet Rise
-- 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.

Hva som kan og ikke kan tweenes
TypeTweenes jevnt?Eksempler
numberJaTransparency, Reflectance, Value på en NumberValue
Vector3, CFrameJaPosition, Size, CFrame, Orientation
Color3JaColor
UDim2, Vector2JaSize og Position på GUI
boolean, EnumItemSkifter på sluttenCanCollide, Material
string, InstanceNeiGir 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.

TweenInfo.new(time, style, direction, repeatCount, reverses, delayTime)
VerdiStandardHva den gjør
time1Sekunder per avspilling.
easingStyleQuadFormen på bevegelsen: Linear (konstant fart), Sine, Quad, Cubic, Back (skyter litt over), Bounce, Elastic, Exponential.
easingDirectionOutOut starter raskt og bremser ned; In starter sakte; InOut gjør begge deler.
repeatCount0Hvor mange ganger den gjentas etter første avspilling. -1 gjentar uendelig.
reversesfalseGå tilbake til start etter hver avspilling.
delayTime0Hvor mange sekunder den venter før start.
Script i en part i Workspace med navnet Platform
-- 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 i en part i Workspace med navnet FadingWall
-- 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 i en part i Workspace med navnet FloatingGem
-- 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 i en modell i Workspace med navnet Elevator
-- 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.

Hvor du starter tweenen
Start iNårEksempel
Et Script på serverenEndringen betyr noe for spillet eller for alle.Dører, bevegelige hindringer, en bro som foldes ut
LocalScriptBare 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.

Du skriver

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.

RoCode gjør
  • 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

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.

Prøv RoCode i ditt eget spill.

Gratis credits hver dag, uten kort. Installer pluginen, beskriv en funksjon og se hva som dukker opp i Studio.