Tutorial · Basics ng scripting

TweenService sa Roblox: pagalawin, paikutin at itago ang parts

Ang tween ay dahan-dahang nagbabago ng property mula sa kasalukuyang value hanggang sa target sa loob ng itinakdang oras: dumudulas ang platform, umiikot ang crystal, naglalaho ang pader. Ang TweenService na mismo ang nagkukuwenta ng mga hakbang sa gitna, kaya hindi mo kailangang sumulat ng loop na gumagalaw sa part bawat frame. Sa guide na ito: ang tatlong linyang kailangan ng bawat tween, ano ang ginagawa ng bawat setting ng TweenInfo, paggalaw, pag-ikot at paglaho ng parts, loops, paghintay na matapos ang tween, at ang paraan para i-tween ang buong model (Model).

In-update Nobyembre 20, 20266 minutong basaIsinulat ni

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
  1. Paano ito gumagana
  2. 1. TweenInfo
  3. 2. Pag-ikot at paglaho
  4. 3. Loops
  5. 4. Models
  6. Server o client
  7. Common errors
  8. Gamit ang RoCode
  9. Mga madalas itanong
  10. Mga source at dagdag na babasahin

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 part sa Workspace na pinangalanang Rise
-- 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.

Ano ang puwede at hindi puwedeng i-tween
TypeSmooth ba ang tween?Mga halimbawa
numberOoTransparency, Reflectance, Value ng NumberValue
Vector3, CFrameOoPosition, Size, CFrame, Orientation
Color3OoColor
UDim2, Vector2OoSize at Position ng GUI
boolean, EnumItemNagpapalit sa duloCanCollide, Material
string, InstanceHindiNagbibigay 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.

TweenInfo.new(time, style, direction, repeatCount, reverses, delayTime)
ValueDefaultAno ang ginagawa
time1Mga segundo para sa isang play.
easingStyleQuadHugis ng galaw: Linear (pare-parehong bilis), Sine, Quad, Cubic, Back (lumalampas nang kaunti), Bounce, Elastic, Exponential.
easingDirectionOutAng Out ay mabilis sa simula at bumabagal; ang In ay mabagal sa simula; ginagawa ng InOut ang pareho.
repeatCount0Ilang beses uulit pagkatapos ng unang play. Ang -1 ay umuulit nang walang katapusan.
reversesfalseBumalik sa simula pagkatapos ng bawat play.
delayTime0Ilang segundong maghihintay bago magsimula.
Script sa part sa Workspace na pinangalanang Platform
-- 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 part sa Workspace na pinangalanang FadingWall
-- 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 part sa Workspace na pinangalanang FloatingGem
-- 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 model sa Workspace na pinangalanang Elevator
-- 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.

Saan patakbuhin ang tween
Patakbuhin saKailanHalimbawa
Server ScriptMahalaga ang pagbabago sa game o para sa lahat.Mga pinto, gumagalaw na obstacle, tulay na bumubukas
LocalScriptAng 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.

Ang tina-type mo

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.

Ang ginagawa ng RoCode
  • 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

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.

Subukan ang RoCode sa sarili mong game.

Libreng credits araw-araw, walang card. I-install ang plugin, ilarawan ang feature, at tingnan kung ano ang lumabas sa Studio.