教程 · 脚本基础

Roblox Studio 怎么写脚本:新手入门教程

在 Roblox Studio 里写脚本,也就是编程,意思是用 Luau(Roblox 版本的 Lua 语言)在你添加到场景里的脚本中写代码。本教程从一个空的 Baseplate 开始:你会打开 Output 窗口,写出第一个脚本,用代码修改零件,对踩上踏板的玩家做出反应,并尝试 LocalScript,同时一路弄懂变量、函数、条件、循环和事件。

更新于 2026年11月20日阅读约 5 分钟作者

要点

要在 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。
本页内容
  1. 开始之前
  2. 1. 第一个脚本
  3. 2. 修改零件
  4. 3. 事件
  5. 4. 第一个 LocalScript
  6. 5. 测试
  7. 脚本放在哪里
  8. 阅读错误
  9. 旧教程
  10. 练习
  11. 接下来
  12. Common errors
  13. 使用 RoCode
  14. 常见问题
  15. 参考资料

开始之前:Studio、Baseplate 和 Output 窗口

示意四个脚本在同一次试玩中运行:ColourChanger 零件每秒换一次颜色,踩上 Pad 会让它对所有玩家变黄 2 秒并在 Output 中写下你的名字,而按 E 只会让这个屏幕上的 Pad 变得更透明。

你需要 Roblox Studio 和一个 Roblox 账户,别的都不需要:不需要代码编辑器,也不需要插件。本教程的每个脚本都在 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。你的脚本输出的信息和错误会显示在这里。
  5. 在 Output 窗口的显示设置中开启 Show Context(把每条信息标记为 Client 或 Server)和 Show Source(显示信息来自哪个脚本和第几行)。
你将要写的四个脚本
脚本类型放在哪里学到什么
FirstScriptScriptServerScriptService变量、函数、if 条件、循环和表
ColourChangerScriptWorkspace 中的某个 Part 内部修改属性、script.Parent 以及带等待的循环
TouchPadScript名为 Pad 的 Part 内部事件、找出碰到零件的玩家,以及 debounce
MyFirstLocalScriptLocalScriptStarterPlayer 内的 StarterPlayerScripts单个玩家设备上的代码、按键,以及哪些改动只留在这台设备上
最终的 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 步:写出第一个脚本

  1. 在 Explorer 中把鼠标移到 ServerScriptService 上,点击 + 并选择 Script(快捷键 Ctrl+I,Mac 上是 ⌘I)。Studio 会创建脚本并在 Script Editor 中打开它。
  2. 右键点击新脚本,选择 Rename,把它命名为 FirstScript。名字不会改变脚本做的事,但能告诉你是哪个脚本打印了什么。
  3. 新脚本一开始只有一行 print("Hello world!")。删掉它,粘贴下面的代码。
  4. 在 Play 左边的列表中选择 Test,然后点击 Play(F5)。Studio 会开始试玩,并把角色放在 SpawnLocation 上。
  5. 阅读 Output 中的输出,然后点击 Stop(Shift+F5)。Stop 还会把所有对象恢复到点击 Play 之前的状态,所以游戏过程中你移动或改色的东西都会复原。
Script 位置: ServerScriptService 名称: FirstScript
-- 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 和行号。

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 表示只有这个脚本或它所在的代码块能使用它。引号里的文本是字符串;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,整个脚本都无法运行;阅读错误一节会告诉你会看到什么提示。

第 2 步:用脚本修改零件

脚本在改变世界里的东西时才变得有用。你在 Properties 窗口里看到的设置,比如零件的 Color、Transparency 或 Anchored,都是属性,脚本也可以设置它们。

  1. 在 Home 选项卡上点击 Part。Studio 会在 Workspace 中添加一个方块。它叫什么名字无所谓。
  2. 在 Explorer 中把鼠标移到新零件上,点击 + 并插入一个 Script。把它重命名为 ColourChanger,并把内容换成下面的代码。
  3. 点击 Play。零件变红,然后变蓝,然后变绿,每秒换一次,然后重新开始。
Script 位置: Workspace 中的任意零件 名称: ColourChanger
-- 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 把这些称为事件。要在事件触发时运行代码,就给它连接一个函数。

  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 内部的 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)
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 中的 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、LocalScript 和 ModuleScript
类型在哪里运行改动传到哪里用来做什么通常放在
Script服务端所有玩家游戏规则:金币、伤害、门、回合、存档ServerScriptService,学习阶段也可以放在零件内部
LocalScript单个玩家的设备只在这台设备上,自己角色的移动除外输入、镜头、屏幕菜单、单个玩家的效果StarterPlayerScripts 或 StarterGui
ModuleScript对它调用 require() 的那一端和引用它的脚本一样多个脚本共用的代码两端都用放 ReplicatedStorage,只给服务端用放 ServerScriptService

作弊者能改什么

要假设作弊者能控制他自己设备上的一切。他可以运行自己的 LocalScript,也可以修改你的,所以他能在自己的屏幕上把踏板或任何东西变透明。这里这没有危害:透明度只影响外观,而且只留在他的设备上。正因如此,一切重要的事都由服务端的 Script 决定。

服务端的 Script 也不会自动就是安全的。TouchPad 在服务端运行,但每个玩家的设备控制着自己角色的物理,Roblox 的安全文档在列举客户端能对其控制的零件做什么时,就提到了控制 Touched 的触发时机,甚至完全阻止它触发。对发光踏板来说这无关紧要。对会发钱的踏板,还要检查服务端自己记录的内容,比如跑酷教程中的规则:存档点只能按顺序计入。

第 5 步:同时测试四个脚本

  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 是弄清脚本为什么什么都不做的最快办法。停止游戏,删掉 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 会显示:

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:客户端看到的是服务端设置的颜色,因为服务端的改动会传到所有客户端。

接下来学什么

现在你已经用过构成大多数游戏脚本的那些部件。接下来比较好的顺序是:

  1. LocalScript vs Script vs ModuleScript:每种脚本在哪里运行、能改什么,比第 4 步讲得更深入。
  2. RemoteEvents:LocalScript 如何请求服务端做某件事,以及服务端如何检查这个请求。
  3. 排行榜:你的第一批由服务端创建和修改的数据。
  4. 你的第一个游戏:用两个服务端脚本做一条带熔岩、金币和终点踏板的短赛道,然后发布。
  5. 然后选一个系统:商店 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。

RoCode 的操作
  • 在 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 API 类型定义(luau-lsp,2026年11月20日)通过 Luau strict 类型检查。类型检查能发现 API 名称写错和类型不匹配,但发现不了游戏逻辑上的错误。发布前请务必在 Studio 中测试。

在你自己的游戏里试试 RoCode。

每天有免费额度,无需绑定银行卡。安装插件,描述你想要的功能,然后看看它在 Studio 里做了什么。