튜토리얼 · 게임 시스템

Roblox Studio에서 메인 메뉴 만드는 방법

Roblox Studio의 메인 메뉴(시작 메뉴나 타이틀 화면이라고도 합니다)는 Play 버튼이 있는 ScreenGui입니다. 하지만 완성된 게임처럼 느껴지게 만드는 것은 다른 부분입니다. 플레이어는 Play를 누르기 전까지 스폰되면 안 되고, 카메라는 맵을 보여 주다가 캐릭터로 돌아와야 하며, 메뉴는 죽은 뒤에 다시 나타나면 안 됩니다. 이 가이드에서는 마우스, 터치스크린, 게임패드에서 모두 작동하는 스크립트 두 개로 이 모든 것을 만듭니다.

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

요약

Players 서비스의 CharacterAutoLoads를 꺼서 접속할 때 아무도 스폰되지 않게 합니다. StarterPlayerScripts의 LocalScript가 ResetOnSpawn을 끈 ScreenGui 안에 메뉴(게임 이름, Play 버튼, 페이드용 검은 프레임)를 만들고, CameraType Scriptable로 카메라를 MenuCamera라는 파트에 맞추며, Play를 누르면 RemoteEvent를 보냅니다. ServerScriptService의 Script가 Player:LoadCharacterAsync()로 응답하면, LocalScript가 카메라를 되돌리고(CameraType Custom, CameraSubject는 Humanoid) 메뉴를 없앱니다.

  • Play가 클릭, 탭, 게임패드에서 모두 작동하도록 MouseButton1Click 대신 Activated를 쓰고, 게임패드 플레이어가 누를 수 있도록 버튼을 선택해 두세요.
  • CharacterAutoLoads를 끄면 StarterGui는 캐릭터가 스폰될 때만 플레이어의 PlayerGui로 복사됩니다. 그래서 메뉴는 StarterPlayerScripts의 LocalScript가 만듭니다.
  • CharacterAutoLoads를 끄면 Roblox가 플레이어를 리스폰하지도 않습니다. 그래서 서버 스크립트가 죽거나 맵 밖으로 떨어진 플레이어를 Players.RespawnTime(기본값 5초)만큼 기다린 뒤 직접 리스폰합니다.
이 페이지의 내용
  1. 작동 방식
  2. 1. 준비
  3. 2. 서버 스크립트
  4. 3. 메뉴 스크립트
  5. 서버가 결정하는 것
  6. 4. 디자인
  7. 5. 테스트
  8. 다른 시스템과 함께
  9. 복사한 메뉴가 고장 나는 이유
  10. Common errors
  11. RoCode로
  12. 자주 묻는 질문
  13. 출처와 더 읽을거리

메인 메뉴의 작동 방식

일러스트실행 중인 게임의 완성된 메뉴이며, 서버를 기다리는 시간은 빨리 감았습니다. Play를 누르면 화면이 어두워지고, 서버가 캐릭터를 스폰하며, 카메라가 캐릭터로 돌아옵니다.

메뉴에는 두 측면이 있습니다. 플레이어의 기기는 게임 이름과 버튼을 그리고 카메라를 움직입니다. 서버는 캐릭터가 언제 나타날지 정합니다. 메뉴 자체는 한 사람의 화면에 보이는 그림일 뿐입니다. 실제 변화는 서버가 캐릭터를 스폰할 때 일어나며, 그 일은 서버만 할 수 있습니다.

메뉴의 구성 요소
부분위치하는 일
MenuService ScriptServerScriptService자동 스폰을 끄고, PlayRequest를 만들고, Play를 누른 플레이어를 스폰하며, 죽거나 떨어진 플레이어를 리스폰합니다.
MainMenu LocalScriptStarterPlayerScripts게임 이름, Play 버튼, 페이드를 만들고, 카메라 장면을 움직이며, 서버에 캐릭터를 요청하고 카메라를 되돌립니다.
PlayRequest RemoteEventReplicatedStorage(MenuService가 만들므로 직접 추가하지 마세요)서버에 "이 플레이어가 Play를 눌렀다"는 메시지 하나만 전달합니다. 값은 들어 있지 않습니다.
MenuCamera PartWorkspace(직접 배치)메뉴 카메라가 놓이는 위치와 바라보는 방향입니다.
CharacterAutoLoadsPlayers 서비스의 속성꺼져 있으므로 서버가 LoadCharacterAsync를 호출하기 전까지 아무도 스폰되지 않습니다.
메뉴가 완성되었을 때의 Explorer입니다. PlayRequest는 게임을 실행하면 나타납니다. MenuService가 만들기 때문에 직접 추가하지 마세요.
Workspace
  MenuCamera Part new
ReplicatedStorage
  PlayRequest RemoteEvent new
