튜토리얼 · 게임 시스템

Roblox Studio에서 문 만드는 법

Roblox에서 작동하는 문에는 세 가지가 필요합니다. 플레이어가 누르는 것("Open"이라고 쓰인 ProximityPrompt), 부드러운 움직임(TweenService), 그리고 모든 플레이어가 같은 문을 보도록 변경을 만드는 서버입니다. 이 가이드에서는 태그가 붙은 모든 문에 대해 이 일을 하는 스크립트 하나를 만듭니다. 여닫이문이든 슬라이딩 문이든 상관없고, 선택적으로 열쇠 잠금도 넣을 수 있습니다. 서버는 무언가를 열기 전에 열쇠를 확인합니다.

업데이트: 2026년 11월 20일읽는 데 15분작성:

요약

문을 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초 뒤에 저절로 닫힙니다(여기서는 빨리 감기). VaultDoor는 RedKey가 없는 플레이어에게 닫힌 채로 남습니다.

실제 게임에서 작동하는 문은 서버가 움직여야 합니다. LocalScript가 움직이면 문은 한 플레이어의 화면에서만 열리고 다른 모든 사람에게는 닫힌 채로 남습니다. 클라이언트가 만든 변경은 그 기기에만 남기 때문입니다(무엇이 복제되고 무엇이 복제되지 않는지 참고). 그래서 이 가이드에서는 플레이어의 기기는 프롬프트를 보여 주고 키 입력을 알리기만 하고, 나머지는 서버 Script 하나가 모두 처리합니다. 문을 한 번 사용하는 과정은 이렇습니다.

  1. 플레이어가 문에서 8스터드 안으로 다가오면 Open 동작, Door 오브젝트 이름, 키보드의 E 키가 표시된 프롬프트가 나타납니다. 게임패드나 터치스크린에서는 Roblox가 알맞은 버튼을 보여 줍니다.
  2. 플레이어가 E를 0.2초 동안 누릅니다. 프롬프트의 Triggered 이벤트가 서버에서 그 플레이어와 함께 발생합니다.
  3. DoorService가 플레이어를 확인합니다. 살아 있는지, 충분히 가까운지, 프롬프트를 연타하지 않는지, 그리고 문이 열쇠를 요구하면 열쇠를 가지고 있는지 봅니다.
  4. 스크립트가 숫자를 0(닫힘)에서 1(열림)로 트윈합니다. 숫자가 바뀔 때마다 PivotTo로 문을 닫힌 위치에서 열린 위치까지의 그 비율만큼 옮깁니다.
  5. 완전히 열린 지 4초 뒤에 문은 같은 방식으로 닫힙니다. 움직이는 도중에 누르면 문은 지금 있는 자리에서 다시 반대로 돌아갑니다.
