Útmutató · Scriptelési alapok

TweenService a Robloxban: partok mozgatása, forgatása és eltüntetése

Egy tween egy tulajdonságot simán változtat meg a jelenlegi értékétől a célig, adott idő alatt: egy platform elsiklik, egy kristály forog, egy fal elhalványul. A TweenService maga számolja ki a köztes lépéseket, így nem kell olyan ciklust írnod, amely minden képkockában arrébb tolja a partot. Ebben az útmutatóban: a három sor, amely nélkül egyetlen tween sem működik, mit csinál a TweenInfo minden beállítása, partok mozgatása, forgatása és eltüntetése, ciklusok, a tween végének kivárása, és egy trükk egy teljes modell (Model) tweeneléséhez.

Frissítve 2026. november 20.6 perc olvasásSzerző:

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 PivotTo segítségével mozgasd.
Ezen az oldalon
  1. Hogyan működik
  2. 1. TweenInfo
  3. 2. Forgatás és eltüntetés
  4. 3. Ciklusok
  5. 4. Modellek
  6. Szerver vagy kliens
  7. Common errors
  8. RoCode-dal
  9. Gyakori kérdések
  10. Források és további olvasnivaló

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 helye: egy partban a Workspace-ben neve: Rise
-- 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.

Mit lehet és mit nem lehet tweenelni
TípusSimán tweenelhető?Példák
numberIgenTransparency, Reflectance, a NumberValue Value tulajdonsága
Vector3, CFrameIgenPosition, Size, CFrame, Orientation
Color3IgenColor
UDim2, Vector2IgenA GUI Size és Position tulajdonsága
boolean, EnumItemA végén vált átCanCollide, Material
string, InstanceNemA 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.

TweenInfo.new(time, style, direction, repeatCount, reverses, delayTime)
ÉrtékAlapértelmezésMit csinál
time1Egy lejátszás másodpercben.
easingStyleQuadA mozgás alakja: Linear (állandó sebesség), Sine, Quad, Cubic, Back (túllövéssel), Bounce, Elastic, Exponential.
easingDirectionOutAz Out gyorsan indul és lelassul; az In lassan indul; az InOut mindkettőt csinálja.
repeatCount0Hányszor ismétlődjön az első lejátszás után. A -1 végtelenül ismétel.
reversesfalseMinden lejátszás után visszatér-e a kezdetre.
delayTime0Hány másodpercet várjon indulás előtt.
Script helye: egy partban a Workspace-ben neve: Platform
-- 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 helye: egy partban a Workspace-ben neve: FadingWall
-- 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 helye: egy partban a Workspace-ben neve: FloatingGem
-- 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 helye: egy modellben a Workspace-ben neve: Elevator
-- 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.

Hol indítsd a tweent
Indítsd ittMikorPélda
Szerveroldali ScriptA változás fontos a játék vagy mindenki számára.Ajtók, mozgó akadályok, kinyíló híd
LocalScriptCsak 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.

Te írod

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.

A RoCode elvégzi
  • 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ó

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.

Próbáld ki a RoCode-ot a saját játékodban.

Ingyenes kreditek minden nap, bankkártya nélkül. Telepítsd a plugint, írd le a funkciót, és nézd meg, mi jelenik meg a Studióban.