ServerScriptService
  MenuService Script new
StarterPlayer
  StarterPlayerScripts
    MainMenu LocalScript new

1단계: 자동 스폰을 끄고 메뉴 카메라 배치하기

  1. Explorer에서 Players를 선택합니다. Properties 창에서 CharacterAutoLoads 체크를 해제합니다. MenuService도 이 값을 끄지만, 체크를 해제해 두면 스크립트가 실행되기 직전에 누군가 스폰되는 일이 없습니다.
  2. Workspace에 마우스를 올리고 + 버튼을 눌러 Part를 넣습니다. 이름을 MenuCamera로 바꾸고(이름은 대소문자를 구분합니다) 폴더나 모델 안이 아니라 Workspace 바로 아래에 둡니다.
  3. Properties에서 Anchored를 체크하고, CanCollide를 해제하고, Transparency를 1로 설정합니다. 앵커가 중요합니다. 앵커되지 않았고 아무것과도 충돌하지 않는 파트는 맵을 뚫고 떨어지며, Roblox는 Workspace.FallenPartsDestroyHeight보다 아래로 떨어진 파트를 삭제합니다.
  4. 파트의 앞면이 원하는 장면을 향하도록 이동하고 회전합니다. 카메라는 파트의 위치를 가져오고 파트의 앞면과 같은 방향을 바라봅니다.

가장 빠르게 맞추는 방법: Studio 카메라를 원하는 장면으로 옮긴 뒤 Command Bar(Script 탭, 또는 Window 다음 Script)를 열고 workspace.MenuCamera.CFrame = workspace.CurrentCamera.CFrame를 실행합니다. 편집 모드에서 CurrentCamera는 지금 보고 있는 시점이므로, 파트가 정확히 그 장면으로 이동합니다.

Workspace.StreamingEnabled는 그대로 두세요. 새 플레이스에서는 인스턴스 스트리밍이 켜져 있으며, 아래 스크립트는 이를 고려해 작성되었습니다.

2단계: Play를 누르면 플레이어 스폰하기

ServerScriptService에 마우스를 올리고 Script를 넣은 뒤 이름을 MenuService로 짓고 다음 코드를 붙여 넣습니다:

Script 위치: ServerScriptService 이름: MenuService
-- ServerScriptService에 있는 MenuService라는 이름의 Script.
-- 플레이어는 캐릭터 없이 접속합니다. 메뉴의 Play 버튼이 요청하면 서버가 캐릭터를 만들고,
-- 자동 스폰이 꺼져 있으므로 죽은 플레이어도 서버가 리스폰합니다.

local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

-- Properties 창에서 Players 서비스의 CharacterAutoLoads 체크도 해제하세요.
-- 그래야 이 스크립트가 실행되기 직전에 누군가 스폰되는 일이 없습니다.
Players.CharacterAutoLoads = false

-- 이 스크립트가 PlayRequest를 직접 만들므로 ReplicatedStorage에 따로 추가하지 마세요
local playRequest = Instance.new("RemoteEvent")
playRequest.Name = "PlayRequest"
playRequest.Parent = ReplicatedStorage

local spawning: { [Player]: boolean } = {}

local function spawnCharacter(player: Player)
	if spawning[player] then
		return -- 첫 번째 스폰이 아직 로딩 중일 때 Play를 다시 누른 경우
	end
	spawning[player] = true
	local oldCharacter = player.Character
	local ok, err = pcall(function()
		player:LoadCharacterAsync()
	end)
	spawning[player] = nil
	if not ok then
		warn(`MenuService: could not spawn {player.Name}: {err}`)
		-- 리스폰에 실패하면 죽은 플레이어가 갇혀 버리므로 잠시 뒤 다시 시도합니다.
		-- 첫 스폰 실패는 다시 시도할 필요가 없습니다. 메뉴 버튼에 Try again이 표시됩니다.
		if oldCharacter then
			task.delay(Players.RespawnTime, function()
				local current = player.Character
				if player.Parent == Players and (current == oldCharacter or current == nil) then
					spawnCharacter(player)
				end
			end)
		end
	elseif oldCharacter and oldCharacter ~= player.Character then
		oldCharacter:Destroy() -- 이전 캐릭터의 연결을 해제합니다
	end
end

-- 스폰을 요청할 수 있는 것은 아직 메뉴에 있는(캐릭터가 아직 없는) 플레이어뿐입니다. 죽은
-- 플레이어는 아직 캐릭터가 있으므로, 이 방법으로 리스폰 대기를 건너뛸 수 없습니다.
playRequest.OnServerEvent:Connect(function(player: Player)
	if player.Character == nil then
		spawnCharacter(player)
	end
end)

