教學 · Script 基礎

Roblox TweenService:移動、旋轉與淡出零件

補間(tween)會在指定時間內,把一個屬性從目前的值平順地變到目標值:平台滑動、水晶旋轉、牆壁漸漸消失。TweenService 會自己計算中間的每一步,所以你不需要寫每一格都移動零件的迴圈。這篇教學包含:每個補間都少不了的三行程式碼、TweenInfo 每一項設定的作用、零件的移動、旋轉與淡出、循環、等待補間結束,以及補間整個模型(Model)的技巧。

更新日期 2026年11月20日閱讀約 3 分鐘作者

重點摘要

用 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 移動模型。
本頁內容
  1. 運作方式
  2. 1. TweenInfo
  3. 2. 旋轉與淡出
  4. 3. 循環
  5. 4. 模型
  6. 伺服器或用戶端
  7. Common errors
  8. 用 RoCode
  9. 常見問題
  10. 來源與延伸閱讀

每個補間都需要的三行程式碼

在 Workspace 中插入一個 Part,勾選 Anchored,然後把游標移到它上面,按 + 並插入一個 Script。這個 Script 會在 2 秒內把零件升高 10 個 stud:

Script 位於 Workspace 中的零件 名稱為 Rise
-- 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 依下列順序最多接受六個值。後面的可以省略。

TweenInfo.new(time, style, direction, repeatCount, reverses, delayTime)
值預設作用
time1播放一次的秒數。
easingStyleQuad動作的曲線:Linear(等速)、Sine、Quad、Cubic、Back(會衝過頭)、Bounce、Elastic、Exponential。
easingDirectionOutOut 開始快、逐漸變慢;In 開始慢;InOut 兩者都有。
repeatCount0第一次播放後再重複幾次。-1 會無限重複。
reversesfalse每次播放後是否回到起點。
delayTime0開始前等待幾秒。
Script 位於 Workspace 中的零件 名稱為 Platform
-- 名為 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 啟動時轉動,接著淡出並縮小,補間結束後被刪除:

Script 位於 Workspace 中的零件 名稱為 FadingWall
-- 名為 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 零件:

Script 位於 Workspace 中的零件 名稱為 FloatingGem
-- 名為 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 移動模型,它會把裡面所有零件一起移動:

Script 位於 Workspace 中的模型 名稱為 Elevator
-- 名為 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 秒內淡出。

RoCode 會做
  • 在寫任何東西之前,可以先用 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() 繼續。

來源與延伸閱讀

程式碼如何驗證:本頁每一段 Script 都通過 Luau 嚴格型別檢查,並使用 Roblox API 定義(luau-lsp,2026年11月20日)。型別檢查能找出拼錯的 API 與錯誤的型別,但無法檢查遊戲邏輯,所以發布前請先在 Studio 中測試。

在你自己的遊戲裡試試 RoCode。

每天都有免費點數,不需要信用卡。安裝外掛程式,描述你要的功能,再看看 Studio 裡出現了什麼。