문 시스템의 구성 요소
요소위치하는 일
Script DoorServiceServerScriptService모든 문을 찾아 각각에 프롬프트를 추가하고, 사용할 때마다 확인하고, 문을 움직입니다. 이 가이드의 유일한 스크립트입니다.
Door 태그문의 각 Part 또는 Model무엇이 문인지 표시합니다. 태그는 Properties 창에서 추가하며 플레이스와 함께 저장됩니다.
Style, KeyName 같은 속성각 문(선택 사항)문 하나의 설정입니다. 여닫이인지 슬라이딩인지, 각도, 속도, 자동 닫힘, 열쇠.
ProximityPrompt DoorPrompt문 안(DoorService가 추가)"Open" 또는 "Close"를 보여 주고, 플레이어가 E를 길게 누르면 Triggered를 발생시킵니다.
NumberValue DoorProgress문 안(DoorService가 추가)트윈이 0과 1 사이에서 움직이는 숫자입니다. 바뀔 때마다 문이 움직입니다.
Tool RedKey(선택 사항)StarterPack, 테스트용잠긴 문의 열쇠입니다. 이름이 문의 KeyName과 같으면 어떤 Tool이든 됩니다.
가이드를 마쳤을 때의 Explorer. 두 문 모두 Door 태그가 있고, VaultDoor에는 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, 두께 0.5스터드)로 정한 뒤 문틀 안에 놓으세요. 파트 여러 개로 된 문도 됩니다. 파트들을 선택하고 Ctrl+G를 눌러 Model로 묶으세요.
  2. 문의 모든 파트에서 Anchored를 체크하고 CanCollide는 켜 두세요. 고정된 파트는 중력이나 충돌로 절대 움직이지 않지만 스크립트는 여전히 움직일 수 있고, DoorService가 하는 일이 바로 그것입니다.
  3. 경첩을 정하세요. 문을 선택하고 Model 탭을 열어 Pivot을 켜세요. Pivot 버튼 모서리의 작은 화살표를 길게 눌러 Snap을 체크하면 pivot이 모서리, 가장자리, 중심의 기준점에 붙습니다. pivot을 경첩이 있을 문 가장자리로 끌어다 놓으세요. 슬라이딩 문이라면 pivot은 가운데에 둬도 됩니다.
  4. 태그를 추가하세요. 문을 선택한 상태로 Properties 창을 Tags까지 내리고 +를 눌러 대문자 D로 Door를 입력하세요. 문이 Model이라면 안쪽 파트가 아니라 Model 자체에 태그를 붙이세요.
  5. 두 번째 문을 만드세요. 슬라이딩 문과 열쇠 부분에서 필요합니다. Workspace에 Part를 두 개 더 넣으세요. 크기가 대략 4, 7, 0.5인 Panel과, Panel의 한 면에 붙인 대략 0.5, 0.5, 0.5의 Knob입니다. 둘 다 선택하고 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으로 옮겨집니다.

문 설정(속성)

모든 문은 아래 표의 기본값으로 작동합니다. 문 하나를 바꾸려면 그 문을 선택하고 Properties 창을 Attributes까지 내린 뒤 +를 눌러 이름을 입력하고 타입을 고른 다음 Save를 누르고 값을 정하세요. DoorService는 문을 설정할 때 속성을 한 번만 읽으므로, 게임이 멈춰 있을 때 바꾸세요.

각 문의 선택 속성
속성타입기본값하는 일
StylestringSwingSwing은 문을 pivot 중심으로 돌립니다. Slide는 너비 방향으로 옆으로 밉니다.
OpenAnglenumber90여닫이문이 도는 각도(도)입니다. 음수를 넣으면 반대쪽으로 열립니다. 값은 -179에서 179 사이로 두세요. 문은 항상 짧은 호를 따라 돌기 때문에 DoorService가 각도를 이 범위로 제한합니다.
SlideDistancenumber문의 너비슬라이딩 문이 너비 방향으로 움직이는 스터드 수입니다. 음수를 넣으면 반대쪽으로 움직입니다.
OpenSecondsnumber0.6완전히 열리거나 닫히는 데 걸리는 시간이며, 0.05에서 10 사이입니다.
AutoCloseSecondsnumber4문이 저절로 닫히기 전에 완전히 열린 채로 있는 시간입니다. 0이면 누군가 닫을 때까지 열려 있습니다.
KeyNamestring없음문을 열기 위해 플레이어가 가지고 있어야 하는 Tool의 이름입니다. 예: RedKey. 누구나 열 수 있는 문에는 정하지 마세요.

2단계: 문 스크립트 추가하기

ServerScriptService에 마우스를 올리고 이름이 DoorService인 Script를 넣은 뒤 아래 코드를 붙여 넣으세요. 이 스크립트는 태그를 몇 개 붙였든 플레이스의 모든 문을 관리합니다. 맨 위의 설정 세 개는 모든 문에 적용되고, 1단계의 속성은 문 하나를 바꿉니다.

