教程 · 游戏系统

Roblox Studio 怎么做门

Roblox 里一扇能用的门需要三样东西:玩家按的东西(写着 "Open" 的 ProximityPrompt)、平滑的移动(TweenService),以及由服务端做出改动,让所有玩家看到同一扇门。在这篇教程里,我们写一个脚本,为每扇带标签的门做到这些,无论是平开门还是推拉门,还可以加一把可选的钥匙锁:服务端会先检查钥匙,再打开任何东西。

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

要点

把门做成 Part 或 Model,勾选 Anchored,把它的 pivot 移到装合页的那一边(Model 选项卡,Pivot),并在 Properties 窗口中添加标签 Door。ServerScriptService 里的一个 Script 通过 CollectionService 找到所有带标签的门,添加一个 ProximityPrompt("Open",长按 E),并在 Triggered 事件中把一个 NumberValue 从 0 补间到 1,通过 door:PivotTo(closedPivot:Lerp(openPivot, alpha)) 移动门。每扇门上的 Attribute 决定它是平开还是推拉、角度、时间、自动关门和钥匙。

  • Model 的位置不能直接补间:Model 没有 CFrame 或 Position 属性,而它的 WorldPivot 只决定 pivot 的位置。请补间 NumberValue,再用 PivotTo 移动门:Roblox 称它是在脚本中移动模型的主要方式。
  • 在服务端开门。在 LocalScript 中打开的门只会在那个玩家的屏幕上移动。
  • 在服务端检查钥匙和距离。Roblox 的安全指南说,ProximityPrompt 和 RemoteEvent 一样可能被滥用,并且就在那里举了一个服务端必须做的检查的例子:玩家是否持有开门所需的钥匙。
本页内容
  1. 工作方式
  2. 1. 做门
  3. 2. 门脚本
  4. 推拉门
  5. 钥匙门
  6. 旧教程
  7. 防护的边界
  8. 3. 测试
  9. 扩展
  10. Common errors
  11. 用 RoCode
  12. 常见问题
  13. 参考资料

脚本门的工作方式

示意长按 E 0.2 秒,门在 0.6 秒内打开,完全打开 4 秒后自动关上(这里已加速)。对没有 RedKey 的玩家,VaultDoor 保持关闭。

在真正的游戏里能用的门,必须由服务端来移动。如果由 LocalScript 移动,门只会在一个玩家的屏幕上打开,对其他所有人仍然是关着的,因为客户端做出的改动只留在那台设备上(参见 哪些会复制,哪些不会)。所以在这篇教程里,玩家的设备只负责显示提示并报告按键,其他一切都由一个服务端 Script 完成。一次开门的过程如下:

  1. 玩家走到离门 8 格(stud)以内,出现一个提示,动作是 Open,对象名称是 Door,键盘按键是 E。在手柄或触摸屏上,Roblox 会显示对应的按钮。
  2. 玩家长按 E 0.2 秒。提示的 Triggered 事件在服务端带着这个玩家触发。
  3. DoorService 检查玩家:是否活着、是否足够近、是否在狂按提示,以及门需要钥匙时是否带着钥匙。
  4. 脚本把一个数字从 0(关闭)补间到 1(打开)。数字每次变化时,它都通过 PivotTo 把门从关闭位置向打开位置移动相应的比例。
  5. 完全打开四秒后,门以同样的方式关上。在移动过程中再按一次,门会从当前位置折返。
门系统由哪些部分组成
组成部分位置作用
Script DoorServiceServerScriptService找到所有门,给每扇门加上提示,检查每次使用并移动门。是本教程里唯一的脚本。
标签 Door每扇门的 Part 或 Model 上标记哪些是门。标签在 Properties 窗口中添加,并随场景一起保存。
Attribute,例如 Style 和 KeyName每扇门上(可选)单扇门的设置:平开还是推拉、角度、速度、自动关门和钥匙。
ProximityPrompt DoorPrompt门内部(由 DoorService 添加)显示 "Open" 或 "Close",并在玩家长按 E 时触发 Triggered。
NumberValue DoorProgress门内部(由 DoorService 添加)补间在 0 和 1 之间移动的数字。每次变化都会移动门。
Tool RedKey(可选)StarterPack,用于测试上锁的门的钥匙。任何 Tool 都可以,只要它的名字与门的 KeyName 一致。
完成本教程后的 Explorer。两扇门都有 Door 标签,VaultDoor 还有 Attribute Style = Slide 和 KeyName = RedKey。游戏运行时,DoorService 会在每扇门里添加 DoorProgress,并在挂提示的零件里添加 DoorPrompt。
Workspace
  FrontDoor Part new
  VaultDoor Model new
    Panel Part new
    Knob Part new
