요약
ServerScriptService에 서버 Script 하나를 쓰고, 정해진 상태들을 계속 돌게 하세요. 인터미션(필요한 인원이 모일 때까지 기다린 뒤 카운트다운), 맵 불러오기(ServerStorage의 무작위 맵을 Workspace로 복제), 텔레포트(살아 있는 캐릭터를 모두 PivotTo로 스폰 파트에 옮기기), 라운드(시간이 다 되거나 플레이어 한 명 또는 팀 하나만 남을 때까지 타이머 진행), 정리(Wins 지급, 생존자 리스폰, 맵 삭제)입니다.
- 순환은 서버에서만 돌리세요. 상태와 남은 초는 ReplicatedStorage의 Folder에 속성(attribute)으로 공개하고, 표시는 LocalScript가 맡게 하세요.
- 아직 라운드에 남아 있는 플레이어 테이블을 유지하세요. Humanoid가 죽거나, 캐릭터가 삭제되거나, 플레이어가 나가면 그 플레이어를 빼세요.
- 라운드가 시작되는 순간 캐릭터가 살아 있는 플레이어만 텔레포트하세요. 나중에 들어온 사람은 로비에서 다음 라운드를 기다립니다.
이 페이지의 내용
라운드 시스템의 작동 방식
라운드 시스템은 상태 머신입니다. 서버는 언제나 정확히 하나의 상태에 있고, 각 상태에는 할 일이 하나 있으며, 조건 하나가 다음 상태로 넘깁니다. 이렇게 쓰면 모든 로직이 한곳에 있고, 타이머 반복문과 라운드 반복문이 같은 라운드를 둘 다 끝내려 하는 흔한 버그가 생기지 않습니다.
| 상태 | 서버가 하는 일 | 다음으로 넘어가는 때 |
|---|---|---|
| Waiting | "Waiting for players (1/2)"를 표시 | 서버에 플레이어가 충분함 |
| Intermission | 모두 로비에 있는 동안 시간을 셈 | 카운트다운이 끝남(플레이어가 나가면 Waiting으로 돌아감) |
| Starting | 무작위 맵을 Workspace에 복사하고 이름을 보여 주며, 클라이언트에 맵을 불러오라고 요청 | 짧은 "준비" 카운트다운이 끝남 |
| InRound | 살아 있는 플레이어를 텔레포트하고, 타이머를 진행하고, 죽거나 나간 사람을 뺌 | 시간이 다 되거나, 플레이어 한 명 또는 팀 하나만 남음 |
| Results | 아직 살아 있는 모두에게 Win을 주고 누가 이겼는지 보여 줌 | 몇 초가 지남 |
| Cleanup | 생존자를 로비에 리스폰하고 맵을 삭제 | 바로, 그 뒤 순환이 처음부터 다시 시작 |
모든 상태의 주인은 서버입니다. 클라이언트는 서버가 알려 주는 것을 보여 주기만 합니다. LocalScript의 카운트다운은 실제와 어긋나고, 나중에 들어온 사람에게는 틀리며, 익스플로이터가 바꿀 수 있습니다. 서버와 클라이언트의 구분이 처음이라면 먼저 Script vs LocalScript vs ModuleScript를 읽어 보세요.
1단계: 로비, 맵, Wins 스탯 만들기
- Workspace에
SpawnLocation이 있는 로비를 만드세요. Neutral 속성이 체크되어 있는지 확인해서, 모든 플레이어가 여기서 스폰하고, 여기서 기다리고, 탈락하면 여기로 돌아오게 하세요. - ServerStorage에
Maps라는Folder를 넣으세요. ServerStorage의 오브젝트는 플레이어에게 절대 전송되지 않으므로, 쓰지 않는 맵은 플레이어에게 아무 부담이 되지 않습니다. - 각 맵은
Maps안에Model로 만들고, 파트는 고정(Anchored)하세요. 로비에서 멀리 떨어진 곳에 만드세요(수백 스터드면 충분합니다). 복사본은 정확히 만든 그 자리에 나타나고, 탈락한 플레이어가 다시 걸어 들어갈 수 없어야 하기 때문입니다. - 각 맵 안에
Spawns라는Folder를 넣고, 그 안에 예상 인원마다 고정된Part를 하나씩 넣으세요. Transparency를 1로 하고 CanCollide를 끄면 아무도 보지 못하고 걸려 넘어지지도 않습니다.
Workspace
Lobby Model
SpawnLocation SpawnLocation
ServerStorage
Maps Folder new
Desert Model new
Spawns Folder new
Spawn1 Part new
Spawn2 Part new
Castle Model new
Spawns Folder new
ServerScriptService
Leaderstats Script new
RoundSystem Script new
StarterGui
RoundHud ScreenGui new
RoundHudClient LocalScript new
라운드 스크립트는 플레이어의 leaderstats 폴더 안에 있는 Wins라는 IntValue에 1을 더합니다. 게임에 아직 leaderstats가 없다면 아래의 짧은 스크립트를 넣으세요. 이미 있다면, 예를 들어 리더보드 가이드의 저장 버전이 있다면 건너뛰세요. leaderstats를 만드는 스크립트가 두 개면 플레이어마다 폴더가 두 개 생깁니다.
local Players = game:GetService("Players")
local function setupLeaderstats(player: Player)
local leaderstats = Instance.new("Folder")
leaderstats.Name = "leaderstats" -- 이름은 정확히 이대로, 소문자여야 합니다
local wins = Instance.new("IntValue")
wins.Name = "Wins"
wins.Value = 0
wins.Parent = leaderstats
leaderstats.Parent = player
end
Players.PlayerAdded:Connect(setupLeaderstats)
-- Studio에서는 이 스크립트가 실행되기 전에 들어올 수 있으므로, 이미 있는 모두를 설정합니다
for _, player in Players:GetPlayers() do
setupLeaderstats(player)
end
이 Wins는 플레이어가 나가면 초기화됩니다. 세션 사이에도 유지하려면 리더보드 가이드의 DataStore 버전을 쓰세요.
2단계: 라운드 스크립트 추가하기
ServerScriptService에 Script를 넣고 이름을 RoundSystem으로 한 다음 아래 코드를 붙여 넣으세요. 맨 위의 설정이 아마 바꿔야 할 유일한 줄들입니다. 각 상태는 별도의 함수이고, 맨 아래의 반복문이 이들을 순서대로 끝없이 실행합니다.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerStorage = game:GetService("ServerStorage")
-- 설정
local MIN_PLAYERS = 2 -- 혼자 테스트하는 동안은 1로 두세요
local INTERMISSION_SECONDS = 20
local GET_READY_SECONDS = 5
local ROUND_SECONDS = 120
local RESULTS_SECONDS = 5
local USE_TEAMS = false -- true: 플레이어가 한 팀에만 남으면 라운드가 끝납니다
local mapsFolder = ServerStorage:WaitForChild("Maps")
local random = Random.new()
-- 모든 플레이어의 화면에 보이는 것은 이 폴더의 속성에 저장됩니다.
-- 서버가 설정한 속성은 나중에 들어온 사람을 포함해 모든 클라이언트에 복제됩니다.
local roundInfo = Instance.new("Folder")
roundInfo.Name = "RoundInfo"
roundInfo.Parent = ReplicatedStorage
local function setState(state: string, status: string)
roundInfo:SetAttribute("State", state)
roundInfo:SetAttribute("Status", status)
roundInfo:SetAttribute("TimeLeft", 0)
end
local function setTimeLeft(seconds: number)
roundInfo:SetAttribute("TimeLeft", seconds)
end
-- 현재 라운드에 아직 남은 사람과, 각자를 지켜보는 연결
local alive: { [Player]: boolean } = {}
local watchers: { [Player]: { RBXScriptConnection } } = {}
local function eliminate(player: Player)
if not alive[player] then
return
end
alive[player] = nil
player:SetAttribute("InRound", false)
local connections = watchers[player]
if connections then
for _, connection in connections do
connection:Disconnect()
end
watchers[player] = nil
end
end
Players.PlayerRemoving:Connect(eliminate)
-- 플레이어가 지금 살아 있을 때만 캐릭터와 Humanoid를 돌려줍니다
local function getLivingCharacter(player: Player): (Model?, Humanoid?)
local character = player.Character
if not character or not character.Parent then
return nil, nil
end
local humanoid = character:FindFirstChildOfClass("Humanoid")
if not humanoid or humanoid.Health <= 0 or not humanoid.RootPart then
return nil, nil
end
return character, humanoid
end
-- 라운드에 남은 편을 셉니다(USE_TEAMS가 켜져 있으면 플레이어 대신 팀)
local function countSides(): (number, number)
local sides: { [Instance]: boolean } = {}
local sideCount = 0
local playerCount = 0
for player in alive do
playerCount += 1
local team = player.Team
local side: Instance = if USE_TEAMS and team then team else player
if not sides[side] then
sides[side] = true
sideCount += 1
end
end
return sideCount, playerCount
end
-- 상태: Waiting과 Intermission. 카운트다운 중에 플레이어가 나가면 false를 돌려줍니다.
local function runIntermission(): boolean
while #Players:GetPlayers() < MIN_PLAYERS do
setState("Waiting", `Waiting for players ({#Players:GetPlayers()}/{MIN_PLAYERS})`)
task.wait(1)
end
setState("Intermission", "Intermission")
for secondsLeft = INTERMISSION_SECONDS, 1, -1 do
if #Players:GetPlayers() < MIN_PLAYERS then
return false
end
setTimeLeft(secondsLeft)
task.wait(1)
end
return true
end
-- 상태: Starting, 1부. 무작위 맵을 복사합니다(고를 수 있으면 지난번 맵은 빼고).
local lastMapName = ""
local function loadMap(): Model?
local allMaps: { Model } = {}
local freshMaps: { Model } = {}
for _, child in mapsFolder:GetChildren() do
if child:IsA("Model") then
table.insert(allMaps, child)
if child.Name ~= lastMapName then
table.insert(freshMaps, child)
end
end
end
local choices = if #freshMaps > 0 then freshMaps else allMaps
if #choices == 0 then
warn("RoundSystem: add at least one map Model to ServerStorage > Maps")
return nil
end
local chosen = choices[random:NextInteger(1, #choices)]
lastMapName = chosen.Name
local map = chosen:Clone()
map.Parent = workspace
return map
end
local function getSpawnPoints(map: Model): { BasePart }
local points: { BasePart } = {}
local folder = map:FindFirstChild("Spawns")
if folder then
for _, child in folder:GetChildren() do
if child:IsA("BasePart") then
table.insert(points, child)
end
end
end
-- 플레이어가 매 라운드 같은 스폰에 서지 않도록 섞습니다
for i = #points, 2, -1 do
local j = random:NextInteger(1, i)
points[i], points[j] = points[j], points[i]
end
return points
end
-- 서 있는 캐릭터의 root part가 바닥에서 얼마나 높이 있는지.
-- Roblox의 Humanoid.HipHeight 문서에 나온 공식입니다(R6 리그는 다리 높이를 더합니다).
local function rootHeight(character: Model, humanoid: Humanoid, rootPart: BasePart): number
local height = rootPart.Size.Y / 2 + humanoid.HipHeight
if humanoid.RigType == Enum.HumanoidRigType.R6 then
local leg = character:FindFirstChild("Left Leg")
if leg and leg:IsA("BasePart") then
height += leg.Size.Y
end
end
return height
end
-- 상태: Starting, 2부. 준비한 다음 살아 있는 모두를 텔레포트합니다.
local function startRound(map: Model): boolean
local spawnPoints = getSpawnPoints(map)
if #spawnPoints == 0 then
warn(`RoundSystem: {map.Name} needs a Spawns folder with at least one part in it`)
return false
end
-- 스트리밍이 켜져 있으면 캐릭터가 도착하기 전에 각 클라이언트에 맵을 불러오라고 요청합니다
if workspace.StreamingEnabled then
local mapPosition = map:GetPivot().Position
for _, player in Players:GetPlayers() do
task.spawn(function()
pcall(function()
player:RequestStreamAroundAsync(mapPosition, GET_READY_SECONDS)
end)
end)
end
end
setState("Starting", `Map: {map.Name}`)
for secondsLeft = GET_READY_SECONDS, 1, -1 do
setTimeLeft(secondsLeft)
task.wait(1)
end
-- 지금 살아 있는 사람만 참가합니다. 나머지는 다음 라운드를 기다립니다.
local participants: { Player } = {}
for _, player in Players:GetPlayers() do
if getLivingCharacter(player) then
table.insert(participants, player)
end
end
if #participants < MIN_PLAYERS then
setState("Waiting", "Not enough players, starting over")
task.wait(2)
return false
end
for index, player in participants do
local character, humanoid = getLivingCharacter(player)
local rootPart = if humanoid then humanoid.RootPart else nil
if character and humanoid and rootPart then
local spawnPart = spawnPoints[(index - 1) % #spawnPoints + 1]
-- 캐릭터의 피벗은 root part이므로, 파트 위에 서 있는 높이만큼 올립니다
local height = spawnPart.Size.Y / 2 + rootHeight(character, humanoid, rootPart)
character:PivotTo(spawnPart.CFrame + Vector3.new(0, height, 0))
alive[player] = true
player:SetAttribute("InRound", true)
watchers[player] = {
humanoid.Died:Connect(function()
eliminate(player)
end),
player.CharacterRemoving:Connect(function()
eliminate(player)
end),
}
end
end
return true
end
-- 상태: InRound. 시간이 다 되거나 한 편만 남으면 끝납니다.
local function runRound()
setState("InRound", "Round in progress")
local startingSides = countSides()
for secondsLeft = ROUND_SECONDS, 1, -1 do
local _, playersLeft = countSides()
roundInfo:SetAttribute("Status", `{playersLeft} left`)
setTimeLeft(secondsLeft)
task.wait(1)
local sidesLeft = countSides()
-- 한 편으로 시작한 라운드(혼자 테스트)는 시간이 다 되거나 죽어야만 끝납니다
if sidesLeft == 0 or (startingSides > 1 and sidesLeft == 1) then
break
end
end
end
-- 상태: Results. 아직 살아 있는 모두가 이깁니다.
local function awardWin(player: Player)
local leaderstats = player:FindFirstChild("leaderstats")
local wins = leaderstats and leaderstats:FindFirstChild("Wins")
if wins and wins:IsA("IntValue") then
wins.Value += 1
end
end
local function finishRound(): { Player }
local sidesLeft = countSides()
local winners: { Player } = {}
for player in alive do
table.insert(winners, player)
end
local message = `{#winners} players survived!`
local firstTeam = if #winners > 0 then winners[1].Team else nil
if #winners == 0 then
message = "Nobody survived"
elseif USE_TEAMS and sidesLeft == 1 and firstTeam then
message = `{firstTeam.Name} wins!`
elseif #winners == 1 then
message = `{winners[1].DisplayName} wins!`
end
for _, player in winners do
awardWin(player)
eliminate(player) -- 더는 지켜보지 않습니다. 정리할 때까지 맵에 남아 있습니다
end
setState("Results", message)
task.wait(RESULTS_SECONDS)
return winners
end
-- 상태: Cleanup. 생존자를 로비로 돌려보낸 다음 맵을 삭제합니다.
local function cleanup(map: Model, survivors: { Player })
for _, player in survivors do
if player.Parent then -- 아직 서버에 있음
task.spawn(function()
local ok, err = pcall(function()
player:LoadCharacterAsync()
end)
if not ok then
warn(`RoundSystem: could not respawn {player.Name}: {err}`)
end
end)
end
end
map:Destroy()
end
-- 순환: 한 바퀴가 라운드 하나입니다
while true do
if runIntermission() then
local map = loadMap()
if map then
local survivors: { Player } = {}
if startRound(map) then
runRound()
survivors = finishRound()
end
cleanup(map, survivors)
else
task.wait(5) -- 아직 맵이 없음: 곧 다시 시도합니다
end
end
end
중요한 일은 모두 여기, 서버에서 일어납니다. 누가 라운드에 있는지, 타이머, 승자, Wins입니다. 클라이언트는 ReplicatedStorage.RoundInfo의 속성 세 개(State, Status, TimeLeft)와 각 플레이어의 InRound 속성만 받습니다.
각 상태의 작동 방식
대기와 인터미션
runIntermission은 먼저 #Players:GetPlayers()가 MIN_PLAYERS에 이를 때까지 순환을 붙잡아 둡니다. 그다음 task.wait(1)로 1초씩 세면서 매 틱마다 인원을 확인합니다. 누군가 나가서 서버 인원이 최소보다 적어지면 false를 돌려주고, 메인 순환은 Waiting부터 다시 시작하므로 라운드가 한 사람만으로 시작되는 일은 없습니다.
맵 고르기와 불러오기
loadMap은 ServerStorage.Maps의 모든 Model을 모으고, 고를 것이 있으면 지난 라운드의 맵을 빼고, Random:NextInteger로 하나를 고릅니다. 그다음 그 맵을 Workspace로 복제합니다. 원본은 ServerStorage에 그대로 남으므로 라운드마다 새 복사본으로 시작합니다. 지난 라운드에 플레이어가 부수거나 옮긴 것은 모두 사라집니다.
새 플레이스에서는 인스턴스 스트리밍이 켜져 있어서, 클라이언트는 자기 캐릭터 근처의 파트만 갖고 있습니다. 스크립트는 텔레포트 전에 플레이어마다 Player:RequestStreamAroundAsync를 호출하는데, 이는 "준비" 카운트다운 동안 맵 주변 영역을 클라이언트에 보내 달라고 엔진에 요청합니다. 이것이 없으면 바닥이 로드되기 전에 플레이어가 도착해 잠깐 멈출 수 있습니다.
PivotTo로 플레이어 텔레포트하기
카운트다운이 끝나면 스크립트는 캐릭터가 존재하고, 아직 세계 안에 있으며, 체력이 0보다 큰 Humanoid와 root part를 가진 플레이어들로 참가자 목록을 만듭니다. 이 검사는 카운트다운 뒤에 하므로, 카운트다운 중에 죽거나 나간 사람은 목록에 들어가지 않습니다.
참가자는 각각 character:PivotTo(cframe)로 옮깁니다. Roblox 문서는 PivotTo를 스크립트로 모델을 움직이는 기본 방법이라고 부르며, 이 메서드는 캐릭터의 모든 부분을 함께 옮깁니다. HumanoidRootPart.Position을 설정하는 것은 같지 않습니다. Roblox가 연결을 조정해서 그 부분 하나만 움직이고, 몸의 나머지는 뒤에 남을 수 있습니다. 캐릭터의 피벗은 root part이므로, 목표는 스폰 파트의 CFrame을 파트 높이의 절반과 root part가 바닥 위에 서는 높이만큼 올린 값입니다. rootHeight는 이 높이를 Roblox의 Humanoid.HipHeight 문서에 나온 공식으로 계산합니다. root part 높이의 절반에 HipHeight를 더하고, R6 리그는 다리 길이를 더합니다. 그래서 크기를 바꾼 아바타나 커스텀 아바타도 파트에 박히거나 위에서 떨어지지 않습니다. CFrame에는 회전도 들어 있으므로 플레이어는 스폰 파트가 향하는 쪽을 봅니다. 모두가 맵 가운데를 보도록 파트를 돌려 두세요.
플레이어가 스폰 파트보다 많으면 스크립트는 첫 번째 파트부터 다시 쓰고 플레이어가 서로 겹치므로, 최대 인원 이상으로 스폰을 넣으세요.
달리기 가이드의 속도 검사도 쓰고 있다면, 텔레포트가 속도 초과로 잡히지 않도록 startRound의 character:PivotTo(...) 바로 뒤에 player:SetAttribute("MovementCheckSkip", true)를 넣으세요.
라운드 타이머와 종료 조건
runRound는 1초마다 틱합니다. 틱마다 상태(남은 플레이어 수)와 남은 초를 갱신한 다음, 살아 있는 편을 셉니다. 라운드는 세 가지 중 하나로 끝납니다.
- 시간이 다 됨.
for반복문이 1에 이르러 끝납니다. - 한 편만 남음. 편은 플레이어이며,
USE_TEAMS가 켜져 있으면 팀입니다. 이 검사는 라운드가 두 편 이상으로 시작했을 때만 작동하므로, 혼자 하는 테스트가 시작하자마자 끝나지 않습니다. - 아무도 남지 않음. 모두 죽거나 나갔고, 라운드는 승자 없이 끝납니다.
1초마다 검사하므로 마지막 탈락 뒤에도 라운드가 최대 1초 더 이어질 수 있는데, 라운드 타이머에서는 거의 눈에 띄지 않습니다.
Wins 지급과 결과 표시
이 스크립트의 규칙은 단순합니다. 라운드가 끝나는 순간 살아 있는 모두가 이깁니다. 이 로직 한 줄로 마지막 생존 플레이어, 마지막 생존 팀, "타이머가 끝날 때까지 버티기" 모드를 모두 처리합니다. finishRound는 승자마다 Wins에 1을 더하고, 더는 지켜보지 않으며, RESULTS_SECONDS 동안 "Alex wins!" 같은 메시지를 보여 줍니다. 시간이 다 됐을 때 승자가 없게 하고 싶다면, sidesLeft가 1보다 클 때 awardWin을 건너뛰고 메시지를 바꾸세요. 어느 쪽이든 목록은 계속 돌려주세요. 정리 단계가 그 목록으로 생존자를 로비에 돌려보내기 때문입니다.
정리
생존자는 아직 맵 위에 서 있으므로, cleanup은 예전 LoadCharacter를 대신하는 Player:LoadCharacterAsync()로 그들을 로비에 리스폰한 다음 맵 복사본을 삭제합니다. 리스폰은 각각 pcall 안에서 자기 task.spawn으로 돌립니다. 이 호출은 캐릭터가 로드될 때까지 기다리고, 그 순간 플레이어가 나가면 실패할 수 있기 때문입니다. 탈락한 플레이어는 할 일이 없습니다. 이미 스스로 로비에서 리스폰했습니다.
3단계: 모든 플레이어에게 타이머와 상태 보여 주기
서버는 ReplicatedStorage.RoundInfo에 속성 세 개를 공개합니다. State(스크립트용으로 InRound 같은 고정된 단어), Status(사람이 읽는 텍스트), TimeLeft(초)입니다. 서버 스크립트가 복제되는 오브젝트에 설정한 속성은 자동으로 모든 클라이언트에 전달되고, 라운드 도중에 들어온 플레이어도 바로 현재 값을 받습니다. 그래서 타이머에는 리모트보다 이쪽이 낫습니다. 누군가 들어오기 전에 보낸 RemoteEvent는 그 사람에게 절대 도착하지 않습니다.
- Explorer에서 StarterGui에 ScreenGui를 넣고 이름을
RoundHud로 하세요. ResetOnSpawn은 켜 둔 채로 두세요(기본값). RoundHud에 LocalScript를 넣고 이름을RoundHudClient로 한 다음 아래 코드를 붙여 넣으세요. 문구를 직접 만들므로 따로 그릴 것은 없습니다.- Play를 누르세요. 화면 위쪽 문구에 상태와
m:ss형식의 카운트다운이 보입니다.
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local roundInfo = ReplicatedStorage:WaitForChild("RoundInfo")
local screenGui = script.Parent :: ScreenGui
-- 문구. RoundHud에 직접 그린 TextLabel이 있다면 이 블록을 지우고 다음을 쓰세요:
-- local label = screenGui:WaitForChild("StatusLabel") :: TextLabel
local label = Instance.new("TextLabel")
label.Name = "StatusLabel"
label.AnchorPoint = Vector2.new(0.5, 0)
label.Position = UDim2.new(0.5, 0, 0, 12)
label.Size = UDim2.fromOffset(320, 44)
label.BackgroundColor3 = Color3.fromRGB(20, 14, 32)
label.BackgroundTransparency = 0.2
label.TextColor3 = Color3.new(1, 1, 1)
label.Font = Enum.Font.BuilderSansBold
label.TextSize = 22
label.TextWrapped = true -- 긴 메시지는 두 번째 줄로 넘어갑니다
label.Text = ""
label.Parent = screenGui
local corner = Instance.new("UICorner")
corner.CornerRadius = UDim.new(0, 10)
corner.Parent = label
local function formatTime(seconds: number): string
return string.format("%d:%02d", seconds // 60, seconds % 60)
end
local function update()
local status = roundInfo:GetAttribute("Status")
local timeLeft = roundInfo:GetAttribute("TimeLeft")
local text = if type(status) == "string" then status else ""
if type(timeLeft) == "number" and timeLeft > 0 then
text ..= " " .. formatTime(timeLeft)
end
label.Text = text
end
roundInfo:GetAttributeChangedSignal("Status"):Connect(update)
roundInfo:GetAttributeChangedSignal("TimeLeft"):Connect(update)
update()
ResetOnSpawn이 켜져 있으므로, 정리 단계의 리스폰을 포함해 캐릭터가 스폰할 때마다 Roblox가 플레이어에게 RoundHud의 새 복사본을 줍니다. 그러면 스크립트가 현재 속성을 다시 읽으므로 문구가 낡는 일이 없습니다.
클라이언트는 읽기만 합니다. LocalScript에서 바꾼 속성은 그 클라이언트 하나에만 남으므로, 플레이어가 자기 화면에서 무엇을 바꾸든 진짜 타이머에는 영향이 없습니다. 0.1초 단위 카운트다운이 필요하다면, 서버가 대신 workspace:GetServerTimeNow()로 구한 종료 시각을 속성에 저장하고, 각 클라이언트가 매 프레임 자기 workspace:GetServerTimeNow()를 거기서 빼면 됩니다.
게임이 메인 메뉴로 시작한다면, StarterGui는 캐릭터가 스폰한 뒤에야 플레이어에게 복사되므로 RoundHud는 플레이어가 Play를 누를 때 나타납니다. 아직 메뉴에 있는 플레이어는 캐릭터가 없으므로 라운드로 텔레포트되지 않습니다.
라운드 도중에 죽거나, 나가거나, 들어오는 플레이어
라운드 스크립트를 처음 쓸 때는 이런 경우를 놓치기 쉽습니다. 그중 하나라도 처리하지 않으면 보통 Output에 오류가 뜨거나 라운드가 끝나지 않습니다. 위 스크립트가 각각을 어떻게 처리하는지 정리했습니다.
| 상황 | 일어나는 일 | 스크립트의 위치 |
|---|---|---|
| 라운드 중에 플레이어가 죽음(처치당함, 리셋, 추락) | 라운드에서 빠지고, Players.RespawnTime(기본 5초) 뒤에 로비에서 리스폰합니다. | humanoid.Died가 eliminate를 호출 |
| 죽지 않고 캐릭터가 삭제됨 | 죽었을 때와 같습니다. 플레이어가 탈락합니다. | player.CharacterRemoving이 eliminate를 호출 |
| 플레이어가 서버에서 나감 | 빠지고, 연결이 끊기며, 다음 틱에서 편을 다시 셉니다. | Players.PlayerRemoving이 eliminate를 호출 |
| 라운드 도중에 플레이어가 들어옴 | 로비에서 스폰하고, 실시간 상태와 타이머를 보며, 다음 라운드에 들어갑니다. | 참가자는 startRound에서만 고름 |
| 라운드가 시작될 때 플레이어가 죽어 있었음 | 텔레포트되지 않고 로비에서 기다립니다. | getLivingCharacter |
| 모두 나가거나 죽음 | "Nobody survived"로 라운드가 끝나고 순환이 다시 시작됩니다. 서버에 인원이 아직 충분하면 Intermission, 아니면 Waiting입니다. | runRound의 sidesLeft == 0 |
eliminate는 같은 플레이어에게 여러 번 호출해도 안전하게 쓰여 있습니다. 죽었다가 리스폰한 플레이어는 Died와 CharacterRemoving을 모두 일으키고, 나가는 플레이어는 세 이벤트를 모두 일으킬 수 있지만, 실제로 무언가를 하는 것은 첫 번째 호출뿐입니다.
확장하기: 팀, 맵 투표, 라운드 이벤트
마지막까지 살아남은 팀
USE_TEAMS = true로 설정한 다음, Explorer의 Teams 서비스에 Team 오브젝트를 넣고 각각 이름과 TeamColor를 정하세요. 기본적으로 Roblox는 들어오는 플레이어를 인원이 가장 적은 자동 배정 팀에 넣습니다. 플레이어가 나갈 때 팀을 다시 맞추지는 않으므로, 세션이 길어지면 팀 인원이 고르지 않을 수 있습니다. 모든 팀이 로비에서 스폰하도록 로비의 SpawnLocation은 Neutral로 두세요. 그러면 살아 있는 플레이어가 한 팀에만 남았을 때 라운드가 끝나고, 결과는 "Red wins!"처럼 보입니다.
"한 명 대 모두" 형식(술래 한 명, 나머지는 생존)이라면 startRound에서 참가자 한 명을 무작위로 고르고, 텔레포트 전에 그 플레이어의 Team을 술래 팀으로 설정하세요. 새 플레이어가 절대 들어가지 않도록 술래 팀의 AutoAssignable을 끄고, cleanup에서 술래를 생존자 팀으로 돌려놓으세요. 그러면 같은 종료 조건이 그대로 작동합니다. 생존자가 모두 탈락하면 술래가 이기고, 타이머가 끝날 때까지 버티면 생존자가 이깁니다. 단, 시간이 다 됐을 때 술래의 awardWin은 건너뛰어야 합니다.
플레이어의 맵 투표
투표를 하려면 클라이언트가 서버와 소통해야 하므로 RemoteEvent가 필요합니다. 인터미션 동안 서버가 맵 이름 두세 개를 속성으로 공개하고, 각 클라이언트는 누른 이름을 RemoteEvent로 보내며, 서버는 loadMap을 실행하기 전에 표를 셉니다. 서버는 모든 표를 반드시 검사해야 합니다. 인자가 문자열인지, 현재 선택지 중 하나인지, 상태가 Intermission인지, 플레이어마다 한 번만 세는지입니다(표는 Player를 키로 하는 테이블에 저장해서 두 번째 표가 첫 번째 표를 대신하게 하고, PlayerRemoving에서 비우세요). RemoteEvent 가이드에서 이 검사 패턴을 자세히 다룹니다.
라운드 시작 때 도구 지급하기
다른 스크립트는 RoundSystem을 건드리지 않고도 라운드에 반응할 수 있습니다. 라운드 스크립트는 플레이어를 텔레포트할 때 InRound 속성을 설정하고, 탈락하면 해제합니다. 아래 스크립트는 그 속성을 감지해서 ServerStorage에 있는 RoundTool이라는 Tool의 복사본을 각 플레이어에게 줍니다.
local Players = game:GetService("Players")
local ServerStorage = game:GetService("ServerStorage")
local toolTemplate = ServerStorage:WaitForChild("RoundTool") :: Tool
local function watchPlayer(player: Player)
player:GetAttributeChangedSignal("InRound"):Connect(function()
if player:GetAttribute("InRound") ~= true then
return
end
local backpack = player:FindFirstChildOfClass("Backpack")
if backpack then
toolTemplate:Clone().Parent = backpack
end
end)
end
Players.PlayerAdded:Connect(watchPlayer)
for _, player in Players:GetPlayers() do
watchPlayer(player)
end
도구를 회수하는 코드는 없습니다. 캐릭터가 죽으면 Roblox가 Backpack을 StarterPack으로 채운 새것으로 바꾸고, 정리 단계의 LoadCharacterAsync가 생존자의 Backpack을 비우므로, 라운드가 끝나면 도구는 이미 없습니다.
지급할 무기가 필요하다면 검이나 레이캐스트 총을 만들어 StarterPack 대신 ServerStorage에 두고, 이 스크립트의 "RoundTool"을 그 이름으로 바꾸세요.
라운드 동안만 있는 NPC와 오브젝트
라운드 동안에만 있어야 하는 것은 모두 맵 모델 안에 둘 수 있습니다. 적, 주울 수 있는 아이템, 움직이는 발판 같은 것입니다. ServerStorage에 있는 모델 안의 스크립트는 작동하지 않다가, 복사본이 Workspace에 들어가는 순간 실행되며, 정리 단계의 map:Destroy()가 나머지와 함께 지웁니다. 플레이어를 쫓는 적을 넣으려면 NPC pathfinding 가이드대로 하나를 만들어 맵에 넣으세요. 라운드마다 처음에 맵을 둘러보는 연출이 필요하다면, 컷신 가이드에서 이 스크립트가 BindableEvent로 각 플레이어에게 컷신을 틀어 주는 방법을 보여 줍니다.
모듈로 만들기
처음에는 ModuleScript가 필요 없습니다. 게임을 만드는 동안에는 Script 하나가 읽기 더 쉽습니다. 다른 스크립트가 라운드 함수를 호출해야 하거나, 서버와 UI가 모두 require로 불러올 수 있는 공유 ModuleScript 하나로 설정을 빼고 싶을 때 나누세요. 그때까지는 RoundInfo의 State 속성과 각 플레이어의 InRound 속성이 이미 라운드 시스템의 공개 인터페이스 역할을 합니다. 어떤 스크립트든 이를 감지할 수 있습니다.
자주 발생하는 오류와 해결 방법
Play를 누르기 전에 Output 창을 여세요(Studio의 Window 메뉴나 Script 탭). 라운드 시스템 문제는 대부분 그곳에 스크립트 이름과 줄 번호가 담긴 경고나 오류를 남깁니다.
"Waiting for players (1/2)"에서 멈춤
혼자 테스트하는데 MIN_PLAYERS가 2입니다. 혼자 테스트할 때는 1로 두거나, 클라이언트 2개로 Server & Clients 모드에서 테스트하세요.
Infinite yield possible on 'ServerStorage:WaitForChild("Maps")'
폴더가 없거나, 이름에 오타가 있거나, 다른 서비스에 있습니다. ServerStorage 바로 안에 정확히 Maps라는 이름의 Folder여야 합니다. LocalScript에서 RoundInfo에 대해 같은 경고가 뜬다면 RoundSystem 스크립트가 그 폴더를 만드는 데까지 가지 못한 것입니다. 꺼져 있거나, 오류로 멈췄거나, 아직 Maps 폴더를 기다리고 있습니다.
텔레포트 후 플레이어가 맵 아래로 떨어짐
맵의 파트가 고정되지 않아서 복사본이 Workspace에 들어가자마자 무너집니다. 맵을 선택해 파트를 고정하고, 스폰 파트가 바닥 안이 아니라 바닥 위에 있는지 확인하세요.
탈락한 플레이어가 경기장에서 리스폰함
맵 안에 SpawnLocation이 있습니다. 그 맵의 Spawns 폴더에 있는 일반 Part로 바꾸세요.
모두 죽어도 라운드가 끝나지 않음
피해가 플레이어를 움직이거나 고정하는 것이 아니라 Humanoid를 실제로 죽이는지(체력이 0이 되는지) 확인하세요. Humanoid의 Dead 상태를 꺼 두었다면 Died가 절대 발생하지 않으므로, 라운드는 타이머가 끝날 때까지 가야 합니다.
오류 한 번에 라운드 순환이 완전히 멈춤
순환은 스레드 하나에서 돌기 때문에, 어떤 상태에서든 오류가 나면 끝나 버립니다. Output의 오류를 읽고, 그 줄을 고치고, 다시 테스트하세요. 흔한 원인은 캐릭터가 있는지 확인하지 않고 player.Character.Humanoid를 쓰도록 스크립트를 바꾼 경우입니다.
RoCode로 만들기
이 모든 것을 직접 만들기 싫다면 RoCode가 열어 둔 플레이스에서 해 줄 수 있습니다. RoCode는 Roblox Studio 플러그인으로 작동하는 AI 에이전트이므로, 스크립트와 파트가 붙여 넣어야 하는 채팅 창이 아니라 내 Explorer에 나타납니다.
라운드 시스템을 추가해 줘: 2명이 필요한 20초 인터미션, ServerStorage.Maps에서 무작위 맵, 모두를 맵의 스폰 파트로 텔레포트, 마지막까지 살아남은 플레이어가 이기는 2분 라운드, leaderstats에 Win 추가, 화면 위쪽에 상태와 타이머 표시.
- 두 번째 세트를 더하지 않고 내 Maps 폴더와 leaderstats 스크립트를 쓰려고, 먼저 List Children, Search Game, Search Scripts로 플레이스를 살펴볼 수 있습니다
- Create Script로 ServerScriptService에 라운드 Script를, 타이머 LocalScript를 만들고, 아직 맵이 없다면 Place Prefab으로 미리 만든 구조물에서 경기장을 배치할 수 있습니다
- 마치기 전에 Studio 안에서 Check Script로 각 스크립트의 컴파일을 확인합니다. 이 검사는 라운드 로직 오류가 아니라 문법 오류를 잡습니다
- 내가 플레이테스트한 뒤에는 Check Output이 마지막 플레이테스트의 Server와 Client 줄을 읽어 실행 중 오류를 고칩니다
플러그인 3.9 이상에서 RoCode는 짧은 플레이테스트를 돌려 오류를 읽을 수 있고, 플러그인 3.9.11 이상에서는 테스트 캐릭터 하나를 조종할 수 있지만, 여러 플레이어로는 테스트하지 않으므로 라운드는 Server & Clients 모드에서 직접 돌려 보세요. 변경 묶음마다 Studio의 실행 취소 지점이 됩니다. 라운드 순환은 많은 게임의 바탕이며, AI로 시스템을 하나씩 쌓아 Roblox 게임 전체를 만드는 일도 이런 순환으로 시작하는 경우가 많습니다. RoCode가 Studio에 연결되는 방식.
자주 묻는 질문
Roblox에서 팀이 있는 라운드 시스템은 어떻게 만드나요?
Teams 서비스에 Team 오브젝트를 넣고 라운드 스크립트에서 USE_TEAMS = true로 설정하세요. Roblox는 들어오는 플레이어를 인원이 가장 적은 자동 배정 팀에 넣고, 살아 있는 플레이어가 한 팀에만 남으면 라운드가 끝납니다.
모든 플레이어에게 카운트다운을 보여 주려면 어떻게 하나요?
서버에서 ReplicatedStorage의 오브젝트에 남은 초를 속성으로 설정하고, 3단계처럼 TextLabel을 갱신하는 LocalScript에서 GetAttributeChangedSignal로 감지하세요. 나중에 들어온 플레이어도 바로 현재 값을 받습니다.
라운드 순환에는 wait()와 task.wait() 중 무엇을 쓰나요?
task.wait()를 쓰세요. Roblox는 전역 wait()를 더 이상 권장하지 않으며 task.wait()로 대체되었다고 표시합니다.
라운드마다 플레이어를 다른 플레이스로 텔레포트하려면 어떻게 하나요?
그것은 다른 도구입니다. 이 가이드는 PivotTo로 같은 서버 안에서 캐릭터를 옮깁니다. 내 experience의 다른 플레이스로 플레이어를 보내는 것은 다른 서버로 옮겨 주는 TeleportService가 맡습니다. 텔레포트 가이드에서 텔레포트가 실패하면 다시 시도하는 포털을 만듭니다.
텔레포트 후 플레이어가 잠깐 멈추는 이유는 무엇인가요?
인스턴스 스트리밍이 켜져 있어서 클라이언트가 아직 맵을 받지 못했습니다. "준비" 카운트다운 동안 스크립트의 RequestStreamAroundAsync 호출이 엔진에 맵을 미리 보내 달라고 요청하며, GET_READY_SECONDS를 늘리면 느린 연결에 시간을 더 줄 수 있습니다.
출처와 더 읽을거리
- Roblox Creator Docs: Add rounds (영어). 레이저 태그 예제에 있는 Roblox 자체의 팀 라운드 순환
- Roblox Creator Docs: PVInstance:PivotTo (영어). 스크립트로 모델과 캐릭터 옮기기
- Roblox Creator Docs: Player (영어). LoadCharacterAsync, CharacterRemoving, RequestStreamAroundAsync
- Roblox Creator Docs: Properties and attributes (영어). 속성 설정과 변경 감지
- Roblox Creator Docs: Implement teams (영어). 팀 추가와 자동 배정
- Roblox Creator Docs: Studio testing modes (영어). 여러 클라이언트로 하는 Server & Clients 테스트
코드 검증 방법: 이 페이지의 모든 스크립트는 Roblox API 정의를 적용한 Luau의 엄격한 타입 검사기(luau-lsp, 2026년 11월 20일)를 통과합니다. 타입 검사는 잘못 쓴 API 이름과 잘못된 타입을 찾아내지만 게임 로직의 오류는 찾지 못하므로, 게시하기 전에 Studio에서 직접 테스트하세요.