-- CharacterAutoLoads가 꺼져 있으면 아무도 죽은 플레이어를 리스폰하지 않으므로 여기서 처리합니다
local function onCharacterAdded(player: Player, character: Model)
	local respawning = false
	local function respawnLater()
		if respawning then
			return
		end
		respawning = true
		task.wait(Players.RespawnTime)
		-- 플레이어가 아직 있고, 그 사이 다른 곳에서 스폰되지 않았을 때만 리스폰합니다
		local current = player.Character
		if player.Parent == Players and (current == character or current == nil) then
			spawnCharacter(player)
		end
	end
	local humanoid = character:WaitForChild("Humanoid") :: Humanoid
	humanoid.Died:Connect(respawnLater)
	-- 맵 밖으로 떨어지면 캐릭터가 Workspace에서 사라질 수 있고, Died는 Humanoid가
	-- Workspace에 있을 때만 발생하므로 이 경우도 여기서 잡아냅니다
	character.AncestryChanged:Connect(function()
		if not character:IsDescendantOf(workspace) then
			respawnLater()
		end
	end)
end

local function onPlayerAdded(player: Player)
	player.CharacterAdded:Connect(function(character: Model)
		onCharacterAdded(player, character)
	end)

	-- 스트리밍을 쓰면 맵은 플레이어 캐릭터 주변으로 로드되는데, 메뉴에 있는 플레이어는
	-- 아직 캐릭터가 없습니다. 스폰될 때까지 메뉴 카메라에 복제 포커스를 추가합니다.
	local menuCamera = workspace:FindFirstChild("MenuCamera")
	if menuCamera and menuCamera:IsA("BasePart") then
		player:AddReplicationFocus(menuCamera)
		player.CharacterAdded:Once(function()
			player:RemoveReplicationFocus(menuCamera) -- 이제부터는 캐릭터가 포커스입니다
		end)
	end
end

Players.PlayerAdded:Connect(onPlayerAdded)
for _, player in Players:GetPlayers() do
	onPlayerAdded(player)
end

Players.PlayerRemoving:Connect(function(player: Player)
	spawning[player] = nil
end)

PlayRequest는 아무 값도 보내지 않습니다. Roblox가 이벤트를 보낸 플레이어를 OnServerEvent의 첫 번째 인수로 넘겨 주며, 서버가 알아야 할 것은 그것뿐입니다.

누가 스폰될 수 있나

PlayRequest 핸들러는 player.Character가 nil일 때만 플레이어를 스폰하는데, 이는 아직 메뉴에 있는 플레이어의 경우입니다. 죽은 플레이어는 MenuService가 리스폰할 때까지 캐릭터를 유지하므로, 리모트를 통해 대기 시간을 건너뛸 수 없습니다.

spawning 테이블은 첫 번째 스폰이 아직 로딩 중일 때 두 번째 요청이 두 번째 스폰을 시작하지 못하게 막습니다. LoadCharacterAsync는 캐릭터가 로드될 때까지 기다리며, Roblox 문서는 같은 플레이어의 CharacterAppearanceLoaded 이벤트가 발생하기 전에는 다시 호출하지 말라고 권합니다. 모든 호출은 pcall 안에서 실행되므로, 예를 들어 로딩 중에 플레이어가 나가서 스폰이 실패하면 오류 대신 플레이어 이름이 담긴 경고가 출력됩니다. 리스폰이 실패하면 MenuService는 RespawnTime만큼 기다렸다가 다시 시도하므로, 리스폰 실패로 죽은 플레이어가 갇히지 않습니다. 첫 스폰이 실패하면 서버는 다시 시도하지 않습니다. 메뉴 버튼에 Try again이 표시되고 플레이어가 그 버튼을 누를 수 있습니다.

죽거나 떨어진 뒤의 리스폰

CharacterAutoLoads가 꺼져 있으면 Roblox는 아무도 리스폰하지 않습니다. Players.RespawnTime(기본값 5초)은 CharacterAutoLoads가 켜져 있을 때만 저절로 작동하므로, MenuService가 이 값을 읽고 직접 기다린 뒤 LoadCharacterAsync를 다시 호출합니다. 새 캐릭터는 평소처럼 SpawnLocation에 나타나고, 스크립트는 이전 캐릭터를 제거하는데, 이때 그 캐릭터의 연결도 함께 끊어집니다.

