Röviden
Kérd le a szolgáltatást a game:GetService("TweenService") hívással, írd le a mozgást a TweenInfo.new(time, easingStyle, easingDirection) segítségével, aztán hívd meg a TweenService:Create(part, info, { Position = goal }) függvényt, és indítsd el a kapott tweent a :Play() hívással. Bármilyen number, Vector3, CFrame, Color3, UDim2 és hasonló típusú tulajdonság tweenelhető. A végének kivárásához használd a tween.Completed:Wait() hívást, a végtelen oda-vissza mozgáshoz pedig állítsd a TweenInfo ismétlésszámát -1-re, és kapcsold be a reverses opciót.
- A partot a szerveren tweeneld, ha minden játékosnak látnia kell; a kliensen, ha az effektus csak ennek a játékosnak kell.
- A tweenelt partokat rögzítsd (Anchored), különben a fizika belezavar a tweenbe.
- A Modelnek nincs tweenelhető Position vagy CFrame tulajdonsága: tweenelj egy NumberValue-t, és a modellt a
PivotTosegítségével mozgasd.
Ezen az oldalon
A három sor, amely minden tweenhez kell
Szúrj be egy Partot a Workspace-be, jelöld be az Anchored opciót, aztán vidd fölé az egeret, kattints a + gombra, és szúrj be egy Scriptet. Ez a script 2 másodperc alatt 10 studdal megemeli a partot:
-- Script egy Partban.
local TweenService = game:GetService("TweenService")
local part = script.Parent :: BasePart
local info = TweenInfo.new(2) -- 2 másodperc, alapértelmezett easing
local goal = { Position = part.Position + Vector3.new(0, 10, 0) }
local tween = TweenService:Create(part, info, goal)
tween:Play()
A cél egy táblázat a tulajdonságok neveivel és azokkal az értékekkel, amelyeken véget kell érniük. Egyszerre több tulajdonság is tweenelhető: { Position = ..., Transparency = 1, Color = Color3.fromRGB(255, 0, 0) }. A tween azokkal az értékekkel indul, amelyek a Play hívásakor vannak, ezért mindig csak a véget adod meg.
| Típus | Simán tweenelhető? | Példák |
|---|---|---|
| number | Igen | Transparency, Reflectance, a NumberValue Value tulajdonsága |
| Vector3, CFrame | Igen | Position, Size, CFrame, Orientation |
| Color3 | Igen | Color |
| UDim2, Vector2 | Igen | A GUI Size és Position tulajdonsága |
| boolean, EnumItem | A végén vált át | CanCollide, Material |
| string, Instance | Nem | A cannot be tweened due to type mismatch hibát adja |
1. lépés: A TweenInfo összes beállítása
A TweenInfo.new legfeljebb hat értéket fogad el ebben a sorrendben. Az utolsókat el lehet hagyni.
| Érték | Alapértelmezés | Mit csinál |
|---|---|---|
time | 1 | Egy lejátszás másodpercben. |
easingStyle | Quad | A mozgás alakja: Linear (állandó sebesség), Sine, Quad, Cubic, Back (túllövéssel), Bounce, Elastic, Exponential. |
easingDirection | Out | Az Out gyorsan indul és lelassul; az In lassan indul; az InOut mindkettőt csinálja. |
repeatCount | 0 | Hányszor ismétlődjön az első lejátszás után. A -1 végtelenül ismétel. |
reverses | false | Minden lejátszás után visszatér-e a kezdetre. |
delayTime | 0 | Hány másodpercet várjon indulás előtt. |
-- Script egy Platform nevű Partban.
-- Végtelenül megy oda-vissza 12 studnyit, mindkét végén simán.
local TweenService = game:GetService("TweenService")
local platform = script.Parent :: BasePart
local info = TweenInfo.new(
3, -- másodperc minden irányba
Enum.EasingStyle.Sine,
Enum.EasingDirection.InOut,
-1, -- végtelen ismétlés
true -- minden alkalommal visszatér
)
TweenService:Create(platform, info, { Position = platform.Position + Vector3.new(12, 0, 0) }):Play()
Ha a platformnak vinnie kell a rajta álló játékosokat, vedd figyelembe: a tweenelt rögzített part mozog alattuk, de nem viszi magával őket. Ezt az esetet a mozgó platform útmutató tárgyalja.
2. lépés: Forgatás, méret és eltüntetés
Egy part elforgatásához tweeneld a CFrame értékét a jelenlegi CFrame és egy forgatás szorzatára. Az Orientation tweenelése is működik, de CFrame-mel a part helyben fordul el. Itt a fal a script indulásakor elfordul, aztán elhalványul és összemegy, a tween vége után pedig törlődik:
-- Script egy FadingWall nevű Partban.
local TweenService = game:GetService("TweenService")
local wall = script.Parent :: BasePart
-- negyed fordulat a saját függőleges tengelye körül 1 másodperc alatt
local turn = TweenService:Create(wall, TweenInfo.new(1), {
CFrame = wall.CFrame * CFrame.Angles(0, math.rad(90), 0),
})
turn:Play()
turn.Completed:Wait() -- csak akkor folytatjuk, amikor a forgatás véget ért
-- aztán egyszerre elhalványítjuk és összezsugorítjuk
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()
A Completed egy PlaybackState értékkel sül el: Completed, ha a tween elérte a célt, vagy Cancelled, ha a tween:Cancel() leállította. Ne várd a Completed eseményt egy végtelenül ismétlődő tweennél: az soha nem ér véget.
3. lépés: Lebegő és forgó tárgy
Két ismétlődő tween különböző tulajdonságokon egyszerre fut. Egy teljes 360 fokos fordulat CFrame-mel tweenelve semmit sem csinál, mert a kezdet és a vég ugyanaz a forgatás, ezért a forgatás egy NumberValue-t tweenel 0-tól 360-ig, és ennek alapján állítja be a CFrame-et. Tedd ezt a Scriptet egy rögzített partba:
-- Script egy Gem nevű Partban. Végtelenül lebeg fel-le és forog.
local TweenService = game:GetService("TweenService")
local FLOAT_HEIGHT = 1.5 -- studdal feljebb annál a helynél, ahová tetted
local FLOAT_SECONDS = 1.2 -- minden irányba
local SPIN_SECONDS = 3 -- egy teljes fordulat
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()
A forgatás Linear easinget használ, ezért állandó sebességgel forog, és minden ciklus újra 0-ról indul, ami ugyanaz a szög, mint a 360, így nincs rántás. Az érmegyűjtés útmutató ilyen tárgyakat épít be a játékba.
4. lépés: Egy teljes modell tweenelése
A Modelnek nincs Position vagy CFrame tulajdonsága, ezért a TweenService:Create(model, ...) hívásnak nincs mit mozgatnia. Helyette tweenelj egy NumberValue-t 0-tól 1-ig, és a modellt a PivotTo segítségével mozgasd, amely a benne lévő összes partot együtt mozgatja:
-- Script egy Elevator nevű Modelben.
-- Az egész modellt 20 studdal felfelé és vissza mozgatja, az összes partot együtt.
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()
A modell minden partját rögzítsd. A TweenInfo végén lévő kettes a késleltetés minden lejátszás előtt, ezért a lift fent és lent is megáll. Az ajtó útmutató ugyanígy nyit ki több partból álló ajtókat.
Szerver vagy kliens?
Egy szerveroldali Scriptben indított tween a szerveren változtatja meg a partot, az új értékek pedig minden játékoshoz replikálódnak, ezért mindenki látja. Egy LocalScriptben indított tween csak ennek a játékosnak a képernyőjén változtatja meg a partot.
| Indítsd itt | Mikor | Példa |
|---|---|---|
| Szerveroldali Script | A változás fontos a játék vagy mindenki számára. | Ajtók, mozgó akadályok, kinyíló híd |
| LocalScript | Csak ennek a játékosnak kell látnia, vagy tisztán vizuális effektus. | Egy tárgy, amely elhalványul annál a játékosnál, aki felvette, UI |
A replikáció másodpercenként sokszor küld frissítéseket, ezért a szerveroldali tweenek a legtöbb játékosnak simának tűnnek, de a nagyon gyors vagy nagyon nagy számú szerveroldali tween lassú kapcsolaton kevésbé simának tűnhet. Sok díszítő mozgáshoz (több száz forgó érme) a tweeneket minden kliensen egy LocalScriptben indítsd.
Gyakori hibák és megoldásaik
Nyisd meg az Output ablakot (Window menü, majd Output), mielőtt megnyomod a Play gombot.
A part egyáltalán nem mozog
Ellenőrizd, hogy meghívtad-e a tween :Play() metódusát, hogy a célban a tulajdonság neve pontosan van-e írva (Position, nem position), és hogy Scriptről van-e szó olyan helyen, ahol a scriptek futnak (egy partban a Workspace-ben vagy a ServerScriptService-ben).
A part leesik vagy remeg a tween közben
Nincs rögzítve, ezért a gravitáció és az ütközések belezavarnak a tweenbe. Jelöld be az Anchored opciót.
TweenService:Create property cannot be tweened due to type mismatch
A célérték rossz típusú, például szám egy Vector3 típusú tulajdonsághoz. Lásd a hiba oldalát (angolul).
Unable to cast to Dictionary vagy Unable to cast value to Object
Az argumentumok rossz sorrendben vagy rossz típussal vannak megadva. A sorrend mindig Create(instance, tweenInfo, goalTable). Lásd: Unable to cast value to Object (angolul).
Elkészítés a RoCode-dal
Ha nincs kedved kézzel megírni a tweeneket, a RoCode összerakhatja őket a nálad nyitott place-ben. A RoCode egy független AI-ügynök a Roblox Studióhoz, nem a Robloxtól: a webes chatben leírod a módosítást, a Studio pluginja pedig létrehozza a scripteket az Explorerben, így semmit sem kell beillesztened.
Csináld meg, hogy a Workspace-ben lévő híd modell 15 studdal oldalra csússzon, amikor a kör elkezdődik, egy NumberValue tweenelésével és PivotTo-val, és közben 1 másodperc alatt halványítsd el a piros akadály partokat.
- Mielőtt bármit írna, a Search Game segítségével megkeresheti a szükséges partokat és modelleket
- A Create Script segítségével megírja a Scriptet, és utasítása szerint a Check Scripttel ellenőrzi a lefordulását
- Minden módosításcsomag előtt és után visszavonási pontot állít be, így a Ctrl+Z csomagonként vonja vissza a módosításokat
3.9-es vagy újabb pluginnal a RoCode rövid playtestet indíthat, és elolvashatja a hibákat, de a mozgást a legegyszerűbb a saját szemeddel megítélni, ezért nyomd meg a Play gombot, és nézd meg. Hogyan csatlakozik a RoCode a Studióhoz.
Gyakori kérdések
Hogyan használjam a TweenService-t a Robloxban?
Kérd le a szolgáltatást, hozz létre egy TweenInfo objektumot, hívd meg a TweenService:Create(object, info, { Property = goal }) függvényt, és indítsd el az eredményt a :Play() hívással. Az első részben van egy háromsoros példa.
Hogyan ismételhetek egy tweent örökké?
Adj át -1-et negyedik értékként a TweenInfo.new függvénynek (repeatCount), és true értéket ötödikként, ha oda-vissza kell mennie.
Hogyan várhatom meg egy tween végét?
Hívd meg a tween.Completed:Wait() függvényt a tween:Play() után, vagy kapcsolj egy függvényt a tween.Completed eseményhez.
Lehet Modelt tweenelni?
Közvetlenül nem. Tweenelj egy NumberValue-t 0-tól 1-ig, és minden változáskor hívd meg a model:PivotTo(start:Lerp(goal, value)) függvényt, ahogy a 4. lépésben.
Hogyan állíthatok le egy tweent?
Hívd meg a tween:Cancel() metódust, hogy leállítsd, és a part ott maradjon, ahol van, vagy a tween:Pause() metódust, hogy később a Play() hívással folytasd.
Források és további olvasnivaló
- Roblox Creator Docs: TweenService (angolul). Create, mely típusok tweenelhetők, és a megszakítás
- Roblox Creator Docs: TweenInfo (angolul)
- Roblox Creator Docs: Tween (angolul). Play, Pause, Cancel és Completed
- Roblox Creator Docs: UI animation and tweens (angolul). easing stílusok és irányok UI példán
- Roblox Creator Docs: PVInstance:PivotTo (angolul)
Hogyan ellenőriztük a kódot: az oldalon minden script átmegy a Luau szigorú típusellenőrzésén a Roblox API definícióival (luau-lsp, 2026. november 20.). A típusellenőrzés kiszűri az elírt API-neveket és a rossz típusokat, de a játéklogikai hibákat nem, ezért publikálás előtt mindent tesztelj a Studióban.