教學 · Script 基礎

如何在 Roblox Studio 寫 Script:新手教學

在 Roblox Studio 寫 Script,也就是寫程式,指的是用 Luau(Roblox 版本的 Lua 語言)在你加進場景的 Script 中撰寫程式碼。這篇教學從空白的 Baseplate 開始:你會打開 Output 視窗、寫出第一個 Script、用程式碼改變零件、在玩家踩上踏板時做出反應,並試試 LocalScript,一路上也會認識變數、函式、條件、迴圈與事件。

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

重點摘要

要在 Roblox Studio 寫 Script,請在 Explorer 中把滑鼠移到 ServerScriptService 上,按下 + 並插入 Script。Studio 會在 Script Editor 中開啟它。寫下 Luau,例如 print("Hello"),按下 Play(F5),然後在 Output 視窗(Window 選單或 Script 分頁)中查看結果。Script 在伺服器上執行,改變的東西所有人都看得到;放在 StarterPlayerScripts 中的 LocalScript 則在單一玩家的裝置上執行。

  • 先學會四個概念:變數(local coins = 3)、函式(local function name() ... end)、if 條件與事件(part.Touched:Connect(...))。這篇教學的四個 Script 就是用它們,再加上迴圈與表格組成的。
  • 請使用 task.wait(),不要用 wait()。Roblox 參考文件把全域的 wait() 標示為已淘汰,並由 task.wait() 取代。
  • 在 Output 視窗的顯示設定中開啟 Show Context,讓每一行都標示它來自 Server 還是 Client。
本頁內容
  1. 開始之前
  2. 1. 第一個 Script
  3. 2. 改變零件
  4. 3. 事件
  5. 4. 第一個 LocalScript
  6. 5. 測試
  7. Script 要放在哪裡
  8. 看懂錯誤
  9. 舊教學
  10. 練習
  11. 下一步
  12. Common errors
  13. 使用 RoCode
  14. 常見問題
  15. 來源與延伸閱讀

開始之前:Studio、Baseplate 與 Output 視窗

示意畫面四個 Script 在同一次試玩測試中:ColourChanger 零件每秒換一次顏色,踩上 Pad 會讓它對所有玩家變黃 2 秒並在 Output 寫出你的名字,而按 E 只會在這個畫面上讓 Pad 變得更透明。

你只需要 Roblox Studio 和 Roblox 帳號,其他都不用:不需要程式碼編輯器,也不需要外掛程式。這篇教學的每個 Script 都是在 Studio 內建的 Script Editor 中輸入的。

  1. 安裝 Roblox Studio(Roblox 提供的免費 Windows 與 Mac 應用程式),並用 Roblox 帳號登入。
  2. 打開 Studio。起始頁面有範本:選擇 Baseplate。你會得到一片有 4x4 格線材質的地板,以及 SpawnLocation,也就是遊玩時你的虛擬人偶出現的位置。
  3. 如果看不到 Explorer 與 Properties 視窗,請從 Window 選單或 Home 分頁打開它們。Explorer 列出場景中的所有物件;Properties 顯示目前選取物件的設定。
  4. 從 Window 選單或 Script 分頁打開 Output。你的 Script 的訊息與錯誤都會出現在這裡。
  5. 在 Output 視窗的顯示設定中開啟 Show Context(把每則訊息標示為 Client 或 Server)與 Show Source(顯示訊息來自哪個 Script 與第幾行)。
你會寫出的四個 Script
Script類型位置學到什麼
FirstScriptScriptServerScriptService變數、函式、if 條件、迴圈與表格
ColourChangerScript在 Workspace 的 Part 裡面修改屬性、script.Parent 與有等待的迴圈
TouchPadScript在名為 Pad 的 Part 裡面事件、找出碰到零件的玩家,以及 debounce
MyFirstLocalScriptLocalScriptStarterPlayerScripts(在 StarterPlayer 裡面)在單一玩家裝置上執行的程式碼、按鍵,以及哪些東西只留在這台裝置上
完成後的 Explorer(只列出本教學的物件)
Workspace
  Baseplate Part
  SpawnLocation SpawnLocation
  Part Part new
    ColourChanger Script new
  Pad Part new
    TouchPad Script new
ServerScriptService
  FirstScript Script new
StarterPlayer
  StarterPlayerScripts
    MyFirstLocalScript LocalScript new