맵 밖으로 떨어지는 경우에는 두 번째 확인이 필요합니다. Roblox는 Workspace.FallenPartsDestroyHeight보다 아래로 떨어진 파트를 삭제하고, 마지막 파트가 사라진 모델도 삭제합니다. 그래서 떨어진 캐릭터는 Workspace를 벗어날 수 있는데, Humanoid.Died는 Humanoid가 Workspace에 있을 때만 발생합니다. 따라서 MenuService는 Workspace를 벗어난 캐릭터(AncestryChanged)도 리스폰하며, respawning 플래그가 캐릭터마다 리스폰이 한 번만 일어나도록 합니다. 기다린 뒤에는 플레이어가 아직 게임에 있고 player.Character가 여전히 그 캐릭터이거나 nil일 때만 리스폰하므로, 그 사이 다른 방식으로 스폰된 플레이어가 두 번 스폰되지 않습니다.

스트리밍과 메뉴 카메라

인스턴스 스트리밍에서는 각 클라이언트가 자신의 복제 포커스 주변의 파트를 받는데, 기본값은 자기 캐릭터의 PrimaryPart입니다. 메뉴에 있는 플레이어는 캐릭터가 없으며, Roblox의 스트리밍 기법 문서는 스폰된 캐릭터가 없는 클라이언트에는 복제 포커스가 없어서 맵이 아예 로드되지 않을 수 있다고 경고합니다. 그 문서의 해결책은 Player:AddReplicationFocus()이며, MenuService는 플레이어가 접속할 때 MenuCamera 파트로 이를 호출합니다(Roblox는 서버에서만 호출하라고 합니다). 캐릭터가 처음 스폰되면 MenuService는 RemoveReplicationFocus를 호출하고, 다시 캐릭터가 유일한 포커스가 됩니다. 포커스가 하나 늘 때마다 서버의 스트리밍 작업이 늘어나기 때문입니다. 5단계에는 메뉴 뒤로 맵이 보이는지 확인하기 위해 스트리밍을 켠 상태로 하는 플레이 테스트가 있습니다.

서버가 결정하는 것과 치터가 할 수 있는 것

치터는 자기 기기에서 자기 코드를 실행할 수 있습니다. 언제든, 어떤 값으로든 PlayRequest를 보낼 수 있고, 자기 화면의 무엇이든 바꿀 수 있습니다. 그렇게 해서 얻는 것은 다음과 같습니다.

치터가 메뉴로 시도할 수 있는 것
치터의 행동결과
Play를 누르지 않고 PlayRequest를 보냄Play를 누른 것과 똑같이 스폰됩니다. 메뉴를 건너뛰어도 얻는 것이 없습니다.
PlayRequest를 수백 번 보냄스폰은 한 번입니다. 로딩 중에는 spawning 플래그가 나머지를 무시하고, 그 뒤에는 플레이어에게 캐릭터가 있으므로 모든 요청이 한 번의 확인으로 거부됩니다. 그래서 이 리모트에는 빈도 제한이 필요 없습니다.
더 빨리 리스폰하려고 죽은 상태에서 PlayRequest를 보냄거부됩니다. 죽은 플레이어는 MenuService가 리스폰할 때까지 캐릭터를 유지합니다.
PlayRequest에 추가 값을 실어 보냄무시됩니다. 핸들러는 그 값을 전혀 읽지 않습니다.
메뉴를 삭제하거나 자기 카메라를 움직임자기 화면만 바뀝니다. 서버가 스폰하기 전까지는 여전히 캐릭터가 없습니다.

분명히 말하자면, 메뉴는 화면일 뿐 자물쇠가 아닙니다. 플레이어가 언제 스폰되는지만 정하고 그 외에는 아무것도 정하지 않습니다. 메뉴 버튼이 스킨, VIP 문, 코인 같은 무언가를 준다면, 상점 가이드가 모든 구매를 확인하는 것처럼 서버 Script가 그것을 확인해야 합니다. 리모트가 받는 값을 확인하는 방법은 RemoteEvent 가이드에서 다룹니다.

4단계: 내 게임 스타일로 메뉴 꾸미기

스크립트는 로직을 이해하기 쉽도록 일부러 단순한 메뉴를 그립니다. 아래 내용은 모두 MainMenu의 GUI 부분만 바꿉니다. 카메라와 Play 코드는 그대로 두세요.

  • 텍스트 대신 로고. 로고 이미지를 Studio나 Creator Hub에 업로드한 다음, 게임 이름 TextLabel을 Image가 rbxassetid://와 이미지 에셋 ID인 ImageLabel로 바꿉니다. 비율을 유지하도록 BackgroundTransparency를 1, ScaleType을 Fit으로 설정하세요.
  • 흐린 배경. MainMenu에서 BlurEffect를 만들어 workspace.CurrentCamera에 넣습니다. Roblox가 메뉴에 권하는 방식으로, 카메라 아래의 효과는 그 플레이어만 봅니다. Size는 픽셀 단위의 흐림 반경입니다. Play 핸들러에서 gui:Destroy() 옆에서 이 효과를 제거하세요.
  • 색상. 버튼에 UIGradient를 넣거나 테두리용 UIStroke를 추가합니다. 작은 화면에서도 글자가 들어가도록 텍스트의 TextScaled는 유지하세요.
  • 버튼 더 넣기. 버튼들을 UIListLayout과 작은 Padding이 있는 Frame에 넣고, 각 버튼에 Activated 핸들러와 자체 UISizeConstraint를 줍니다. Settings나 Help 버튼은 클라이언트에서만 패널을 열어도 됩니다. Shop 버튼은 상점 가이드의 창을 열 수 있으며, 구매는 여전히 서버에서 처리됩니다.

