이 가이드는 서버 충돌, 연결 문제, 동기화 어긋남 및 지연, 세이브 손상, 버전 불일치를 포함하여 Legion Hosting의 Abiotic Factor 전용 서버에서 발생하는 일반적인 문제를 다룹니다. 초기 서버 설정 및 구성에 대해서는 Abiotic Factor 서버 설정 가이드를 참조하세요.
서버 패널: 모든 서버 관리는 gpanel.legionhosting.net의 GPanel을 통해 이루어집니다. 구성 및 로그 파일에 접근하려면 파일 관리자 또는 SFTP를 사용하세요.
서버가 시작되지 않음
GPanel에서 시작을 누른 후 서버가 시작되지 않거나 즉시 멈추는 경우, 다음 점검 사항을 따라 진행하세요:
콘솔 출력 확인
- GPanel의 Console 탭으로 이동합니다.
- Start를 누르고 콘솔 출력에서 오류 메시지가 있는지 주의 깊게 확인합니다.
Error,Fatal또는Failed가 포함된 줄을 찾습니다. 이 줄들은 서버 시작을 방해하는 원인을 나타냅니다.
일반적인 원인
| 증상 | 유력한 원인 | 해결책 |
|---|---|---|
| 서버가 시작된 후 즉시 멈춤 | 설치 손상 또는 파일 누락 | GPanel Settings 탭에서 서버를 재설치하세요(Reinstall Server). 이는 월드 세이브에 영향을 주지 않고 Steam에서 모든 서버 파일을 다시 다운로드합니다. |
| 포트가 이미 사용 중이라는 오류 | 이전 서버 인스턴스가 정상적으로 종료되지 않음 | 30초를 기다린 후 다시 시작해 보세요. 문제가 지속되면 GPanel의 Kill 버튼을 사용하여 멈춰 있는 프로세스를 강제 종료한 후 다시 시작하세요. |
| Steam 초기화 실패 | Steam 인증 문제 | Steam 서버가 일시적으로 사용 불가능할 때 발생할 수 있습니다. 몇 분 기다린 후 다시 시도하세요. 지속되면 서버를 재설치하세요. |
| 월드 로드 시 충돌 | 세이브 데이터 손상 | 복구 옵션은 아래의 세이브 손상 섹션을 참조하세요. |
| DLL 또는 라이브러리 누락 오류 | 불완전한 설치 | GPanel Settings에서 서버를 재설치하세요. 재설치 과정에서 필요한 모든 종속성을 다시 다운로드합니다. |
게임 업데이트를 확인하세요. 이전에 정상 작동하던 서버가 갑자기 시작되지 않는 경우, 게임 업데이트가 출시되었을 수 있습니다. 서버는 시작할 때마다 자동 업데이트를 시도하지만, 업데이트 과정이 실패하거나 중단된 경우 GPanel Settings 탭에서 서버를 재설치해 보세요.
서버 충돌
게임 플레이 도중 서버가 충돌(갑자기 멈추거나 응답하지 않음)하는 경우, 다음 단계를 사용하여 문제를 진단하고 해결하세요.
로그 파일 확인
서버 로그는 충돌 전에 무슨 일이 있었는지에 대한 상세한 정보를 제공합니다:
- GPanel에서 Files 탭으로 이동합니다.
- 로그 디렉터리로 이동합니다:
AbioticFactor/Saved/Logs/ - 가장 최근의 로그 파일(보통 날짜로 이름이 지정되거나
AbioticFactorServer.log)을 엽니다. - 파일 끝으로 스크롤하여 오류 메시지, 스택 추적 또는 크래시 덤프 참조를 찾습니다.
일반적인 충돌 원인
- 메모리 고갈: 서버가 할당된 RAM을 소진하면 충돌합니다. 이는 높은 플레이어 수, 크게 지어진 기지, 또는 장시간 가동되는 서버에서 더 흔합니다. 누적된 메모리 사용량을 정리하려면 정기적으로(매일 또는 며칠마다) 서버를 재시작하세요.
- 손상된 월드 데이터: 플레이어가 특정 월드 영역에 진입할 때 지속적으로 충돌이 발생하는 경우, 해당 영역의 세이브 데이터가 손상되었을 수 있습니다. 옵션은 세이브 손상 섹션을 참조하세요.
- 극단적인 엔티티 수: 매우 많은 수의 설치된 오브젝트, 바닥에 떨어진 아이템, 또는 스폰된 적은 서버에 과부하를 줄 수 있습니다. 불필요한 설치 아이템과 구조물을 정리하세요.
- 소프트웨어 버그: 일부 충돌은 게임 자체의 버그로 인해 발생합니다. 알려진 문제는 Abiotic Factor Steam 커뮤니티와 패치 노트를 확인하세요. 서버를 최신 버전으로 유지하세요.
충돌 빈도 줄이기
- 메모리 누수를 정리하기 위해 정기적인 서버 재시작(예: 매일)을 예약하세요.
- 엔티티 수가 너무 많은 경우
SandboxSettings.ini에서EnemySpawnRate를 줄이세요. - 서버를 정기적으로 재시작하여 서버 소프트웨어를 최신 상태로 유지하세요(업데이트는 시작 시 적용됩니다).
- 플레이어가 사용하지 않는 설치물과 떨어진 아이템을 정리하도록 권장하세요.
연결 문제
플레이어가 서버에 연결할 수 없는 경우, 다음 단계를 순서대로 진행하세요.
서버가 브라우저에 표시되지 않음
- 서버가 실행 중인지 확인하세요. GPanel Console 탭에서 서버가 온라인 상태이고 완전히 로드되었는지 확인합니다. 아직 시작 중인 서버는 브라우저에 나타나지 않습니다.
- Steam 인덱싱을 기다리세요. 새 서버나 최근에 재시작한 서버는 Steam 마스터 서버 목록에 나타나는 데 2~5분이 걸릴 수 있습니다.
- 서버 이름을 확인하세요. GPanel Startup 탭에서 서버 이름이 올바르게 설정되었는지 확인합니다. 서버 브라우저에서 부분 일치로 검색해 보세요.
- 직접 연결을 사용하세요. 브라우저에 서버가 표시되지 않으면 IP와 포트를 사용하여 직접 연결하세요. 서버 IP 및 포트 찾는 방법을 참조하세요.
연결 거부 또는 시간 초과
| 문제 | 해결책 |
|---|---|
| 연결 시간 초과 | 서버가 완전히 시작되었는지, 그리고 플레이어가 올바른 IP와 게임 포트(쿼리 포트가 아님)를 사용하고 있는지 확인하세요. 게임 포트는 일반적으로 7777입니다. |
| 연결 거부 | 서버가 가득 찼거나, 비밀번호가 틀렸거나, 서버가 충돌했을 수 있습니다. 콘솔에서 오류를 확인하고 플레이어 수가 최대치에 도달하지 않았는지 확인하세요. |
| 접속 시 즉시 강퇴됨 | 동기화할 월드 데이터가 많을 때 발생할 수 있습니다. 플레이어가 접속을 시도하기 전에 관리자가 많이 지어진 영역에서 멀어지도록 하세요. 접속하는 플레이어는 메인 메뉴가 완전히 로드되기 전에 게임 실행 직후 바로 연결을 시도해 볼 수도 있습니다. |
| 비밀번호 거부됨 | GPanel Startup 탭에서 서버 비밀번호를 다시 확인하세요. 비밀번호는 대소문자를 구분합니다. 플레이어가 (관리자 비밀번호가 아닌) 서버 비밀번호를 입력하고 있는지 확인하세요. |
플레이어가 무작위로 연결이 끊김
- 서버 콘솔에서 연결 끊김과 일치하는 연결 끊김 메시지나 오류를 확인하세요.
- 영향을 받는 플레이어가 Steam에서 게임 파일을 검증하도록 하세요(게임 우클릭 > 속성 > 설치된 파일 > 게임 파일 무결성 검사).
- 여러 플레이어가 동시에 연결이 끊긴다면 서버가 충돌하고 있을 수 있습니다. 위의 충돌 섹션을 확인하세요.
- 플레이어 측의 불안정한 인터넷 연결도 무작위 연결 끊김을 유발할 수 있습니다. 연결 안정성을 테스트하도록 하세요.
동기화 어긋남 및 지연
동기화 어긋남(desync)은 서버와 클라이언트가 동기화되지 않아 오브젝트나 플레이어가 순간이동하거나, 고무줄처럼 튕기거나, 불규칙하게 동작하는 것처럼 보이는 현상입니다. 지연(lag)은 플레이어 동작에 대한 반응이 지연되는 형태로 나타납니다.
서버 측 지연
모든 플레이어가 동시에 지연을 겪는다면 문제는 서버 측일 가능성이 높습니다:
- 높은 엔티티 수: 너무 많은 설치 오브젝트, 떨어진 아이템, 스폰된 적은 서버 틱 레이트를 느리게 만들 수 있습니다. 불필요한 아이템을 정리하고
EnemySpawnRate를 줄이는 것을 고려하세요. - 메모리 압박: 장시간 가동된 서버는 메모리 사용량이 누적될 수 있습니다. 정기적인 재시작을 예약하세요.
- 월드 복잡성: 매우 크고 많이 지어진 기지는 서버 성능에 부담을 줍니다. 플레이어가 건축물을 통합하고 방치된 구조물을 제거하도록 권장하세요.
클라이언트 측 지연
한 명의 플레이어만 지연이나 동기화 어긋남을 겪는 경우:
- 인터넷 연결 속도와 안정성을 확인하도록 하세요.
- Steam을 통해 게임 파일을 검증하도록 하세요.
- 지연처럼 보일 수 있는 클라이언트 측 끊김을 줄이기 위해 게임 내 그래픽 설정을 낮추세요.
- 서버의 물리적 위치에서 멀리 떨어져 있다면 일부 지연 시간은 예상됩니다. 서버와 지리적으로 가까운 플레이어가 더 낮은 핑을 갖습니다.
VOIP 관련 동기화 어긋남
일부 플레이어는 게임 내 VOIP 시스템과 관련된 동기화 어긋남 문제를 보고합니다:
- 게임 내 Escape 메뉴에서 VOIP를 재설정해 보세요.
- VOIP가 지속적인 문제를 일으키는 경우, 플레이어는 게임 설정에서 이를 완전히 비활성화할 수 있습니다.
세이브 손상
세이브 손상은 정상적인 종료 없이 서버가 강제 종료되거나, 저장 작업 중 서버가 충돌하거나, 드물게 소프트웨어 버그로 인해 발생할 수 있습니다.
손상의 증상
- 특정 월드를 로드할 때 서버가 충돌합니다.
- 재시작 후 구조물, 아이템 또는 플레이어 진행 상황이 사라집니다.
- 플레이어가 맵의 특정 영역에 진입할 때 지속적으로 충돌이 발생합니다.
- 콘솔 로그에서 세이브 데이터나 월드 파일을 참조하는 오류 메시지가 표시됩니다.
복구 옵션
- 백업에서 복원: 월드 세이브 디렉터리의 백업이 있다면, 서버를 중지하고 손상된 월드 폴더를 백업 복사본으로 교체한 후 서버를 시작하세요. 백업 방법은 서버 설정 가이드를 참조하세요.
- 새 월드 시작: 백업이 없는 경우, 손상된 월드 폴더의 이름을 변경하고 서버를 시작하여 새 월드를 생성할 수 있습니다. 이전 세이브 데이터는 향후 업데이트나 도구로 복구할 수 있도록 이름이 변경된 폴더에 보존됩니다.
손상 방지
- 항상 정상적인 종료를 사용하세요. 서버가 완전히 응답하지 않는 경우가 아니라면 GPanel에서 Kill 대신 Stop 버튼을 사용하세요. Stop 명령은 종료 전에 정상적인 저장을 실행합니다.
- 정기적으로 백업하세요. SFTP나 GPanel Files 탭을 통해 월드 세이브 폴더의 복사본을 정기적으로 다운로드하세요.
- 세이브 파일을 수동으로 편집하지 마세요. 정확히 무엇을 하는지 알지 못한다면 세이브 데이터 파일을 직접 수정하지 마세요.
SandboxSettings.ini와 같은 구성 파일만 편집하세요.
Kill 버튼은 저장하지 않습니다. GPanel에서 Kill을 사용하면 저장하지 않고 서버 프로세스를 즉시 강제 종료합니다. 이것은 서버가 Stop 명령에 완전히 응답하지 않을 때 최후의 수단으로만 사용하세요. 마지막 자동 저장 이후의 모든 진행 상황이 손실됩니다.
버전 불일치
Abiotic Factor는 클라이언트(게임)와 서버가 동일한 버전으로 실행되어야 합니다. 불일치가 있으면 플레이어가 연결할 수 없습니다.
증상
- 플레이어가 접속을 시도할 때 "version mismatch" 또는 "incompatible version" 오류를 봅니다.
- 서버가 브라우저에 표시되지만 플레이어가 연결할 수 없습니다.
- 이전에 연결할 수 있었던 플레이어가 게임을 업데이트한 후 갑자기 연결할 수 없게 됩니다.
버전 불일치 해결
- 서버 업데이트: GPanel에서 서버를 재시작하세요. 서버는 시작할 때마다 Steam에서 업데이트를 자동으로 확인하고 적용합니다. 업데이트가 출시되었을 때 서버가 이미 실행 중이었다면, 새 버전을 다운로드하기 위해 재시작해야 합니다.
- 클라이언트 업데이트: 모든 플레이어가 Steam을 통해 게임을 업데이트했는지 확인하세요. Steam 라이브러리에서 Abiotic Factor를 우클릭하고 속성 > 업데이트로 이동하여 자동 업데이트가 활성화되어 있는지 확인하세요.
- 재설치 강제: 서버를 재시작해도 업데이트되지 않는 경우, GPanel Settings로 이동하여 Reinstall Server 옵션을 사용하세요. 이는 모든 서버 파일을 새로 다운로드하도록 강제합니다.
게임 업데이트 후: 새로운 Abiotic Factor 패치가 출시되면 업데이트를 다운로드하기 위해 서버를 재시작해야 합니다. 서버가 재시작될 때까지, 이미 게임 클라이언트를 업데이트한 플레이어는 연결할 수 없습니다. 다운타임을 최소화하기 위해 패치 출시 후 가능한 한 빨리 서버를 재시작하세요.
베타 브랜치 선택
서버에서 Abiotic Factor의 베타 또는 실험 브랜치를 실행하는 경우, 연결하는 모든 플레이어도 Steam에서 동일한 브랜치를 선택해야 합니다:
- Steam 라이브러리에서 Abiotic Factor를 우클릭합니다.
- 속성 > 베타로 이동합니다.
- 서버가 실행 중인 것과 동일한 브랜치(예:
experimental또는staging)를 선택합니다. - 게임이 베타 버전으로 업데이트될 때까지 기다립니다.
성능 최적화 팁
서버가 실행 중이지만 성능이 좋지 않은 경우, 다음 최적화를 시도해 보세요:
- 정기적인 재시작 예약: 누적된 메모리 사용량을 정리하고 대기 중인 업데이트를 적용하기 위해 서버를 하루에 한 번(최소 2~3일마다) 재시작하세요.
- 적 스폰 비율 줄이기: 서버가 엔티티 수로 어려움을 겪는 경우
SandboxSettings.ini에서EnemySpawnRate를0.5또는0.75로 설정하세요. - 월드 정리: 사용하지 않는 구조물, 설치물, 떨어진 아이템을 제거하세요. 많은 수의 월드 오브젝트는 서버 처리 부하를 증가시킵니다.
- 플레이어 수 제한: 플레이어가 늘어날수록 성능이 저하되는 경우, 서버가 편안하게 처리할 수 있는 수로
MAX_PLAYERS를 줄이세요. - 콘솔 모니터링: GPanel 콘솔에서 반복되는 경고 메시지를 확인하세요. 틱 레이트, 메모리 또는 엔티티 제한에 대한 반복적인 경고는 성능 병목을 나타냅니다.
일반적인 문제 해결 단계
위의 어떤 섹션도 특정 문제를 해결하지 못하는 경우, 다음 일반적인 단계를 시도해 보세요:
- 오류 메시지가 있는지 콘솔과 로그를 확인하세요.
AbioticFactor/Saved/Logs/의 가장 최근 로그 파일에 종종 해답이 있습니다. - 서버를 재시작하세요. 많은 일시적인 문제는 정상적인 재시작으로 해결됩니다.
- 업데이트 후 문제가 나타났거나 파일이 손상되었을 수 있는 경우, GPanel Settings에서 서버를 재설치하세요.
- 문제가 특정 플레이어에게만 발생하는 경우, Steam을 통해 클라이언트 측에서 게임 파일을 검증하세요.
- 알려진 문제와 버그나 패치에 대한 개발자 공지는 Abiotic Factor Steam 커뮤니티를 확인하세요.
관련 문서
도움이 필요하신가요?
위의 단계를 시도한 후에도 Abiotic Factor 서버에 여전히 문제가 있는 경우, 지원 티켓을 열어 주시면 저희 팀이 기꺼이 도와드리겠습니다.