步驟 1:寫出第一個 Script

  1. 在 Explorer 中把滑鼠移到 ServerScriptService 上,按下 + 並選擇 Script(快速鍵 Ctrl+I,Mac 上為 ⌘I)。Studio 會建立 Script 並在 Script Editor 中開啟它。
  2. 在新的 Script 上按右鍵,選擇 Rename,把它命名為 FirstScript。名稱不會改變 Script 的作用,但能讓你知道是哪個 Script 印出了什麼。
  3. 新的 Script 一開始只有一行 print("Hello world!")。把它刪掉,貼上下面的程式碼。
  4. 在 Play 左邊的清單中選擇 Test,然後按下 Play(F5)。Studio 會開始試玩測試,並把虛擬人偶放在 SpawnLocation 上。
  5. 看完 Output 中的訊息後,按下 Stop(Shift+F5)。Stop 也會把所有物件還原到按下 Play 之前的狀態,所以你在遊玩時移動或改色的東西都會恢復原狀。
Script 位於 ServerScriptService 名稱為 FirstScript
-- ServerScriptService 中名為 FirstScript 的 Script。
-- 你的第一段 Luau:變數、函式、if 條件、迴圈與表格。
-- 按下 Play(F5),在 Output 視窗中查看結果。

-- 變數是一個儲存數值的名稱
local gameName = "Coin Run"
local coinsToWin = 3

-- 函式是一段有名字的程式碼,可以執行任意多次。
-- name 和 goal 是它的參數;return 把一個值傳回給呼叫它的地方。
local function describe(name: string, goal: number): string
	return `{name}: collect {goal} coins to win`
end

print(describe(gameName, coinsToWin)) --> Coin Run: collect 3 coins to win

-- if 條件只在條件成立時執行程式碼
if coinsToWin > 5 then
	print("That is a long game")
elseif coinsToWin > 1 then
	print("That is a short game")
else
	print("One coin and you win")
end

-- for 迴圈把程式碼重複指定的次數
for count = 1, coinsToWin do
	print("Coin number", count)
end

-- 表格儲存一串數值;這個迴圈依序走過它們
local colours = { "Red", "Green", "Blue" }
for position, colour in colours do
	print(position, colour) --> 1 Red,接著 2 Green,接著 3 Blue
end

一行中 -- 之後的所有內容都是註解:Luau 會略過它,所以你可以替自己留下筆記。--> 註解標示的是那一行會印出什麼。

Output 應該會顯示這八行,夾雜在 Studio 本身的訊息之中。當 print 收到多個值時,會在它們之間加上空格。開啟 Show Context 與 Show Source 後,每一行還會標上 Server 以及 FirstScript 和行號。

Output(預期結果)
Coin Run: collect 3 coins to win
That is a short game
Coin number 1
Coin number 2
Coin number 3
1 Red
2 Green
3 Blue

把每一行對應到印出它的程式碼。之後你也會用同樣的方法看錯誤訊息,所以這個習慣很有用。

FirstScript 只用到純 Luau,沒有用到 Roblox 物件,所以它也能在瀏覽器中免費的 Luau 沙盒 執行。在那裡改一個數值再執行一次,看看會有什麼不同。

FirstScript 每個部分的作用
程式碼概念意思
local gameName = "Coin Run"變數一個儲存數值的名稱。local 表示只有這個 Script 或它所在的區塊可以使用它。引號中的文字是字串;3 是數字。名稱有分大小寫,所以 coinsToWin 和 CoinsToWin 是兩個不同的變數。
local function describe(name: string, goal: number): string函式一段有名字的程式碼,可以執行任意多次。name 和 goal 是它的參數:每次呼叫時傳進去的值。: string 與 : number 是可選的型別註記。Luau 用它們在 Script Editor 中提醒你錯誤;沒有它們,程式碼一樣能執行。
return回傳值把一個值交回給呼叫函式的程式碼。print(describe(gameName, coinsToWin)) 會印出 describe 回傳的內容。
`{name}: collect {goal} coins to win`字串插值反引號中的文字可以包含數值:Luau 會把 {name} 與 {goal} 換成它們目前的值。
if, elseif, else, endif 條件Luau 由上到下檢查條件,只執行第一個成立的。coinsToWin 等於 3,不大於 5,但大於 1,所以只會印出「That is a short game」。
for count = 1, coinsToWin do數字 for 迴圈對從 1 到 coinsToWin 的每個數字各執行一次裡面的程式碼,count 依序是 1、2、3。
{ "Red", "Green", "Blue" } 與 for position, colour in colours do表格與迴圈當作清單使用的表格,Luau 稱為陣列。位置從 1 開始,不是 0。迴圈走過每個元素,並給出它的位置與值。