5단계: 테스트하기

  1. Output 창(Window 메뉴 다음 Output)을 열고 Play를 누릅니다. MenuCamera 장면 위에 게임 이름과 Play 버튼이 서서히 나타나고, 플레이어 목록과 배낭은 숨겨져 있습니다. Explorer의 Workspace에는 내 이름으로 된 모델이 없습니다. 아직 캐릭터가 없기 때문입니다.
  2. Play 버튼을 누릅니다. 버튼에 "Loading..."이 표시되고, 화면이 어두워졌다가 일반 카메라와 함께 내 캐릭터 뒤에서 다시 밝아지며, 플레이어 목록이 돌아옵니다. Players, 내 이름, PlayerGui에 MainMenu와 MenuFade가 더 이상 없습니다.
  3. 게임 메뉴에서 캐릭터를 리셋합니다. 약 5초 뒤에 리스폰되고, 메뉴는 다시 나타나지 않습니다.
  4. 맵 가장자리에서 걸어 나가거나 뛰어내립니다. 캐릭터가 월드 밖으로 떨어지면 약 5초 뒤에 리스폰됩니다.
  5. Studio의 Device Simulator로 휴대폰 화면을 확인합니다(작성 시점에는 베타입니다. File, Beta Features에서 New Device Simulator를 켜고 Studio를 다시 시작하세요). 작은 휴대폰에서도 Play 버튼은 최소 160 x 56픽셀을 유지하며 손가락으로 누를 수 있습니다.
  6. 플레이 테스트 중에 Controller Emulator(Emulation 탭의 Controller)로 게임패드를 확인합니다. 에뮬레이트된 게임패드의 아무 버튼이나 누르면 Play가 선택되어 있고, A를 누르면 게임이 시작됩니다. Play가 선택되지 않았다면 게임패드의 Select를 누르세요. GuiService.AutoSelectGuiEnabled가 켜져 있는 동안 버튼을 선택해 줍니다. 그다음 A를 누릅니다.
  7. 새 플레이스처럼 인스턴스 스트리밍이 켜진 상태에서, 메뉴 뒤로 하늘만이 아니라 MenuCamera 주변의 맵이 보이는지 확인합니다.

Output에는 어느 시점에도 MenuService나 MainMenu의 빨간 오류가 없어야 합니다. 뭔가 맞지 않으면 자주 발생하는 오류를 보세요.

다른 시스템과 함께 쓰는 메뉴

CharacterAutoLoads를 끄면 게임 안의 다른 모든 스크립트의 동작이 바뀝니다. 이 사이트의 다른 가이드를 따라 만들었다면 아래 항목을 확인하세요.

