重點摘要
用 game:GetService("TweenService") 取得服務,用 TweenInfo.new(time, easingStyle, easingDirection) 描述動作,然後呼叫 TweenService:Create(part, info, { Position = goal }),再對得到的補間執行 :Play()。任何 number、Vector3、CFrame、Color3、UDim2 等類型的屬性都可以補間。要等它結束,請使用 tween.Completed:Wait();要無止盡地來回移動,就在 TweenInfo 中把重複次數設為 -1 並開啟 reverses。
- 需要讓所有玩家都看到時,在伺服器上補間零件;效果只給這位玩家看時,在用戶端補間。
- 要補間的零件請設為 Anchored,否則物理會干擾補間。
- Model 沒有可以補間的 Position 或 CFrame:請補間一個 NumberValue,並用
PivotTo移動模型。
每個補間都需要的三行程式碼
在 Workspace 中插入一個 Part,勾選 Anchored,然後把游標移到它上面,按 + 並插入一個 Script。這個 Script 會在 2 秒內把零件升高 10 個 stud:
-- Part 裡面的 Script。
local TweenService = game:GetService("TweenService")
local part = script.Parent :: BasePart
local info = TweenInfo.new(2) -- 2 秒,預設 easing
local goal = { Position = part.Position + Vector3.new(0, 10, 0) }
local tween = TweenService:Create(part, info, goal)
tween:Play()
目標是一個表格,寫著屬性名稱以及它們最後要變成的值。你可以同時補間好幾個屬性:{ Position = ..., Transparency = 1, Color = Color3.fromRGB(255, 0, 0) }。補間會從呼叫 Play 當下的值開始,所以你永遠只需要設定終點。
| 類型 | 能平順補間嗎? | 例子 |
|---|---|---|
| number | 可以 | Transparency、Reflectance、NumberValue 的 Value |
| Vector3、CFrame | 可以 | Position、Size、CFrame、Orientation |
| Color3 | 可以 | Color |
| UDim2、Vector2 | 可以 | GUI 的 Size 與 Position |
| boolean、EnumItem | 在結束時切換 | CanCollide、Material |
| string、Instance | 不行 | 會出現錯誤 cannot be tweened due to type mismatch |
步驟 1:TweenInfo 的所有設定
TweenInfo.new 依下列順序最多接受六個值。後面的可以省略。
| 值 | 預設 | 作用 |
|---|---|---|
time | 1 | 播放一次的秒數。 |
easingStyle | Quad | 動作的曲線:Linear(等速)、Sine、Quad、Cubic、Back(會衝過頭)、Bounce、Elastic、Exponential。 |
easingDirection | Out | Out 開始快、逐漸變慢;In 開始慢;InOut 兩者都有。 |
repeatCount | 0 | 第一次播放後再重複幾次。-1 會無限重複。 |
reverses | false | 每次播放後是否回到起點。 |
delayTime | 0 | 開始前等待幾秒。 |
-- 名為 Platform 的 Part 裡面的 Script。
-- 無止盡地來回移動 12 個 stud,兩端都平順減速。
local TweenService = game:GetService("TweenService")
local platform = script.Parent :: BasePart
local info = TweenInfo.new(
3, -- 每個方向的秒數
Enum.EasingStyle.Sine,
Enum.EasingDirection.InOut,
-1, -- 無限重複
true -- 每次都折返
)
TweenService:Create(platform, info, { Position = platform.Position + Vector3.new(12, 0, 0) }):Play()
如果平台要載著站在上面的玩家移動,請注意:用補間移動的 Anchored 零件會在玩家腳下移動,但不會把他們一起帶走。這種情況在移動平台教學中有詳細說明。
步驟 2:旋轉、尺寸與淡出
要旋轉零件,請把 CFrame 補間到目前的 CFrame 乘上一個旋轉。補間 Orientation 也可以,但用 CFrame 時零件會在原地轉動。這裡的牆壁會在 Script 啟動時轉動,接著淡出並縮小,補間結束後被刪除:
-- 名為 FadingWall 的 Part 裡面的 Script。
local TweenService = game:GetService("TweenService")
local wall = script.Parent :: BasePart
-- 在 1 秒內繞自己的垂直軸轉四分之一圈
local turn = TweenService:Create(wall, TweenInfo.new(1), {
CFrame = wall.CFrame * CFrame.Angles(0, math.rad(90), 0),
})
turn:Play()
turn.Completed:Wait() -- 等轉動結束後才繼續
-- 接著同時淡出並縮小
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 觸發時會帶著 PlaybackState:補間到達目標時是 Completed,被 tween:Cancel() 停止時是 Cancelled。不要等待無限重複的補間的 Completed:它永遠不會結束。
步驟 3:漂浮又旋轉的物品
兩個在不同屬性上循環的補間會同時進行。用 CFrame 補間整整 360 度的一圈不會有任何效果,因為起點和終點是同一個旋轉,所以旋轉改為把 NumberValue 從 0 補間到 360,再依照它設定 CFrame。把這個 Script 放進一個 Anchored 零件:
-- 名為 Gem 的 Part 裡面的 Script。無止盡地上下漂浮並旋轉。
local TweenService = game:GetService("TweenService")
local FLOAT_HEIGHT = 1.5 -- 比你放置的位置高幾個 stud
local FLOAT_SECONDS = 1.2 -- 每個方向
local SPIN_SECONDS = 3 -- 轉完整一圈
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,所以會以固定速度轉動,而每次循環都從 0 重新開始,0 和 360 是同一個角度,所以不會頓一下。收集金幣教學會把這類物品放進遊戲中。
步驟 4:補間整個模型
Model 沒有 Position 或 CFrame 屬性,所以 TweenService:Create(model, ...) 沒有東西可以移動。改為把 NumberValue 從 0 補間到 1,並用 PivotTo 移動模型,它會把裡面所有零件一起移動:
-- 名為 Elevator 的 Model 裡面的 Script。
-- 把整個模型往上移動 20 個 stud 再回來,所有零件一起移動。
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()
請把模型的所有零件設為 Anchored。TweenInfo 最後的 2 是每次播放前的延遲,所以電梯會在頂端和底部停一下。門的教學用同樣的方法打開由多個零件組成的門。
伺服器還是用戶端?
在伺服器 Script 中啟動的補間會在伺服器上改變零件,新的值會複寫到所有玩家,所以每個人都看得到。LocalScript 中的補間只會在這位玩家的畫面上改變零件。
| 執行位置 | 時機 | 例子 |
|---|---|---|
| 伺服器 Script | 這個變化對遊戲或所有人都重要。 | 門、移動的障礙物、展開的橋 |
| LocalScript | 只有這位玩家需要看到,或純粹是視覺效果。 | 撿起物品的玩家看到物品淡出、UI |
複寫每秒會傳送很多次更新,所以伺服器補間對大多數玩家來說看起來很平順,但非常快或非常多的伺服器補間,在慢速連線上可能沒那麼平順。大量的裝飾性動作(數百個旋轉的金幣)請在每個用戶端的 LocalScript 中執行補間。
常見錯誤與解法
按下 Play 之前,先開啟 Output 視窗(Window 選單,再選 Output)。
零件完全不動
確認你對補間呼叫了 :Play(),目標中的屬性名稱完全正確(是 Position,不是 position),而且它是放在會執行 Script 的位置的 Script(Workspace 中的零件裡,或 ServerScriptService)。
零件在補間期間掉落或抖動
它沒有設為 Anchored,所以重力與碰撞干擾了補間。請勾選 Anchored。
TweenService:Create property cannot be tweened due to type mismatch
目標值的類型不對,例如對 Vector3 類型的屬性給了數字。請見錯誤說明頁(英文)。
Unable to cast to Dictionary 或 Unable to cast value to Object
參數的順序或類型不對。順序永遠是 Create(instance, tweenInfo, goalTable)。請見 Unable to cast value to Object(英文)。
用 RoCode 來做
如果不想手寫補間,RoCode 可以在你開啟的場景中幫你建立。RoCode 是獨立的 Roblox Studio AI 代理,不是 Roblox 推出的:你在網頁聊天中描述變更,它的 Studio 外掛程式就會在你的 Explorer 中建立 Script,所以不需要貼上程式碼。
回合開始時,讓 Workspace 中的橋模型用 NumberValue 補間加 PivotTo 往旁邊移開 15 個 stud,同時讓紅色的屏障零件在 1 秒內淡出。
- 在寫任何東西之前,可以先用 Search Game 找到需要的零件與模型
- 用 Create Script 撰寫 Script,並被指示用 Check Script 檢查能否編譯
- 在每一批變更前後設下復原點,所以 Ctrl+Z 一次還原一批
使用外掛程式 3.9 或更新版本,RoCode 可以執行短暫的試玩測試並讀取錯誤,但動作最好還是親眼判斷,所以請按下 Play 看看。RoCode 如何連接 Studio。
常見問題
Roblox 的 TweenService 要怎麼用?
取得服務,建立 TweenInfo,呼叫 TweenService:Create(object, info, { Property = goal }),再對結果執行 :Play()。第一節有三行程式碼的範例。
要怎麼讓補間永遠循環?
在 TweenInfo.new 的第四個值(repeatCount)傳入 -1,如果要來回移動,第五個值傳入 true。
要怎麼等補間結束?
在 tween:Play() 之後呼叫 tween.Completed:Wait(),或把函式連接到 tween.Completed。
Model 可以補間嗎?
不能直接補間。請把 NumberValue 從 0 補間到 1,並在每次變化時呼叫 model:PivotTo(start:Lerp(goal, value)),就像步驟 4。
要怎麼停止補間?
呼叫 tween:Cancel() 停止它,讓零件留在目前的位置;或呼叫 tween:Pause(),之後再用 Play() 繼續。
來源與延伸閱讀
- Roblox Creator Docs:TweenService(英文). Create、哪些類型可以補間,以及取消
- Roblox Creator Docs:TweenInfo(英文)
- Roblox Creator Docs:Tween(英文). Play、Pause、Cancel 與 Completed
- Roblox Creator Docs:UI animation and tweens(英文). 以 UI 為例說明 easing 的樣式與方向
- Roblox Creator Docs:PVInstance:PivotTo(英文)
程式碼如何驗證:本頁每一段 Script 都通過 Luau 嚴格型別檢查,並使用 Roblox API 定義(luau-lsp,2026年11月20日)。型別檢查能找出拼錯的 API 與錯誤的型別,但無法檢查遊戲邏輯,所以發布前請先在 Studio 中測試。