이 가이드는 Hurtworld 전용 서버의 관리자 설정, 콘솔 명령어, 플레이어 관리, Oxide/uMod 플러그인 지원, 문제 해결을 다룹니다. Hurtworld는 플레이어가 자원을 채집하고, 기지를 건설하며, 적대적인 환경에서 생존하는 멀티플레이어 생존 FPS입니다. 초기 서버 설정, 구성 및 연결 지침은 Hurtworld 서버 설정 가이드를 참조하세요.
1. 관리자 설정
Hurtworld는 Steam ID를 사용하여 관리자 권한을 부여합니다. 재시작 후에도 유지되도록 관리자 명령어를 autoexec.cfg에 추가하세요.
소유자 추가
ownerid <SteamID64> "PlayerName" "reason"예: ownerid 76561198012345678 "Admin" "Server owner"
모더레이터 추가
moderatorid <SteamID64> "PlayerName" "reason"관리자 권한 제거
removeowner <SteamID64>
removemoderator <SteamID64>2. 콘솔 명령어
GPanel Console 탭을 통해 콘솔에 접근하거나, 관리자 권한으로 게임 내에서 F1을 누르세요.
플레이어 관리
| 명령어 | 설명 |
|---|---|
kick <SteamID64> | 서버에서 플레이어를 추방합니다. |
ban <SteamID64> | 플레이어를 영구적으로 차단합니다. |
unban <SteamID64> | 플레이어의 차단을 해제합니다. |
mutevoice <SteamID64> | 플레이어의 음성 채팅을 음소거합니다. |
mutechat <SteamID64> | 플레이어의 텍스트 채팅을 음소거합니다. |
status | Steam ID와 함께 접속한 모든 플레이어를 나열합니다. |
월드 및 서버 명령어
| 명령어 | 설명 |
|---|---|
teleport <SteamID64> <x> <y> <z> | 플레이어를 좌표로 순간이동시킵니다. |
teleportto <SteamID64> <TargetID> | 한 플레이어를 다른 플레이어에게 순간이동시킵니다. |
spawn <itemid> <amount> | 아이템을 인벤토리에 스폰합니다(소유자 전용). |
settime <hours> | 게임 내 하루의 시간을 설정합니다(0-24). |
weather <type> | 날씨를 강제합니다(clear, rain, snow, sandstorm). |
say "message" | 서버 전체 채팅 메시지를 보냅니다. |
save | 즉시 월드 저장을 강제합니다. |
quit | 저장하고 서버를 종료합니다. |
3. Oxide/uMod 플러그인 지원
Hurtworld는 사용자 지정 플러그인, 향상된 관리자 도구, 게임플레이 수정으로 서버 기능을 확장하기 위해 Oxide/uMod 모딩 프레임워크를 지원합니다.
Oxide 설치
- GPanel에서 서버를 중지하세요.
- 서버 파일에
oxide/디렉터리가 있는지 확인하여 Oxide가 사전 설치되어 있는지 확인하세요. - 없다면 umod.org에서 Hurtworld용 최신 Oxide를 다운로드하세요.
- SFTP를 통해 서버 루트에 파일을 업로드하고, 메시지가 표시되면 덮어쓰세요.
- 서버를 시작하고 콘솔에서 Oxide가 로드되는지 확인하세요.
플러그인 설치
- umod.org Hurtworld 플러그인에서 플러그인을 탐색하세요.
.cs파일을 다운로드하여oxide/plugins/에 업로드하세요.- 서버가 자동으로 플러그인을 컴파일하고 로드합니다. 콘솔에서 확인하세요.
인기 플러그인
- Kits: 구성 가능한 아이템과 쿨다운으로 플레이어에게 시작 키트를 제공합니다.
- Teleportation: 플레이어가 홈 포인트를 설정하고 서로에게 순간이동할 수 있게 합니다.
- Stack Size Controller: 편의를 위해 아이템 스택 크기를 수정합니다.
- Better Chat: 채팅 형식을 사용자 지정하고 채팅 그룹을 추가합니다.
- Anti-Cheat: 추가적인 서버 측 치트 탐지 및 방지.
플러그인 관리
oxide.reload PluginName # Reload a specific plugin
oxide.unload PluginName # Unload a specific plugin
oxide.load PluginName # Load a specific plugin
oxide.plugins # List all loaded plugins플러그인 구성
대부분의 Oxide 플러그인은 처음 로드될 때 oxide/config/ 디렉터리에 구성 파일을 생성합니다. 이 JSON 파일을 편집하여 플러그인 동작을 사용자 지정하세요. 편집 후에는 변경 사항을 적용하기 위해 oxide.reload PluginName으로 플러그인을 다시 로드하세요.
플러그인 데이터
플러그인 데이터 파일(플레이어 데이터, 저장된 정보)은 oxide/data/에 보관됩니다. 서버 이동이나 리셋 시 플러그인 상태를 보존하려면 이 디렉터리를 SFTP 백업에 포함하세요.
4. 문제 해결
시작 시 서버 충돌
- GPanel 콘솔에서 오류 메시지를 확인하세요.
- Oxide를 사용하는 경우, 문제를 식별하기 위해 최근에 추가한 플러그인을
oxide/plugins/에서 제거하세요. autoexec.cfg를 삭제하고 다시 시작하여 기본값을 재생성해 보세요.
플레이어가 연결할 수 없음
- GPanel에서 서버가 실행 중인지 확인하세요.
- Network 탭에서 올바른 IP와 포트를 확인하세요.
- 서버와 플레이어가 모두 동일한 게임 버전인지 확인하세요.
Oxide 플러그인이 로드되지 않음
- 플러그인이 로드될 때 콘솔에서 컴파일 오류를 확인하세요.
- 플러그인이 현재 Hurtworld 및 Oxide 버전과 호환되는지 확인하세요.
.cs파일이 하위 디렉터리가 아니라oxide/plugins/에 직접 있는지 확인하세요.- 문제를 해결한 후
oxide.reload PluginName으로 다시 로드해 보세요.
성능 문제
- 접속한 플레이어가 많을 때 서버가 지연되면
maxplayers를 줄이세요. - 설치된 Oxide 플러그인을 검토하세요 — 빈번한 타이머나 무거운 데이터베이스 작업이 있는 일부 플러그인은 성능에 영향을 줍니다.
- 성능이 계속 좋지 않으면 서버 플랜 업그레이드에 대해 지원팀에 문의하세요.
관련 문서
도움이 필요하신가요?
여기서 다루지 않은 Hurtworld 서버 문제가 발생하면 지원 티켓을 여세요. 그리고 서버 IP, 문제에 대한 설명, GPanel 콘솔의 관련 오류 메시지를 포함해 주세요.
