Kort fortalt
Hent servicen med game:GetService("TweenService"), beskriv bevægelsen med TweenInfo.new(time, easingStyle, easingDirection), kald derefter TweenService:Create(part, info, { Position = goal }) og start det tween, du får, med :Play(). Du kan tweene enhver egenskab af typen number, Vector3, CFrame, Color3, UDim2 og lignende. Brug tween.Completed:Wait() for at vente på afslutningen, og til en bevægelse frem og tilbage uden ende sætter du antal gentagelser til -1 i TweenInfo og slår reverses til.
- Tween parten på serveren, når alle spillere skal se det; på klienten, når effekten kun er til den ene spiller.
- Gør de parts, du tweener, Anchored, ellers kommer fysikken i vejen for tweenet.
- En Model har ingen Position eller CFrame at tweene: tween en NumberValue og flyt modellen med
PivotTo.
På denne side
De tre linjer, hvert tween har brug for
Indsæt en Part i Workspace, sæt flueben i Anchored, hold derefter musen over den, klik på + og indsæt et Script. Dette script løfter parten 10 studs på 2 sekunder:
-- Script inde 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 tabel med egenskabsnavne og de værdier, de skal ende på. Du kan tweene flere egenskaber på én gang: { Position = ..., Transparency = 1, Color = Color3.fromRGB(255, 0, 0) }. Tweenet starter fra de værdier, der er i det øjeblik, Play kaldes, så du angiver altid kun slutningen.
| Type | Tweenes glidende? | 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 til sidst | CanCollide, Material |
| string, Instance | Nej | Giver fejlen cannot be tweened due to type mismatch |
Trin 1: alle indstillinger i TweenInfo
TweenInfo.new tager op til seks værdier i denne rækkefølge. De sidste kan udelades.
| Værdi | Standard | Hvad den gør |
|---|---|---|
time | 1 | Sekunder for én afspilning. |
easingStyle | Quad | Bevægelsens form: Linear (konstant fart), Sine, Quad, Cubic, Back (skyder over), Bounce, Elastic, Exponential. |
easingDirection | Out | Out starter hurtigt og bremser ned; In starter langsomt; InOut gør begge dele. |
repeatCount | 0 | Hvor mange gange der gentages efter første afspilning. -1 gentager uendeligt. |
reverses | false | Gå tilbage til starten efter hver afspilning. |
delayTime | 0 | Hvor mange sekunder der ventes før start. |
-- Script inde i en Part med navnet Platform.
-- Kører uendeligt frem og tilbage 12 studs, glidende i begge ender.
local TweenService = game:GetService("TweenService")
local platform = script.Parent :: BasePart
local info = TweenInfo.new(
3, -- sekunder i hver retning
Enum.EasingStyle.Sine,
Enum.EasingDirection.InOut,
-1, -- gentag uendeligt
true -- vend tilbage hver gang
)
TweenService:Create(platform, info, { Position = platform.Position + Vector3.new(12, 0, 0) }):Play()
Hvis platformen skal bære de spillere, der står på den, så husk: en anchored part med et tween bevæger sig under dem, men tager dem ikke med. Det tilfælde gennemgås i guiden til bevægelige platforme.
Trin 2: drejning, størrelse og fade
For at dreje en part tweener du CFrame til den nuværende CFrame ganget med en rotation. Et tween af Orientation virker også, men med CFrame drejer parten på stedet. Her drejer en væg, når scriptet starter, forsvinder derefter og skrumper, og når tweenet er færdigt, slettes den:
-- Script inde i en Part med navnet FadingWall.
local TweenService = game:GetService("TweenService")
local wall = script.Parent :: BasePart
-- drej en kvart omgang om sin egen lodrette 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() -- fortsæt først, når drejningen er færdig
-- fade derefter ud og skrump 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 udløses med en PlaybackState: Completed, hvis tweenet nåede målet, eller Cancelled, hvis tween:Cancel() stoppede det. Vent ikke på Completed fra et tween, der gentages uendeligt: det slutter aldrig.
Trin 3: en genstand, der svæver og drejer
To tweens i løkke på forskellige egenskaber kører samtidig. Et tween af en hel omgang på 360 grader via CFrame gør ingenting, fordi start og slut er den samme rotation, så drejningen tweener en NumberValue fra 0 til 360 og sætter CFrame ud fra den. Læg dette Script i en anchored part:
-- Script inde i en Part med navnet Gem. Svæver op og ned og drejer uendeligt.
local TweenService = game:GetService("TweenService")
local FLOAT_HEIGHT = 1.5 -- studs over stedet, hvor du placerede den
local FLOAT_SECONDS = 1.2 -- i hver retning
local SPIN_SECONDS = 3 -- én hel omgang
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()
Drejningen bruger Linear easing, så den drejer med konstant fart, og hver omgang starter igen ved 0, som er samme vinkel som 360, så der er intet ryk. Guiden til at samle mønter bygger den slags genstande ind i et spil.
Trin 4: tween en hel model
En Model har ingen egenskab Position eller CFrame, så TweenService:Create(model, ...) har intet at flytte. Tween i stedet en NumberValue fra 0 til 1, og flyt modellen med PivotTo, der flytter alle parts i den samlet:
-- Script inde i en Model med navnet Elevator.
-- Flytter hele modellen 20 studs op og tilbage, alle parts samlet.
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 alle modellens parts Anchored. Tallet 2 sidst i TweenInfo er pausen før hver afspilning, så elevatoren holder stille øverst og nederst. Guiden til døre åbner døre af flere parts på samme måde.
Server eller klient?
Et tween, der startes i et server-Script, ændrer parten på serveren, og de nye værdier replikeres til alle spillere, så alle ser det. Et tween i et LocalScript ændrer kun parten på den ene spillers skærm.
| Kør det i | Hvornår | Eksempel |
|---|---|---|
| Et server-Script | Ændringen betyder noget for spillet eller for alle. | Døre, bevægelige forhindringer, en bro, der folder sig ud |
| LocalScript | Kun den ene spiller skal se det, eller det er en ren visuel effekt. | En genstand, der forsvinder for den spiller, der samlede den op, UI |
Replikeringen sender opdateringer mange gange i sekundet, så servertweens ser glidende ud for de fleste spillere, men meget hurtige eller meget mange servertweens kan se mindre glidende ud på en langsom forbindelse. Til store mængder dekorativ bevægelse (hundredvis af mønter, der drejer) kører du tweens i et LocalScript på hver klient.
Almindelige fejl og løsninger
Åbn vinduet Output (menuen Window og derefter Output), før du trykker på Play.
Parten bevæger sig slet ikke
Tjek, at du har kaldt :Play() på tweenet, at egenskabens navn i målet er stavet præcist (Position, ikke position), og at det er et Script et sted, hvor scripts kører (inde i en part i Workspace eller i ServerScriptService).
Parten falder eller ryster under tweenet
Den er ikke anchored, så tyngdekraft og kollisioner forstyrrer tweenet. Sæt flueben i Anchored.
TweenService:Create property cannot be tweened due to type mismatch
Målværdien har den forkerte type, for eksempel et tal til en egenskab af typen Vector3. Se fejlsiden (på engelsk).
Unable to cast to Dictionary eller Unable to cast value to Object
Argumenterne står i forkert rækkefølge eller har forkert type. Rækkefølgen er altid Create(instance, tweenInfo, goalTable). Se Unable to cast value to Object (på engelsk).
Lav det med RoCode
Hvis du ikke har lyst til at skrive tweens i hånden, kan RoCode bygge dem i det place, du har åbent. RoCode er en uafhængig AI-agent til Roblox Studio, ikke fra Roblox: du beskriver ændringen i webchatten, og dens Studio-plugin opretter scripts i din Explorer, så du ikke skal sætte kode ind.
Få bromodellen i Workspace til at køre 15 studs til siden, når en runde starter, med et tween af en NumberValue og PivotTo, og fade samtidig de røde barriere-parts ud på 1 sekund.
- Kan finde de rigtige parts og modeller med Search Game, før den skriver noget
- Skriver Script med Create Script og er instrueret i at tjekke kompileringen med Check Script
- Sætter et fortryd-punkt før og efter hver omgang ændringer, så Ctrl+Z ruller én omgang tilbage ad gangen
Med plugin 3.9 eller nyere kan RoCode køre en kort playtest og læse fejl, men bevægelse vurderes nemmest med egne øjne, så tryk på Play og se efter. Sådan forbinder RoCode til Studio.
Ofte stillede spørgsmål
Hvordan bruger man TweenService i Roblox?
Hent servicen, opret en TweenInfo, kald TweenService:Create(object, info, { Property = goal }), og start resultatet med :Play(). Første afsnit har et eksempel på tre linjer.
Hvordan får man et tween til at køre i løkke for altid?
Giv -1 som fjerde værdi i TweenInfo.new (repeatCount) og true som femte, hvis det skal gå frem og tilbage.
Hvordan venter man på, at et tween er færdigt?
Kald tween.Completed:Wait() efter tween:Play(), eller forbind en funktion til tween.Completed.
Kan man tweene en Model?
Ikke direkte. Tween en NumberValue fra 0 til 1, og kald ved hver ændring model:PivotTo(start:Lerp(goal, value)), som i trin 4.
Hvordan stopper man et tween?
Kald tween:Cancel() for at stoppe det og lade parten blive, hvor den er, eller tween:Pause() for senere at fortsætte med Play().
Kilder og videre læsning
- Roblox Creator Docs: TweenService (på engelsk). Create, hvilke typer der kan tweenes, og annullering
- 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-stile og -retninger vist med UI
- Roblox Creator Docs: PVInstance:PivotTo (på engelsk)
Sådan blev koden tjekket: hvert script på denne side gennemgår streng Luau-typekontrol med Roblox API-definitionerne (luau-lsp, 20. november 2026). Typekontrollen fanger fejl i API-navne og forkerte typer, men ikke fejl i spillogikken, så test alt i Studio, før du udgiver.