이 가이드는 Hogwarp 서버의 서버 관리, 플러그인 지원, 업데이트 및 문제 해결을 다룹니다. Hogwarp는 Hogwarts Legacy용 멀티플레이어 모드입니다. 초기 설정, API 키 구성 및 연결 방법은 Hogwarp 서버 설정 가이드를 참조하세요.
1. 서버 관리
Hogwarp 서버 관리는 주로 config.json 파일과 GPanel 콘솔을 통해 이루어집니다. 서버는 Wine(Linux의 Windows 호환성 레이어)을 통해 실행됩니다.
GPanel 콘솔
GPanel의 Console 탭을 사용하여 서버 활동을 모니터링하고 연결 로그를 확인하세요. 서버는 플레이어 접속/퇴장 이벤트 및 오류를 콘솔에 출력합니다.
2. 플러그인 지원
Hogwarp는 서버 측 플러그인을 지원합니다. 플러그인 파일을 다음 위치에 넣으세요:
plugins/SFTP를 통해 플러그인을 업로드하고 서버를 재시작하세요. 사용 가능한 플러그인 및 호환성 정보는 Hogwarp Discord에서 확인하세요.
참고: 플러그인 사용 가능 여부는 Hogwarp 버전에 따라 다릅니다. 최신 플러그인 목록은 Hogwarp Discord에서 확인하세요.
3. 서버 설정
고급 구성을 위해 config.json을 직접 편집하세요. 변경하기 전에 서버를 중지하세요.
| 설정 | 설명 |
|---|---|
ApiKey | Hogwarp API 키(필수). |
Name | 멀티플레이어 목록에 표시되는 서버 이름. |
Port | 서버 포트(GPanel에서 관리). |
Description | 멀티플레이어 목록에 표시되는 서버 설명. |
MaxPlayer | 최대 플레이어 수(Patreon 등급에 따라 제한됨). |
IconUrl | 서버 아이콘 이미지의 URL. |
4. 서버 업데이트
Hogwarp는 자주 업데이트됩니다. 업데이트하려면:
- 서버를 중지합니다.
- 최신 서버 파일은 Hogwarp Discord에서 확인합니다.
- 새 서버 파일을 다운로드하고 SFTP를 통해 업로드하여 기존 파일을 교체합니다.
- 먼저
config.json과plugins/디렉터리를 백업합니다. - 서버를 시작합니다.
버전 일치가 매우 중요합니다. 서버 버전은 클라이언트 모드 버전과 일치해야 합니다. 서버를 업데이트한 후, 모든 플레이어가 클라이언트 모드도 함께 업데이트하도록 하세요.
5. 문제 해결
서버가 시작되지 않음
- "API Key" 오류:
API_KEY가 기본값CHANGEME가 아니라 presence.hogwarp.com에서 발급받은 유효한 키로 설정되어 있는지 확인하세요. - Wine 오류: 서버는 Wine에서 실행됩니다. GPanel 콘솔에서 Wine 관련 오류를 확인하세요. 이러한 오류는 보통 서버 재설치로 해결됩니다.
- 파일 누락:
HogWarpServer.exe가 없는 경우 GPanel 설정에서 서버를 재설치하세요.
플레이어가 연결할 수 없음
- 콘솔에
Server started on port가 표시되는지 확인하세요. - API 키가 유효하고 활성화되어 있는지 확인하세요.
- 모든 플레이어가 올바른 Hogwarp 클라이언트 모드 버전을 사용하는지 확인하세요.
- API 키가 유효하면 서버가 Hogwarp 멀티플레이어 목록에 자동으로 표시되어야 합니다.
서버가 목록에 표시되지 않음
- API 키가 올바르고 활성화되어 있는지 다시 확인하세요.
- 서버가 완전히 시작되었는지 확인하세요(콘솔에서 시작 메시지 확인).
- Hogwarp 마스터 서버가 일시적으로 다운되었을 수 있습니다. 상태 업데이트는 Hogwarp Discord에서 확인하세요.
관련 문서
도움이 필요하신가요?
여기에서 다루지 않은 Hogwarp 서버 문제가 발생하면 지원 티켓을 열고 서버 IP, 문제 설명 및 GPanel 콘솔의 관련 오류 메시지를 포함해 주세요.
