개요: 이 가이드는 Project Zomboid 서버에서 관리자 접근을 설정하는 방법과 플레이어 관리, 월드 제어, 모더레이션을 위한 가장 흔한 관리자 명령어를 사용하는 방법을 다룹니다.
사전 요구 사항
- Legion Hosting에서 호스팅되는 실행 중인 Project Zomboid 서버
- GPanel 접근 권한
- 설치되어 있고 서버에 연결할 수 있는 게임
관리자 접근 설정하기
인게임에서 관리자 명령어를 사용하려면 먼저 서버에 관리자 비밀번호를 구성해야 합니다. 이를 수행하는 두 가지 방법이 있습니다.
옵션 1: 서버 설정 파일
- GPanel을 열고 서버로 이동합니다.
- 파일 관리자로 이동하여
/.cache/server/<servername>.ini를 엽니다(<servername>을 서버 이름으로 바꿉니다). AdminPassword=라고 적힌 줄을 찾아 안전한 비밀번호로 설정합니다:AdminPassword=YourSecurePassword123- 파일을 저장하고 서버를 재시작합니다.
옵션 2: GPanel Startup 탭
- GPanel을 열고 서버로 이동합니다.
- Startup 탭으로 이동합니다.
- Admin Password 필드를 찾아 원하는 비밀번호를 입력합니다.
- 변경 사항이 적용되도록 서버를 재시작합니다.
플레이어에게 관리자 접근 권한 부여하기
관리자 비밀번호가 설정되면 연결하여 관리자 비밀번호를 입력하는 플레이어는 관리자 접근 권한을 갖게 됩니다. 서버 콘솔에서 직접 접근 레벨을 설정할 수도 있습니다.
GPanel 콘솔 탭에서 다음을 입력하세요:
setaccesslevel <username> admin이것은 콘솔 전용 명령어입니다 — 인게임 채팅이 아닌 GPanel 콘솔 또는 서버 콘솔에서 실행해야 합니다.
중요: 관리자 비밀번호를 공개적으로 공유하지 마세요. 비밀번호를 가진 사람은 누구나 서버에 대한 완전한 관리자 접근 권한을 얻을 수 있습니다.
흔한 관리자 명령어
/로 시작하는 명령어는 인게임 채팅에 입력합니다 — T 또는 Enter를 눌러 채팅 창을 엽니다. / 접두사가 없는 명령어는 콘솔 전용이며 GPanel 콘솔 탭에서 실행해야 합니다.
플레이어 관리
| 명령어 | 설명 |
|---|---|
/players |
현재 연결된 모든 플레이어 나열 |
/kick <username> |
서버에서 플레이어 추방 |
/banuser <username> |
서버에서 플레이어 차단 |
/unbanuser <username> |
플레이어의 차단 해제 |
/adduser <username> <password> |
플레이어를 위한 화이트리스트 계정 생성 |
/servermsg <message> |
서버의 모든 플레이어에게 메시지 방송 |
텔레포트
| 명령어 | 설명 |
|---|---|
/teleport <username> |
자신을 플레이어의 위치로 텔레포트 |
/teleportto <x> <y> <z> |
자신을 특정 맵 좌표로 텔레포트 |
플레이어 치트 / 디버그
| 명령어 | 설명 |
|---|---|
/godmod <username> |
플레이어의 무적 모드 토글 |
/invisible <username> |
플레이어의 투명 모드 토글(좀비가 무시함) |
/noclip <username> |
플레이어의 노클립 토글(벽과 지형을 통과해 비행) |
/addxp <username> <perk> <amount> |
특정 스킬에서 플레이어에게 XP 부여(예: /addxp Player1 Carpentry 1000) |
월드 & 이벤트
| 명령어 | 설명 |
|---|---|
/startrain |
비 이벤트 시작 |
/stoprain |
현재 비 중지 |
/gunshot |
좀비를 유인하기 위해 근처에서 총성 소리 이벤트 발생 |
/chopper |
헬리콥터 비행 이벤트 발생 |
서버 제어
| 명령어 | 설명 |
|---|---|
/save |
월드를 즉시 강제 저장 |
/quit |
월드를 저장하고 서버를 정상적으로 중지 |
접근 레벨
Project Zomboid에는 플레이어가 사용할 수 있는 명령어를 제어하는 여러 접근 레벨이 있습니다. GPanel 콘솔에서 플레이어의 접근 레벨을 설정하세요(이것은 콘솔 전용 명령어입니다):
setaccesslevel <username> <level>| 레벨 | 설명 |
|---|---|
| admin | 모든 명령어에 대한 완전한 접근. 다른 관리자를 관리하고, 서버 설정을 변경하고, 서버를 제어할 수 있습니다. |
| moderator | 플레이어를 추방 및 차단하고, 텔레포트하고, 플레이어 정보를 볼 수 있습니다. 서버 설정은 변경할 수 없습니다. |
| overseer | 제한된 모더레이션 기능. 플레이어 정보를 보고 기본 모더레이션을 수행할 수 있습니다. |
| gm | 게임 마스터. 아이템을 스폰하고, 텔레포트하고, 인게임 이벤트를 관리할 수 있습니다. 롤플레이 서버에 유용합니다. |
| observer | 플레이어를 관전할 수 있습니다. 최소한의 명령어 접근. 서버 모니터링에 유용합니다. |
| none | 특별한 권한이 없는 일반 플레이어. 모든 플레이어의 기본값입니다. |
팁: 플레이어에게서 관리자 접근 권한을 제거하려면 GPanel 콘솔에서 접근 레벨을 다시
none으로 설정하세요:setaccesslevel PlayerName none
GPanel 콘솔 사용하기
게임에 로그인하지 않고도 GPanel 웹 콘솔을 통해 명령어를 실행할 수 있습니다:
- GPanel을 열고 서버로 이동합니다.
- Console 탭으로 이동합니다.
- 하단의 입력 상자에 명령어를 입력하고 Enter를 누릅니다.
참고: 인게임 명령어(
/ 접두사 포함)는 / 접두사와 함께 입력하면 GPanel 콘솔에서도 실행할 수 있습니다. setaccesslevel과 같은 일부 명령어는 콘솔 전용이며 / 접두사를 사용하지 않습니다. 특정 명령어(텔레포트 및 무적 모드 등)는 게임에 로그인했을 때만 작동할 수 있습니다.
차단 목록 관리하기
/banuser를 사용하여 플레이어를 차단하면 차단은 /.cache/db/에 위치한 서버의 데이터베이스에 저장됩니다.
차단을 관리하려면:
- 플레이어 차단:
/banuser <username> - 플레이어 차단 해제:
/unbanuser <username> - 수동 편집: 필요한 경우 GPanel 파일 관리자를 사용하여
/.cache/db/디렉터리를 탐색하고 차단 목록을 수동으로 편집할 수도 있습니다.
문제 해결
관리자 명령어가 작동하지 않음
- 관리자 비밀번호가
/.cache/server/<servername>.ini(AdminPassword=줄)에 올바르게 설정되어 있고 변경 후 서버가 재시작되었는지 확인하세요. - 서버에 연결할 때 관리자 비밀번호를 입력했는지 확인하세요.
- 오류 메시지가 있는지
/.cache/Logs/에서 서버 로그를 확인하세요.
"You don't have access" 오류
- 접근 레벨이 충분히 높지 않을 수 있습니다. 서버 관리자에게
setaccesslevel <username> admin을 사용하여 GPanel 콘솔에서 접근 레벨을 설정하도록 요청하세요. - 일부 명령어는 admin 접근 레벨이 필요합니다. 더 낮은 레벨(예: moderator 또는 gm)로 설정된 경우 특정 명령어를 사용할 수 없을 수 있습니다.
/addxp가 작동하지 않음
- 퍽 이름이 올바르게 표기되어 있고 정확한 PZ 퍽 이름을 사용하는지 확인하세요(예:
Carpentry,Cooking,Farming,Fitness,Strength). - 명령어를 실행할 때 플레이어가 온라인 상태여야 합니다.
GPanel 콘솔 명령어가 응답하지 않음
- 일부 명령어는 GPanel 콘솔이 아닌 인게임에서 입력할 때만 작동합니다.
- 서버가 실행 중이며 충돌하거나 중지된 상태가 아닌지 확인하세요.
- GPanel에서 서버를 재시작하고 명령어를 다시 시도해 보세요.
관련 가이드
- Project Zomboid 서버 설정 가이드 — 서버의 게임플레이 설정, 난이도, 샌드박스 옵션을 구성합니다.
- Project Zomboid 모드 설치 가이드 — 서버에 Workshop 모드를 추가합니다.
도움이 필요하신가요? 관리자 명령어나 서버 관리에 문제가 있으면 지원 티켓을 열어 주시면 저희 팀이 도와드리겠습니다.