ServerScriptService
  DoorService Script new
StarterPack
  RedKey Tool new
    Handle Part new

第 1 步:做好门并设置合页

  1. 在 Explorer 中把鼠标悬停在 Workspace 上,点击 + 按钮,插入一个 Part。把它命名为 FrontDoor,把 Size 设为大约 4, 7, 0.5(宽 4 格,高 7 格,厚半格),放进门洞里。由多个零件组成的门也可以:选中它们,按 Ctrl+G 组合成一个 Model。
  2. 给门的每个零件勾选 Anchored,并保持 CanCollide 开启。锚固的零件永远不会因重力或碰撞而移动,但脚本仍然可以移动它们,DoorService 做的正是这件事。
  3. 设置合页。选中门,打开 Model 选项卡,开启 Pivot。按住 Pivot 按钮角上的小箭头,勾选 Snap,让 pivot 吸附到角、边和中心的参考点上。把 pivot 拖到门上本该装合页的那一边。推拉门的 pivot 可以留在中心。
  4. 添加标签。保持门的选中状态,把 Properties 窗口滚动到 Tags,点击 +,输入首字母大写的 Door。如果门是 Model,标签要加在 Model 本身上,而不是里面的零件上。
  5. 再做第二扇门,推拉门和钥匙的章节会用到它。在 Workspace 中再插入两个 Part:大约 4, 7, 0.5 的 Panel,以及大约 0.5, 0.5, 0.5 的 Knob,贴在 Panel 的一个面上。选中两者,按 Ctrl+G,把新的 Model 重命名为 VaultDoor。把两个零件都锚固,把模型放进第二个门洞,并在 Model 上添加标签 Door。它的 pivot 可以留在中心,因为这扇门会是推拉门。

pivot 很重要,因为平开门是绕着它旋转的。如果留在中心,门会在原地转圈,就像商场的旋转门。对零件来说,你设置的 pivot 会保存为 PivotOffset,GetPivot 会把它考虑在内,所以脚本会精确地绕你选的点旋转门。如果 Model 有 PrimaryPart,模型的 pivot 就是这个零件的 pivot,DoorService 也会把提示挂在它上面。没有 PrimaryPart 时,提示会挂在模型里找到的第一个零件上。如果要设置 PrimaryPart,请在移动 pivot 之前设置:按 Roblox 关于 Pivot tools 的页面所说,指定 PrimaryPart 会把模型的 pivot 移到这个零件的 pivot 上。

门的设置(Attribute)

任何门都可以使用下表中的默认值工作。要修改某一扇门,选中它,把 Properties 窗口滚动到 Attributes,点击 +,输入名称,选择类型并点击 Save,然后设置值。DoorService 在设置门时只读取一次 Attribute,所以请在游戏停止时修改它们。

每扇门上可选的 Attribute
Attribute类型默认值作用
StylestringSwingSwing 让门绕自己的 pivot 旋转。Slide 让它沿宽度方向侧移。
OpenAnglenumber90平开门旋转的角度。负数会让它往另一个方向打开。请把值保持在 -179 到 179 之间:门总是走较短的弧线,所以 DoorService 会把角度限制在这个范围内。
SlideDistancenumber门的宽度推拉门沿自身宽度移动多少格。负数会让它往另一个方向移动。
OpenSecondsnumber0.6完全打开或关闭所需的时间,范围 0.05 到 10。
AutoCloseSecondsnumber4门完全打开后停留多久再自动关上。0 表示一直开着,直到有人把它关上。
KeyNamestring无玩家开门必须持有的 Tool 名称,例如 RedKey。任何人都能打开的门不要设置它。

第 2 步:添加门脚本

把鼠标悬停在 ServerScriptService 上,插入一个名为 DoorService 的 Script,把下面的代码粘贴进去。不管你给多少扇门加了标签,它都会管理场景里的所有门。开头的三个设置作用于所有门;第 1 步中的 Attribute 修改单扇门。