다른 시스템과 나란히 놓은 메뉴
시스템바뀌는 점해야 할 일
라운드 시스템라운드는 서버의 모든 사람을 세므로 메뉴에 있는 플레이어도 MIN_PLAYERS에 포함되지만, 텔레포트되지는 않습니다. startRound는 살아 있는 캐릭터가 있는 플레이어만 데려갑니다. 탈락한 플레이어는 Roblox가 아니라 MenuService가 리스폰합니다.꼭 할 일은 없습니다. 메뉴에 있는 플레이어 때문에 라운드가 시작되지 않는다면("Not enough players, starting over"), runIntermission에서 Character가 nil이 아닌 플레이어만 세세요.
오비 체크포인트ObbyCheckpoints도 CharacterAutoLoads를 끄고, 각 플레이어의 스테이지가 로드되는 즉시 스폰합니다. 두 스크립트가 모두 있으면 플레이어가 메뉴 뒤에서 자기 체크포인트에 스폰되고, Play는 메뉴만 없앱니다.스포너는 하나만 남기세요. ObbyCheckpoints를 남기고 MenuService를 삭제합니다. ObbyCheckpoints에서 onPlayerAdded 끝의 spawnAtStage(player) 줄을 지웁니다. 그다음 스크립트 최상위, Players.PlayerAdded:Connect(onPlayerAdded) 바로 위(onPlayerAdded 안이 아님)에 MenuService에서 ReplicatedStorage 줄과 PlayRequest를 만드는 줄을 복사하고, OnServerEvent 핸들러를 연결합니다. 핸들러에서는 player.Character가 nil이고, stageValues[player]가 존재하며, 그 플레이어의 스폰이 진행 중이 아닐 때만(MenuService의 spawning 같은 테이블) spawnAtStage(player)를 호출합니다. 스테이지가 로드되기 전에 Play를 누른 플레이어는 Try again을 보고 다시 누를 수 있습니다. 리스폰 처리는 그대로 둡니다. 플레이스에서 스트리밍이 켜져 있다면 MenuService의 MenuCamera 관련 줄(AddReplicationFocus와 RemoveReplicationFocus)도 onPlayerAdded 시작 부분에 복사하세요.
리더보드와 DataStore 스크립트플레이어가 메뉴에 있는 동안, 접속할 때 실행됩니다.할 일 없음. 플레이어가 메뉴를 보는 동안 데이터 로딩이 시작됩니다.
상점 GUIShopClient는 플레이어가 접속하자마자 창을 만들기 때문에 Shop 버튼이 메뉴 옆에 나타납니다.ShopClient에서 gui.Parent = player:WaitForChild("PlayerGui") 줄 바로 앞에 if not player.Character then player.CharacterAdded:Wait() end를 추가해, 상점이 Play 뒤에 나타나게 하세요.
인트로 컷신CutsceneService는 플레이어가 처음 스폰될 때 인트로를 보여 주는데, 메뉴가 있으면 Play 뒤의 첫 스폰이 됩니다. 메뉴가 캐릭터가 나타날 때 core GUI를 다시 켜므로, 인트로 중에 플레이어 목록이 보일 수 있습니다.꼭 할 일은 없습니다. 컷신은 자기가 숨긴 core GUI만 다시 켜므로, 인트로 뒤에도 켜진 상태로 유지됩니다.
StarterGui의 ScreenGui캐릭터가 스폰될 때만 플레이어에게 복사됩니다.할 일 없음. Play 뒤에 나타나며, HUD라면 보통 이것이 원하는 동작입니다.

StarterPlayerScripts와 StarterGui에 있는 스크립트의 차이는 Script vs LocalScript vs ModuleScript 가이드에서 다룹니다.

복사해 온 메뉴 스크립트가 고장 나는 이유

버튼을 화면에 띄우는 것은 쉽습니다. 문제는 Play 뒤에 시작됩니다. 문제를 일으키는 패턴과, 이 가이드가 그 대신 하는 일은 다음과 같습니다.

흔한 메뉴 패턴과 그 문제점
패턴문제이 가이드에서는
Play 버튼의 MouseButton1ClickRoblox는 이것을 마우스 왼쪽 버튼 클릭용으로 설명합니다. Activated는 클릭, 탭, 게임패드 버튼용으로 설명된 이벤트입니다.Activated, 그리고 게임패드용으로 Play 선택
ResetOnSpawn이 켜진 StarterGui의 메뉴 ScreenGuiRoblox가 스폰할 때마다 새 복사본을 주므로, 죽을 때마다 메뉴가 다시 나타납니다ResetOnSpawn을 끄고 Play 뒤에 메뉴를 제거
캐릭터를 스폰한 뒤 메뉴 뒤에 얼려 둠(예: WalkSpeed 0)캐릭터가 월드 안에 있어서 다른 사람이 보고, 밀고, 공격합니다Play 전에는 캐릭터가 없음
player:LoadCharacter()Roblox는 이것이 LoadCharacterAsync로 대체되었다고 표시합니다pcall 안의 LoadCharacterAsync
Play 뒤에도 카메라가 Scriptable로 남음카메라가 메뉴 장면에 갇힙니다카메라 함수 바인딩 해제, CameraType을 Custom으로, CameraSubject를 Humanoid로
workspace.MenuPart를 바로 읽음스트리밍에서는 파트가 아직 클라이언트에 도착하지 않았을 수 있어 스크립트가 오류로 멈춥니다서버에서 추가한 MenuCamera 복제 포커스, 5초 제한과 대체 시점이 있는 WaitForChild
카메라용 repeat wait() until 루프Roblox는 wait()를 더 이상 권장되지 않는 것으로 표시하며, task.wait()로 대체되었습니다카메라에는 BindToRenderStep, 나머지에는 task.wait
Humanoid.Died로만 리스폰CharacterAutoLoads가 꺼져 있으면 맵에서 떨어진 플레이어가 끝내 리스폰되지 않을 수 있습니다. 떨어지면 캐릭터가 Workspace에서 사라질 수 있는데, Died는 Workspace 안에서만 발생합니다캐릭터가 Workspace를 벗어날 때도 리스폰
무료 모델의 메뉴Roblox는 Creator Store의 모델에 백도어 스크립트가 들어 있을 수 있다고 경고합니다한 줄씩 읽어 볼 수 있는 짧은 스크립트 두 개

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

