이 가이드는 GPanel을 통해 Project Zomboid 서버를 Build 41(B41)과 Build 42(B42) 사이에서 전환하는 방법을 설명합니다. 저장 데이터 호환성, 월드 백업, 직접 전환 수행 방법을 다룹니다.
전환하기 전에: 저장 데이터 호환성 문제 이해하기
Project Zomboid는 모든 월드 및 플레이어 데이터를 생성된 빌드 버전에 연결된 저장 폴더에 보관합니다. 두 빌드는 맵 청크, 아이템 정의, 플레이어 캐릭터 데이터에 대해 서로 다른 형식을 사용합니다.
| 빌드 | Steam 베타 브랜치 | B41 저장 데이터 사용 가능? | B42 저장 데이터 사용 가능? |
|---|---|---|---|
| Build 41 (B41) | (공백/비어 있음) | 예 | 아니요 |
| Build 42 (B42) | unstable |
아니요 | 예 |
베타 브랜치는 GPanel 서버의 Startup 탭에서 설정됩니다.
전환이 완료되면 서버는 새 빌드에서 새로 시작됩니다. 이전 빌드의 기존 월드는 저장 폴더에 그대로 남아 있지만, 서버는 이를 로드하지 않습니다. 자동으로 삭제되지는 않으며 — 단지 사용되지 않을 뿐입니다. 새 빌드에서 시작하기 전에 서버 이름을 변경하거나 기존 저장 데이터를 삭제해야 합니다.
1단계 — 현재 월드 백업하기
빌드를 전환하기 전에 현재 저장 데이터의 복사본을 다운로드하세요. 이전 빌드로 돌아갈 계획이 없더라도, 백업을 보유하면 우발적인 데이터 손실을 방지하고 상황이 바뀔 경우 복원할 무언가를 제공합니다.
옵션 A: GPanel을 통한 백업
- GPanel에 로그인하고 Project Zomboid 서버를 선택합니다.
- Console 탭의 Stop 버튼을 사용하여 서버를 중지하고 상태가 Offline으로 표시될 때까지 기다립니다.
- GPanel의 Backups 탭으로 이동합니다.
- Create Backup을 클릭하고 완료될 때까지 기다립니다. 백업이 아래 목록에 나타납니다.
- 백업이 목록에 표시되면 다운로드 아이콘을 클릭하여 로컬에 저장합니다.
옵션 B: SFTP를 통한 저장 폴더 다운로드
전체 서버 백업이 아닌 월드 저장 데이터만 다운로드하려면, SFTP를 통해 서버에 연결하고 저장 폴더를 수동으로 다운로드합니다.
- GPanel에서 SFTP 탭으로 이동하여 SFTP 호스트 이름, 포트, 사용자 이름, 비밀번호를 확인합니다.
- FileZilla와 같은 SFTP 클라이언트를 열고 해당 자격 증명을 사용하여 연결합니다.
- 월드 저장 디렉터리로 이동합니다:
/home/container/.cache/saves/multiplayer/<YourWorldName>/ - 전체
<YourWorldName>폴더를 로컬 컴퓨터로 다운로드합니다.
2단계 — GPanel에서 빌드 전환하기
B41과 B42 간 전환은 서버의 시작 옵션을 통해 수행됩니다. 지원 티켓은 필요하지 않습니다.
- GPanel에 로그인하고 Project Zomboid 서버를 선택합니다.
- 서버가 중지되어 있는지 확인합니다.
- Startup 탭으로 이동합니다.
- Beta Branch 필드를 찾습니다:
- B41로 전환하려면: Beta Branch 필드를 비워 둡니다(비어 있음).
- B42로 전환하려면: Beta Branch 필드에
unstable을 입력합니다.
- Startup 탭의 Server Name을 현재 이름과 다른 새 이름으로 변경합니다. 이는 새 빌드가 호환되지 않는 저장 데이터를 로드하려고 시도하는 것을 방지합니다.
- Settings 탭으로 이동하여 Reinstall Server를 클릭합니다. 이는 선택한 빌드에 맞는 게임 파일을 다운로드합니다.
- 서버를 시작합니다. 새 서버 이름으로 새로운 월드를 생성합니다.
.cache/ 폴더를 제외한 서버의 모든 파일을 삭제한 다음 재설치할 수 있습니다. .cache/ 폴더에는 서버 구성이 포함되어 있으므로, 이 방법은 새 빌드를 위한 깨끗한 게임 설치를 보장하면서 설정을 보존합니다. 서버 이름을 변경하고 싶지 않은 경우에만 이 방법을 사용하세요 — 이전 서버 이름의 저장 데이터는 .cache/saves/multiplayer/에서 수동으로 삭제해야 한다는 점에 유의하세요.
전환 후 모드 호환성
모드는 빌드 간에 호환되지 않습니다. B41용으로 작성된 모드는 B42에서 작동하지 않으며, 그 반대도 마찬가지입니다. 전환 후에는 전체 모드 목록을 검토하고 교체해야 합니다.
- B41에서 B42로 전환: 대부분의 인기 있는 B41 모드는 B42 버전으로 업데이트되거나 교체되었습니다. 실행 중이던 모드의 B42 전용 버전을 Steam Workshop에서 확인하세요.
WorkshopItems형식도 B42에서 변경되었다는 점에 유의하세요 — 올바른 B42 형식은 모드 설치 가이드를 참조하세요. - B42에서 B41로 전환: B42 모드는 B41에서 로드되지 않습니다. 사용하려는 모드의 원래 B41 버전을 찾아 설치해야 합니다. 별도의 B41 브랜치를 유지하는 모드 작성자를 Steam Workshop에서 확인하세요.
자주 묻는 질문
B41 월드를 유지하면서 B42 월드도 가질 수 있나요?
동일한 서버에서 동시에는 불가능합니다 — 단일 서버 인스턴스는 한 번에 하나의 빌드만 실행합니다. 그러나 B42로 전환한 후에도 B41 저장 파일은 디스크에 남아 있습니다. 나중에 B41로 다시 전환하고 원래 서버 이름을 복원하면, 이전 저장 데이터를 다시 로드할 수 있습니다. 이전 저장 데이터는 .cache/saves/multiplayer/에 저장되며 빌드 전환 중에 자동으로 삭제되지 않습니다.
B41로 다시 전환하는 데 비용이 드나요?
아니요. 빌드 전환은 전적으로 GPanel을 통해 추가 비용 없이 수행됩니다. Project Zomboid B41과 B42 서버 슬롯은 Legion Hosting에서 동일한 가격으로 책정됩니다.
전환 후 플레이어가 버전 불일치 오류를 받고 있습니다
이는 서버와 플레이어의 게임 클라이언트가 서로 다른 빌드 버전임을 의미합니다. 플레이어는 Steam 베타 브랜치를 서버의 빌드와 일치시켜야 합니다:
- Steam에서 Project Zomboid를 마우스 오른쪽 버튼으로 클릭하고 Properties를 선택합니다.
- Betas 탭을 클릭합니다.
- 드롭다운에서 None을 선택합니다 — 이는 현재 기본 빌드(B41)를 제공합니다.
- 서버가 B42를 실행 중이라면 대신 unstable을 선택합니다.
- Steam이 게임을 업데이트할 때까지 기다린 다음 실행하고 연결합니다.
여전히 도움이 필요하신가요?
전환 중에 문제가 발생하면 지원 티켓을 여세요. 도와드리겠습니다.
