이 가이드는 서버 설정 파일과 GPanel을 통한 샌드박스 변수를 포함하여 Legion Hosting에서 호스팅되는 Project Zomboid 서버를 구성하는 방법을 다룹니다.
구성 파일을 편집하기 전에 서버를 중지하세요. Project Zomboid는 종료 시 구성을 디스크에 기록합니다. 서버가 실행 중일 때 파일을 편집하면 서버가 다음에 중지될 때 변경 사항이 덮어쓰여집니다. 항상 먼저 GPanel에서 서버를 중지하고, 변경한 다음, 다시 시작하세요.
구성 파일 개요
Project Zomboid는 서버의 /.cache/server/ 디렉터리 내 두 개의 파일에 서버 구성을 저장합니다. 두 파일 모두 파일 이름의 일부로 서버 이름을 사용합니다.
| 파일 | 용도 |
|---|---|
/.cache/server/servername.ini |
핵심 서버 설정 — 비밀번호, 플레이어 슬롯, 포트, PvP, 음성 채팅 등 |
/.cache/server/servername_SandboxVars.lua |
게임플레이 및 월드 설정 — 좀비 개체 수, 전리품 풍부함, 속도, 리스폰 비율 |
내 서버 이름은 무엇인가요? 서버 이름은 GPanel의 Startup 탭에서 설정됩니다. 변경하지 않은 경우 기본값은
servertest입니다. 확실하지 않다면 GPanel Startup 탭을 확인하세요 — Server Name 필드의 값입니다.
1단계 — GPanel에서 파일 관리자 열기
- GPanel에 로그인합니다.
- 서버 목록에서 Project Zomboid 서버를 클릭합니다.
- Console 탭에서 서버가 실행 중이면 Stop을 클릭합니다. 계속하기 전에 상태가 Offline으로 변경될 때까지 기다립니다.
- Files 탭을 클릭하여 파일 관리자를 엽니다.
.cache/server/디렉터리로 이동합니다..cache폴더가 보이지 않으면 Show Hidden Files를 클릭하거나 숨김 파일 표시를 전환해야 할 수 있습니다 — 이 폴더는 점으로 시작합니다.