Script 位置: ServerScriptService 名称: DoorService
-- ServerScriptService 中名为 DoorService 的 Script。
-- 通过长按 E 的提示,打开和关闭每个带 "Door" 标签的 Part 或 Model。
-- 门由服务端移动,所以所有玩家看到的是同一扇门;也由服务端
-- 检查距离和钥匙,所以没人能从远处打开上锁的门。
--
-- 每扇门上可选的 Attribute(在 Properties 窗口中设置):
--   Style            string  "Swing"(默认)或 "Slide"
--   OpenAngle        number  平开门绕 pivot 转动的角度(默认 90,范围 -179 到 179)
--   SlideDistance    number  推拉门沿自身宽度移动的格数(默认:门的宽度)
--   OpenSeconds      number  打开所需的时间(默认 0.6)
--   AutoCloseSeconds number  过这么多秒后重新关上;0 表示保持打开(默认 4)
--   KeyName          string  玩家必须持有的 Tool 名称,例如 "RedKey"

local CollectionService = game:GetService("CollectionService")
local TweenService = game:GetService("TweenService")

local DOOR_TAG = "Door"
local PROMPT_DISTANCE = 8 -- 格(stud)
local MIN_SECONDS_BETWEEN_USES = 0.3 -- 每扇门单独计算,防止狂按提示

local doorsSetUp: { [Instance]: boolean } = {}

local function attribute(door: Instance, name: string, default: any): any
	local value = door:GetAttribute(name)
	if value == nil or typeof(value) ~= typeof(default) then
		return default
	end
	if typeof(value) == "number" and (value ~= value or math.abs(value) == math.huge) then
		return default -- 在 Properties 窗口中输入的 NaN 或无穷大
	end
	return value
end

local function hasKey(player: Player, keyName: string): boolean
	local backpack = player:FindFirstChildOfClass("Backpack")
	local character = player.Character
	local inBackpack = backpack and backpack:FindFirstChild(keyName)
	local held = character and character:FindFirstChild(keyName)
	return (inBackpack ~= nil and inBackpack:IsA("Tool")) or (held ~= nil and held:IsA("Tool"))
end

local function setUpDoor(door: Instance)
	if doorsSetUp[door] or not (door:IsA("BasePart") or door:IsA("Model")) then
		return -- 已经是可用的门,或者既不是零件也不是模型
	end
	local promptPart = if door:IsA("Model") then (door.PrimaryPart or door:FindFirstChildWhichIsA("BasePart", true)) else door
	if not (promptPart and promptPart:IsA("BasePart")) then
		warn(`DoorService: {door:GetFullName()} has no part to put the prompt on`)
		return
	end

	doorsSetUp[door] = true
	door.Destroying:Connect(function()
		doorsSetUp[door] = nil
	end)
	-- 复制一扇可用的门时会带上旧的提示和数值:把它们删掉
	for _, leftover in door:GetDescendants() do
		if leftover.Name == "DoorPrompt" or leftover.Name == "DoorProgress" then
			leftover:Destroy()
		end
	end

	-- 关闭和打开的位置只计算一次,以门现在所在的位置为准
	local closedPivot = door:GetPivot()
	local openPivot: CFrame
	if attribute(door, "Style", "Swing") == "Slide" then
		-- 沿门较长的水平边,也就是宽度移动。Model 沿其 pivot 的各边测量,
		-- Part 按自身的 Size 测量,所以不要旋转推拉零件的 pivot
		local size = if door:IsA("Model") then door:GetExtentsSize() else (door :: BasePart).Size
		local alongX = size.X >= size.Z
		local width = if alongX then size.X else size.Z
		local direction = if alongX then Vector3.xAxis else Vector3.zAxis
		openPivot = closedPivot * CFrame.new(direction * attribute(door, "SlideDistance", width))
	else
		-- Lerp 总是沿较短的弧线旋转,所以更大的角度会让门往错误的方向打开
		local angle = math.clamp(attribute(door, "OpenAngle", 90), -179, 179)
		openPivot = closedPivot * CFrame.Angles(0, math.rad(angle), 0)
	end
	local openSeconds = math.clamp(attribute(door, "OpenSeconds", 0.6), 0.05, 10)
	local autoClose = math.max(attribute(door, "AutoCloseSeconds", 4), 0)
	local keyName = attribute(door, "KeyName", "")

	-- 把一个数字从 0(关闭)补间到 1(打开),并让门跟着它移动。
	-- PivotTo 会让单个零件或整个模型绕其 pivot 移动。
	local progress = Instance.new("NumberValue")
	progress.Name = "DoorProgress"
	progress.Parent = door
	progress.Changed:Connect(function(alpha: number)
		door:PivotTo(closedPivot:Lerp(openPivot, alpha))
	end)

	local prompt = Instance.new("ProximityPrompt")
	prompt.Name = "DoorPrompt"
	prompt.ActionText = "Open"
	prompt.ObjectText = if keyName ~= "" then `Needs {keyName}` else "Door"
	prompt.HoldDuration = 0.2
	prompt.MaxActivationDistance = PROMPT_DISTANCE
	prompt.RequiresLineOfSight = false
	prompt.Parent = promptPart

	local isOpen = false
	local lastUse = 0
	local moveCount = 0

	local function move(open: boolean)
		isOpen = open
		moveCount += 1
		door:SetAttribute("Open", open) -- 其他脚本可以读取这个值
		prompt.ActionText = if open then "Close" else "Open"
		-- 在同一个值上的新补间会取消旧补间,所以门可以在半路折返。
		-- 时间按它还剩多少路程来缩放。
		local target = if open then 1 else 0
		local seconds = openSeconds * math.abs(target - progress.Value)
		TweenService:Create(progress, TweenInfo.new(seconds, Enum.EasingStyle.Quad, Enum.EasingDirection.Out), { Value = target }):Play()

		if open and autoClose > 0 then
			local thisMove = moveCount
			task.delay(openSeconds + autoClose, function()
				if moveCount == thisMove and isOpen then
					move(false)
				end
			end)
		end
	end

	prompt.Triggered:Connect(function(player: Player)
		local now = os.clock()
		if now - lastUse < MIN_SECONDS_BETWEEN_USES then
			return
		end
		-- Roblox 的安全指南说提示可以像 Remote 一样被滥用,所以这里再检查一次
		local character = player.Character
		local humanoid = character and character:FindFirstChildOfClass("Humanoid")
		local rootPart = humanoid and humanoid.RootPart
		if not (humanoid and rootPart) or humanoid.Health <= 0 then
			return
		end
		if (rootPart.Position - promptPart.Position).Magnitude > PROMPT_DISTANCE + 6 then
			return -- 距离太远,不可能正常使用提示
		end
		if keyName ~= "" and not isOpen and not hasKey(player, keyName) then
			return -- 门已上锁,而这个玩家没有钥匙
		end
		lastUse = now
		move(not isOpen)
	end)