每個以 function、if、for 或 while 開頭的區塊,都要用 end 結束。只要少一個 end,整個 Script 都無法執行;看懂錯誤 一節會告訴你會出現什麼訊息。

步驟 2:用 Script 改變零件

Script 在改變世界中的東西時才真正有用。你在 Properties 視窗看到的設定,例如零件的 Color、Transparency 或 Anchored,就是屬性,Script 也能設定它們。

  1. 在 Home 分頁按下 Part。Studio 會在 Workspace 中加入一個方塊。名稱不重要。
  2. 在 Explorer 中把滑鼠移到新的零件上,按下 + 並插入 Script。把它重新命名為 ColourChanger,並用下面的程式碼取代裡面的內容。
  3. 按下 Play。零件會變成紅色,接著藍色,接著綠色,每秒換一次,然後重新開始。
Script 位於 Workspace 中的任何零件 名稱為 ColourChanger
-- Workspace 中 Part 裡面名為 ColourChanger 的 Script。
-- Script 改變的,就是 Properties 視窗中看到的那些屬性。
-- 這個 Script 每秒替它的零件換一個新顏色,所有玩家都看得到。

local part = script.Parent :: BasePart -- 這個 Script 所在的零件

local colours = {
	Color3.fromRGB(255, 85, 85), -- 紅色
	Color3.fromRGB(85, 170, 255), -- 藍色
	Color3.fromRGB(85, 255, 127), -- 綠色
}

part.Anchored = true -- 固定的零件會留在你放的位置

local index = 1
while true do
	part.Color = colours[index]
	index = index % #colours + 1 -- 1、2、3,然後又是 1
	task.wait(1) -- 暫停一秒(舊的 wait() 已淘汰)
end
  • script.Parent 是 Script 所在的物件,這裡就是零件。把 Script 拖到另一個零件裡,它就會改變那個零件。
  • :: BasePart 是型別轉換。它告訴 Script Editor 父物件是零件,好讓它檢查你用到的屬性。Luau 只用型別來提供警告與提示,所以這個轉換不會改變這一行的作用。
  • part.Color 與 part.Anchored 就是 Properties 視窗中的那些屬性,名稱也一樣。Roblox 使用美式拼法,所以屬性叫做 Color,雖然 Script 的名稱是 ColourChanger。
  • Anchored = true 讓零件留在原地:Roblox 參考文件說,固定的零件永遠不會因為重力、碰撞或其他物理而移動。
  • colours[index] 讀取清單中的一個元素。#colours 是清單長度 3,% 取除法的餘數,所以 index % #colours + 1 會數 1、2、3、1、2、3。
  • while true do 會無限重複,所以裡面的 task.wait(1) 非常重要。Roblox 文件說無限迴圈裡一定要有像 task.wait() 這樣的延遲:少了它遊戲會卡住,Studio 會當掉。

ColourChanger 是 Script,所以它在伺服器上執行,所有玩家會同時看到同一個顏色。步驟 4 會介紹另一種 Script。

步驟 3:用事件回應玩家

大部分遊戲程式碼都在等某件事發生:玩家加入、零件被碰到、按鈕被按下。Roblox 把這些稱為事件。要在事件觸發時執行程式碼,就把一個函式連接到它上面。

  1. 再插入一個 Part,把它重新命名為 Pad,P 要大寫,一字不差。把它直接留在 Workspace 中,不要放進資料夾或模型,因為步驟 4 的 LocalScript 會在那裡找它。
  2. 把它做成可以站上去的扁平踏板,例如在 Properties 視窗把 Size 設為 6, 1, 6。把它放在 SpawnLocation 旁邊的地板上,並勾選 Anchored,讓它不會移動。
  3. 把滑鼠移到 Pad 上,按下 +,插入 Script,重新命名為 TouchPad,並貼上下面的程式碼。
  4. 按下 Play 並站到踏板上。它會變黃 2 秒,Output 會寫出你的名字。
Script 位於 Workspace.Pad 名稱為 TouchPad
-- Workspace 中名為 Pad 的 Part 裡面,名為 TouchPad 的 Script。
-- 事件:玩家踩上踏板時,它會發出黃光,Output 會寫出是誰。
-- Debounce 讓玩家站在上面時,程式碼不會一秒觸發很多次。

local Players = game:GetService("Players")

local pad = script.Parent :: BasePart
local COOLDOWN_SECONDS = 2

local normalColour = pad.Color
local busy = false

