이 가이드는 HumanitZ 전용 서버의 관리자 설정, 사용 가능한 모든 콘솔 명령어, 플레이어 관리, 월드 설정, 문제 해결을 다룹니다. HumanitZ는 서버 관리를 위해 /가 접두사로 붙는 채팅 기반 명령어를 사용합니다.
관리자 설정
HumanitZ는 비밀번호 시스템을 통해 관리자 권한을 부여합니다. 관리자 비밀번호는 서버의 GameServerSettings.ini 파일이나 GPanel 시작 변수를 통해 구성됩니다.
관리자 비밀번호 설정
서버 구성 파일에서 관리자 비밀번호를 설정하세요:
AdminPassword=YourSecurePassword123Admin Password 변수를 편집하여 GPanel의 Startup 탭을 통해서도 설정할 수 있습니다. 비밀번호를 변경한 후에는 적용되도록 서버를 다시 시작하세요.
게임 내에서 관리자로 로그인하기
- 일반 플레이어로 서버에 접속하세요.
- 게임 내 채팅을 여세요(Enter 또는 T 누르기).
- 관리자 비밀번호와 함께 다음 명령어를 입력하세요:
/AdminAccess YourSecurePassword123현재 세션에 대해 관리자 권한이 부여되었다는 확인 메시지가 표시됩니다. 관리자 접근 권한은 서버에서 연결이 끊길 때까지 유지됩니다.
관리자 태그 표시
기본적으로 채팅에서 이름 옆에 관리자 태그가 나타날 수 있습니다. 이 표시 여부를 전환할 수 있습니다:
/admintag이것은 관리자 표시기를 숨기거나 표시하여 필요한 경우 익명으로 플레이할 수 있게 해줍니다.
관리자 명령어
모든 명령어는 게임 내 채팅에 입력하며 /가 접두사로 붙습니다. 명령어는 대소문자를 구분합니다.
서버 관리 명령어
| 명령어 | 구문 | 설명 |
|---|---|---|
| Shutdown | /Shutdown [seconds] |
지정된 지연 시간 후 서버를 종료합니다. 모든 플레이어에게 채팅으로 알림이 전송되며 종료 전에 월드가 저장됩니다. |
| Save Game | /SaveGame |
즉시 수동 월드 저장을 강제합니다. 변경 사항을 적용하거나 유지 관리를 수행하기 전에 유용합니다. |
| Admin UI | /adminw |
그래픽 인터페이스를 통해 아이템을 스폰하고 설정을 조정할 수 있는 관리자 유틸리티 패널을 엽니다. |
| SuperAdmin | /SuperAdmin |
투명 비행 모드를 전환합니다. 다른 플레이어에게 보이지 않게 되며 맵 전체를 자유롭게 날아다닐 수 있습니다. 비활성화하려면 명령어를 다시 실행하세요. |
| God Mode | /god |
무적을 전환합니다. 활성화된 동안 어떤 원천으로부터도 피해를 입지 않습니다. 비활성화하려면 다시 실행하세요. |
| FPS Display | /FPS 또는 /FPS2 |
프레임 속도 카운터 표시를 전환합니다. 서버 성능 모니터링에 유용합니다. |
| Execute Command | /ExecCmd [command] |
원시 Unreal Engine 콘솔 명령어를 실행합니다. 고급 사용자 전용입니다. |
스폰 명령어
스폰 명령어를 사용하면 현재 위치에 아이템, 차량, 생물, 동반자를 생성할 수 있습니다.
| 명령어 | 구문 | 설명 |
|---|---|---|
| Spawn Item | /Spawn item_[Name] |
현재 위치에 줍기 가능한 아이템을 스폰합니다. 예: /Spawn item_Apple |
| Force Spawn | /fspawn item_[Name] |
충돌 검사를 무시하고 아이템을 강제로 스폰합니다. 지형 때문에 /Spawn이 실패할 때 사용하세요. |
| Spawn Vehicle | /spawn car_[Type] |
현재 위치에 차량을 스폰합니다. 아래 차량 목록을 참조하세요. |
| Spawn AI | /spawn ai_[Type] |
좀비, 적대적 NPC 또는 야생 생물을 스폰합니다. 아래 AI 목록을 참조하세요. |
| Spawn Dog | /spawn Dog |
현재 위치에 동반자 개를 스폰합니다. |
| Spawn Claimable Dog | /spawn CompDog |
모든 플레이어가 자신의 동반자로 입양할 수 있는 개를 스폰합니다. |
| Spawn Horse | /spawn horse |
현재 위치에 무작위 말을 스폰합니다. |
차량 유형
/spawn car_[Type]과 함께 다음 식별자를 사용하세요:
| 유형 | 차량 |
|---|---|
car_suv | SUV |
car_pickup | 픽업트럭 |
car_jeep | 지프 |
car_hatchback | 해치백 |
car_van | 밴 |
car_truck | 트럭 |
car_sport | 스포츠카 |
car_rv | RV / 캠핑카 |
car_policesuv | 경찰 SUV |
car_gaztiger | 군용 차량 (Gaz Tiger) |
car_edmond | Edmond 세단 |
car_rally | 랠리카 |
car_amero | Amero 머슬카 |
car_lazer | Lazer 스포츠카 |
AI 스폰 유형
/spawn ai_[Type]과 함께 다음 식별자를 사용하세요:
| 유형 | 설명 |
|---|---|
ai_bear | 곰 (적대적 야생동물) |
ai_wolf | 늑대 (적대적 야생동물) |
ai_buck | 사슴 / 수사슴 (수동적 야생동물) |
ai_zombiepolice | 경찰 좀비 |
ai_zombiegirl | 여성 좀비 |
ai_zombiebelly | 부풀어 오른 좀비 |
ai_humanmelee | 적대적 인간 NPC (근접 공격) |
/adminw 패널을 사용하여 그래픽 인터페이스를 통해 사용 가능한 아이템을 탐색하세요.
동반자 및 플레이어 명령어
| 명령어 | 구문 | 설명 |
|---|---|---|
| Name Dog | /DogSetName [Name] |
동반자 개의 사용자 지정 이름을 설정합니다. |
| Teleport Dog | /TPDog |
동반자 개를 현재 위치로 순간이동시킵니다. 개가 끼었을 때 유용합니다. |
| Remove Dog | /NoDog |
게임에서 동반자 개를 제거합니다. |
| Give Experience | /exp [amount] |
캐릭터에게 지정된 양의 경험치를 부여합니다. |
| Unstuck | /unstuck |
끼이거나 물체와 상호작용할 수 없는 상태를 해결합니다. |
| Unstuck Geometry | /unstuckgeo |
지형이나 지오메트리에서 캐릭터를 강제로 해방시킵니다. /unstuck으로 충분하지 않을 때 사용하세요. |
날씨 및 계절 명령어
| 명령어 | 구문 | 설명 |
|---|---|---|
| Weather | /weather list |
사용 가능한 날씨 유형을 나열하고 현재 날씨를 변경할 수 있게 합니다. |
| Season | /season list |
사용 가능한 계절을 나열하고 현재 계절을 변경할 수 있게 합니다. |
플레이어 관리
HumanitZ는 개별 채팅 명령어보다는 주로 서버 구성과 관리자 패널을 통해 플레이어 관리를 처리합니다.
관리자 패널을 통한 플레이어 관리
/adminw 명령어를 사용하여 게임 내에서 관리자 유틸리티 패널을 여세요. 이 그래픽 인터페이스는 방해되는 플레이어를 서버에서 제거하는 기능을 포함하여 접속한 플레이어를 관리하는 옵션을 제공합니다.
서버 비밀번호 보호
서버 접근을 제한하는 가장 간단한 방법은 서버 비밀번호를 통하는 것입니다. GameServerSettings.ini의 Password 필드를 설정하고 신뢰할 수 있는 플레이어에게만 공유하세요:
Password=YourServerPassword경고와 함께 종료
서버를 다시 시작하거나 유지 관리해야 할 때, 플레이어가 진행 상황을 저장할 시간을 주기 위해 지연 시간이 있는 종료 명령어를 사용하세요:
/Shutdown 60이것은 서버가 종료되고 저장되기 전에 접속한 모든 플레이어에게 채팅으로 60초 경고를 보냅니다.
월드 설정 관리
대부분의 월드 설정은 서버를 시작하기 전에 GameServerSettings.ini를 통해 구성되지만, 일부 조정은 관리자 명령어를 사용하여 즉석에서 수행할 수 있습니다.
빠른 설정 참조
| 변경하려는 항목 | 변경 방법 |
|---|---|
| 현재 날씨 | 게임 내에서 /weather list |
| 현재 계절 | 게임 내에서 /season list |
| 좀비 밀도, 난이도, 전리품 비율 | GameServerSettings.ini를 편집하고 서버 다시 시작 |
| 낮/밤 지속 시간 | 구성에서 DayDur 및 NightDur 편집 후 다시 시작 |
| PvP 모드 | 구성에서 PVP 편집 후 다시 시작 |
| 테스트용 아이템/차량 스폰 | 게임 내에서 /adminw 패널 또는 /Spawn 명령어 |
문제 해결
서버 충돌
- 콘솔 로그 확인: 충돌 전 GPanel 콘솔 출력에서 오류 메시지를 검토하세요. 일반적인 원인으로는 메모리 제한과 손상된 세이브 데이터가 있습니다.
- 메모리 문제: HumanitZ는 안정적인 작동을 위해 6-8 GB RAM을 권장합니다. 부하 상태에서 서버가 충돌하면 서버 플랜 업그레이드를 고려하세요.
- 손상된 월드 세이브: 서버가 시작 시 반복적으로 충돌하면 백업에서 복원하거나 월드 리셋을 수행해 보세요. 백업 및 리셋 지침은 서버 설정 가이드를 참조하세요.
- 게임 업데이트: 게임 업데이트 후 충돌은 이전 버전의 세이브 데이터가 호환되지 않음을 나타낼 수 있습니다. 알려진 문제에 대해 공식 HumanitZ 패치 노트와 커뮤니티 포럼을 확인하세요.
연결 문제
- 서버 브라우저에 표시되지 않음: 서버가 완전히 시작되었는지 확인하세요(GPanel 콘솔에서 준비 메시지 확인). 쿼리 포트가 올바르게 할당되었는지 확인하세요.
- Direct IP를 통해 연결할 수 없음: IP와 게임 포트(쿼리 포트가 아님)를 다시 확인하세요.
IP:Port형식을 사용하세요. 서버 IP 및 포트 찾는 방법을 참조하세요. - 연결 시 시간 초과: 서버가 과부하 상태이거나 응답하지 않을 수 있습니다. GPanel을 통해 다시 시작해 보세요. 문제가 지속되면 콘솔에서 오류를 확인하세요.
- "Version mismatch": 서버와 클라이언트가 모두 동일한 게임 버전이어야 합니다. 보류 중인 업데이트를 적용하려면 서버를 다시 시작하고, 플레이어가 Steam을 통해 게임을 업데이트했는지 확인하세요.
관리자 명령어가 작동하지 않음
- 인증되지 않음: 서버에 접속할 때마다
/AdminAccess [password]를 실행해야 합니다. 관리자 접근 권한은 세션 간에 유지되지 않습니다. - 잘못된 비밀번호: 관리자 비밀번호는 대소문자를 구분합니다. 서버 구성의
AdminPassword설정과 정확히 일치하는지 확인하세요. - 관리자 비밀번호 미설정: 구성 파일에서
AdminPassword가 비어 있거나 누락된 경우 관리자 명령어가 작동하지 않습니다. 비밀번호를 설정하고 서버를 다시 시작하세요. - 명령어 오타: 명령어는 대소문자를 구분합니다.
/spawn과/Spawn은 다르게 동작할 수 있습니다. 이 가이드에 표시된 정확한 구문을 사용하세요.
성능 최적화
- 서버가 현재 플레이어 수로 어려움을 겪는다면
MaxPlayers를 줄이세요. - 엔티티 수와 CPU 사용량을 줄이려면
ZombieAmountMulti와HumanAmountMulti를 낮추세요. - 엔티티 수를 더 낮게 유지하려면 리스폰 타이머(
ZombieRespawnTimer,HumanRespawnTimer)를 늘리세요. - 서버에 월드 크기와 활성 플레이어 수에 충분한 RAM이 있는지 확인하세요.
- 누적된 메모리 사용량을 정리하기 위해 주기적인 재시작(매일 또는 며칠마다)을 예약하세요.
- 모든 진행 상황이 보존되도록 재시작 전에
/SaveGame을 사용하세요.
