教學 · 遊戲系統

如何在 Roblox Studio 製作門

Roblox 中能運作的門需要三樣東西:玩家按的東西(寫著 "Open" 的 ProximityPrompt)、平順的移動(TweenService),以及由伺服器做出變更,讓所有玩家看到同一扇門。這篇教學會做出一個 Script,替每一扇加上標籤的門完成這些事,不論是旋轉門還是滑動門,還可以選擇加上鑰匙鎖:伺服器會先檢查鑰匙,才打開任何東西。

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

重點摘要

把門做成 Part 或 Model,勾選 Anchored,把它的 pivot 移到有鉸鏈的那一邊(Model 分頁的 Pivot),並在 Properties 視窗加上 Door 標籤。一個 ServerScriptService 中的 Script 透過 CollectionService 找出所有加上標籤的門,加上 ProximityPrompt("Open",按住 E),並在 Triggered 事件中把 NumberValue 從 0 Tween 到 1,透過 door:PivotTo(closedPivot:Lerp(openPivot, alpha)) 移動門。每扇門上的屬性(attribute)設定旋轉或滑動類型、角度、時間、自動關門與鑰匙。

  • Model 的位置無法直接 Tween:Model 沒有 CFrame 或 Position 屬性,而它的 WorldPivot 只決定 pivot 的位置。請 Tween 一個 NumberValue,再透過 PivotTo 移動門:Roblox 把它稱為用 Script 移動模型的主要方式。
  • 在伺服器上開門。從 LocalScript 打開的門,只會在那位玩家的畫面上移動。
  • 在伺服器上檢查鑰匙與距離。Roblox 的安全教學提到,ProximityPrompt 和 RemoteEvent 一樣可能被濫用,同一頁也舉出伺服器必須做的檢查範例:玩家是否擁有開門所需的鑰匙。
本頁內容
  1. 運作方式
  2. 1. 製作門
  3. 2. 門的 Script
  4. 滑動門
  5. 鑰匙門
  6. 舊的教學
  7. 防護的極限
  8. 3. 測試
  9. 擴充
  10. Common errors
  11. 使用 RoCode
  12. 常見問題
  13. 來源與延伸閱讀

用 Script 控制的門如何運作

示意畫面按住 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. Script 把一個數字從 0(關閉)Tween 到 1(打開)。每次數字改變時,它就透過 PivotTo 把門移到從關閉位置到打開位置之間的那個比例。
  5. 門完全打開四秒後,會用同樣的方式關上。在移動中再按一次,門會從目前的位置反轉回去。
門系統由哪些部分組成
元件位置作用
Script DoorServiceServerScriptService找出所有門、替每扇門加上提示、檢查每次使用並移動門。這是這篇教學中唯一的 Script。
Door 標籤在每扇門的 Part 或 Model 上標示哪些東西是門。標籤在 Properties 視窗加上,會和場景一起儲存。
屬性,例如 Style 與 KeyName在每扇門上(選用)單扇門的設定:旋轉或滑動、角度、速度、自動關門與鑰匙。
ProximityPrompt DoorPrompt在門裡面(由 DoorService 加入)顯示 "Open" 或 "Close",並在玩家按住 E 時觸發 Triggered。
NumberValue DoorProgress在門裡面(由 DoorService 加入)Tween 在 0 與 1 之間移動的數字。每次改變都會移動門。
Tool RedKey(選用)StarterPack,用於測試上鎖門的鑰匙。任何 Tool 都可以,只要名稱與門的 KeyName 相同。
完成教學後的 Explorer。兩扇門都有 Door 標籤,VaultDoor 另外還有屬性 Style = Slide 與 KeyName = RedKey。遊戲執行時,DoorService 會在每扇門中加入 DoorProgress,並在掛著提示的 part 中加入 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 stud、高 7 stud、厚半個 stud),放進門口。由多個 part 組成的門也可以:選取它們並按 Ctrl+G,把它們組成 Model。
  2. 勾選門的每個 part 的 Anchored,並保持 CanCollide 開啟。已固定的 part 永遠不會因為重力或碰撞而移動,但 Script 仍然可以移動它們,而 DoorService 做的正是這件事。
  3. 設定鉸鏈。選取門,打開 Model 分頁並啟用 Pivot。按住 Pivot 按鈕角落的小箭頭,勾選 Snap,讓 pivot 吸附到角落、邊緣與中心的參考點。把 pivot 拖到門上會裝鉸鏈的那一邊。滑動門的 pivot 可以留在中心。
  4. 加上標籤。在門仍被選取的情況下,把 Properties 視窗捲到 Tags,按 + 並輸入大寫 D 開頭的 Door。如果門是 Model,請把標籤加在 Model 本身,而不是裡面的 part。
  5. 再做第二扇門,滑動門與鑰匙的段落會用到它。在 Workspace 再插入兩個 Part:大約 4, 7, 0.5 的 Panel,以及大約 0.5, 0.5, 0.5 的 Knob,貼在 Panel 的其中一面。選取兩者,按 Ctrl+G,把新的 Model 改名為 VaultDoor。把兩個 part 都固定,把模型放進第二個門口,並在 Model 上加上 Door 標籤。它的 pivot 可以留在中心,因為這扇門會是滑動門。