local function onTouched(otherPart: BasePart)
	if busy then
		return -- 上一次碰觸後的冷卻時間還沒結束
	end
	-- 角色是一個 Model,碰到踏板的身體部位(或帽子)就在裡面
	local character = otherPart:FindFirstAncestorOfClass("Model")
	local player = character and Players:GetPlayerFromCharacter(character)
	if not player then
		return -- 碰到的是鬆散的零件或 NPC,不是玩家
	end

	busy = true
	print(`{player.Name} stepped on the pad`)
	pad.Color = Color3.fromRGB(255, 220, 0)
	task.wait(COOLDOWN_SECONDS)
	pad.Color = normalColour
	busy = false
end

pad.Touched:Connect(onTouched)
TouchPad 如何從碰觸找到玩家
程式碼作用
pad.Touched:Connect(onTouched)把函式連接到踏板的 Touched 事件,所以每次有東西碰到踏板時,Roblox 都會執行 onTouched,並傳入碰到它的零件。
otherPart碰到踏板的零件:腳掌、腿、帽子的把手,或玩家手中的工具。它絕不會是玩家本身,所以接下來兩行要找出它屬於誰。
otherPart:FindFirstAncestorOfClass("Model")從這個零件往上找到第一個類別剛好是 Model 的祖先,也就是角色。因為類別名稱必須完全相同,它會跳過帽子(類別 Accessory)與手中的工具(類別 Tool)。
Players:GetPlayerFromCharacter(character)回傳這個角色所屬的 Player,如果它不屬於任何人(例如 NPC)就回傳 nil。前面的 character and 會在找不到模型時略過呼叫,讓 player 維持 nil。
if not player then return end只要不是玩家,就在這裡停止。return 讓函式提早結束。

為什麼踏板需要 debounce

Roblox 關於 debounce 的頁面提醒,零件互相接觸時 Touched 會連續觸發好幾次,而走路的角色有好幾個身體部位。如果沒有檢查,踩一步就可能印出很多行,並一再重新開始黃光。

變數 busy 就是 debounce。第一次碰觸把它設為 true,之後 2 秒內的每次碰觸都會遇到 if busy then return end 而停下。task.wait(COOLDOWN_SECONDS) 之後,踏板恢復原本的顏色,busy 又變回 false。COOLDOWN_SECONDS 用大寫,是因為它是遊玩中不會改變的設定:Roblox 建議常數用這種方式命名。

這個踏板所有人共用一個 debounce,所以在這 2 秒內踩上來的第二位玩家會被忽略。對發光的踏板來說這沒問題。會發放獎勵的踏板則應該為每位玩家各自記錄冷卻時間,就像排行榜教學中的金幣踏板。

步驟 4:第一個 LocalScript 與它的不同之處

執行中的遊戲是一台伺服器,加上每位玩家各一個用戶端。到目前為止的都是在伺服器上執行的 Script,所以它的變更會傳到所有玩家。LocalScript 在單一玩家的裝置上執行。按鍵、鏡頭與畫面上的選單都在那裡處理,因為只有那台裝置知道它們。

  1. 在 Explorer 中展開 StarterPlayer,把滑鼠移到 StarterPlayerScripts 上,按下 + 並插入 LocalScript。把它重新命名為 MyFirstLocalScript,並貼上下面的程式碼。
  2. 按下 Play。Output 會顯示 Hello, 和你的名字,並標示為 Client。
  3. 點一下遊戲視窗,按下 E。踏板會變得更透明。再按一次 E 就會恢復。
  4. 試玩測試進行中時,按下 Studio 測試控制項中的 Client/Server 切換鈕,切到遊戲的伺服器端。在那裡踏板是不透明的:伺服器完全不知道這個變更。
LocalScript 位於 StarterPlayerScripts 名稱為 MyFirstLocalScript
-- StarterPlayer > StarterPlayerScripts 中名為 MyFirstLocalScript 的 LocalScript。
-- LocalScript 在單一玩家的裝置上執行。按下 E:Pad 只會在你的畫面上
-- 變得更透明,因為從這裡改變零件,不會傳到伺服器,也不會傳給其他人。

local Players = game:GetService("Players")
local UserInputService = game:GetService("UserInputService")

local player = Players.LocalPlayer
print(`Hello, {player.Name}`) -- 會出現在 Output 中,並標示為 Client

UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
	if gameProcessed then
		return -- 這個按鍵已被拿去做別的事,例如在聊天中打字
	end
	if input.KeyCode == Enum.KeyCode.E then
		local pad = workspace:FindFirstChild("Pad")
		if pad and pad:IsA("BasePart") then
			pad.Transparency = if pad.Transparency == 0 then 0.6 else 0
		end
	end