end

-- 现在所有带标签的门,以及之后获得标签的门(包括脚本克隆出来的门)
for _, door in CollectionService:GetTagged(DOOR_TAG) do
	setUpDoor(door)
end
CollectionService:GetInstanceAddedSignal(DOOR_TAG):Connect(setUpDoor)

游戏启动时,DoorService 会自动在每扇门里添加 DoorPrompt 和 DoorProgress,所以不需要手动插入任何东西。只保留一份脚本:它已经负责所有带标签的门。

DoorService 各部分的作用
脚本部分作用原因
attribute()读取一个 Attribute,如果它不存在、类型不对或不是真正的数字(NaN 或无穷大),就返回默认值。在 Properties 窗口里打错字,得到的是使用默认设置的门,而不是坏掉的门。
doorsSetUp 和 leftover 循环每扇门只设置一次,并先删除从另一扇门复制来的 DoorPrompt 或 DoorProgress。否则复制出来的门会有两个提示,其中一个无法使用。
closedPivot 和 openPivot只计算一次,以设置时门所在的位置为准。平开门让 pivot 绕自身的竖直轴旋转;推拉门让它沿门较长的一边移动。从关闭 pivot 到打开 pivot 的 Lerp 在门旋转时让 pivot 保持不动,所以装合页的那一边在整个旋转过程中都不会移位。
DoorProgress 和 PivotTo补间改变一个数字;每次变化都把门放到 closedPivot:Lerp(openPivot, alpha)。TweenService 可以补间 NumberValue,而 PivotTo 会移动零件或模型及其所有零件,使 pivot 落在这个 CFrame 上。
提示HoldDuration 0.2,MaxActivationDistance 8,RequiresLineOfSight 关闭。上锁的门显示 "Needs RedKey"。开启视线检测时,只要有东西挡住提示所在的零件,提示就会隐藏;关闭后,门框或模型门的其他部分不会挡住提示。
move()启动一个朝 1 或 0 的补间,并按门还剩多少路程来缩放时间。在同一个值上的新补间会取消旧补间,所以在半路折返的门会平滑地往回走,只用一半的时间。
自动关门等待打开时间加上 AutoCloseSeconds,然后只有在 moveCount 没有变化时才关门。旧的计时器永远不会把一扇在此期间被人关上又重新打开的门砰地关上。
Triggered 中的检查每扇门每 0.3 秒只能使用一次、角色活着、离挂提示的零件不超过 14 格,以及钥匙(只在开门时检查)。客户端能触发的一切都可能被滥用,所以服务端会重复检查。14 格是提示的 8 格加上 6 格余量,留给长按 E 时移动了位置的玩家。
Attribute Open每次移动时设置在门上。在服务端设置的 Attribute 会复制给所有玩家,所以其他脚本(包括 LocalScript)可以通过 GetAttributeChangedSignal("Open") 监听它。