pivot 很重要,因為旋轉門會繞著它轉。如果留在中心,門就會像商店的旋轉門那樣在原地打轉。對 part 來說,你設定的 pivot 會存成 PivotOffset,而 GetPivot 會把它算進去,所以 Script 會精確地繞著你選的點旋轉門。如果 Model 有 PrimaryPart,模型的 pivot 就是那個 part 的 pivot,DoorService 也會把提示掛在它上面。沒有 PrimaryPart 時,提示會放在模型裡找到的第一個 part。如果要設定 PrimaryPart,請在移動 pivot 之前設定:指定 PrimaryPart 會把模型的 pivot 移到那個 part 的 pivot,Roblox 的 Pivot tools 頁面也有提到這點。

門的設定(屬性)

任何門都能用下表中的預設值運作。要改變某一扇門,請選取它,把 Properties 視窗捲到 Attributes,按 +,輸入名稱、選擇類型並按 Save,再設定數值。DoorService 只在設定門的時候讀取一次屬性,所以請在遊戲停止時修改。

每扇門上的選用屬性
屬性類型預設值作用
StylestringSwingSwing 讓門繞著 pivot 旋轉。Slide 讓門沿著寬度往側邊滑動。
OpenAnglenumber90旋轉門轉動的角度。負數會讓門往另一個方向打開。請把數值保持在 -179 到 179 之間:門一定會走較短的那段弧,所以 DoorService 會把角度限制在這個範圍內。
SlideDistancenumber門的寬度滑動門沿著寬度移動的 stud 數。負數會讓門往另一個方向移動。
OpenSecondsnumber0.6完整打開或關上所需的時間,範圍是 0.05 到 10。
AutoCloseSecondsnumber4門完全打開後停留多久才會自己關上。0 會讓門一直開著,直到有人把它關上。
KeyNamestring無玩家開門所需的 Tool 名稱,例如 RedKey。任何人都能開的門請不要設定它。

步驟 2:加入門的 Script

把滑鼠移到 ServerScriptService 上,插入名為 DoorService 的 Script,貼上下方的程式碼。不論你替多少扇門加上標籤,它都會管理場景中的所有門。開頭的三個設定作用於所有門;步驟 1 的屬性則改變單一扇門。

Script 位於 ServerScriptService 名稱為 DoorService
-- ServerScriptService 中名為 DoorService 的 Script。
-- 透過按住 E 的提示,打開與關上每個帶有 "Door" 標籤的 Part 或 Model。
-- 門由伺服器移動,所以所有玩家看到的都是同一扇門,而且也由伺服器
-- 檢查距離與鑰匙,所以沒有人能從遠處打開上鎖的門。
--
-- 每扇門上的選用屬性(在 Properties 視窗設定):
--   Style            string  "Swing"(預設)或 "Slide"
--   OpenAngle        number  旋轉門繞著 pivot 轉動的角度(預設 90,範圍 -179 到 179)
--   SlideDistance    number  滑動門沿著寬度移動的 stud 數(預設:門的寬度)
--   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 -- 已經是運作中的門,或者不是 part 也不是模型
	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 測量,所以不要旋轉滑動 part 的 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(關閉)Tween 到 1(打開),並讓門跟著它移動。
	-- PivotTo 會繞著 pivot 移動單一 part 或整個模型。
	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) -- 其他 Script 可以讀取這個值
		prompt.ActionText = if open then "Close" else "Open"
		-- 在同一個數值上的新 Tween 會取消舊的,所以門可以在半途反轉。
		-- 依照門剩下要走的距離調整時間。
		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