Play를 누르기 전에 Output 창(Window 메뉴 다음 Output)을 여세요. 메뉴 문제는 대부분 그곳에 스크립트 이름과 줄 번호가 담긴 경고나 오류를 출력합니다.

Play 뒤에도 카메라가 메뉴 장면에 머뭅니다

MainMenu가 카메라를 되돌리는 단계까지 가지 못했거나, 그 뒤에 다른 스크립트가 카메라를 바꾼 것입니다. Output에서 MainMenu의 빨간 오류를 찾아보세요. 내 스크립트 중에 CameraType을 설정하는 것이 있다면, 플레이어가 게임에 들어간 뒤 Scriptable로 설정하지 않는지 확인하세요.

버튼에 "Loading..."이 뜬 뒤 "Try again"이 표시됩니다

MainMenu가 PlayRequest를 찾았으니 MenuService는 실행 중이지만, Humanoid가 있는 캐릭터가 15초 안에 나타나지 않았습니다. ReplicatedStorage에 PlayRequest를 직접 추가했다면 삭제하세요. MenuService가 자기 것을 만들기 때문에, 같은 이름의 오브젝트가 두 개 있으면 서버는 한쪽을 듣는데 버튼은 다른 쪽으로 보낼 수 있습니다. 그다음 Output에서 MenuService: could not spawn과 그 뒤의 원인을 찾아보세요. 직접 만든 StarterCharacter를 쓴다면, 두 스크립트 모두 그 이름의 자식을 기다리므로 Humanoid의 이름이 Humanoid여야 합니다. 스폰이 단지 느렸던 것이라면 Try again을 누르면 마무리됩니다.

Infinite yield possible on 'ReplicatedStorage:WaitForChild("PlayRequest")'

MainMenu가 MenuService가 만드는 RemoteEvent를 기다리고 있으므로 MenuService가 실행되지 않고 있습니다. 꺼져 있거나, 위치가 잘못되었거나, 오류로 멈춘 것입니다. 이 경고는 스크립트 오류 가이드에서 다룹니다.

내 캐릭터가 메뉴 뒤에서 스폰됩니다

다른 무언가가 플레이어를 스폰하고 있습니다. Players 서비스의 CharacterAutoLoads 체크를 해제하고, 접속할 때 LoadCharacterAsync를 호출하는 다른 스크립트(예: 오비 체크포인트 스크립트)를 찾아보세요. 다른 시스템과 함께 쓰는 메뉴를 참고하세요.

메뉴에 하늘만 보입니다

카메라가 대체 시점을 쓰고 있거나, 맵이 로드되지 않았습니다. 파트 이름이 정확히 MenuCamera인지, Workspace 바로 아래(폴더나 모델 안이 아님)에 있는지, 앵커되어 있는지, 앞면이 맵을 향하는지 확인하세요.

죽은 뒤 리스폰되지 않습니다

이제 플레이어를 리스폰하는 것은 MenuService뿐이므로, Output에서 MenuService의 오류를 찾아보세요. 리스폰이 실패하면 MenuService: could not spawn이 출력되고 RespawnTime 뒤에 다시 시도합니다. 게임에서 Humanoid의 Dead 상태를 끈다면 Died가 절대 발생하지 않으므로, 내 사망 처리 코드에서 플레이어를 리스폰하세요.

StarterGui의 HUD가 Play 뒤에야 나타납니다

정상입니다. CharacterAutoLoads가 꺼져 있으면 Roblox는 캐릭터가 스폰될 때만 StarterGui를 플레이어의 PlayerGui로 복사합니다. 메뉴에서 보여야 하는 것은 MainMenu처럼 StarterPlayerScripts의 LocalScript에서 만드세요.

RoCode로 만들기

이 모든 것을 직접 만들고 싶지 않다면 RoCode가 지금 열려 있는 플레이스에 만들어 줄 수 있습니다. RoCode는 Roblox와 무관한 독립 제품으로, Roblox Studio용 AI 에이전트입니다. 웹 채팅에서 기능을 설명하면 Studio 플러그인이 내 Explorer에 파트와 스크립트를 만들어 주므로, 채팅 창에서 코드를 복사할 필요가 없습니다.

입력하는 내용

메인 메뉴를 추가해 줘. 플레이어는 Play를 누르기 전까지 스폰되면 안 돼. MenuCamera 파트에서 천천히 움직이는 카메라 장면 위에 내 게임 이름과 Play 버튼을 보여 주고, 화면을 어둡게 한 뒤 서버에서 플레이어를 스폰하고 일반 카메라로 되돌려 줘. 휴대폰과 게임패드에서도 작동해야 해.