end)
  • Players.LocalPlayer 是執行這個 Script 的裝置所屬的玩家。Roblox 只在 LocalScript 以及它們載入的 ModuleScript 中提供它,所以伺服器程式碼無法使用。
  • UserInputService.InputBegan 會在玩家開始按下按鍵、點擊或觸控時觸發。當引擎已經使用了這次輸入(例如點擊按鈕,或在聊天欄中按鍵)時,gameProcessed 為 true,所以 Script 會忽略它。
  • workspace:FindFirstChild("Pad") 回傳名為 Pad 的子物件,如果沒有就回傳 nil。pad:IsA("BasePart") 會先確認它真的是零件,Script 才去改它的 Transparency。
  • if pad.Transparency == 0 then 0.6 else 0 是 if 運算式:它從兩個值中選一個。Transparency 0 表示完全可見,1 表示看不見。
  • Shift 跑步 Script 很適合當第二個 LocalScript:它監聽按鍵並改變角色的 WalkSpeed。
Script、LocalScript 與 ModuleScript
類型在哪裡執行變更會傳到哪裡用途通常放在
Script在伺服器上所有玩家遊戲規則:金幣、傷害、門、回合、存檔ServerScriptService,或在學習階段放在零件裡面
LocalScript在單一玩家的裝置上只在這台裝置上,自己角色的移動除外輸入、鏡頭、畫面上的選單、給單一玩家的效果StarterPlayerScripts 或 StarterGui
ModuleScript在對它呼叫 require() 的那一邊和載入它的 Script 相同多個 Script 共用的程式碼ReplicatedStorage 給兩邊用,ServerScriptService 只給伺服器用

作弊者可以改變什麼

請假設作弊者能控制他裝置上的一切。他可以執行自己的 LocalScript,也能修改你的,所以他可以讓踏板或任何東西在他自己的畫面上變透明。在這裡這是無害的:透明度只是外觀,而且只留在他的裝置上。正因如此,所有重要的事都由伺服器上的 Script 決定。

伺服器 Script 也不會自動就安全。TouchPad 在伺服器上執行,但每位玩家的裝置都控制著自己角色的物理,而 Roblox 的安全性文件列出,用戶端可以對它所控制的零件做的事情之一,就是控制 Touched 觸發的時機,或完全阻擋它。對發光的踏板來說這不重要。對會發獎勵的踏板,還要檢查伺服器自己追蹤的資訊,就像障礙賽教學中的規則:檢查點只能依序計算。

步驟 5:一起測試四個 Script

  1. 用 Ctrl+K(Mac 上為 ⌘K)清空 Output,按下 Play(F5)。Output 會顯示八行標示為 Server 的 FirstScript 訊息,以及你那一行標示為 Client 的 Hello。ColourChanger 零件每秒換一次顏色。
  2. 站到踏板上。它會變黃 2 秒,Output 會顯示一次你的名字與「stepped on the pad」。在上面走來走去:新的一行最多每 2 秒出現一次,而不是每次 Touched 觸發就出現。
  3. 按下 E。踏板變成半透明(Transparency 0.6)。再按一次 E,它就不透明了。
  4. 按下 Stop。在測試清單中選擇 Server & Clients,設定 2 個用戶端,按下 Play(或 F7)。Studio 會開啟一個伺服器視窗與兩個用戶端視窗。在其中一個用戶端按 E:踏板在那裡變得更透明,而另一個用戶端與伺服器顯示它仍是不透明的。結束後按下 End Session。
  5. 故意弄壞一些東西。把 Pad 重新命名為 Pad2 並執行遊戲。踩上踏板仍會讓它變黃,因為 TouchPad 是透過 script.Parent 找到自己的零件,而不是靠名稱。現在按 E 沒有任何作用,也沒有錯誤:FindFirstChild("Pad") 回傳了 nil,而 if pad and ... 檢查安靜地略過了其餘部分。在 FindFirstChild 的下一行加上 print(pad),執行並按下 E:Output 會顯示 nil。這種 print 是找出 Script 為什麼沒有作用最快的方法。停止遊戲,刪掉 print 那一行,再把零件改回 Pad 這個名稱。

Script 要放在哪裡

Script 放在哪裡,決定了它到底會不會執行,而如果它永遠不會執行,Studio 也不會提醒你。你接下來寫的 Script 可以這樣放:

每種 Script 要放在哪裡
容器放什麼原因
ServerScriptService包含大部分遊戲規則的 Script:獎勵、回合、存檔它們在伺服器上執行,ServerScriptService 中的任何東西都不會傳送給玩家。
在 Workspace 的零件裡面只跟一個零件有關的 Script,像 ColourChanger 和 TouchPad學習階段沒問題:零件就是 script.Parent。真正的專案中,Roblox 建議改用標籤標記零件(見下方)。
StarterPlayerScripts(在 StarterPlayer 裡面)大多數 LocalScript:輸入、鏡頭、給單一玩家的效果每位玩家加入時都會拿到自己的一份。
StarterGui在 ScreenGui 裡面、控制畫面選單的 LocalScript每位玩家都會拿到自己的一份介面。
ReplicatedStorage伺服器與用戶端程式碼都會載入的 ModuleScript兩邊都看得到它。預設設定的 LocalScript 或 Script 放在這裡永遠不會執行。

Roblox 關於 Script 位置的頁面建議完全不要把 Script 直接放進 Workspace 的零件中:改用標籤標記零件,並在一個 ModuleScript 中透過 CollectionService 處理它們。不過放在零件裡的 Script 仍然是最簡單的起點,學習時用在一兩個物件上沒有問題。門的教學示範了使用標籤的做法,一個 Script 管理所有門,而用戶端與伺服器教學有完整的表格,列出哪些容器會執行哪些 Script。

出問題時:看 Output

錯誤會以紅色顯示在 Output 中。每則錯誤開頭先說明發生的位置,也就是 Script 的完整名稱與行號,接著說明哪裡有問題。點一下錯誤,Studio 就會在那一行開啟 Script。例如,如果你把 TouchPad 中的 if not player 檢查刪掉,然後有鬆散的零件掉到踏板上,Output 會顯示:

Output(範例)
Workspace.Pad.TouchPad:22: attempt to index nil with 'Name'

程式碼寫法上的錯誤,例如少了 end,在按下 Play 之前就看得到:Script Editor 會用紅線標出,Script Analysis 視窗(Script 分頁上的 Analysis 按鈕)會列出它們。有這種錯誤的 Script 完全不會執行,連錯誤上方的那幾行也不會。

值得認得的三種錯誤
訊息意思如何修正
Colour is not a valid member of Part "Workspace.Part"這個物件沒有名稱完全一樣的東西。這裡的屬性要寫成 Color。對照 Properties 或 Explorer 視窗,檢查拼法與大小寫。這個錯誤的詳細說明。
attempt to index nil with 'Name'程式碼從一個 nil 值讀取了東西,這裡是 .Name。在上面的例子中,player 是 nil,因為碰到踏板的是鬆散的零件。找出這個值為什麼是 nil,並在使用前用 if 檢查它。這個錯誤的詳細說明。
Expected 'end' (to close 'then' at line 2), got <eof>第 2 行的 if 沒有對應的 end。如果是函式,訊息會寫 to close 'function',而 <eof> 表示檔案結尾。依照括號中的行號補上缺少的 end,而不是看最後一行。有時訊息結尾會是「did you forget to close ... at line N?」。這是 Luau 根據縮排的猜測,可能指向錯的區塊,所以請先檢查括號中的那一行。語法錯誤的詳細說明。

如果 Script 沒有任何作用,Output 也是空的,通常是 Script 放在永遠不會執行的位置,或在等一個不會觸發的事件。錯誤教學中有沒有反應的 Script 檢查清單,以及更多關於看懂 Output 的說明。

舊的 Script 教學有哪些不同的做法

如果你也在看影片與論壇文章學習,會遇到一些舊的寫法。以下是重要的幾種,並說明每一種為什麼有問題。

舊教學中的寫法,以及這篇教學改用的做法
舊教學問題這篇教學
用 wait(1) 暫停Roblox 參考文件把全域的 wait() 標示為已淘汰,並說它已被 task.wait() 取代。task.wait(1)
用 otherPart.Parent 找角色,就像 Roblox 的熔岩課程當碰到零件的是帽子或手中的工具時,otherPart.Parent 是 Accessory 或 Tool,而不是角色,所以找不到 Humanoid,這次碰觸就漏掉了。FindFirstAncestorOfClass("Model"),再用 GetPlayerFromCharacter
使用沒有 debounce 的 Touched踩一步 Touched 就會連續觸發好幾次,所以程式碼會一再執行。busy 旗標與冷卻時間
把 LocalScript 放進 Workspace 的零件裡LocalScript 在那裡永遠不會執行。它只會在屬於單一玩家的位置中執行。放在 StarterPlayerScripts 的 LocalScript(原因)
寫 part.Touched:connect(...) 或 table.getn(list)Roblox 的命名指南說 camelCase 的 API 大多已淘汰,參考文件也只列出 Connect。table.getn 已淘汰,改用 #list。:Connect(...) 與 #list
在 LocalScript 中改變金幣或造成傷害變更只留在那位玩家的裝置上,所以其他人都看不到,伺服器也不會計算它。把遊戲規則放在伺服器的 Script 中