-- 現在所有帶標籤的門,以及之後才加上標籤的所有門(包括由 Script 複製出來的門)
for _, door in CollectionService:GetTagged(DOOR_TAG) do
	setUpDoor(door)
end
CollectionService:GetInstanceAddedSignal(DOOR_TAG):Connect(setUpDoor)

遊戲開始時,DoorService 會自己在每扇門中加入 DoorPrompt 與 DoorProgress,所以不需要手動插入任何東西。只保留一份 Script:它已經在處理所有加上標籤的門。

DoorService 每個部分的作用
Script 的部分作用原因
attribute()讀取一個屬性,如果屬性不存在、類型不對,或不是真正的數字(NaN 或無限大),就回傳預設值。Properties 視窗中的打錯字會讓門使用預設設定,而不是讓門壞掉。
doorsSetUp 與處理 leftover 的迴圈每扇門只設定一次,並先刪除從另一扇門複製過來的 DoorPrompt 或 DoorProgress。否則運作中的門的複本會有兩個提示,其中一個沒有作用。
closedPivot 與 openPivot只計算一次,以設定時門所在的位置為準。旋轉門會讓 pivot 繞著自己的垂直軸轉動;滑動門會讓它沿著門較長的一邊移動。從關閉的 pivot Lerp 到打開的 pivot,會讓 pivot 在門旋轉時留在原地,所以有鉸鏈的那一邊在整個旋轉過程中都不會移動。
DoorProgress 與 PivotToTween 改變數字;每次改變都把門放到 closedPivot:Lerp(openPivot, alpha)。TweenService 可以 Tween NumberValue,而 PivotTo 會移動 part 或模型及其所有 part,讓 pivot 落在這個 CFrame 上。
提示HoldDuration 0.2、MaxActivationDistance 8、RequiresLineOfSight 關閉。上鎖的門會顯示 "Needs RedKey"。開啟視線檢查時,只要有東西擋住提示所在的 part,提示就會隱藏;關閉後,門框或模型門的其他部分都不會把提示遮住。
move()啟動往 1 或往 0 的 Tween,並依照門剩下要走的距離調整時間。在同一個數值上的新 Tween 會取消舊的,所以在半途反轉的門會平順地往回走,並只花一半的時間。
自動關門等待打開的時間加上 AutoCloseSeconds,然後只在 moveCount 沒有改變時關門。舊的計時器永遠不會把這段期間有人關上又重新打開的門甩上。
Triggered 中的檢查每扇門每 0.3 秒只能使用一次、角色要活著、與提示所在的 part 距離不超過 14 stud,以及鑰匙,但只在開門時檢查。用戶端能觸發的任何東西都可能被濫用,所以由伺服器再檢查一次。14 stud 是提示的 8 stud,再加上 6 stud 的餘裕,留給按住 E 時移動了的玩家。
Open 屬性每次移動時設定在門上。在伺服器上設定的屬性會複寫給所有玩家,所以其他 Script,包括 LocalScript,都能透過 GetAttributeChangedSignal("Open") 監聽它。

用標籤標示所有門,並從一個 Script 管理它們,是 Roblox 自己推薦的做法:CollectionService 的說明提到,如果你把同一個 Script 加進許多物件,使用 CollectionService 的 Script 可能會更好。GetTagged 回傳 Script 啟動時已經存在的門,而 GetInstanceAddedSignal 會抓到之後才加上標籤或加入的門。這種組織場景的方式在用戶端與伺服器 Script 教學中有詳細說明。

如何製作滑動門

選取 VaultDoor,加上一個 string 類型、名為 Style 的屬性,並把值設為 Slide。現在門不會旋轉,而是往側邊滑動:滑動自己的寬度,或者如果你設定了 SlideDistance,就滑動那麼多 stud。要讓它往另一邊滑,請設定負的距離,例如寬 4 stud 的門設為 -4。任何其他門,包括 FrontDoor,只要加上這個屬性,也會以同樣方式變成滑動門。