给所有门加上标签,并用一个脚本统一管理,这是 Roblox 自己推荐的做法:CollectionService 的参考文档说,如果你要把同一个脚本加到很多对象里,使用 CollectionService 的脚本可能更好。GetTagged 返回脚本启动时已经存在的门,GetInstanceAddedSignal 则捕获之后加上标签或新添加的门。这种组织场景的方式在 客户端与服务端脚本教程 中有详细介绍。

如何做推拉门

选中 VaultDoor,添加一个 string 类型、名为 Style 的 Attribute,值设为 Slide。现在门不再旋转,而是侧向移动:移动自身的宽度,或者如果你设置了 SlideDistance,就移动那么多格。要让它往另一个方向移动,设置一个负的距离,例如宽 4 格的门设为 -4。任何其他门,包括 FrontDoor,只要加上这个 Attribute,同样会变成推拉门。

DoorService 会测量门的两个水平尺寸,也就是宽度和厚度,并沿较大的那个方向移动它。Model 通过 GetExtentsSize 测量,它的包围盒跟随模型 pivot 的朝向,所以组合后旋转了 90 度的门仍然沿宽度而不是厚度移动。Part 按零件自身的 Size 测量,所以不要旋转推拉零件的 pivot。移动这个 pivot 是可以的。

  • 双开门:两扇带标签的半门并排放置,两者的 Style 都是 Slide,其中一扇的 SlideDistance 为负数,这样它们会从中间向两边分开。如果是平开的双开门,把每扇半门的 pivot 放在它的外侧边缘,并给其中一扇设置负的 OpenAngle。每扇半门都有自己的提示,并单独打开。如果两扇半门相互撞在一起,就把负号换到另一扇上。
  • 向上升起的大门:这个脚本只让门沿宽度移动。要让门向上升起,把脚本中的 direction 设为 Vector3.yAxis(这样所有推拉门都会向上移动),并给每扇门设置等于其高度的 SlideDistance。
  • 物理门:Roblox 关于移动物体的教程用 PrismaticConstraint 让零件沿一个轴移动。和合页门一样,这是物理驱动的,在你自己写出来之前没有提示和门锁。

如何给门加钥匙锁

上锁的门只会为持有指定名称 Tool 的玩家打开。先做一把钥匙,再把钥匙的名字告诉门:

  1. 把鼠标悬停在 StarterPack 上,点击 +,插入一个名为 RedKey 的 Tool。在里面插入一个名为 Handle 的 Part,这是角色拿在手里的零件,并确保它没有锚固:工具里锚固的零件会把角色钉在原地。如果不希望玩家把钥匙丢给别人,请取消 Tool 的 CanBeDropped 勾选:勾选时,按 Backspace 会把装备着的工具丢到 Workspace 中。
  2. 选中 VaultDoor,添加一个 string 类型、名为 KeyName 的 Attribute,值设为 RedKey。现在提示上的对象名称显示为 Needs RedKey。

DoorService 会在两个地方找钥匙。Tool 在装备之前放在玩家的 Backpack 里,装备后会移到角色里,所以无论钥匙在快捷栏里还是拿在手上,门都会打开。检查在服务端进行,因为 Roblox 的安全指南正是把这种情况(玩家是否有这扇门的钥匙)列为服务端必须检查的权限。钥匙只在开门时需要:任何人都可以关上打开的门,门也会在 AutoCloseSeconds 后自动关上。

StarterPack 会在每次重生时把钥匙发给所有人,测试时这正合适。在真正的游戏里,请换一种方式发放:

  • 从商店:商店 GUI 教程 会把 ServerStorage 中的 Tool 发到买家的 Backpack 和 StarterGear。
  • 从角色:NPC 对话教程 会在玩家选择带 GiveItem 动作的选项时,发放 ServerStorage.DialogueItems 中的 Tool。在这个文件夹里放一个名为 RedKey 的 Tool,并在 DialogueData 中给选项设置 action = "GiveItem" 和 item = "RedKey",钥匙就会在对话中发放。
  • 作为背包物品:配合 背包系统,钥匙物品在玩家装备后就能生效,因为装备会把它的 Tool 副本放进 Backpack 和手中。

