重點摘要
要在 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。
本頁內容
開始之前:Studio、Baseplate 與 Output 視窗
你只需要 Roblox Studio 和 Roblox 帳號,其他都不用:不需要程式碼編輯器,也不需要外掛程式。這篇教學的每個 Script 都是在 Studio 內建的 Script Editor 中輸入的。
- 安裝 Roblox Studio(Roblox 提供的免費 Windows 與 Mac 應用程式),並用 Roblox 帳號登入。
- 打開 Studio。起始頁面有範本:選擇 Baseplate。你會得到一片有 4x4 格線材質的地板,以及 SpawnLocation,也就是遊玩時你的虛擬人偶出現的位置。
- 如果看不到 Explorer 與 Properties 視窗,請從 Window 選單或 Home 分頁打開它們。Explorer 列出場景中的所有物件;Properties 顯示目前選取物件的設定。
- 從 Window 選單或 Script 分頁打開 Output。你的 Script 的訊息與錯誤都會出現在這裡。
- 在 Output 視窗的顯示設定中開啟 Show Context(把每則訊息標示為 Client 或 Server)與 Show Source(顯示訊息來自哪個 Script 與第幾行)。
| Script | 類型 | 位置 | 學到什麼 |
|---|---|---|---|
FirstScript | Script | ServerScriptService | 變數、函式、if 條件、迴圈與表格 |
ColourChanger | Script | 在 Workspace 的 Part 裡面 | 修改屬性、script.Parent 與有等待的迴圈 |
TouchPad | Script | 在名為 Pad 的 Part 裡面 | 事件、找出碰到零件的玩家,以及 debounce |
MyFirstLocalScript | LocalScript | StarterPlayerScripts(在 StarterPlayer 裡面) | 在單一玩家裝置上執行的程式碼、按鍵,以及哪些東西只留在這台裝置上 |
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
- 在 Explorer 中把滑鼠移到 ServerScriptService 上,按下 + 並選擇 Script(快速鍵 Ctrl+I,Mac 上為 ⌘I)。Studio 會建立 Script 並在 Script Editor 中開啟它。
- 在新的 Script 上按右鍵,選擇 Rename,把它命名為
FirstScript。名稱不會改變 Script 的作用,但能讓你知道是哪個 Script 印出了什麼。 - 新的 Script 一開始只有一行
print("Hello world!")。把它刪掉,貼上下面的程式碼。 - 在 Play 左邊的清單中選擇 Test,然後按下 Play(F5)。Studio 會開始試玩測試,並把虛擬人偶放在 SpawnLocation 上。
- 看完 Output 中的訊息後,按下 Stop(Shift+F5)。Stop 也會把所有物件還原到按下 Play 之前的狀態,所以你在遊玩時移動或改色的東西都會恢復原狀。
-- 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 和行號。
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 沙盒 執行。在那裡改一個數值再執行一次,看看會有什麼不同。
| 程式碼 | 概念 | 意思 |
|---|---|---|
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, end | if 條件 | 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 也能設定它們。
- 在 Home 分頁按下 Part。Studio 會在 Workspace 中加入一個方塊。名稱不重要。
- 在 Explorer 中把滑鼠移到新的零件上,按下 + 並插入 Script。把它重新命名為
ColourChanger,並用下面的程式碼取代裡面的內容。 - 按下 Play。零件會變成紅色,接著藍色,接著綠色,每秒換一次,然後重新開始。
-- 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 把這些稱為事件。要在事件觸發時執行程式碼,就把一個函式連接到它上面。
- 再插入一個 Part,把它重新命名為
Pad,P 要大寫,一字不差。把它直接留在 Workspace 中,不要放進資料夾或模型,因為步驟 4 的 LocalScript 會在那裡找它。 - 把它做成可以站上去的扁平踏板,例如在 Properties 視窗把
Size設為6, 1, 6。把它放在 SpawnLocation 旁邊的地板上,並勾選 Anchored,讓它不會移動。 - 把滑鼠移到 Pad 上,按下 +,插入 Script,重新命名為
TouchPad,並貼上下面的程式碼。 - 按下 Play 並站到踏板上。它會變黃 2 秒,Output 會寫出你的名字。
-- 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)
| 程式碼 | 作用 |
|---|---|
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 在單一玩家的裝置上執行。按鍵、鏡頭與畫面上的選單都在那裡處理,因為只有那台裝置知道它們。
- 在 Explorer 中展開 StarterPlayer,把滑鼠移到 StarterPlayerScripts 上,按下 + 並插入 LocalScript。把它重新命名為
MyFirstLocalScript,並貼上下面的程式碼。 - 按下 Play。Output 會顯示
Hello,和你的名字,並標示為 Client。 - 點一下遊戲視窗,按下 E。踏板會變得更透明。再按一次 E 就會恢復。
- 試玩測試進行中時,按下 Studio 測試控制項中的 Client/Server 切換鈕,切到遊戲的伺服器端。在那裡踏板是不透明的:伺服器完全不知道這個變更。
-- 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 | 在伺服器上 | 所有玩家 | 遊戲規則:金幣、傷害、門、回合、存檔 | ServerScriptService,或在學習階段放在零件裡面 |
| LocalScript | 在單一玩家的裝置上 | 只在這台裝置上,自己角色的移動除外 | 輸入、鏡頭、畫面上的選單、給單一玩家的效果 | StarterPlayerScripts 或 StarterGui |
| ModuleScript | 在對它呼叫 require() 的那一邊 | 和載入它的 Script 相同 | 多個 Script 共用的程式碼 | ReplicatedStorage 給兩邊用,ServerScriptService 只給伺服器用 |
作弊者可以改變什麼
請假設作弊者能控制他裝置上的一切。他可以執行自己的 LocalScript,也能修改你的,所以他可以讓踏板或任何東西在他自己的畫面上變透明。在這裡這是無害的:透明度只是外觀,而且只留在他的裝置上。正因如此,所有重要的事都由伺服器上的 Script 決定。
伺服器 Script 也不會自動就安全。TouchPad 在伺服器上執行,但每位玩家的裝置都控制著自己角色的物理,而 Roblox 的安全性文件列出,用戶端可以對它所控制的零件做的事情之一,就是控制 Touched 觸發的時機,或完全阻擋它。對發光的踏板來說這不重要。對會發獎勵的踏板,還要檢查伺服器自己追蹤的資訊,就像障礙賽教學中的規則:檢查點只能依序計算。
步驟 5:一起測試四個 Script
- 用 Ctrl+K(Mac 上為 ⌘K)清空 Output,按下 Play(F5)。Output 會顯示八行標示為 Server 的 FirstScript 訊息,以及你那一行標示為 Client 的 Hello。ColourChanger 零件每秒換一次顏色。
- 站到踏板上。它會變黃 2 秒,Output 會顯示一次你的名字與「stepped on the pad」。在上面走來走去:新的一行最多每 2 秒出現一次,而不是每次 Touched 觸發就出現。
- 按下 E。踏板變成半透明(Transparency 0.6)。再按一次 E,它就不透明了。
- 按下 Stop。在測試清單中選擇 Server & Clients,設定 2 個用戶端,按下 Play(或 F7)。Studio 會開啟一個伺服器視窗與兩個用戶端視窗。在其中一個用戶端按 E:踏板在那裡變得更透明,而另一個用戶端與伺服器顯示它仍是不透明的。結束後按下 End Session。
- 故意弄壞一些東西。把 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 可以這樣放:
| 容器 | 放什麼 | 原因 |
|---|---|---|
| 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 會顯示:
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 的組成元件。接下來建議的順序是:
- LocalScript vs Script vs ModuleScript:每種 Script 在哪裡執行、可以改變什麼,比步驟 4 更深入。
- RemoteEvents:LocalScript 如何請伺服器做事,以及伺服器如何檢查請求。
- 排行榜:你的第一組數據,在伺服器上建立與修改。
- 你的第一個遊戲:一條有熔岩、金幣與終點踏板的短關卡,用兩個伺服器 Script 完成,然後發布。
- 然後選一個系統:商店 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。
- 在 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,試試練習題,接著完成第一個遊戲教學,再一次加入一個系統。
來源與延伸閱讀
- Roblox Creator Docs:Luau(英文). Luau 是什麼、從哪裡來
- Roblox Creator Docs:Roblox Studio setup(英文). Windows 與 Mac、系統需求
- Roblox Creator Docs:Output(英文). 開啟 Output、篩選、Show Context 與 Show Source
- Roblox Creator Docs:Studio testing modes(英文). Play、Run、Stop、Client/Server 切換鈕與 Server & Clients
- Roblox Creator Docs:Script Editor(英文). 新的 Script 在哪裡開啟,以及 Script Analysis
- Roblox Creator Docs:Script types and locations(英文). 每種 Script 在哪裡執行,以及用標籤取代零件中的 Script
- Roblox Creator Docs:Script(英文). Script 何時開始執行
- Roblox Creator Docs:Control structures(英文). 條件、迴圈,以及為什麼無限迴圈需要等待
- Roblox Creator Docs:Events(英文). Connect,以及 Touched 傳給函式的內容
- Roblox Creator Docs:Debounce patterns(英文). 為什麼一次碰觸會讓 Touched 觸發好幾次
- Roblox Creator Docs:wait(英文). 全域的 wait() 與 task.wait()
- Roblox Creator Docs:Network ownership, movement validation and physics exploits(英文). 用戶端可以對自己的角色做什麼
- Roblox Creator Docs:Coding fundamentals(英文). Roblox 給新手的系列教學
程式碼如何驗證:本頁每一段 Script 都通過 Luau 嚴格型別檢查,並使用 Roblox API 定義(luau-lsp,2026年11月20日)。型別檢查能找出拼錯的 API 與錯誤的型別,但無法檢查遊戲邏輯,所以發布前請先在 Studio 中測試。