DoorService 會測量門的兩個水平尺寸,也就是寬度與厚度,並沿著較大的那一個移動門。Model 是透過 GetExtentsSize 測量的,它的方框會跟著模型 pivot 的方向,所以組成群組後被旋轉 90 度的門,仍然會沿著寬度而不是厚度滑動。Part 是依照 part 自己的 Size 測量的,所以不要旋轉滑動 part 的 pivot。移動這個 pivot 則沒有問題。

  • 雙開門:兩個並排、加上標籤的門片,兩者的 Style 都是 Slide,其中一個的 SlideDistance 是負數,讓它們從中間往兩側分開。要做旋轉的雙開門,請把每個門片的 pivot 放在它的外側邊緣,並把其中一個門片的 OpenAngle 設為負數。每個門片都有自己的提示,並各自打開。如果門片互相往對方移動,就把負號改到另一個門片上。
  • 往上升起的閘門:這個 Script 只會沿著寬度移動門。要讓門往上升,請把 Script 中的 direction 設為 Vector3.yAxis(這樣所有滑動門都會往上移動),並把每扇門的 SlideDistance 設為它的高度。
  • 物理門:Roblox 關於移動物件的教學透過 PrismaticConstraint 讓 part 沿著一個軸移動。就像鉸鏈門一樣,這是物理,在你自己寫出來之前,沒有提示也沒有門鎖。

如何用鑰匙鎖門

上鎖的門只會替擁有正確名稱 Tool 的玩家打開。先做一把鑰匙,再告訴門它的名稱:

  1. 把滑鼠移到 StarterPack 上,按 + 並插入名為 RedKey 的 Tool。在裡面插入一個名為 Handle 的 Part,也就是角色拿在手上的 part,並確認它沒有固定:工具中已固定的 part 會把角色釘在原地。如果玩家不該把鑰匙丟給別人,請取消 Tool 的 CanBeDropped 勾選:勾選時,Backspace 會把裝備中的工具丟到 Workspace。
  2. 選取 VaultDoor,加上一個 string 類型、名為 KeyName 的屬性,並把值設為 RedKey。現在提示上的物件名稱會寫著 Needs RedKey。

DoorService 會在兩個地方找鑰匙。Tool 在被裝備前放在玩家的 Backpack,裝備後會移到角色身上,所以不論鑰匙在快捷列還是在手上,門都會打開。檢查在伺服器上進行,因為 Roblox 的安全教學正是把這個情況,也就是玩家是否有這扇門的鑰匙,列為伺服器必須檢查的權限。鑰匙只在開門時需要:任何人都能關上打開的門,而且門會在 AutoCloseSeconds 後自己關上。

StarterPack 會在每次重生時把鑰匙發給所有人,測試時正好需要這樣。在真正的遊戲中,請用其他方式發放:

  • 從商店:商店 GUI 教學會把 Tool 從 ServerStorage 發到買家的 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 並把它刪除(Destroy)。

舊的門教學錯在哪裡

如果你拿這篇教學和影片或論壇文章比較,以下是造成大多數「我的門不能用」問題的做法,以及這篇教學改用的做法。

門教學中常見的做法,以及這篇教學改用的做法
教學問題這篇教學
Tween 模型門的 CFrameModel 的說明中沒有 CFrame 或 Position 屬性。它的 WorldPivot 只決定模型 pivot 的位置,所以 Tween 它只會移動 pivot 點,part 則留在原地。Tween 一個 NumberValue,並透過 PivotTo 移動整個模型。
透過 SetPrimaryPartCFrame 移動模型已過時:Roblox 建議新專案使用 PivotTo。使用 PivotTo,Roblox 稱它為用 Script 移動 Model 的主要函式。
把所有 part 焊接到一個鉸鏈 part 上,只 Tween 鉸鏈所有 Weld 都在時可以運作,但任何沒有焊接的 part 都會在鉸鏈移動時被留在後面。所有 part 都保持固定,不用 Weld。PivotTo 會移動門以及門裡的所有東西。
把同一個 Script 複製到每扇門每次修正都得在每份複本中重做。Roblox 建議用標籤標示物件,並透過 CollectionService 用一個 Script 處理。一個 DoorService 加上 Door 標籤。
在 LocalScript 中開門門只會在這位玩家的畫面上打開,其他所有人看到的還是關著的。門由伺服器移動,所以所有玩家看到的都是同一扇門。
用 Touched 開門Touched 一次碰觸就會連續觸發好幾次(Roblox 關於 debounce 的頁面),而且玩家的裝置可以控制自己角色的 Touched 何時觸發(Roblox 安全文件)。由伺服器檢查的提示。
在迴圈中用 wait() 一步一步移動門Roblox 已把 wait() 標示為由 task.wait() 取代,而且有人再按一次時,迴圈無法在半途反轉。每次移動一個 Tween。在同一個數值上的新 Tween 會取消舊的,所以門會從目前的位置反轉。
在 LocalScript 中檢查鑰匙,或完全不檢查作弊者掌控自己裝置上的一切,所以用戶端的檢查擋不住任何人。伺服器在玩家的 Backpack 與角色中尋找 Tool。
提示沒有冷卻時間Roblox 的安全教學提到,提示和 remote 一樣容易被濫用,所以沒有任何東西能阻止它被一再觸發。每扇門每 0.3 秒只能使用一次。