練習:值得一試的三個修改

修改程式碼比閱讀程式碼學到更多。在你的場景中一次試一個,每改一個就按一次 Play。

  • 讓踏板給一分。加入排行榜教學步驟 1 的 Leaderstats Script。接著在 TouchPad 中 busy = true 之後,找到玩家的 leaderstats 資料夾,並把 Coins 的值加 1。提示:player:FindFirstChild("leaderstats"),接著 leaderstats:FindFirstChild("Coins"),接著 coins.Value += 1。排行榜教學中的金幣踏板就是完成版,而且每位玩家各有冷卻時間。
  • 讓 ColourChanger 也改變透明度。讓 ColourChanger 每秒也改變零件的 Transparency。提示:再加一個 0 到 1 之間的數字表格,例如 { 0, 0.3, 0.6 },在 part.Color 的下一行用同一個 index 從裡面設定 part.Transparency。
  • 印出踏板的顏色。讓 MyFirstLocalScript 在按下 E 時印出踏板的 Color。提示:在 if pad and pad:IsA("BasePart") 區塊中寫 print(pad.Color)。在踏板是黃色時按 E:用戶端看得到伺服器設定的顏色,因為伺服器上的變更會傳到所有用戶端。

接下來要學什麼

現在你已經用過大部分遊戲 Script 的組成元件。接下來建議的順序是:

  1. LocalScript vs Script vs ModuleScript:每種 Script 在哪裡執行、可以改變什麼,比步驟 4 更深入。
  2. RemoteEvents:LocalScript 如何請伺服器做事,以及伺服器如何檢查請求。
  3. 排行榜:你的第一組數據,在伺服器上建立與修改。
  4. 你的第一個遊戲:一條有熔岩、金幣與終點踏板的短關卡,用兩個伺服器 Script 完成,然後發布。
  5. 然後選一個系統:商店 GUI、回合系統、障礙賽檢查點、載入畫面或按鍵播放動畫。出問題時,Script 錯誤教學能幫你看懂訊息。檢查點教學目前只有英文版。

Roblox 自己的教學 Coding fundamentals(英文)很適合搭配這篇教學:共六個系列,從變數與函式,經過條件、迴圈、陣列與字典,一直到用 ModuleScript 組織程式碼,並附有在 Studio 中完成的小專案。

常見錯誤與解法

第一個 Script 的問題大多是名稱不一致、Script 放錯位置,或迴圈沒有等待。測試時請把 Output 開著。

按下 Play 時 Studio 卡住或沒有回應

while true do 迴圈中沒有等待,所以其他東西都無法執行。Roblox 文件說,沒有像 task.wait() 這種延遲的無限迴圈會讓遊戲卡住並讓 Studio 當掉。請在每個無限迴圈中加上 task.wait(),就像 ColourChanger 一樣。

我站到踏板上時什麼事都沒發生

確認 TouchPad 是 Script 而不是 LocalScript、直接放在 Pad 零件裡面、沒有被停用,並且踏板的 CanTouch 屬性有勾選。接著在 onTouched 裡面的第一行加上 print("touched", otherPart.Name)。如果沒有印出來,表示事件沒有觸發;如果有印出來,問題在更下面。

按 E 沒有任何作用

MyFirstLocalScript 必須是放在 StarterPlayerScripts 中的 LocalScript:放在 Workspace 或 ServerScriptService 中的 LocalScript 永遠不會執行。零件的名稱必須剛好是 Pad,並且直接放在 Workspace 中。先點一下遊戲視窗,並確認你不是在聊天中打字,因為 Script 會忽略遊戲已經用掉的按鍵。

零件在我的畫面上改變了,但其他玩家看不到

這個變更是 LocalScript 做的,所以它只留在你的裝置上。請在伺服器 Script 中做,或讓 LocalScript 透過 RemoteEvent 請伺服器處理。

ColourChanger 放在零件裡可以運作,放到 ServerScriptService 就壞了

