Unturned 서버 문제 해결
이 가이드는 Legion Hosting의 Unturned 전용 서버에서 발생하는 일반적인 문제와 해결 방법을 다룹니다. 초기 서버 설정에 대해서는 Unturned 서버 설정 가이드를 참조하세요.
서버가 서버 브라우저에 표시되지 않음
서버가 실행 중이지만 Unturned 또는 Steam 서버 브라우저에 나타나지 않는 경우:
- GSLT 필요: 유효한 게임 서버 로그인 토큰이 없으면 서버가 서버 목록에 공개적으로 나타나지 않을 수 있습니다. App ID 304930을 사용하여 Steam 게임 서버 계정 관리 페이지에서 토큰을 생성한 다음, GPanel의 Startup 탭의 GSLT 필드에 붙여넣으세요. 전체 지침은 서버 설정 가이드를 참조하세요.
- 시작 후 5-10분 기다리세요 — Steam이 새 서버를 색인하는 데 시간이 걸립니다.
- 서버가 GPanel에서 실행 중인지 확인하세요(녹색 상태 표시기).
- IP와 포트를 사용하여 직접 연결을 시도하여 서버에 도달할 수 있는지 확인하세요. 서버 IP 및 포트 찾는 방법을 참조하세요.
- 게임 포트와 쿼리 포트(게임 포트 + 1)가 GPanel의 Network 탭에 할당된 것과 일치하는지 확인하세요.
연결할 수 없음 / 연결 시간 초과
연결 시간 초과가 발생하거나 서버에 접속할 수 없는 경우:
- 서버가 실행 중이고 GPanel에서 녹색 상태를 표시하는지 확인하세요.
- 올바른 IP 주소와 포트를 사용하고 있는지 확인하세요 — 서버 IP 및 포트 찾는 방법을 확인하세요.
Commands.dat의Port값이 GPanel의 Network 탭에서 서버에 할당된 포트와 일치하는지 확인하세요. 불일치하면 연결이 차단됩니다.Commands.dat에Password를 설정한 경우 연결 시 올바르게 입력하고 있는지 확인하세요.- GPanel에서 서버를 재시작해 보세요.
- 문제가 계속되면 GPanel의 서버 콘솔 로그에서 오류 메시지를 확인하세요.
Workshop 모드가 다운로드되지 않음
재시작 후 워크샵 모드가 로드되지 않는 경우:
Servers/default/WorkshopDownloadConfig.json을 열고 유효한 JSON인지 확인하세요. 일반적인 실수로는 ID 사이의 쉼표 누락, 마지막 ID 뒤의 후행 쉼표, 또는 일치하지 않는 괄호가 있습니다.- Workshop 아이템 ID가 올바른 정수(따옴표로 묶인 문자열이 아님)인지 확인하세요.
- 시작 중 Steam API 또는 다운로드 오류에 대해 GPanel의 서버 콘솔 로그를 확인하세요.
- 일부 워크샵 아이템은 작성자에 의해 제한되거나 제거되었을 수 있습니다 — Steam Workshop에서 여전히 공개적으로 사용 가능한지 확인하세요.
- 종속성이 있는 워크샵 아이템은 구성에 추가 ID가 필요할 수 있습니다. 모드의 워크샵 페이지에서 필요한 아이템을 확인하세요.
자세한 내용은 모드 및 플러그인 설치 가이드를 참조하세요.
Rocket 플러그인이 로드되지 않음
설치 후 RocketMod 또는 LDM 플러그인이 작동하지 않는 경우:
.dll파일이 하위 폴더나 ZIP 압축 파일 안이 아니라Rocket/Plugins/에 직접 배치되어 있는지 확인하세요.- 서버를 재시작한 후 GPanel 콘솔 로그에서 플러그인 로드 오류를 확인하세요. 오류 메시지는 일반적으로 버전 비호환성 또는 종속성 누락을 나타냅니다.
- 플러그인 버전이 사용 중인 Unturned 및 RocketMod/LDM 버전과 호환되는지 확인하세요.
- 일부 플러그인은
Rocket/Plugins/폴더에 함께 배치해야 하는 다른 DLL 종속성을 필요로 합니다. - 플러그인이 이전에는 작동했지만 Unturned 업데이트 후 중단된 경우, 작성자로부터 최신 버전의 플러그인이 있는지 확인하세요.
플러그인 설치 세부 사항은 모드 및 플러그인 설치 가이드를 참조하세요.
시작 시 서버 충돌
서버가 시작 후 즉시 중지되거나 충돌하는 경우:
- 콘솔 로그 확인: GPanel에서 — 로그 끝부분 근처의 오류 메시지가 무엇이 잘못되었는지 나타냅니다.
- 잘못된 Commands.dat: 형식이 잘못되었거나 손상된
Commands.dat는 시작을 막을 수 있습니다. 재설정하려면 GPanel 파일 관리자를 통해Servers/default/Commands.dat를 삭제하고 서버를 재시작하세요. 기본값으로 다시 생성됩니다. - 불량 워크샵 모드: 호환되지 않거나 손상된 워크샵 모드는 충돌을 일으킬 수 있습니다.
WorkshopDownloadConfig.json에서 모든 Workshop ID를 제거하고 서버가 정상적으로 시작되는지 확인한 다음, 문제가 되는 모드를 식별하기 위해 ID를 하나씩 다시 추가하세요. - 손상된 플러그인: 불량 Rocket 플러그인도 서버를 충돌시킬 수 있습니다.
Rocket/Plugins/에서 모든.dll파일을 제거하고 서버가 시작되는지 확인한 다음, 플러그인을 하나씩 다시 추가하세요. - 서버가 명백한 오류 없이 충돌하는 경우, GPanel의 Settings 탭에서 서버 파일을 다시 설치해 보세요(Reinstall Server 옵션).
플레이어가 예기치 않게 추방됨
플레이어가 설명 없이 연결이 끊기거나 추방되는 경우:
- 서버 콘솔 로그에서 추방 사유를 확인하세요 — 일반적인 원인으로는 BattlEye 안티치트 위반 또는 시간 초과 오류가 있습니다.
- 워크샵 모드를 사용하는 경우 모든 플레이어가 동일한 워크샵 아이템을 구독했는지 확인하세요. 콘텐츠 누락은 비동기화 추방을 일으킬 수 있습니다.
- 높은 서버 리소스 사용량(RAM 또는 CPU)은 플레이어 시간 초과를 일으킬 수 있습니다. GPanel에서 리소스 사용량을 모니터링하고
MaxPlayers를 줄이거나 리소스를 많이 사용하는 모드를 제거하는 것을 고려하세요. - 특정 플레이어가 반복적으로 추방되는 경우 게임 파일이 손상되었을 수 있습니다 — Steam을 통해 게임 파일을 확인하도록 안내하세요(Unturned 마우스 오른쪽 클릭 > Properties > Local Files > Verify).
맵이 로드되지 않음 / 잘못된 맵
서버가 시작되지만 잘못된 맵을 로드하거나 워크샵 맵 로드에 실패하는 경우:
Commands.dat의Map값이 정확한 내부 이름(예:PEI,Washington,Russia)과 일치하는지 확인하세요. 이름은 대소문자를 구분합니다.- 워크샵 맵의 경우 Workshop ID가
WorkshopDownloadConfig.json에 있어야 하며Map값은 워크샵 표시 이름이 아니라 다운로드된 폴더 이름과 일치해야 합니다. - 시작 중 맵 로딩 오류 또는 다운로드 실패에 대해 서버 콘솔 로그를 확인하세요.
관련 문서
- Unturned 서버 설정 가이드 — 초기 구성, GSLT, 맵 및 연결.
- Unturned 관리자 설정 — 권한, 관리자 목록 및 인게임 관리자 명령.
- Unturned 모드 및 플러그인 설치 — Workshop 모드 및 RocketMod/LDM 플러그인.
- 서버 IP 및 포트 찾는 방법
- SFTP를 통한 파일 업로드 방법
도움이 필요하신가요?
위의 해결 방법을 시도한 후에도 문제가 계속 발생하면 저희 지원팀이 도와드릴 수 있습니다.
지원 티켓 열기