作弊者能做與不能做的事

請假設作弊者掌控自己裝置上的一切,包括他的角色。以下是這對這些門的意義。

作弊者可能嘗試的事,以及 DoorService 如何應對
作弊者嘗試結果原因
從地圖另一端觸發提示如果他的角色不在門邊就會被忽略DoorService 會測量角色的根部 part 到提示所在 part 的距離,忽略超過 14 stud 的一切。作弊者可以先把角色傳送到門邊(見最後一列),所以距離檢查防的是從遠處使用,而不是傳送。
每秒觸發好幾次每扇門每 0.3 秒最多使用一次伺服器會記錄每扇門上次被使用的時間。
沒有鑰匙就打開鑰匙門拒絕伺服器在它自己看到的 Backpack 與角色中尋找 Tool,而不是在作弊者的畫面上。
在角色死亡時使用門被忽略DoorService 會檢查是否有生命值大於 0 的 Humanoid 以及根部 part。
還是穿過關著的門有可能Roblox 的安全文件把穿越物理障礙、修改自己的碰撞,列為用戶端能對自己角色做的事。
傳送到門的後面有可能同一份文件也提到可以把自己的角色傳送到任何地方。

步驟 3:測試

  1. 按 Play(F5)。走到 FrontDoor 旁邊:在 8 stud 以內會出現提示,上面有動作 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:複本不需要額外的 Script 就能運作。

讓 Output 視窗保持開啟(Window 選單,再選 Output)。一切正常時,DoorService 不會印出任何東西。如果出現門 "has no part to put the prompt on" 的警告,表示加上標籤的 Model 裡面沒有任何 part。其他情況請參考常見錯誤段落。

如何擴充

自動門

要讓門在有人靠近時打開,請在 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,這是遊戲通行證教學中的伺服器 Script 設定的屬性。只在伺服器上讀取它。

密碼面板

要做輸入密碼才能打開的門,請把密碼存在伺服器 Script 或 ServerStorage 中,玩家永遠拿不到這些地方,絕對不要放在作弊者讀得到的 LocalScript 中。面板的 LocalScript 只透過 RemoteEvent 送出輸入的數字。在伺服器上檢查玩家是否在門附近、限制嘗試的頻率、比對數字,然後才呼叫 move(true)。RemoteEvent 教學示範了如何檢查 remote 收到的東西。

音效

把 Sound 放進門的 part 裡,讓聲音從這個 part 的位置發出,並在 move 的開頭呼叫它的 Play 方法。或者從 LocalScript 播放它,透過 GetAttributeChangedSignal("Open") 監聽門的 Open 屬性,因為伺服器每次移動都會設定這個屬性。

遊戲中加入的門

從 ServerStorage 中關閉狀態的範本複製新門。DoorService 會在門出現時讀取它的關閉位置,所以如果複本在那一刻是打開的,它會把自己的打開位置當成關閉位置。請在把複本的 Parent 設為 Workspace 之前,先透過 PivotTo 把它放進門口,讓 DoorService 把這個位置記為關閉位置。隨複本一起帶來的舊提示與數值會自動刪除。如果是把玩家傳送到另一個區域或另一個場景的門,請閱讀傳送教學。

常見錯誤與解法

在按 Play 之前打開 Output 視窗(Window 選單,再選 Output)。大部分門的問題,都是因為標籤、pivot 或屬性和 Script 預期的有一點點不同。

門沒有出現提示

