이 가이드는 Legion Hosting에서 Rust 전용 서버를 운영할 때 발생할 수 있는 일반적인 문제와 해결 방법을 다룹니다. 일반적인 서버 구성에 대해서는 Rust 서버 구성 가이드를 참조하세요.

서버가 서버 브라우저에 나타나지 않음

서버가 실행 중이지만 플레이어가 인게임 브라우저에서 찾을 수 없는 경우:

• 서버 브라우저가 새로 시작된 서버를 색인하는 데 10~20분이 걸릴 수 있습니다. 브라우저가 따라잡는 동안 서버에 접근 가능한지 확인하려면 F1 콘솔을 통한 직접 연결(client.connect IP:PORT)을 사용하세요.
• QUERY_PORT 시작 변수(GPanel의 Startup 탭)가 GPanel의 Network 탭에 할당된 쿼리 포트와 일치하는지 확인하세요. 잘못된 쿼리 포트는 서버가 브라우저에 나타나지 않는 가장 일반적인 이유입니다.
• 서버가 완전히 시작되었는지 확인하세요 -- 연결을 테스트하기 전에 콘솔에서 Server startup complete 줄을 찾아보세요.
• server.cfg에 server.hostname이 설정되어 있는지 확인하세요. 호스트 이름이 없는 서버는 브라우저에 제대로 표시되지 않을 수 있습니다.

서버에 연결할 수 없음

참여하려고 할 때 연결 오류 또는 시간 초과가 발생하는 경우:

• GPanel Console 탭에서 서버가 실행 중이고 완전히 시작되었는지 확인하세요.
• GPanel의 Network 탭에서 올바른 IP 주소와 게임 포트를 사용하고 있는지 다시 확인하세요.
• 서버가 최근에 업데이트된 경우(특히 첫 번째 목요일 강제 와이프 중에), 업데이트 후 서버를 다시 시작했는지 확인하세요. 새 클라이언트 버전의 플레이어는 이전 버전을 실행하는 서버에 연결할 수 없습니다.
• server.maxplayers를 초과하지 않았는지 확인하세요. 서버가 가득 차면 새 연결이 거부됩니다.
• 차단되지 않았는지 확인하세요. 서버 관리자에게 문의하거나 서버의 bans.cfg를 검토하세요.

외부 도구로 RCON에 연결할 수 없음

RustAdmin, RCON.IO 또는 다른 RCON 클라이언트가 연결할 수 없는 경우:

• server.cfg에 rcon.web 1이 설정되어 있는지 확인하세요. 대부분의 외부 도구는 WebSocket RCON 인터페이스를 필요로 합니다.
• 게임 포트가 아닌 RCON 포트를 사용하고 있는지 확인하세요. 할당된 RCON 포트는 GPanel Network 탭에서 확인하세요.
• RCON 비밀번호가 server.cfg에 설정된 것과 정확히 일치하는지 다시 확인하세요. 비밀번호는 대소문자를 구분합니다.
• RCON 연결이 수락되기 전에 서버가 완전히 시작되어야 합니다. 콘솔에서 Server startup complete를 기다리세요.

전체 RCON 설정 지침은 Rust RCON 접속 및 관리자 명령을 참조하세요.

Oxide 플러그인이 로드되지 않음

• Oxide가 설치되어 활성화되어 있는지 확인하세요. GPanel의 Startup 탭에서 FRAMEWORK 변수가 oxide로 설정되어 있어야 합니다. 시작 중에 콘솔 로그에 Loaded plugin Oxide.Core가 표시되어야 합니다.
• 플러그인 파일은 정확한 .cs 확장자로 oxide/plugins/에 직접 배치되어야 합니다. 하위 디렉터리에 있거나 잘못된 확장자를 가진 파일은 무시됩니다.
• 콘솔과 oxide/logs/에서 컴파일 오류를 확인하세요. 구문 오류가 있는 플러그인은 로드에 실패하며 오류 메시지가 문제를 설명합니다.
• 일부 플러그인은 다른 플러그인에 대한 종속성이 있습니다(예: Economics). 필요한 모든 종속성을 먼저 설치하세요.
• 플러그인 버전이 현재 Oxide 버전과 호환되는지 확인하세요. 오래된 플러그인은 최신 Oxide 릴리스에 대해 컴파일에 실패할 수 있습니다.

