要点
要在 Roblox Studio 中写脚本,在 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(...))。本教程的四个脚本就是用它们搭起来的,再加上循环和表。 - 使用
task.wait(),而不是wait()。Roblox 参考文档把全局的wait()标为已弃用,并由task.wait()取代。 - 在 Output 窗口的显示设置中开启 Show Context,这样每一行都会显示它来自 Server 还是 Client。
开始之前:Studio、Baseplate 和 Output 窗口
你需要 Roblox Studio 和一个 Roblox 账户,别的都不需要:不需要代码编辑器,也不需要插件。本教程的每个脚本都在 Studio 自带的 Script Editor 里输入。
- 安装 Roblox Studio(Roblox 为 Windows 和 Mac 提供的免费应用),并用 Roblox 账户登录。
- 打开 Studio。起始页上有模板:选择 Baseplate。你会得到一块带 4x4 网格纹理的地面和一个 SpawnLocation,也就是游戏时你的角色出现的位置。
- 如果看不到 Explorer 和 Properties 窗口,从 Window 菜单或 Home 选项卡打开它们。Explorer 列出场景里的所有对象;Properties 显示选中对象的设置。
- 从 Window 菜单或 Script 选项卡打开 Output。你的脚本输出的信息和错误会显示在这里。
- 在 Output 窗口的显示设置中开启 Show Context(把每条信息标记为 Client 或 Server)和 Show Source(显示信息来自哪个脚本和第几行)。
| 脚本 | 类型 | 放在哪里 | 学到什么 |
|---|---|---|---|
FirstScript | Script | ServerScriptService | 变量、函数、if 条件、循环和表 |
ColourChanger | Script | Workspace 中的某个 Part 内部 | 修改属性、script.Parent 以及带等待的循环 |
TouchPad | Script | 名为 Pad 的 Part 内部 | 事件、找出碰到零件的玩家,以及 debounce |
MyFirstLocalScript | LocalScript | StarterPlayer 内的 StarterPlayerScripts | 单个玩家设备上的代码、按键,以及哪些改动只留在这台设备上 |
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 步:写出第一个脚本
- 在 Explorer 中把鼠标移到 ServerScriptService 上,点击 + 并选择 Script(快捷键 Ctrl+I,Mac 上是 ⌘I)。Studio 会创建脚本并在 Script Editor 中打开它。
- 右键点击新脚本,选择 Rename,把它命名为
FirstScript。名字不会改变脚本做的事,但能告诉你是哪个脚本打印了什么。 - 新脚本一开始只有一行
print("Hello world!")。删掉它,粘贴下面的代码。 - 在 Play 左边的列表中选择 Test,然后点击 Play(F5)。Studio 会开始试玩,并把角色放在 SpawnLocation 上。
- 阅读 Output 中的输出,然后点击 Stop(Shift+F5)。Stop 还会把所有对象恢复到点击 Play 之前的状态,所以游戏过程中你移动或改色的东西都会复原。
-- ServerScriptService 中的 Script,名为 FirstScript。
-- 你的第一段 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 表示只有这个脚本或它所在的代码块能使用它。引号里的文本是字符串;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,整个脚本都无法运行;阅读错误一节会告诉你会看到什么提示。
第 2 步:用脚本修改零件
脚本在改变世界里的东西时才变得有用。你在 Properties 窗口里看到的设置,比如零件的 Color、Transparency 或 Anchored,都是属性,脚本也可以设置它们。
- 在 Home 选项卡上点击 Part。Studio 会在 Workspace 中添加一个方块。它叫什么名字无所谓。
- 在 Explorer 中把鼠标移到新零件上,点击 + 并插入一个 Script。把它重命名为
ColourChanger,并把内容换成下面的代码。 - 点击 Play。零件变红,然后变蓝,然后变绿,每秒换一次,然后重新开始。
-- Workspace 中某个 Part 内部的 Script,名为 ColourChanger。
-- 脚本修改的就是 Properties 窗口里看到的那些属性。
-- 这个脚本每秒给它所在的零件换一种新颜色,对所有玩家生效。
local part = script.Parent :: BasePart -- 这个脚本所在的零件
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是脚本所在的对象,这里就是零件。把脚本拖到另一个零件里,它就会去改那个零件。:: BasePart是类型转换。它告诉 Script Editor 父级是一个零件,以便检查用到的属性。Luau 只把类型用于提示和自动补全,所以这个转换不会改变这一行做的事。part.Color和part.Anchored就是 Properties 窗口里的那些属性,名字也一样。Roblox 使用美式拼写,所以属性叫Color,尽管脚本叫 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 步会展示另一种脚本。
第 3 步:通过事件对玩家做出反应
大部分游戏代码都在等待某件事发生:玩家进入,零件被碰到,按钮被按下。Roblox 把这些称为事件。要在事件触发时运行代码,就给它连接一个函数。
- 再插入一个 Part,把它准确地重命名为
Pad,P 大写。让它直接放在 Workspace 里,不要放进文件夹或模型,因为第 4 步的 LocalScript 会在那里找它。 - 把它做成一块可以站上去的扁平踏板,比如在 Properties 窗口中把
Size设为6, 1, 6。把它放在 SpawnLocation 旁边的地面上,并勾选 Anchored,让它不会移动。 - 把鼠标移到 Pad 上,点击 +,插入一个 Script,重命名为
TouchPad,并粘贴下面的代码。 - 点击 Play 并站到踏板上。它会变黄 2 秒,Output 会写出你的名字。
-- Workspace 中名为 Pad 的 Part 内部的 Script,脚本名为 TouchPad。
-- 事件:玩家踩上踏板时,它会发出黄光,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 中的 LocalScript,名为 MyFirstLocalScript。
-- 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是运行这个脚本的设备所属的玩家。Roblox 只为 LocalScript 以及它们引用的 ModuleScript 设置它,所以服务端代码不能使用它。UserInputService.InputBegan在玩家开始按键、点击或触摸时触发。当引擎已经用掉了这次输入(比如点击按钮或在聊天栏里按键)时,gameProcessed为true,所以脚本会忽略它。workspace:FindFirstChild("Pad")返回名为 Pad 的子对象,如果没有则返回nil。pad:IsA("BasePart")在脚本修改它的Transparency之前确认它确实是零件。if pad.Transparency == 0 then 0.6 else 0是 if 表达式:它在两个值中选一个。Transparency 为 0 表示完全可见,1 表示不可见。- 按 Shift 冲刺脚本很适合作为第二个 LocalScript:它监听按键并修改角色的 WalkSpeed。
| 类型 | 在哪里运行 | 改动传到哪里 | 用来做什么 | 通常放在 |
|---|---|---|---|---|
| Script | 服务端 | 所有玩家 | 游戏规则:金币、伤害、门、回合、存档 | ServerScriptService,学习阶段也可以放在零件内部 |
| LocalScript | 单个玩家的设备 | 只在这台设备上,自己角色的移动除外 | 输入、镜头、屏幕菜单、单个玩家的效果 | StarterPlayerScripts 或 StarterGui |
| ModuleScript | 对它调用 require() 的那一端 | 和引用它的脚本一样 | 多个脚本共用的代码 | 两端都用放 ReplicatedStorage,只给服务端用放 ServerScriptService |
作弊者能改什么
要假设作弊者能控制他自己设备上的一切。他可以运行自己的 LocalScript,也可以修改你的,所以他能在自己的屏幕上把踏板或任何东西变透明。这里这没有危害:透明度只影响外观,而且只留在他的设备上。正因如此,一切重要的事都由服务端的 Script 决定。
服务端的 Script 也不会自动就是安全的。TouchPad 在服务端运行,但每个玩家的设备控制着自己角色的物理,Roblox 的安全文档在列举客户端能对其控制的零件做什么时,就提到了控制 Touched 的触发时机,甚至完全阻止它触发。对发光踏板来说这无关紧要。对会发钱的踏板,还要检查服务端自己记录的内容,比如跑酷教程中的规则:存档点只能按顺序计入。
第 5 步:同时测试四个脚本
- 用 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 是弄清脚本为什么什么都不做的最快办法。停止游戏,删掉 print 那一行,把零件的名字改回 Pad。
脚本应该放在哪里
脚本放在哪里,决定了它到底会不会运行,而如果它永远不会运行,Studio 也不会提醒你。对你接下来要写的脚本:
| 容器 | 放什么 | 为什么 |
|---|---|---|
| ServerScriptService | 承载大部分游戏规则的脚本:奖励、回合、存档 | 它们在服务端运行,ServerScriptService 里的任何东西都不会发送给玩家。 |
| Workspace 中的零件内部 | 只与一个零件有关的 Script,比如 ColourChanger 和 TouchPad | 学习阶段没问题:零件就是 script.Parent。对正式项目,Roblox 建议改为给零件打标签(见下文)。 |
| StarterPlayer 内的 StarterPlayerScripts | 大多数 LocalScript:输入、镜头、单个玩家的效果 | 每个玩家进入时都会得到自己的一份副本。 |
| StarterGui | 放在 ScreenGui 里、控制屏幕菜单的 LocalScript | 每个玩家都会得到自己的一份界面副本。 |
| ReplicatedStorage | 服务端和客户端代码都会引用的 ModuleScript | 两端都能看到它。默认设置的 LocalScript 或 Script 放在这里永远不会运行。 |
Roblox 关于脚本位置的页面建议根本不要把脚本直接放进 Workspace 的零件里:给零件打标签,然后通过 CollectionService 从一个 ModuleScript 统一处理它们。放在零件里的脚本仍然是最简单的起步方式,学习阶段用在一两个对象上没有问题。门教程展示了用标签、一个脚本管所有门的模式,而客户端与服务端教程有一张完整的表,列出哪些容器会运行哪些脚本。
出问题时:阅读 Output
错误在 Output 中以红色显示。每条错误先写出发生的位置、脚本的完整名称和行号,然后说明哪里不对。点击错误,Studio 会在那一行打开脚本。例如,如果你从 TouchPad 中删掉 if not player 检查,而一个散落的零件掉到了踏板上,Output 会显示:
Workspace.Pad.TouchPad:22: attempt to index nil with 'Name'
代码写法上的错误,比如少了 end,在点击 Play 之前就能看到:Script Editor 会用红色下划线标出它们,Script Analysis 窗口(Script 选项卡上的 Analysis 按钮)会把它们列出来。有这种错误的脚本完全不会运行,连错误上方的行也不会。
| 提示信息 | 含义 | 如何修复 |
|---|---|---|
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 根据缩进做的猜测,可能指向错误的代码块,所以先检查括号里的那一行。关于语法错误的更多内容。 |
如果脚本什么都不做,Output 也是空的,通常是脚本放在了永远不会运行的位置,或者在等一个不会触发的事件。错误教程中有无报错脚本的排查清单,以及关于阅读 Output 的更多内容。
旧的脚本教程有哪些不同的做法
如果你还在看视频和论坛帖子学习,你会碰到一些旧的写法。下面是重要的几种,以及每一种为什么有问题。
| 旧教程 | 问题 | 本教程 |
|---|---|---|
用 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 脚本。然后在 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:客户端看到的是服务端设置的颜色,因为服务端的改动会传到所有客户端。
接下来学什么
现在你已经用过构成大多数游戏脚本的那些部件。接下来比较好的顺序是:
- LocalScript vs Script vs ModuleScript:每种脚本在哪里运行、能改什么,比第 4 步讲得更深入。
- RemoteEvents:LocalScript 如何请求服务端做某件事,以及服务端如何检查这个请求。
- 排行榜:你的第一批由服务端创建和修改的数据。
- 你的第一个游戏:用两个服务端脚本做一条带熔岩、金币和终点踏板的短赛道,然后发布。
- 然后选一个系统:商店 GUI、回合系统、跑酷存档点、加载界面或按键播放动画。出问题时,脚本错误教程能帮你读懂提示信息。存档点教程目前只有英文版。
Roblox 自己的 Coding fundamentals 教程(英文)是本教程很好的补充:六个系列,从变量和函数,经过条件、循环、数组和字典,一直讲到用 ModuleScript 组织代码,并配有在 Studio 中完成的小项目。
常见错误与解决办法
第一批脚本的大多数问题都是名字对不上、脚本放错位置,或者循环里没有等待。测试时一直开着 Output。
点击 Play 时 Studio 卡住或无响应
while true do 循环里没有等待,所以别的东西都无法运行。Roblox 文档说,没有 task.wait() 之类延迟的无限循环会让游戏卡死、让 Studio 崩溃。在每个无限循环里都放上 task.wait(),就像 ColourChanger 那样。
我站到踏板上什么都没发生
检查 TouchPad 是 Script 而不是 LocalScript,它直接放在 Pad 零件内部,没有被禁用,并且踏板的 CanTouch 属性已勾选。然后把 print("touched", otherPart.Name) 作为 onTouched 内部的第一行。如果没有打印,说明事件没有触发;如果打印了,问题在下面的代码里。
按 E 没有反应
MyFirstLocalScript 必须是放在 StarterPlayerScripts 里的 LocalScript:放在 Workspace 或 ServerScriptService 中的 LocalScript 永远不会运行。零件必须正好叫 Pad,并直接放在 Workspace 中。先点击一下游戏窗口,确认你没有在聊天里打字,因为脚本会忽略游戏已经使用过的按键。
零件在我的屏幕上变了,但其他玩家看不到
这个改动是 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 以及按文本过滤。如果它开着却仍然是空的,脚本可能根本没有运行。请看什么都不做的脚本的排查清单。
卡住时:RoCode
如果你在自己场景里的某个脚本上卡住了,RoCode 可以和你一起分析它。RoCode 是独立的 Roblox Studio AI 代理,与 Roblox 无关:你在网页聊天里写,它的 Studio 插件会在你的 Explorer 中创建和修改脚本。
学习阶段,Ask 模式很有用:脚本由你来写,RoCode 读取已有的内容并回答问题。
逐行解释 Pad 零件里的 TouchPad 脚本在做什么,以及它为什么要用 debounce。
- 在 Ask 模式下只使用 Search Scripts 和 Read Script 等读取工具,不改动场景里的任何东西
- 如果有需要修复的地方,会说明它会改什么、改在哪里,并建议切换到 Build
- 在 Build 模式下直接修改脚本,然后用 Check Script 检查每一个。这是编译检查,不是类型检查,也不是试玩
- 用 Check Output 工具读取 Studio 的 Output,包括你上一次试玩的 Server 和 Client 行,即使已经点了 Stop 也可以
在 Build 模式下,使用插件 3.9 或更新版本时 RoCode 可以运行简短试玩并读取错误,使用 3.9.11 或更新版本时还能操控测试角色,但它在游戏运行时不截图,所以你仍然需要自己站上踏板试试。RoCode 如何连接 Studio。
常见问题
在 Roblox Studio 里应该在哪里写脚本?
在 Explorer 中把鼠标移到某个容器上,比如 ServerScriptService,点击 + 并选择 Script。Studio 会在 Script Editor 中打开它,你在那里写 Luau。服务端脚本通常放在 ServerScriptService;LocalScript 放在 StarterPlayerScripts 或 StarterGui。
怎么在 Roblox Studio 里运行脚本?
点击 Play(F5)。Studio 会开始试玩,ServerScriptService 或 Workspace 中每个启用的 Script 会在游戏开始时立即运行;StarterPlayerScripts 中的 LocalScript 会在你进入试玩时运行。Run(在 Play 旁边的列表中选择,或按 F8)会在没有角色的情况下运行游戏,所以本教程请使用 Play。Stop(Shift+F5)结束测试。要打开已有的脚本,在 Explorer 中双击它。
Roblox 用的是什么编程语言?
Luau。Roblox 把它描述为一种快速、小巧、安全、支持渐进类型的脚本语言,源自 Lua 5.1,所以大多数 Lua 教程依然有用。Luau 增加了反引号字符串插值和可选类型注解等功能,Roblox 还加入了自己的库和对象,比如 task.wait。
Script 和 LocalScript 有什么区别?
Script 在服务端运行,它的改动会传到所有玩家那里。LocalScript 在单个玩家的设备上运行,用于输入、镜头和屏幕菜单,它对零件、数值和界面的改动只留在这台设备上。客户端与服务端教程(英文)讲解了这两者以及 ModuleScript。
可以在手机或 iPad 上写 Roblox Studio 脚本吗?
Roblox 的安装页面把 Studio 描述为 Windows 和 Mac 上的免费应用,没有提到手机或平板版本,所以写脚本需要电脑。
为什么我的脚本什么都不做,也不报错?
通常是它放在了这种脚本不会运行的位置(Workspace 中的 LocalScript 或 StarterPlayerScripts 中的 Script),或者它被禁用了,又或者它等待的事件没有触发。错误教程中有一份排查清单。
学会 Roblox 脚本需要多长时间?
没人能给出一个诚实的数字:这取决于你做了多少东西。最有帮助的是经常在自己的场景里写小脚本。修改这里的四个脚本,试试练习题,然后学习第一个游戏教程,再一次加一个系统。
参考资料
- 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 Analysis
- Roblox Creator Docs: Script types and locations(英文). 每种脚本在哪里运行,以及用标签代替零件里的脚本
- 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 面向新手的系列教程
代码如何验证:本页的所有脚本都已用 Roblox API 类型定义(luau-lsp,2026年11月20日)通过 Luau strict 类型检查。类型检查能发现 API 名称写错和类型不匹配,但发现不了游戏逻辑上的错误。发布前请务必在 Studio 中测试。