依序檢查:DoorService 是 Script 而不是 LocalScript,並且直接放在 ServerScriptService 中;門有大寫 D 開頭的 Door 標籤,模型門則加在 Model 本身;門是 part(Part、MeshPart 或其他 BasePart)或 Model;而且你與掛著提示的 part 距離不超過 8 stud。如果 Output 中出現門 "has no part to put the prompt on" 的警告,表示加上標籤的 Model 裡面沒有任何 part。

遊戲開始時門掉下去、飄走或被推動

門有某個 part 沒有固定。選取門的所有 part 並勾選 Anchored。已固定的 part 永遠不會因為物理而移動,但 DoorService 仍然可以移動它們。

我改了屬性,但門沒有理會

檢查三件事。類型:OpenAngle、SlideDistance、OpenSeconds 與 AutoCloseSeconds 必須是 number 類型的屬性,Style 與 KeyName 則是 string 類型;類型錯誤時 DoorService 會使用預設值。拼字:名稱會精確比對,所以 openAngle 是另一個屬性。數值也會精確比對:Style 必須是大寫 S 開頭、沒有空格的 Slide。時機:DoorService 只在設定門的時候讀取一次屬性,所以在試玩測試中修改不會有任何效果,直到你重新執行遊戲。

門往錯的方向打開,或往側邊倒下

要讓它往另一個方向打開,請把 OpenAngle 設為負數,例如 -90。如果它是繞著水平軸而不是垂直的鉸鏈旋轉,代表 pivot 本身被旋轉了:在 Model 分頁啟用 Pivot,把 pivot 轉回垂直的方向。

滑動門滑進牆裡,或只移動了一點點

把它的 SlideDistance 設為負數,讓它往另一個方向滑。如果它移動得太少或太遠,請在 SlideDistance 中設定需要的 stud 數,不要依賴測量出來的寬度。

我有鑰匙,但門打不開

鑰匙必須是 Tool,而不是 Part 或 Model,而且名稱必須和 KeyName 完全一致,包括大寫字母。它必須放在你的 Backpack 或拿在手上。也請確認門上的 KeyName 是 string 類型的屬性。

用 RoCode 完成

如果你不想手動設定這一切,RoCode 可以在你開啟的場景中把它做出來。RoCode 是獨立的 Roblox Studio AI 代理,不是 Roblox 推出的:你在網頁聊天中描述要做的變更,它的 Studio 外掛程式就會在你的 Explorer 中建立 Script 與物件,所以不需要貼上程式碼。

你輸入

讓帶有 Door 標籤的門透過按住 E 的提示打開:在 0.6 秒內繞著 pivot 旋轉 90 度,4 秒後關上,當 Style 屬性是 Slide 時改成滑動而不是旋轉,如果玩家沒有名稱和 KeyName 相同的 Tool,門就保持關閉。全部在伺服器上執行,並檢查距離。

RoCode 會做
  • 在步驟需要時,可以透過 Search Game 與 Search Scripts 瀏覽你的場景,以現有的物品、remote 或存檔程式碼為基礎,而不是再加一套系統
  • 透過 Create Script 在 ServerScriptService 撰寫 Script,可以透過 Create Instance 建立門的 part,並在上面設定 Style 與 KeyName 之類的屬性
  • 它被要求透過 Check Script 檢查每個寫好的 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 拖到有鉸鏈的那一邊;Script 會繞著 pivot 旋轉門。

如何製作滑動門?

把門的 Style 屬性設為 Slide。它會往側邊滑動自己的寬度,或滑動 SlideDistance stud;負的距離會讓它往另一個方向移動。

可以不用 Script 做門嗎?

可以。Roblox 的鉸鏈門教學透過有角度限制的 HingeConstraint,把未固定的門接在門框上,玩家用身體推就能打開。這種門沒有提示、門鎖與自動關門。

如何做出只有 VIP 能打開的門?

使用遊戲通行證教學中的 VIP 門,讓通行證擁有者直接穿過;或在 DoorService 的 Triggered 處理函式中加上一項檢查,在開門前於伺服器上讀取玩家是否擁有通行證,例如那篇教學設定的 OwnsPass_VIP 屬性。

為什麼門在我這邊會打開,其他玩家那邊卻不會?

是 LocalScript 打開了它,而 LocalScript 做的變更只會留在那位玩家的裝置上。請把開門的程式碼移到伺服器 Script 中,就像 DoorService 那樣,讓變更傳給所有人。

來源與延伸閱讀

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

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

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