Barotrauma 문제 해결 가이드
이 가이드는 Legion Hosting에서 Barotrauma 전용 서버를 실행할 때 발생할 수 있는 일반적인 문제와 단계별 해결책을 다룹니다. 초기 서버 설정은 Barotrauma 전용 서버 설정 가이드를 참조하세요.
목차
- 잠수함이 로드되지 않음 / 서버가 시작에서 멈춤
- 모드 충돌 및 크래시
- 서버가 브라우저에 나타나지 않음
- 연결 시간 초과 / 직접 연결 불가
- 재시작 후 캠페인 세이브를 찾을 수 없음
- 서버 렉 및 성능 문제
잠수함이 로드되지 않음 / 서버가 시작에서 멈춤
증상: 서버가 시작되지만 플레이어가 접속할 수 없거나, 서버 로그에 잠수함을 찾을 수 없다는 오류가 표시됩니다.
해결책
- 이름을 정확히 확인하세요:
serversettings.xml의Submarine속성은 대소문자를 포함하여 파일명(.sub확장자 제외)과 정확히 일치해야 합니다. 예를 들어Humpback은 올바르지만humpback은 그렇지 않습니다. - 파일이 존재하는지 확인하세요: SFTP 또는 GPanel 파일 관리자를 통해 서버에 연결하고
.sub파일이Submarines/디렉터리에 있는지 확인하세요. - Workshop 잠수함인가요? 잠수함이 Workshop 모드에서 온 경우, 사용하기 전에
LocalMods/에 설치되고 서버 설정에 등록되어 있어야 합니다. 모드 설치 가이드를 참조하세요. - 기본 잠수함으로 테스트하세요: 내장 잠수함(예:
Humpback)으로 전환하여 서버가 올바르게 시작되는지 확인하세요. 시작된다면 문제는 커스텀 잠수함 파일에 있습니다.
모드 충돌 및 크래시
증상: 시작 시 서버가 충돌하거나, 접속 시 플레이어 연결이 끊기거나, 콘솔에 특정 콘텐츠 ID를 참조하는 오류가 표시됩니다.
해결책
- 문제 모드를 격리하세요: 최근에 추가한 모든 모드를 비활성화하고 서버를 다시 시작하세요. 안정적으로 실행된다면, 모드를 하나씩 다시 활성화하고 매번 재시작하여 충돌을 찾으세요.
- 버전 불일치: 서버의 모든 모드 파일이 클라이언트 컴퓨터에 설치된 버전과 일치하는지 확인하세요. 확실하지 않으면 모드를 다시 다운로드하고 다시 업로드하세요. 업데이트 절차는 모드 설치 가이드를 참조하세요.
- 클라이언트 전용 모드: 일부 Workshop 모드는 클라이언트 측 전용이며 서버에 설치하면 안 됩니다. 이 정보는 모드의 Workshop 설명 페이지에서 확인하세요.
- 서버 로그를 확인하세요: GPanel에서 콘솔을 열고
[ERROR]또는Exception줄을 찾으세요. 이는 보통 크래시를 일으키는 특정 모드나 콘텐츠 파일을 참조합니다.
팁: 많은 모드를 실행 중이고 충돌을 식별할 수 없는 경우, 이진 탐색 방식을 시도하세요: 하나씩이 아니라 한 번에 절반씩 모드를 비활성화하세요. 이렇게 하면 문제를 훨씬 빠르게 좁힐 수 있습니다.
서버가 브라우저에 나타나지 않음
증상: 서버가 실행 중이지만 게임 내 서버 브라우저에 나타나지 않습니다.
해결책
- 몇 분 기다리세요: Steam 서버 브라우저가 새로 시작된 서버를 목록에 표시하는 데 몇 분이 걸릴 수 있습니다. 먼저 직접 연결을 시도하여 서버에 도달할 수 있는지 확인하세요.
- 서버가 완전히 시작되었는지 확인하세요: GPanel을 열고 콘솔에 오류 없이 서버가 실행 중으로 표시되는지 확인하세요.
- query port를 확인하세요:
serversettings.xml의QueryPort값은 서비스에 할당된 query port와 일치해야 합니다. 올바른 port 할당은 GPanel의 Network 탭에서 확인하세요. - 직접 연결로 확인하세요: 서버 IP와 메인 port(할당된 port는 GPanel Network 탭 확인)를 사용하여 직접 연결을 시도하여 브라우저 특정 문제를 배제하세요.
연결 시간 초과 / 직접 연결 불가
증상: 직접 연결로 접속을 시도하면 시간 초과 또는 "connection failed" 오류가 발생합니다.
해결책
- IP와 port를 확인하세요: GPanel의 Network 탭에서 서버의 IP 주소와 port를 확인하세요. 서버 IP와 Port를 찾는 방법을 참조하세요.
- 올바른 port를 사용하세요: query port가 아닌 메인 게임 port에 연결하세요. 메인 port는 GPanel에서 기본 port로 표시된 것입니다.
- 서버가 실행 중인지 확인하세요: GPanel을 확인하여 서버가 충돌하거나 중지되지 않았는지 확인하세요.
- serversettings.xml을 확인하세요:
serversettings.xml의Port값이 GPanel에서 할당된 port와 일치하는지 확인하세요. 다르면 서버가 잘못된 port에 바인딩됩니다. - 본인 측 방화벽: 드물게 로컬 네트워크나 ISP가 비표준 port에서 아웃바운드 UDP 트래픽을 차단할 수 있습니다. 다른 네트워크에서 연결을 시도하거나 VPN을 사용하여 테스트하세요.
재시작 후 캠페인 세이브를 찾을 수 없음
증상: 서버를 재시작한 후 캠페인이 사라지고 플레이어가 새로 시작해야 합니다.
해결책
- 세이브 파일이 존재하는지 확인하세요: SFTP를 통해 연결하고 캠페인 폴더가
Saves/Multiplayer/에 여전히 존재하는지 확인하세요. - 마이그레이션 문제를 확인하세요: 최근에 서버를 마이그레이션했거나 백업에서 복원한 경우, 세이브 폴더가 Barotrauma 서버 디렉터리 내의 올바른 경로에 업로드되었는지 확인하세요.
- 비정상 종료: 서버가 (GPanel을 통해 정상적으로 중지되지 않고) 강제 종료된 경우, 최종 세이브 상태가 기록되지 않았을 수 있습니다. 프로세스를 강제 종료하는 대신 항상 GPanel의 Stop 버튼을 사용하세요.
- 백업에서 복원하세요: 이전에 캠페인을 백업한 경우, 서버를 중지하고 SFTP를 통해 백업 폴더를
Saves/Multiplayer/에 업로드한 다음 서버를 시작하세요. 자세한 백업/복원 지침은 메인 설정 가이드를 참조하세요.
서버 렉 및 성능 문제
증상: 플레이어가 러버밴딩, 입력 지연을 경험하거나, 게임플레이 중 서버가 응답하지 않습니다.
해결책
- 플레이어 수를 줄이세요: 서버 플랜에 현재 플레이어 수에 충분한 리소스가 없는 경우
serversettings.xml의MaxPlayers값을 낮추세요. - 모드 수를 줄이세요: 일부 모드, 특히 많은 새 생물이나 복잡한 시스템을 추가하는 모드는 서버 리소스 사용량을 크게 증가시킵니다. 필수가 아닌 모드를 제거하세요.
- 서버 리소스를 확인하세요: GPanel에서 CPU 및 메모리 사용량을 모니터링하세요. 지속적으로 한계에 가깝다면 서버 플랜 업그레이드를 고려하세요.
- 서버를 재시작하세요: 장시간 실행되는 세션은 메모리 사용량이 누적될 수 있습니다. 플레이 세션 사이에 예약된 재시작은 성능 유지에 도움이 될 수 있습니다.
관련 문서
여전히 문제가 있나요? legionhosting.net/submitticket.php에서 지원 티켓을 열고 서버 이름, GPanel 콘솔의 오류 메시지, 이미 시도한 단계를 포함해 주세요.