角色死亡时,Backpack 里的钥匙会丢失,因为 Roblox 每次重生时都会用 StarterPack 和 StarterGear 重新填充 Backpack。要保留它,就像商店教程那样,再在玩家的 StarterGear 里放一份副本。反过来,如果想让钥匙用一次就消耗掉,就在 Triggered 处理函数中、钥匙检查通过之后,立刻在玩家的 Backpack 或角色里找到钥匙的 Tool 并销毁它。

旧的门教程错在哪里

如果你在拿这篇教程和视频或论坛帖子对比,下面这些做法是大多数“我的门不能用”帖子的根源,以及本教程用什么来代替它们。

门教程中常见的做法,以及本教程的替代做法
教程的做法问题本教程
补间 Model 门的 CFrameModel 的参考文档中没有 CFrame 或 Position 属性。它的 WorldPivot 只决定模型 pivot 的位置,所以补间它移动的是 pivot 点,零件留在原地。补间 NumberValue,并用 PivotTo 移动整个模型。
用 SetPrimaryPartCFrame 移动模型已弃用:Roblox 建议在新项目中使用 PivotTo。使用 PivotTo,Roblox 称它是在脚本中移动 Model 的主要函数。
把所有零件焊接到一个合页零件上,只补间合页所有 Weld 都在时可以用,但只要有一个零件没焊上,合页移动时它就会留在原地。所有零件保持锚固,不用 Weld。PivotTo 会移动门以及门里的一切。
把同一个脚本复制到每扇门里每次修复都得在每份副本里重复一遍。Roblox 建议给对象加标签,用一个脚本通过 CollectionService 统一处理。一个 DoorService 加一个 Door 标签。
在 LocalScript 中开门门只会在那个玩家的屏幕上打开,其他所有人看到的仍然是关着的。门由服务端移动,所以所有玩家看到的是同一扇门。
用 Touched 开门一次触碰会让 Touched 连续触发好几次(Roblox 关于 debounce 的页面),而且玩家的设备可以控制自己角色的 Touched 何时触发(Roblox 安全文档)。由服务端检查的提示。
用带 wait() 的循环一步步移动门Roblox 已把 wait() 标记为被 task.wait() 取代,而且循环无法在有人再次按下时半路折返。每次移动一个补间。在同一个值上的新补间会取消旧补间,所以门会从当前位置折返。
在 LocalScript 中检查钥匙,或者根本不检查作弊者控制自己设备上的一切,所以客户端上的检查拦不住任何人。服务端在玩家的 Backpack 和角色里查找 Tool。
提示没有冷却时间Roblox 的安全指南说提示和 Remote 一样容易被滥用,所以没有什么能阻止有人一遍又一遍地触发它。每扇门每 0.3 秒只能使用一次。

作弊者能做什么,不能做什么

请假定作弊者能控制自己设备上的一切,包括自己的角色。下面是这对这些门意味着什么。

作弊者可能尝试的事,以及 DoorService 如何应对
作弊者尝试结果原因
从地图另一头触发提示如果他的角色不在门边,则被忽略DoorService 测量角色根零件到挂提示零件的距离,并忽略超过 14 格的一切。作弊者可以先把角色传送到门边(见最后一行),所以距离检查防的是远程使用,而不是传送。
每秒触发很多次每扇门每 0.3 秒最多使用一次服务端会记录每扇门上次被使用的时间。
没有钥匙却打开钥匙门被拒绝服务端在它自己看到的地方查找他 Backpack 和角色里的 Tool,而不是作弊者屏幕上显示的。
在角色死亡时使用门被忽略DoorService 会检查是否有生命值大于 0 的 Humanoid 和根零件。
照样穿过关着的门有可能Roblox 的安全文档把绕过物理障碍和修改自身碰撞列为客户端可以对自己角色做的事。
传送到门后面有可能同一份文档提到,客户端可以把自己的角色传送到任何位置。

第 3 步:测试

  1. 点击 Play(F5)。走到 FrontDoor 前:在 8 格以内会出现一个提示,动作是 Open,对象名称是 Door。长按 E。0.2 秒后,门在 0.6 秒内绕装合页的一边转开 90 度,提示现在显示 Close。
  2. 穿过门,然后等待。完全打开四秒后,门会自动关上。在它关闭时长按 E:它会从当前位置折返并重新打开。
  3. 测试门锁。如果 RedKey 在 StarterPack 里,先把它移到 ServerStorage,点击 Play,在 VaultDoor 前长按 E:提示上写着 Needs RedKey,什么都不会动。停止游戏,把 RedKey 放回 StarterPack,再次运行:无论钥匙在快捷栏里还是拿在手上,VaultDoor 都会打开。
  4. 测试推拉门。VaultDoor 是 Style 为 Slide 的 Model,打开时会侧向移动自身的宽度。停止游戏,选中 VaultDoor,用 Rotate 工具把它旋转 90 度,再次运行:它仍然应该沿宽度而不是厚度移动。完成后把它转回来。
  5. 在测试模式下拉列表中选择 Server & Clients,设置 2 个客户端,点击 Play。在一个客户端窗口中打开门:在另一个窗口中它也是开着的,并在两个窗口中一起关上。
  6. 停止游戏,选中门,按 Ctrl+D 复制一份,把副本移到另一个门洞。确认副本的 Tags 中仍然有 Door,然后点击 Play:副本不需要额外的脚本就能工作。

