Sa madaling salita
Kunin ang service gamit ang game:GetService("TweenService"), ilarawan ang galaw gamit ang TweenInfo.new(time, easingStyle, easingDirection), saka tawagin ang TweenService:Create(part, info, { Position = goal }) at patakbuhin ang :Play() sa nakuhang tween. Puwedeng i-tween ang kahit anong property na number, Vector3, CFrame, Color3, UDim2 at mga katulad nito. Para hintayin ang dulo, gamitin ang tween.Completed:Wait(), at para sa paggalaw nang pabalik-balik nang walang katapusan, i-set ang bilang ng ulit sa -1 sa TweenInfo at i-on ang reverses.
- I-tween ang part sa server kapag dapat itong makita ng lahat ng player; sa client kapag para lang sa player na iyon ang effect.
- I-anchor (Anchored) ang mga part na tine-tween mo, kung hindi ay makikialam ang physics sa tween.
- Walang Position o CFrame ang Model na puwedeng i-tween: mag-tween ng NumberValue at galawin ang model gamit ang
PivotTo.
Sa page na ito
Ang tatlong linyang kailangan ng bawat tween
Mag-insert ng Part sa Workspace, i-check ang Anchored, saka i-hover ito, pindutin ang + at mag-insert ng Script. Itinataas ng script na ito ang part nang 10 studs sa loob ng 2 segundo:
-- Script sa loob ng Part.
local TweenService = game:GetService("TweenService")
local part = script.Parent :: BasePart
local info = TweenInfo.new(2) -- 2 segundo, default na easing
local goal = { Position = part.Position + Vector3.new(0, 10, 0) }
local tween = TweenService:Create(part, info, goal)
tween:Play()
Ang goal ay isang table ng mga pangalan ng property at ng mga value kung saan dapat silang matapos. Puwedeng mag-tween ng ilang property nang sabay: { Position = ..., Transparency = 1, Color = Color3.fromRGB(255, 0, 0) }. Nagsisimula ang tween sa mga value na mayroon sa sandaling tinawag ang Play, kaya ang dulo lang ang lagi mong itinatakda.
| Type | Smooth ba ang tween? | Mga halimbawa |
|---|---|---|
| number | Oo | Transparency, Reflectance, Value ng NumberValue |
| Vector3, CFrame | Oo | Position, Size, CFrame, Orientation |
| Color3 | Oo | Color |
| UDim2, Vector2 | Oo | Size at Position ng GUI |
| boolean, EnumItem | Nagpapalit sa dulo | CanCollide, Material |
| string, Instance | Hindi | Nagbibigay ng error na cannot be tweened due to type mismatch |
Hakbang 1: lahat ng setting ng TweenInfo
Tumatanggap ang TweenInfo.new ng hanggang anim na value sa ganitong pagkakasunod. Puwedeng hindi ilagay ang mga huli.
| Value | Default | Ano ang ginagawa |
|---|---|---|
time | 1 | Mga segundo para sa isang play. |
easingStyle | Quad | Hugis ng galaw: Linear (pare-parehong bilis), Sine, Quad, Cubic, Back (lumalampas nang kaunti), Bounce, Elastic, Exponential. |
easingDirection | Out | Ang Out ay mabilis sa simula at bumabagal; ang In ay mabagal sa simula; ginagawa ng InOut ang pareho. |
repeatCount | 0 | Ilang beses uulit pagkatapos ng unang play. Ang -1 ay umuulit nang walang katapusan. |
reverses | false | Bumalik sa simula pagkatapos ng bawat play. |
delayTime | 0 | Ilang segundong maghihintay bago magsimula. |
-- Script sa loob ng Part na pinangalanang Platform.
-- Pabalik-balik nang walang katapusan nang 12 studs, smooth sa magkabilang dulo.
local TweenService = game:GetService("TweenService")
local platform = script.Parent :: BasePart
local info = TweenInfo.new(
3, -- segundo bawat direksyon
Enum.EasingStyle.Sine,
Enum.EasingDirection.InOut,
-1, -- ulitin nang walang katapusan
true -- bumalik bawat beses
)
TweenService:Create(platform, info, { Position = platform.Position + Vector3.new(12, 0, 0) }):Play()
Kung dapat isakay ng platform ang mga player na nakatayo dito, tandaan: gumagalaw sa ilalim nila ang naka-anchor na part na may tween, pero hindi sila nito isinasama. Ipinaliwanag ang kasong ito sa guide tungkol sa moving platform.
Hakbang 2: pag-ikot, laki at paglaho
Para paikutin ang part, i-tween ang CFrame papunta sa kasalukuyang CFrame na pinarami ng rotation. Gumagana rin ang tween ng Orientation, pero sa CFrame, umiikot ang part sa puwesto nito. Dito, umiikot ang pader kapag tumakbo ang script, saka naglalaho at lumiliit, at pagkatapos ng tween ay dine-delete ito:
-- Script sa loob ng Part na pinangalanang FadingWall.
local TweenService = game:GetService("TweenService")
local wall = script.Parent :: BasePart
-- quarter turn sa sarili nitong vertical axis sa loob ng 1 segundo
local turn = TweenService:Create(wall, TweenInfo.new(1), {
CFrame = wall.CFrame * CFrame.Angles(0, math.rad(90), 0),
})
turn:Play()
turn.Completed:Wait() -- tuloy lang kapag tapos na ang pag-ikot
-- saka sabay na palahuin at paliitin
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()
Nagpa-fire ang Completed kasama ang isang PlaybackState: Completed kung naabot ng tween ang goal, o Cancelled kung pinahinto ito ng tween:Cancel(). Huwag hintayin ang Completed ng tween na umuulit nang walang katapusan: hindi ito kailanman matatapos.
Hakbang 3: lumulutang at umiikot na item
Sabay na tumatakbo ang dalawang naka-loop na tween sa magkaibang property. Walang ginagawa ang tween ng buong ikot na 360 degrees gamit ang CFrame, dahil iisang rotation lang ang simula at dulo, kaya nagtu-tween ang pag-ikot ng NumberValue mula 0 hanggang 360 at sine-set ang CFrame batay dito. Ilagay ang Script na ito sa isang naka-anchor na part:
-- Script sa loob ng Part na pinangalanang Gem. Lumulutang pataas-pababa at umiikot nang walang katapusan.
local TweenService = game:GetService("TweenService")
local FLOAT_HEIGHT = 1.5 -- studs na mas mataas sa puwesto kung saan mo ito inilagay
local FLOAT_SECONDS = 1.2 -- bawat direksyon
local SPIN_SECONDS = 3 -- isang buong ikot
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()
Linear easing ang gamit ng pag-ikot, kaya pare-pareho ang bilis nito, at bawat cycle ay nagsisimula ulit sa 0, na parehong anggulo ng 360, kaya walang pagtalon. Inilalagay ng guide tungkol sa pag-collect ng coins ang ganitong mga item sa game.
Hakbang 4: tween ng buong model
Walang property na Position o CFrame ang Model, kaya walang magagalaw ang TweenService:Create(model, ...). Sa halip, mag-tween ng NumberValue mula 0 hanggang 1 at galawin ang model gamit ang PivotTo, na sabay-sabay na naglilipat sa lahat ng part sa loob nito:
-- Script sa loob ng Model na pinangalanang Elevator.
-- Ginagalaw ang buong model nang 20 studs pataas at pabalik, lahat ng part nang sabay.
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()
I-anchor ang lahat ng part ng model. Ang 2 sa dulo ng TweenInfo ay ang delay bago ang bawat play, kaya humihinto ang elevator sa itaas at sa ibaba. Ganito rin ang paraan ng guide tungkol sa mga pinto sa pagbukas ng mga pintong gawa sa maraming part.
Server o client?
Ang tween na pinatakbo sa server Script ay nagbabago sa part sa server, at nire-replicate ang mga bagong value sa lahat ng player, kaya nakikita ito ng lahat. Ang tween sa LocalScript ay nagbabago lang sa part sa screen ng player na iyon.
| Patakbuhin sa | Kailan | Halimbawa |
|---|---|---|
| Server Script | Mahalaga ang pagbabago sa game o para sa lahat. | Mga pinto, gumagalaw na obstacle, tulay na bumubukas |
| LocalScript | Ang player lang na iyon ang dapat makakita, o visual effect lang ito. | Item na naglalaho para sa player na kumuha nito, UI |
Nagpapadala ang replication ng mga update nang maraming beses kada segundo, kaya smooth ang tingin ng karamihan ng player sa mga server tween, pero ang sobrang bilis o sobrang daming server tween ay puwedeng magmukhang hindi gaanong smooth sa mabagal na connection. Para sa maraming pandekorasyong galaw (daan-daang umiikot na coin), patakbuhin ang mga tween sa LocalScript sa bawat client.
Mga karaniwang error at solusyon
Buksan ang Output window (menu na Window, saka Output) bago pindutin ang Play.
Hindi gumagalaw ang part
I-check na tinawag mo ang :Play() sa tween, na eksakto ang pagkakasulat ng pangalan ng property sa goal (Position, hindi position) at na Script ito sa lugar kung saan tumatakbo ang mga script (sa loob ng part sa Workspace o sa ServerScriptService).
Nahuhulog o nanginginig ang part habang nagtu-tween
Hindi ito naka-anchor, kaya nakikialam sa tween ang gravity at mga banggaan. I-check ang Anchored.
TweenService:Create property cannot be tweened due to type mismatch
Mali ang type ng goal value, halimbawa number para sa property na Vector3. Tingnan ang page ng error (sa English).
Unable to cast to Dictionary o Unable to cast value to Object
Mali ang pagkakasunod o type ng mga argument. Ang pagkakasunod ay laging Create(instance, tweenInfo, goalTable). Tingnan ang Unable to cast value to Object (sa English).
Gawin gamit ang RoCode
Kung ayaw mong isulat nang mano-mano ang mga tween, kayang buuin ng RoCode ang mga ito sa place na bukas mo. Ang RoCode ay isang independent na AI agent para sa Roblox Studio, hindi galing sa Roblox: ilalarawan mo ang pagbabago sa web chat, at ang plugin nito para sa Studio ang gagawa ng mga script sa Explorer mo, kaya hindi mo na kailangang mag-paste ng code.
Gawin mong umusog nang 15 studs patagilid ang bridge model sa Workspace kapag nagsimula ang round, gamit ang tween ng NumberValue at PivotTo, at sabay na palahuin ang mga pulang barrier part sa loob ng 1 segundo.
- Kayang hanapin ang tamang mga part at model gamit ang Search Game bago sumulat ng kahit ano
- Sumusulat ng Script gamit ang Create Script, at inuutusan itong i-check ang compile gamit ang Check Script
- Naglalagay ng undo point bago at pagkatapos ng bawat batch ng pagbabago, kaya isang batch kada Ctrl+Z ang naibabalik
Sa plugin 3.9 o mas bago, kayang magpatakbo ng RoCode ng maikling playtest at basahin ang mga error, pero pinakamadaling husgahan ang galaw gamit ang sarili mong mata, kaya pindutin ang Play at tingnan. Paano kumokonekta ang RoCode sa Studio.
Mga madalas itanong
Paano gamitin ang TweenService sa Roblox?
Kunin ang service, gumawa ng TweenInfo, tawagin ang TweenService:Create(object, info, { Property = goal }) at patakbuhin ang :Play() sa resulta. May halimbawang tatlong linya sa unang section.
Paano i-loop ang tween nang walang katapusan?
Ipasa ang -1 bilang ikaapat na value sa TweenInfo.new (repeatCount) at true bilang ikalima kung dapat itong pabalik-balik.
Paano hintayin na matapos ang tween?
Tawagin ang tween.Completed:Wait() pagkatapos ng tween:Play() o ikonekta ang isang function sa tween.Completed.
Puwede bang i-tween ang Model?
Hindi direkta. Mag-tween ng NumberValue mula 0 hanggang 1 at sa bawat pagbabago, tawagin ang model:PivotTo(start:Lerp(goal, value)), gaya ng sa hakbang 4.
Paano pahintuin ang tween?
Tawagin ang tween:Cancel() para pahintuin ito at iwan ang part kung nasaan ito, o tween:Pause() para ituloy mamaya gamit ang Play().
Mga source at dagdag na babasahin
- Roblox Creator Docs: TweenService (sa English). Create, kung aling mga type ang puwedeng i-tween at pagkansela
- Roblox Creator Docs: TweenInfo (sa English)
- Roblox Creator Docs: Tween (sa English). Play, Pause, Cancel at Completed
- Roblox Creator Docs: UI animation and tweens (sa English). mga easing style at direction gamit ang UI bilang halimbawa
- Roblox Creator Docs: PVInstance:PivotTo (sa English)
Paano sinuri ang code: bawat script sa page na ito ay dumaan sa strict Luau type check gamit ang mga definition ng Roblox API (luau-lsp, Nobyembre 20, 2026). Nahuhuli ng type check ang maling pangalan ng API at maling type, pero hindi ang mga mali sa game logic, kaya i-test muna ang lahat sa Studio bago mag-publish.