전체 플러그인 설치 지침은 Rust Oxide/uMod 플러그인 설치를 참조하세요.

서버가 과도한 RAM 또는 CPU를 사용함

서버가 느리게 실행되거나, 지연되거나, 리소스 한도를 초과하는 경우:

• 맵 크기를 줄이세요. server.cfg에서 server.worldsize를 낮추세요. 더 큰 맵은 실행하고 유지하는 데 상당히 더 많은 RAM과 CPU를 필요로 합니다. 3000의 맵 크기는 대부분의 서버에 좋은 균형입니다.
• 설치된 플러그인을 점검하세요. 일부 잘못 작성되거나 오래된 플러그인은 높은 CPU 사용량 또는 메모리 누수를 일으킬 수 있습니다. oxide.plugins를 사용하여 활성 플러그인을 나열하고 한 번에 하나씩 비활성화하여 원인을 식별해 보세요.
• 플레이어 수를 낮추세요. 현재 플레이어 수에 비해 서버 성능이 부족한 경우 server.maxplayers를 줄이세요. 연결된 각 플레이어는 리소스 오버헤드를 추가합니다.
• 엔티티 누적을 확인하세요. 장기간 실행되는 서버에서는 버려진 기지와 부패하는 아이템이 누적될 수 있습니다. 맵 와이프는 엔티티 수를 0으로 재설정합니다.

월드 변경 사항이 저장되지 않음 / 재시작 후 롤백

서버 재시작 후 플레이어 진행 상황이 손실되는 경우:

• server.cfg에서 server.saveinterval이 적절한 값으로 설정되어 있는지 확인하세요(기본값은 60초). 0 또는 매우 큰 숫자로 설정하면 사실상 자동 저장이 비활성화됩니다.
• 즉각적인 저장을 강제하려면 서버를 중지하기 전에 GPanel 콘솔 또는 RCON을 통해 server.save를 수동으로 실행하세요.
• 서버를 강제로 종료하는 대신 GPanel에서 정상적으로 중지했는지 확인하세요. 갑작스러운 종료는 마지막 저장 간격의 변경 사항을 잃게 할 수 있습니다.
• 사용 가능한 디스크 공간을 확인하세요. 서버의 디스크 공간이 부족하면 저장 파일을 기록할 수 없습니다.

서버가 시작 시 충돌함

서버가 시작되지만 즉시 충돌하거나 재시작 루프에 들어가는 경우:

• 콘솔 출력에서 오류 메시지를 확인하세요. 일반적인 원인으로는 손상된 저장 파일, 호환되지 않는 플러그인 또는 누락된 프레임워크 파일이 있습니다.
• 플러그인을 추가한 후 충돌이 시작된 경우 oxide/plugins/에서 가장 최근에 추가한 .cs 파일을 제거하고 다시 시작하세요.
• 게임 업데이트 후 충돌이 시작된 경우 FRAMEWORK 변수가 올바르게 설정되어 있는지 확인하세요. Rust 업데이트 후 프레임워크 파일을 다시 다운로드해야 할 수 있습니다 -- 서버를 다시 시작하기만 하면 업데이트된 프레임워크가 자동으로 가져와집니다.
• 저장 파일(proceduralmap.*.sav 및 proceduralmap.*.map)을 삭제하고 새로운 맵 와이프를 수행해 보세요. 손상된 저장 파일은 서버 시작을 방해할 수 있습니다.

맵 생성에 매우 오랜 시간이 걸림

와이프 후 서버는 새로운 절차적 맵을 생성해야 합니다. 이는 정상적이고 예상되는 일입니다:

• 3000의 맵 크기는 일반적으로 생성하는 데 2~5분이 걸립니다.
• 더 큰 맵(4000~6000)은 10분 이상 걸릴 수 있습니다.
• 맵 생성 중에 서버를 다시 시작하지 마세요. 완전히 완료되도록 두세요. 준비가 되면 콘솔에 Server startup complete가 표시됩니다.

도움이 필요하신가요?

여기에서 다루지 않은 문제가 있으면 지원팀이 도와드립니다. 지원 티켓을 제출하고 다음을 포함해 주세요:

• 서버 ID(GPanel에 표시됨)
• 문제에 대한 설명과 시작된 시점
• 관련 콘솔 출력 또는 오류 메시지
• 이미 시도한 단계