保持 Output 窗口打开(Window 菜单,然后选 Output)。一切正常时,DoorService 什么都不输出。如果出现门 "has no part to put the prompt on" 的警告,说明带标签的 Model 里没有零件。其他问题请看 常见错误 部分。

如何扩展

自动门

要让门在有人走近时打开,就在 setUpDoor 内部调用 move(true),不必等待提示。在 setUpDoor 的末尾用 task.spawn 启动一个循环,因为普通循环在那里永远不会结束,DoorService 就无法处理第一扇门之后的门。让它只在门还在游戏中时运行:task.spawn(function() while door.Parent do ... task.wait(0.5) end end)。在循环里用 workspace:GetPartBoundsInBox 检查门洞周围的盒子里是否有角色,有角色且门关着时调用 move(true)。之后和原来一样,由自动关门把它关上。如果门只应自动打开,把提示的 Enabled 设为 false。

VIP 门

游戏通行证教程 已经用碰撞组做了一扇 VIP 门,通行证持有者可以直接穿过。要做一扇按 E 打开的 VIP 门,就在 Triggered 处理函数中、钥匙检查旁边再加一个检查:如果 player:GetAttribute("OwnsPass_VIP") == true 不成立就 return,这个 Attribute 由游戏通行证教程中的服务端脚本设置。只在服务端读取它。

密码面板

对于输入密码才能打开的门,把密码存放在服务端 Script 或 ServerStorage 中,这些是玩家永远拿不到的,绝对不要放在作弊者能读取的 LocalScript 里。面板的 LocalScript 只通过 RemoteEvent 发送输入的数字。在服务端检查玩家是否在门边,限制尝试频率,比对数字,然后才调用 move(true)。RemoteEvent 教程 介绍了如何检查 Remote 收到的内容。

声音

把一个 Sound 放进门的零件里,让它从这个零件的位置发出声音,并在 move 开头调用它的 Play 方法。或者在一个 LocalScript 中播放它,这个 LocalScript 通过 GetAttributeChangedSignal("Open") 监听门的 Open Attribute,因为服务端每次移动门时都会设置这个 Attribute。

游戏中途添加的门

从 ServerStorage 中关闭状态的模板克隆新门。DoorService 在门出现时读取它的关闭位置,所以如果复制的是一扇当时开着的门,副本会把它的打开位置当成关闭位置。在把副本的 Parent 设为 Workspace 之前,先用 PivotTo 把它放进门洞,让 DoorService 把这个位置记为关闭位置。随副本带来的旧提示和数值会被自动删除。关于把玩家送到另一个区域或另一个场景的门,请阅读 传送教程。

常见错误与解决办法

点击 Play 之前先打开 Output 窗口(Window 菜单,然后选 Output)。门的大多数问题,都是因为标签、pivot 或 Attribute 和脚本预期的有一点点不同。

门上不出现提示

按顺序检查:DoorService 是 Script 而不是 LocalScript,并且直接放在 ServerScriptService 里;门有首字母大写的 Door 标签,模型门的标签在 Model 本身上;门是零件(Part、MeshPart 或其他 BasePart)或 Model;并且你离挂提示的零件不超过 8 格。Output 中出现门 "has no part to put the prompt on" 的警告,说明带标签的 Model 里没有零件。

游戏启动时门掉下来、飘走或被推动

它的某个零件没有锚固。选中门的所有零件,勾选 Anchored。锚固的零件永远不会因物理而移动,但 DoorService 仍然可以移动它们。

我改了 Attribute,但门不理会它

检查三件事。类型:OpenAngle、SlideDistance、OpenSeconds 和 AutoCloseSeconds 必须是 number 类型的 Attribute,Style 和 KeyName 是 string 类型;类型不对时,DoorService 会使用默认值。拼写:名称是精确比较的,所以 openAngle 是另一个 Attribute。值也是精确比较的:Style 必须是首字母大写 S 且没有空格的 Slide。时机:DoorService 在设置门时只读取一次 Attribute,所以在试玩测试中修改不会生效,直到你重新运行游戏。

