이 가이드는 Legion Hosting에서 Project Zomboid 서버 월드를 초기화하거나 와이프하는 과정을 안내합니다. 주요 업데이트 후 새로 시작해야 하거나, 월드 손상에서 복구하고 싶거나, 커뮤니티가 새 맵을 준비하는 경우, GPanel을 통한 과정은 몇 분이면 됩니다.
와이프하기 전에 백업하세요. 월드 데이터가 삭제되면 GPanel에서 복구할 수 없습니다. 진행하기 전에 Backups 탭, 파일 관리자 또는 SFTP를 사용하여 월드를 저장하세요.
사전 요구 사항
- Project Zomboid 서버에 대한 GPanel 액세스
- 월드 파일을 삭제하기 전에 서버가 중지되어 있어야 합니다
Project Zomboid가 월드 데이터를 저장하는 위치
Project Zomboid는 모든 월드 저장 데이터를 서버의 .cache 디렉터리 안에 저장합니다. 월드 폴더 이름은 서버 이름과 일치합니다(시작 매개변수에서 설정되며, 기본적으로 보통 servertest입니다).
| 경로 (GPanel 파일 관리자) | 포함 내용 |
|---|---|
/.cache/saves/multiplayer/<servername>/ |
월드 저장 데이터 (맵 청크, 플레이어 인벤토리, 좀비, 구조물, 플레이어 저장 파일) |
/.cache/server/<servername>.ini |
서버 설정 (샌드박스 옵션, 스폰 규칙) — 월드 초기화 중에 삭제되지 않음 |
/.cache/db/ |
플레이어 로그인 데이터베이스 — 플레이어 연결 자격 증명 및 로그인 데이터 저장 |
/.cache/Logs/ |
서버 로그 파일 — 유지하거나 삭제해도 안전함 |
방법 1 — 저장 폴더 삭제
가장 일반적인 접근 방식입니다. 서버 구성을 그대로 유지하면서 모든 월드 데이터와 플레이어 저장 파일을 제거합니다.
- GPanel에 로그인하고 Project Zomboid 서버를 선택하세요.
- Console 탭에서 Stop을 클릭하고 서버가 Offline으로 표시될 때까지 기다리세요.
- 왼쪽 사이드바에서 File Manager를 클릭하세요.
- 다음 위치로 이동하세요:
/.cache/saves/multiplayer/
- 서버 이름을 딴 하나 이상의 폴더가 표시됩니다(예:
servertest). - 서버의 폴더를 마우스 오른쪽 버튼으로 클릭하고 Delete를 선택하세요. 삭제를 확인하세요.
- Console 탭으로 돌아가 Start를 클릭하세요. 동일한 서버 이름으로 새로운 월드가 자동으로 생성됩니다.
방법 2 — 서버 이름 변경
이전 월드를 삭제하지 않고 접근 가능하게 유지하려면 시작 설정에서 서버 이름을 변경할 수 있습니다. Project Zomboid는 새 이름에 대한 새 저장 폴더를 만들어 이전 폴더를 그대로 둡니다.
- 서버를 중지하세요.
- GPanel에서 Startup 탭으로 이동하세요.
- Server Name 필드를 찾아 새 이름으로 변경하세요(예:
servertest2). - Save를 클릭하세요.
- 서버를 시작하세요. 새 이름으로 새로운 월드가 생성됩니다.
참고: 이전 월드 저장 폴더는 이전 이름으로
/.cache/saves/multiplayer/에 남아 있습니다. 더 이상 필요하지 않으면 나중에 삭제하거나, 서버 이름을 다시 변경하여 그것으로 전환할 수 있습니다.
팁: 서버 구성 파일(
/.cache/server/<servername>.ini)은 월드 초기화의 영향을 받지 않습니다. 샌드박스 설정, 스폰 규칙 및 기타 서버 옵션은 새 월드로 이어집니다.
와이프 전 백업하기
와이프하기 전에 월드를 백업하는 세 가지 방법이 있습니다:
옵션 A — GPanel Backups 탭
가장 쉬운 방법입니다. GPanel에는 서버 파일의 전체 스냅샷을 생성하는 내장 백업 시스템이 있습니다.
- GPanel에서 왼쪽 사이드바의 Backups 탭을 클릭하세요.
- Create Backup을 클릭하세요.
- 백업이 완료될 때까지 기다리세요 — 백업 목록에 나타납니다.
- 이 탭에서 언제든지 백업을 다운로드하거나 복원할 수 있습니다.
옵션 B — GPanel 파일 관리자
- 파일 관리자에서
/.cache/saves/multiplayer/로 이동하세요. - 서버 저장 폴더를 마우스 오른쪽 버튼으로 클릭하고 Archive(또는 Compress)를 선택하세요.
- 생성된
.tar.gz파일을 컴퓨터로 다운로드하세요.
옵션 C — SFTP
- SFTP를 통해 서버에 연결하세요(SFTP 가이드 참조).
/home/container/.cache/saves/multiplayer/로 이동하세요.- 서버 저장 폴더를 로컬 컴퓨터로 드래그하세요.
문제 해결
폴더를 삭제한 후에도 서버가 계속 이전 월드를 로드합니다
- 파일을 삭제하기 전에 서버가 완전히 중지되었는지 확인하세요. 서버가 실행 중이었다면 종료 중에 월드를 다시 저장했을 수 있습니다.
- 올바른 폴더를 삭제했는지 확인하세요 — 폴더 이름은 Startup 탭의 Server Name과 일치해야 합니다.
- 서버를 중지하고, 파일 관리자에서 폴더가 사라졌는지 확인한 다음 다시 시작하세요.
새 월드가 생성되었지만 설정이 다릅니다
- 방법 2(서버 이름 변경)를 사용한 경우, Project Zomboid는 새 이름에 대한 기본 설정으로 새
.ini구성 파일을 만들 수 있습니다. 이전.ini파일의 샌드박스 설정을/.cache/server/<newname>.ini의 새 파일로 복사하세요.
와이프 후 플레이어가 접속할 수 없습니다
- 서버 이름을 변경한 경우, 플레이어는 자신 쪽에서 아무것도 변경할 필요가 없습니다 — 연결 IP와 포트는 동일하게 유지됩니다.
여전히 도움이 필요하신가요?
지원 티켓을 열고 서버 이름과 삭제한 내용을 포함하세요.