Script 위치: ServerScriptService 이름: DoorService
-- ServerScriptService 안의 Script, 이름은 DoorService.
-- "Door" 태그가 붙은 모든 Part 또는 Model을 E 길게 누르기 프롬프트로 열고 닫습니다.
-- 문은 서버가 움직이므로 모든 플레이어가 같은 문을 보고, 거리와 열쇠도
-- 서버가 확인하므로 아무도 멀리서 잠긴 문을 열 수 없습니다.
--
-- 각 문의 선택 속성(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 -- 스터드
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 보안 가이드에 프롬프트도 리모트처럼 악용될 수 있다고 나와 있으므로 여기서 다시 확인합니다
		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()속성 하나를 읽고, 속성이 없거나 타입이 다르거나 진짜 숫자가 아니면(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스터드에 E를 누르는 동안 움직인 플레이어를 위한 여유 6을 더한 것입니다.
Open 속성움직일 때마다 문에 설정됩니다.서버에서 설정한 속성은 모든 플레이어에게 복제되므로, LocalScript를 포함한 다른 스크립트가 GetAttributeChangedSignal("Open")으로 들을 수 있습니다.

모든 문에 태그를 붙이고 스크립트 하나로 관리하는 것은 Roblox가 직접 권하는 방식입니다. CollectionService 문서에는 같은 스크립트를 여러 오브젝트에 넣고 있다면 CollectionService를 쓰는 스크립트가 더 나을 수 있다고 쓰여 있습니다. GetTagged는 스크립트가 시작할 때 존재하는 문을 돌려주고, GetInstanceAddedSignal은 나중에 태그가 붙거나 추가된 문을 잡습니다. 이렇게 플레이스를 정리하는 방법은 클라이언트와 서버 스크립트 가이드에서 다룹니다.

슬라이딩 문 만드는 법

VaultDoor를 선택하고 이름이 Style인 string 타입 속성을 추가한 뒤 값을 Slide로 정하세요. 이제 문은 돌지 않고 옆으로 움직입니다. 자기 너비만큼, 또는 SlideDistance를 정했다면 그 스터드 수만큼 움직입니다. 반대쪽으로 움직이게 하려면 음수 거리를 넣으세요. 예를 들어 너비 4스터드인 문이라면 -4입니다. FrontDoor를 포함한 다른 문도 이 속성을 받으면 똑같이 슬라이딩 문이 됩니다.

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를 선택하고 이름이 KeyName인 string 타입 속성을 추가한 뒤 값을 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 문의 CFrame을 트윈함Model 문서에는 CFrame이나 Position 속성이 없습니다. WorldPivot은 모델 pivot의 위치만 정하므로, 그것을 트윈하면 pivot 지점만 움직이고 파트는 제자리에 남습니다.NumberValue를 트윈하고 PivotTo로 모델 전체를 움직입니다.
SetPrimaryPartCFrame으로 모델을 움직임더 이상 권장되지 않습니다. Roblox는 새 프로젝트에서 PivotTo를 쓰라고 권합니다.Roblox가 스크립트에서 Model을 움직이는 기본 함수라고 부르는 PivotTo를 씁니다.
모든 파트를 경첩 파트 하나에 용접하고 경첩만 트윈함모든 Weld가 제자리에 있으면 작동하지만, 용접되지 않은 파트는 경첩이 움직일 때 뒤에 남습니다.모든 파트를 Weld 없이 고정된 채로 둡니다. PivotTo가 문과 그 안의 모든 것을 움직입니다.
같은 스크립트를 문마다 복사함고칠 때마다 모든 복사본에서 반복해야 합니다. Roblox는 오브젝트에 태그를 붙이고 CollectionService로 스크립트 하나에서 처리하라고 제안합니다.DoorService 하나와 Door 태그.
LocalScript에서 문을 엶문은 그 플레이어의 화면에서만 열리고, 다른 모든 사람에게는 여전히 닫혀 보입니다.문은 서버가 움직이므로 모든 플레이어가 같은 문을 봅니다.
Touched로 문을 엶Touched는 한 번 닿을 때 여러 번 연속으로 발생하고(Roblox의 debounce 페이지), 플레이어의 기기는 자기 캐릭터에 대해 Touched가 언제 발생할지 조종할 수 있습니다(Roblox 보안 문서).서버가 확인하는 프롬프트.
wait() 반복문으로 문을 조금씩 움직임Roblox는 wait()를 task.wait()로 대체된 것으로 표시하며, 반복문은 누군가 다시 눌렀을 때 도중에 되돌아갈 수 없습니다.움직임마다 트윈 하나. 같은 값에 대한 새 트윈은 이전 것을 취소하므로 문은 지금 있는 곳에서 되돌아갑니다.
LocalScript에서 열쇠를 확인하거나 전혀 확인하지 않음치터는 자기 기기의 모든 것을 조종하므로 클라이언트 확인은 아무도 막지 못합니다.서버가 플레이어의 Backpack과 캐릭터에서 Tool을 찾습니다.
프롬프트에 쿨다운이 없음Roblox 보안 가이드에 프롬프트도 리모트처럼 악용에 취약하다고 나와 있으므로, 계속 반복해서 발생시키는 것을 막을 것이 없습니다.문 하나당 0.3초에 한 번만 사용.

치터가 할 수 있는 것과 없는 것

치터는 자기 캐릭터를 포함해 자기 기기의 모든 것을 조종한다고 생각하세요. 이 문들에서 그것이 의미하는 바는 다음과 같습니다.

치터가 시도할 수 있는 것과 DoorService의 대응
치터의 시도결과이유
맵 반대편에서 프롬프트 발생시키기캐릭터가 문 근처에 없으면 무시됨DoorService는 캐릭터의 루트 파트에서 프롬프트 파트까지의 거리를 재고 14스터드보다 먼 것은 무시합니다. 치터는 먼저 캐릭터를 문으로 텔레포트할 수 있으므로(마지막 줄 참고), 거리 확인은 멀리서의 사용을 막는 것이지 텔레포트를 막는 것은 아닙니다.
1초에 여러 번 발생시키기문 하나당 0.3초에 한 번까지만서버가 문마다 마지막 사용 시간을 저장합니다.
열쇠 없이 열쇠 문 열기거부됨서버는 치터의 화면이 아니라 서버 자신이 보는 Backpack과 캐릭터에서 Tool을 찾습니다.
캐릭터가 죽은 상태에서 문 사용하기무시됨DoorService는 체력이 0보다 큰 Humanoid와 루트 파트가 있는지 확인합니다.
그래도 닫힌 문을 통과하기가능Roblox 보안 문서는 물리적 장애물을 우회하거나 자기 충돌을 바꾸는 것을 클라이언트가 자기 캐릭터로 할 수 있는 일로 꼽습니다.
문 너머로 텔레포트하기가능같은 문서에 자기 캐릭터를 아무 곳으로나 텔레포트하는 것도 나옵니다.

3단계: 테스트하기

  1. Play(F5)를 누르세요. FrontDoor로 다가가면 8스터드 안에서 Open 동작과 Door 오브젝트 이름이 있는 프롬프트가 나타납니다. E를 길게 누르세요. 0.2초 뒤 문이 경첩 쪽 가장자리를 중심으로 0.6초 만에 90도 열리고, 프롬프트에는 이제 Close라고 표시됩니다.
  2. 문을 지나가서 기다리세요. 완전히 열린 지 4초 뒤에 문이 저절로 닫힙니다. 닫히는 동안 E를 길게 누르면 문이 방향을 바꿔 있던 자리에서 다시 열립니다.
  3. 잠금을 테스트하세요. RedKey가 StarterPack에 있다면 잠시 ServerStorage로 옮기고 Play를 누른 뒤 VaultDoor에서 E를 길게 누르세요. 프롬프트에 Needs RedKey라고 쓰여 있고 아무것도 움직이지 않습니다. 게임을 멈추고 RedKey를 StarterPack으로 되돌린 뒤 다시 실행하세요. 열쇠가 핫바에 있든 손에 있든 VaultDoor가 열립니다.
  4. 슬라이딩 문을 테스트하세요. Style이 Slide인 Model인 VaultDoor는 열릴 때 자기 너비만큼 옆으로 움직입니다. 게임을 멈추고 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 하세요. 이것은 게임패스 가이드의 서버 스크립트가 설정하는 속성입니다. 서버에서만 읽으세요.

비밀번호 패널

입력한 코드로 열리는 문이라면, 코드는 플레이어가 절대 받지 못하는 서버 Script나 ServerStorage에 두고, 치터가 읽을 수 있는 LocalScript에는 절대 두지 마세요. 패널의 LocalScript는 RemoteEvent로 입력한 숫자만 보냅니다. 서버에서 플레이어가 문 근처에 있는지 확인하고, 시도 횟수를 제한하고, 숫자를 비교한 다음에야 move(true)를 호출하세요. RemoteEvent 가이드가 리모트로 받은 것을 확인하는 법을 보여 줍니다.

소리

문 파트 안에 Sound를 넣으면 그 파트의 위치에서 소리가 나며, move 시작 부분에서 그 Play 메서드를 호출하세요. 또는 GetAttributeChangedSignal("Open")으로 문의 Open 속성을 듣는 LocalScript에서 재생하세요. 서버는 움직일 때마다 이 속성을 설정하기 때문입니다.

게임 중에 추가되는 문

새 문은 ServerStorage에 있는 닫힌 템플릿에서 복제하세요. DoorService는 문이 나타나는 순간의 닫힌 위치를 읽으므로, 그 순간 열려 있던 문의 복사본은 열린 위치를 닫힌 위치로 여기게 됩니다. 복사본의 Parent를 Workspace로 정하기 전에 PivotTo로 문틀에 놓아서 DoorService가 그 자리를 닫힌 위치로 기억하게 하세요. 복사본과 함께 온 예전 프롬프트와 값은 자동으로 지워집니다. 플레이어를 다른 구역이나 다른 플레이스로 보내는 문은 텔레포트 가이드를 보세요.

자주 발생하는 오류와 해결 방법

Play를 누르기 전에 Output 창을 여세요(Window 메뉴에서 Output). 문 문제의 대부분은 태그, pivot, 속성이 스크립트가 기대하는 것과 조금 다를 때 생깁니다.

문에 프롬프트가 나타나지 않음

순서대로 확인하세요. DoorService가 LocalScript가 아니라 Script이고 ServerScriptService 바로 안에 있는지, 문에 대문자 D로 된 Door 태그가 있는지(모델 문이라면 Model 자체에), 문이 파트(Part, MeshPart 또는 다른 BasePart)이거나 Model인지, 그리고 프롬프트가 붙은 파트에서 8스터드 안에 서 있는지 보세요. Output에 문이 "has no part to put the prompt on"이라는 경고가 있다면 태그가 붙은 Model 안에 파트가 없다는 뜻입니다.

게임이 시작되면 문이 떨어지거나, 떠내려가거나, 밀림

문의 어떤 파트가 고정되어 있지 않습니다. 문의 모든 파트를 선택하고 Anchored를 체크하세요. 고정된 파트는 물리로 절대 움직이지 않지만 DoorService는 여전히 움직일 수 있습니다.

속성을 바꿨는데 문이 무시함

세 가지를 확인하세요. 타입: OpenAngle, SlideDistance, OpenSeconds, AutoCloseSeconds는 number 타입 속성이어야 하고, Style과 KeyName은 string 타입이어야 합니다. 타입이 틀리면 DoorService는 기본값을 씁니다. 철자: 이름은 정확히 비교되므로 openAngle은 다른 속성입니다. 값도 정확히 비교됩니다. Style은 대문자 S로 된 Slide여야 하고 공백이 없어야 합니다. 시점: DoorService는 문을 설정할 때 속성을 한 번만 읽으므로, 플레이 테스트 중에 바꾸면 게임을 다시 시작하기 전까지 아무 효과가 없습니다.

문이 엉뚱한 쪽으로 열리거나 옆으로 넘어감

반대쪽으로 열리게 하려면 OpenAngle을 음수로, 예를 들어 -90으로 만드세요. 수직 경첩이 아니라 수평축을 중심으로 돈다면 pivot 자체가 회전되어 있는 것입니다. Model 탭에서 Pivot을 켜고 pivot이 수직으로 서도록 다시 돌리세요.

슬라이딩 문이 벽 속으로 들어가거나 아주 조금만 움직임

반대쪽으로 움직이도록 음수 SlideDistance를 주세요. 너무 조금 또는 너무 멀리 움직이면, 측정된 너비에 기대지 말고 SlideDistance에 원하는 스터드 수를 정하세요.

열쇠가 있는데 문이 열리지 않음

열쇠는 Part나 Model이 아니라 Tool이어야 하고, 이름이 대문자까지 포함해 KeyName과 정확히 같아야 합니다. Backpack에 있거나 손에 들고 있어야 합니다. 문의 KeyName이 string 타입 속성인지도 확인하세요.

RoCode로 만들기

이 모든 것을 직접 설정하기 싫다면 RoCode가 지금 열려 있는 플레이스에 만들어 줄 수 있습니다. RoCode는 Roblox가 아닌 독립 제품으로, Roblox Studio용 AI 에이전트입니다. 웹 채팅에서 변경할 내용을 설명하면 Studio 플러그인이 Explorer에 스크립트와 오브젝트를 만들므로 코드를 붙여 넣을 필요가 없습니다.

입력하는 내용

Door 태그가 붙은 문이 E 길게 누르기 프롬프트로 열리게 해 줘. pivot을 중심으로 0.6초 동안 90도 회전, 4초 뒤에 닫힘, Style 속성이 Slide면 회전 대신 옆으로 이동, 그리고 플레이어에게 KeyName의 이름을 가진 Tool이 없으면 문은 닫힌 채로 있어야 해. 전부 서버에서, 거리 확인도 넣어 줘.

RoCode가 하는 일
  • 단계에 필요할 때 Search Game과 Search Scripts로 플레이스를 살펴볼 수 있어서, 두 번째 시스템을 추가하는 대신 이미 있는 아이템, 리모트, 저장 코드를 바탕으로 작업합니다
  • Create Script로 ServerScriptService에 Script를 작성하고, Create Instance로 문 파트를 만들어 Style, KeyName 같은 속성을 설정할 수 있습니다
  • 작성한 모든 스크립트가 컴파일되는지 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 속성을 Slide로 정하세요. 문은 자기 너비만큼, 또는 SlideDistance 스터드만큼 옆으로 움직이며, 음수 거리는 반대쪽으로 움직입니다.

스크립트 없이 문을 만들 수 있나요?

네. Roblox의 경첩 문 튜토리얼은 고정되지 않은 문을 제한이 있는 HingeConstraint로 문틀에 연결하고, 플레이어는 몸으로 밀어서 문을 엽니다. 이런 문에는 프롬프트, 잠금, 자동 닫힘이 없습니다.

VIP만 열 수 있는 문은 어떻게 만드나요?

패스 소유자가 통과하는 게임패스 가이드의 VIP 문을 쓰거나, DoorService의 Triggered 핸들러에 열기 전에 서버에서 플레이어가 패스를 소유했는지 읽는 확인을 추가하세요. 예를 들어 그 가이드가 설정하는 OwnsPass_VIP 속성입니다.

왜 문이 나에게는 열리는데 다른 플레이어에게는 안 열리나요?

LocalScript가 문을 열고 있고, LocalScript가 만든 변경은 그 플레이어의 기기에만 남습니다. DoorService처럼 여는 코드를 서버 Script로 옮겨서 변경이 모두에게 전달되게 하세요.

출처와 더 읽을거리

코드 검증 방법: 이 페이지의 모든 스크립트는 Roblox API 정의를 적용한 Luau의 엄격한 타입 검사기(luau-lsp, 2026년 11월 20일)를 통과합니다. 타입 검사는 잘못 쓴 API 이름과 잘못된 타입을 찾아내지만 게임 로직의 오류는 찾지 못하므로, 게시하기 전에 Studio에서 직접 테스트하세요.

내 게임에서 RoCode를 사용해 보세요.

매일 무료 크레딧, 카드 등록 없이 시작합니다. 플러그인을 설치하고, 원하는 기능을 설명한 뒤, Studio에 만들어진 결과를 확인하세요.