요약
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초)만큼 기다린 뒤 직접 리스폰합니다.
이 페이지의 내용
메인 메뉴의 작동 방식
메뉴에는 두 측면이 있습니다. 플레이어의 기기는 게임 이름과 버튼을 그리고 카메라를 움직입니다. 서버는 캐릭터가 언제 나타날지 정합니다. 메뉴 자체는 한 사람의 화면에 보이는 그림일 뿐입니다. 실제 변화는 서버가 캐릭터를 스폰할 때 일어나며, 그 일은 서버만 할 수 있습니다.
| 부분 | 위치 | 하는 일 |
|---|---|---|
MenuService Script | ServerScriptService | 자동 스폰을 끄고, PlayRequest를 만들고, Play를 누른 플레이어를 스폰하며, 죽거나 떨어진 플레이어를 리스폰합니다. |
MainMenu LocalScript | StarterPlayerScripts | 게임 이름, Play 버튼, 페이드를 만들고, 카메라 장면을 움직이며, 서버에 캐릭터를 요청하고 카메라를 되돌립니다. |
PlayRequest RemoteEvent | ReplicatedStorage(MenuService가 만들므로 직접 추가하지 마세요) | 서버에 "이 플레이어가 Play를 눌렀다"는 메시지 하나만 전달합니다. 값은 들어 있지 않습니다. |
MenuCamera Part | Workspace(직접 배치) | 메뉴 카메라가 놓이는 위치와 바라보는 방향입니다. |
CharacterAutoLoads | Players 서비스의 속성 | 꺼져 있으므로 서버가 LoadCharacterAsync를 호출하기 전까지 아무도 스폰되지 않습니다. |
Workspace
MenuCamera Part new
ReplicatedStorage
PlayRequest RemoteEvent new
ServerScriptService
MenuService Script new
StarterPlayer
StarterPlayerScripts
MainMenu LocalScript new
1단계: 자동 스폰을 끄고 메뉴 카메라 배치하기
- Explorer에서 Players를 선택합니다. Properties 창에서 CharacterAutoLoads 체크를 해제합니다. MenuService도 이 값을 끄지만, 체크를 해제해 두면 스크립트가 실행되기 직전에 누군가 스폰되는 일이 없습니다.
- Workspace에 마우스를 올리고 + 버튼을 눌러 Part를 넣습니다. 이름을
MenuCamera로 바꾸고(이름은 대소문자를 구분합니다) 폴더나 모델 안이 아니라 Workspace 바로 아래에 둡니다. - Properties에서 Anchored를 체크하고, CanCollide를 해제하고, Transparency를 1로 설정합니다. 앵커가 중요합니다. 앵커되지 않았고 아무것과도 충돌하지 않는 파트는 맵을 뚫고 떨어지며, Roblox는
Workspace.FallenPartsDestroyHeight보다 아래로 떨어진 파트를 삭제합니다. - 파트의 앞면이 원하는 장면을 향하도록 이동하고 회전합니다. 카메라는 파트의 위치를 가져오고 파트의 앞면과 같은 방향을 바라봅니다.
가장 빠르게 맞추는 방법: Studio 카메라를 원하는 장면으로 옮긴 뒤 Command Bar(Script 탭, 또는 Window 다음 Script)를 열고 workspace.MenuCamera.CFrame = workspace.CurrentCamera.CFrame를 실행합니다. 편집 모드에서 CurrentCamera는 지금 보고 있는 시점이므로, 파트가 정확히 그 장면으로 이동합니다.
Workspace.StreamingEnabled는 그대로 두세요. 새 플레이스에서는 인스턴스 스트리밍이 켜져 있으며, 아래 스크립트는 이를 고려해 작성되었습니다.
2단계: Play를 누르면 플레이어 스폰하기
ServerScriptService에 마우스를 올리고 Script를 넣은 뒤 이름을 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단계: 테스트하기
- Output 창(Window 메뉴 다음 Output)을 열고 Play를 누릅니다. MenuCamera 장면 위에 게임 이름과 Play 버튼이 서서히 나타나고, 플레이어 목록과 배낭은 숨겨져 있습니다. Explorer의 Workspace에는 내 이름으로 된 모델이 없습니다. 아직 캐릭터가 없기 때문입니다.
- Play 버튼을 누릅니다. 버튼에 "Loading..."이 표시되고, 화면이 어두워졌다가 일반 카메라와 함께 내 캐릭터 뒤에서 다시 밝아지며, 플레이어 목록이 돌아옵니다.
Players, 내 이름,PlayerGui에 MainMenu와 MenuFade가 더 이상 없습니다. - 게임 메뉴에서 캐릭터를 리셋합니다. 약 5초 뒤에 리스폰되고, 메뉴는 다시 나타나지 않습니다.
- 맵 가장자리에서 걸어 나가거나 뛰어내립니다. 캐릭터가 월드 밖으로 떨어지면 약 5초 뒤에 리스폰됩니다.
- Studio의 Device Simulator로 휴대폰 화면을 확인합니다(작성 시점에는 베타입니다. File, Beta Features에서 New Device Simulator를 켜고 Studio를 다시 시작하세요). 작은 휴대폰에서도 Play 버튼은 최소 160 x 56픽셀을 유지하며 손가락으로 누를 수 있습니다.
- 플레이 테스트 중에 Controller Emulator(Emulation 탭의 Controller)로 게임패드를 확인합니다. 에뮬레이트된 게임패드의 아무 버튼이나 누르면 Play가 선택되어 있고, A를 누르면 게임이 시작됩니다. Play가 선택되지 않았다면 게임패드의 Select를 누르세요.
GuiService.AutoSelectGuiEnabled가 켜져 있는 동안 버튼을 선택해 줍니다. 그다음 A를 누릅니다. - 새 플레이스처럼 인스턴스 스트리밍이 켜진 상태에서, 메뉴 뒤로 하늘만이 아니라 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 스크립트 | 플레이어가 메뉴에 있는 동안, 접속할 때 실행됩니다. | 할 일 없음. 플레이어가 메뉴를 보는 동안 데이터 로딩이 시작됩니다. |
| 상점 GUI | ShopClient는 플레이어가 접속하자마자 창을 만들기 때문에 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를 누르기 전에 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 버튼을 보여 주고, 화면을 어둡게 한 뒤 서버에서 플레이어를 스폰하고 일반 카메라로 되돌려 줘. 휴대폰과 게임패드에서도 작동해야 해.
- 먼저 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 Engine API: Players (영어). CharacterAutoLoads와 RespawnTime
- Roblox Engine API: Player (영어). LoadCharacterAsync, 로딩 순서, AddReplicationFocus
- Roblox Creator Docs: On-screen UI containers (영어). StarterGui가 복사되는 시점, 화면 인셋, 표시 순서
- Roblox Engine API: LayerCollector (영어). ResetOnSpawn
- Roblox Engine API: Camera (영어). 카메라가 바라보는 지점인 Focus
- Roblox Creator Docs: Customize the camera (영어). CameraType Scriptable로 스크립트에서 카메라 제어하기
- Roblox Creator Docs: Streaming techniques and conversion (영어). 캐릭터가 없는 클라이언트가 맵을 받지 못할 수 있는 이유와 복제 포커스
- Roblox Engine API: GuiButton (영어). 클릭, 탭, 게임패드 버튼용 Activated
- Roblox Creator Docs: Loading screens (영어). ReplicatedFirst의 커스텀 로딩 화면
- Roblox Creator Docs: Vulnerabilities from third-party assets (영어). 무료 모델 속 백도어 스크립트
코드 검증 방법: 이 페이지의 모든 스크립트는 Roblox API 정의를 적용한 Luau의 엄격한 타입 검사기(luau-lsp, 2026년 11월 20일)를 통과합니다. 타입 검사는 잘못 쓴 API 이름과 잘못된 타입을 찾아내지만 게임 로직의 오류는 찾지 못하므로, 게시하기 전에 Studio에서 직접 테스트하세요.