门往错误的方向打开,或者侧翻过去

要让它往另一个方向打开,把 OpenAngle 设为负数,例如 -90。如果它绕水平轴而不是竖直的合页旋转,说明 pivot 本身被旋转了:在 Model 选项卡中开启 Pivot,把 pivot 转回竖直方向。

推拉门滑进墙里,或者只移动了一点点

给它设置负的 SlideDistance,让它往另一个方向移动。如果移动得太少或太远,就在 SlideDistance 中填入需要的格数,不要依赖测量出来的宽度。

我有钥匙,但门打不开

钥匙必须是 Tool,而不是 Part 或 Model,它的名字必须与 KeyName 完全一致,包括大小写。它必须在你的 Backpack 里或拿在手上。还要确认门上的 KeyName 是 string 类型的 Attribute。

用 RoCode 来做

如果不想手动设置这一切,RoCode 可以在你打开的场景里把它搭好。RoCode 是独立的 Roblox Studio AI 代理,并非 Roblox 出品:你在网页聊天里描述改动,它的 Studio 插件就会在你的 Explorer 中创建脚本和对象,所以不需要粘贴代码。

你输入

让带 Door 标签的门通过长按 E 的提示打开:在 0.6 秒内绕 pivot 旋转 90 度,4 秒后关上,当 Attribute Style 为 Slide 时改为平移而不是旋转,并且如果玩家没有名称与 KeyName 相同的 Tool,门保持关闭。全部在服务端完成,并检查距离。

RoCode 的操作
  • 在某一步需要时,可以用 Search Game 和 Search Scripts 查看你的场景,以便基于已有的物品、Remote 或存档代码来构建,而不是再加一套系统
  • 用 Create Script 在 ServerScriptService 中编写 Script,可以用 Create Instance 创建门的零件,并在上面设置 Style 和 KeyName 等 Attribute
  • 它被要求用 Check Script 检查自己写的每个脚本能否编译,Check Script 会在 Studio 中编译而不运行
  • 在每批改动前后设置撤销点,所以按 Ctrl+Z 一次回退一批

测试前,请用 Studio 的 Pivot 工具检查每扇门的 pivot:门会绕它旋转。使用插件 3.9 及以上时,RoCode 可以运行简短的试玩测试并读取错误;使用插件 3.9.15 及以上时,它可以操控一个会走路和按键的测试角色,但它只检查自己决定要测试的内容,所以请亲自走到每扇门前长按 E。RoCode 如何连接到 Studio。

常见问题

在 Roblox Studio 中怎么让门按 E 打开?

在门里放一个 ProximityPrompt,并在移动门的服务端 Script 中连接它的 Triggered 事件。DoorService 会为每扇带 Door 标签的门同时做好这两件事。E 是提示的默认按键,Roblox 会为键盘、手柄和触摸屏显示对应的输入。

为什么我的门绕着自己的中心转?

它的 pivot 还在中心。在 Model 选项卡中开启 Pivot,把 pivot 拖到装合页的那一边;脚本会让门绕 pivot 旋转。

怎么做推拉门?

把门的 Style Attribute 设为 Slide。它会侧向移动自身的宽度,或者 SlideDistance 格;负的距离会让它往另一个方向移动。

能不用脚本做门吗?

能。Roblox 关于合页门的教程用带限制的 HingeConstraint 把未锚固的门连到门框上,玩家用身体推就能打开。这样的门没有提示、门锁和自动关门。

怎么做只有 VIP 能打开的门?

使用 游戏通行证教程中的 VIP 门,通行证持有者可以穿过它;或者在 DoorService 的 Triggered 处理函数中加一个检查,在开门前于服务端读取玩家是否拥有通行证,例如那篇教程设置的 OwnsPass_VIP Attribute。

为什么门在我这里能打开,在其他玩家那里却不行?

它是由 LocalScript 打开的,而 LocalScript 做出的改动只留在那个玩家的设备上。像 DoorService 那样,把开门代码移到服务端 Script 中,改动就会传到所有人那里。

参考资料

代码如何验证:本页的所有脚本都已用 Roblox API 类型定义(luau-lsp,2026年11月20日)通过 Luau strict 类型检查。类型检查能发现 API 名称写错和类型不匹配,但发现不了游戏逻辑上的错误。发布前请务必在 Studio 中测试。

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

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