RoCode가 하는 일
  • 먼저 Search Scripts로 플레이스를 확인할 수 있습니다. 예를 들어 이미 CharacterAutoLoads를 끄거나 플레이어를 리스폰하는 스크립트(오비 체크포인트 스크립트가 그렇게 합니다)가 있는지 확인해, 두 스크립트가 충돌하지 않게 합니다
  • Create Instance로 MenuCamera 파트를 만들고 Set Property로 Players.CharacterAutoLoads를 끕니다
  • Create Script로 MenuService와 MainMenu를 작성합니다
  • 작성한 모든 스크립트를 Check Script로 확인하도록 되어 있는데, 이 도구는 스크립트를 실행하지 않고 Studio에서 컴파일합니다. 또한 변경 묶음마다 앞뒤로 실행 취소 지점을 만듭니다

RoCode는 메뉴용 로고 이미지나 음악을 대신 업로드할 수 없습니다. Studio나 Creator Hub에 직접 업로드한 뒤 RoCode에 에셋 ID를 알려 주세요. 플러그인 3.9 이상에서는 RoCode가 짧은 플레이 테스트를 실행하고 오류를 읽을 수 있으며, 플러그인 3.9.15 이상에서는 테스트 캐릭터가 화면의 버튼을 누를 수 있습니다. 하지만 스스로 확인하기로 한 것만 확인하므로 메뉴는 직접 눌러 보세요. 게임 전체를 어떤 순서로 만들지는 AI로 Roblox 게임을 시스템별로 만드는 방법 가이드를 보세요. RoCode가 Studio에 연결되는 방식.

자주 묻는 질문

Play를 누르기 전까지 플레이어가 스폰되지 않게 하려면 어떻게 하나요?

Players 서비스의 CharacterAutoLoads 체크를 해제한 뒤, Play 버튼에서 RemoteEvent가 오면 서버 Script에서 player:LoadCharacterAsync()로 플레이어를 스폰합니다. 그러면 죽은 뒤 리스폰할 때도 같은 호출이 필요한데, MenuService가 이를 처리합니다.

메인 메뉴가 죽을 때마다 다시 나타나는 이유는 무엇인가요?

메뉴 ScreenGui의 ResetOnSpawn이 켜져 있어서 Roblox가 스폰할 때마다 플레이어에게 새 복사본을 주기 때문입니다. 이 값을 끄고, MainMenu처럼 Play 뒤에 메뉴를 없애세요.

메뉴 뒤로 카메라가 맵을 보여 주게 하려면 어떻게 하나요?

LocalScript에서 workspace.CurrentCamera.CameraType을 Scriptable로 설정하고, 배치해 둔 파트의 CFrame을 카메라에 지정합니다. Play 뒤에는 Custom으로 되돌리고 CameraSubject를 Humanoid로 설정하세요.

메뉴 앞에 로딩 화면을 추가하려면 어떻게 하나요?

Roblox의 로딩 화면 가이드는 다른 무엇보다 먼저 플레이어에게 전달되는 ReplicatedFirst의 LocalScript를 사용합니다. 이 스크립트는 ScreenGui를 만들고, ReplicatedFirst:RemoveDefaultLoadingScreen()을 호출하고, game:IsLoaded()가 될 때까지 기다린 뒤 자기 화면을 없앱니다. 사라지기 전까지 이 메뉴를 덮도록 그 ScreenGui의 DisplayOrder를 11보다 높게 주세요. 우리 로딩 화면 가이드는 진행 바와 Skip 버튼이 있는 화면을 만들며, 그 DisplayOrder 100은 이미 메뉴를 덮습니다.

메인 메뉴에 음악을 넣으려면 어떻게 하나요?

권리가 있는 오디오를 사용하세요. 예를 들어 Creator Store의 무료 트랙이나 직접 업로드한 오디오입니다. 그 ID로 Sound를 SoundService에 넣고 Looped를 체크한 뒤, 메뉴가 나타날 때 MainMenu에서 :Play()를, Play 핸들러에서 :Stop()을 호출합니다. SoundService.RespectFilteringEnabled가 켜져 있는 동안 LocalScript에서 재생한 소리는 그 플레이어만 들으며, 이 값은 기본적으로 켜져 있습니다.

무료 모델의 메인 메뉴를 써도 되나요?

써도 되지만 먼저 스크립트를 읽어 보세요. Roblox는 Creator Store의 모델에 만든 사람이 내 게임에 접근할 수 있게 해 주는 백도어 스크립트가 들어 있을 수 있다고 경고합니다. 메뉴에는 이 가이드의 짧은 스크립트 두 개만 있으면 됩니다.

출처와 더 읽을거리

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

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

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