2단계 — 서버 설정 파일(.ini) 편집
.ini 파일은 핵심 서버 구성을 제어합니다. 파일을 클릭하여 인라인 편집기에서 엽니다.
흔히 변경되는 설정
| 설정 | 설명 | 예시 값 |
|---|---|---|
PublicName |
공개 서버 브라우저에 표시되는 서버 이름 | My PZ Server |
PublicDescription |
서버 브라우저에 표시되는 짧은 설명 | Welcome! Friendly server. |
Password |
플레이어가 참가하려면 입력해야 하는 비밀번호. 비밀번호가 없으면 비워 둡니다. | hunter2 |
MaxPlayers |
동시 플레이어 최대 수 | 16 |
PVP |
플레이어 대 플레이어 전투 활성화 또는 비활성화 | true 또는 false |
Public |
서버가 공개 서버 목록에 표시되는지 여부 | true 또는 false |
DefaultPort |
서버가 수신 대기하는 UDP 포트(기본값 16261). GPanel에서 할당된 포트와 일치시킵니다. | 16261 |
Map |
맵 이름. 기본 맵은 Muldraugh, KY를 사용합니다. 모드 맵은 세미콜론으로 구분하여 추가합니다. |
Muldraugh, KY |
Mods |
세미콜론으로 구분된 Mod ID 목록. B41 형식: modid1;modid2. B42 형식: \modid1;\modid2; |
2392509783;2400857388 |
WorkshopItems |
세미콜론으로 구분된 Workshop 아이템 ID(Mods 목록과 일치해야 함) |
2392509783;2400857388 |
Mods와 WorkshopItems는 동기화 상태를 유지해야 합니다.
Mods 아래에 나열된 모든 모드 ID는 WorkshopItems 아래에 일치하는 항목이 있어야 합니다. 불일치는 모드 추가 후 서버 시작 실패의 흔한 원인입니다.
변경한 후 파일 편집기에서 Save를 클릭하세요. 샌드박스 변수도 편집하려면 아직 서버를 시작하지 마세요 — 먼저 3단계를 완료하세요.
3단계 — 샌드박스 변수(게임플레이 설정)
샌드박스 변수는 게임플레이 경험을 제어합니다: 얼마나 많은 좀비가 스폰되는지, 얼마나 빨리 움직이는지, 전리품 희귀도, 그 외 수십 가지 월드 매개변수. 이들은 동일한 /.cache/server/ 디렉터리의 servername_SandboxVars.lua에 있습니다.
권장: 이 파일을 직접 편집하는 대신 인게임 관리자 패널을 사용하세요. 인게임 관리자 패널은 모든 샌드박스 옵션에 대해 라벨이 붙은 슬라이더와 드롭다운을 제공하여 오타 없이 설정을 훨씬 쉽게 찾고 변경할 수 있게 해줍니다. 파일 편집은 대량 변경이나 서버가 한 번도 시작되지 않은 경우의 대안입니다. 접근하려면 인게임 관리자 패널을 사용하세요(관리자로 인게임에서 Esc를 누름).
SandboxVars 파일 직접 편집하기
파일을 편집하는 것을 선호하는 경우, 형식은 Lua 테이블입니다. 각 설정은 자체 줄에 있습니다:
SandboxVars = {
Zombies = 3, -- Population: 1=Insane, 2=Very High, 3=High, 4=Normal, 5=Low
Distribution = 2, -- Zombie distribution: 1=Urban focused, 2=Uniform
ZombieSpeedType = 3, -- Speed: 1=Sprinters, 2=Fast Shamblers, 3=Shamblers, 4=Crawlers
LootAbundance = 3, -- Loot: 1=Insane, 2=Abundant, 3=Normal, 4=Scarce, 5=Very Scarce
DayLength = 2, -- In-game day length in hours: 1=1h, 2=2h ... 15=15h, 16=Real Time
StartYear = 1, -- Starting year (offsets from 1993)
StartMonth = 7, -- Starting month (1–12)
StartDay = 9, -- Starting day (1–31)
WaterShut = 0, -- Tap water shutoff: 0=Never, 1=Instant ... 14=2 years
ElecShut = 0, -- Electricity shutoff: 0=Never, 1=Instant ... 14=2 years
HoursForCorpseRemoval = 0, -- 0=Never auto-remove
CharacterFreePoints = 0, -- Bonus starting trait points
}
샌드박스 설정은 새 월드에만 적용됩니다. 서버가 이미 실행되어 월드를 생성한 경우, 파일에서 샌드박스 변수를 변경해도 실시간 월드가 소급하여 변경되지 않습니다. 새 샌드박스 설정을 적용하려면 월드를 초기화하고 새로 시작해야 합니다. 게임 도중 관리자가 제어 가능한 설정만 조정하려면 인게임 관리자 패널을 대신 사용하세요.
문제 해결
.ini 파일에 대한 변경 사항이 저장되지 않았습니다
- 가장 가능성 높은 원인은 파일을 저장할 때 서버가 여전히 실행 중이었던 것입니다. Project Zomboid는 종료 시 구성을 덮어씁니다. 먼저 서버를 중지하고, 파일을 편집하고, 저장한 다음, 서버를 시작하세요.
- 다른 곳으로 이동하기 전에 GPanel 편집기에서 파일을 저장했는지 확인하세요 — 확인 토스트를 찾거나 파일의 마지막 수정 타임스탬프가 업데이트되었는지 확인하세요.
파일 관리자에서 .cache 폴더를 볼 수 없습니다
- 숨김 디렉터리(점으로 시작하는 디렉터리)는 기본적으로 표시되지 않습니다. GPanel Files 탭에서 Show Hidden Files 토글이나 체크박스를 찾아 활성화하세요.
- 디렉터리가 전혀 존재하지 않는다면 서버가 아직 실행되지 않은 것입니다. 구성 파일을 생성하려면 서버를 한 번 시작하고 중지한 다음 편집하세요.
샌드박스 설정이 실시간 월드에서 변경되지 않습니다
_SandboxVars.lua파일에 대한 변경 사항은 새 월드에서만 적용됩니다. 기존 실행 중인 월드의 경우 초기화 없이 설정을 조정하려면 인게임 관리자 패널의 Options 탭을 사용하세요.
추가 도움이 필요하신가요? 지원 티켓을 열고 GPanel의 서버 ID와 관련 콘솔 출력을 포함하세요.