它把 script.Parent 當作自己的零件。在 ServerScriptService 中,父物件就是 ServerScriptService,它沒有 Anchored 或 Color,所以 Output 會顯示「not a valid member」錯誤。請把它留在零件裡,或替零件取名並用名稱尋找它,例如 local part = workspace:WaitForChild("ColourPart") :: BasePart。

Output 完全沒有顯示任何東西

確認 Output 視窗已開啟(Window 選單或 Script 分頁),而且沒有設定篩選:Output 可以依訊息類型、Client 或 Server 以及文字篩選。如果它已開啟卻仍是空的,Script 可能根本沒有執行。請參考沒有作用的 Script 檢查清單。

卡住時:RoCode

如果你在自己場景中的某個 Script 卡住了,RoCode 可以陪你一起拆解它。RoCode 是獨立的 Roblox Studio AI 代理,不是 Roblox 官方產品:你在網頁聊天中輸入,它在 Studio 的外掛程式會在你的 Explorer 中建立與修改 Script。

學習時很適合用 Ask 模式:Script 由你自己寫,RoCode 讀取已經有的內容並回答問題。

你輸入

逐行說明 Pad 零件裡的 TouchPad Script 在做什麼,以及它為什麼要用 debounce。

RoCode 會做
  • 在 Ask 模式中只使用讀取工具,例如 Search Scripts 與 Read Script,不會改變場景中的任何東西
  • 如果有東西需要修正,會說明它會改哪裡、改什麼,並建議切換到 Build
  • 在 Build 模式中直接修改 Script,然後用 Check Script 檢查每一個。這是編譯檢查,不是型別檢查,也不是試玩測試
  • 用 Check Output 工具讀取 Studio 的 Output,包括你上一次試玩測試的 Server 與 Client 訊息,即使已經按下 Stop

在 Build 模式中,搭配 3.9 或更新版本的外掛程式,RoCode 可以執行簡短的試玩測試並讀取錯誤,搭配 3.9.11 或更新版本還能操控測試角色,但它在遊玩時不會截圖,所以踏板還是要你自己站上去。RoCode 如何連接 Studio。

常見問題

Roblox Studio 的 Script 要在哪裡寫?

在 Explorer 中把滑鼠移到一個容器上,例如 ServerScriptService,按下 + 並選擇 Script。Studio 會在 Script Editor 中開啟它,你就在那裡寫 Luau。伺服器 Script 通常放在 ServerScriptService;LocalScript 放在 StarterPlayerScripts 或 StarterGui。

如何在 Roblox Studio 執行 Script?

按下 Play(F5)。Studio 會開始試玩測試,ServerScriptService 或 Workspace 中每個啟用的 Script 會在遊戲一開始就執行;StarterPlayerScripts 中的 LocalScript 則在你進入試玩測試時執行。Run(在 Play 旁邊的清單中選擇,或按 F8)會在沒有虛擬人偶的情況下執行遊戲,所以這篇教學請用 Play。Stop(Shift+F5)結束測試。要打開現有的 Script,在 Explorer 中按兩下它。

Roblox 使用哪種程式語言?

Luau。Roblox 形容它是快速、小巧、安全、採用漸進式型別的 Script 語言,衍生自 Lua 5.1,所以大部分 Lua 教學仍然有用。Luau 加入了反引號字串插值與可選型別註記等功能,Roblox 則加入了自己的函式庫與物件,例如 task.wait。

Script 和 LocalScript 有什麼不同?

Script 在伺服器上執行,它的變更會傳到所有玩家。LocalScript 在單一玩家的裝置上執行,用於輸入、鏡頭與畫面上的選單,它對零件、數值與介面的變更只留在那台裝置上。用戶端與伺服器教學(英文)會說明兩者,以及 ModuleScript。

可以在手機或 iPad 上用 Roblox Studio 寫 Script 嗎?

Roblox 的安裝頁面說明 Studio 是免費的 Windows 與 Mac 應用程式,沒有提到手機或平板版本,所以寫 Script 需要一台電腦。

為什麼我的 Script 沒有任何作用,也沒有顯示錯誤?

通常是它放在這種 Script 不會執行的位置(Workspace 中的 LocalScript,或 StarterPlayerScripts 中的 Script)、它被停用了,或它在等的事件沒有觸發。錯誤教學中有檢查清單。

學會 Roblox Script 需要多久?

沒有人能給出誠實的數字:這取決於你做了多少東西。最有幫助的是經常在自己的場景中寫小 Script。修改這裡的四個 Script,試試練習題,接著完成第一個遊戲教學,再一次加入一個系統。

來源與延伸閱讀

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

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

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