Valheim 문제 해결

Valheim 문제 해결 - 지식베이스

이 가이드는 Valheim 데디케이트 서버를 운영할 때 발생할 수 있는 일반적인 문제들을 다루며, 연결 문제, 월드 로딩 실패, 모드 관련 오류 등을 포함합니다. 초기 서버 구성에 대해서는 Valheim 데디케이트 서버 설정 가이드를 참고하세요. 모드 설치 단계에 대해서는 Valheim 모드 설치 가이드를 참고하세요.

서버가 서버 브라우저에 표시되지 않음

원인: Steam 서버 브라우저는 game port가 아니라 query port를 통해 서버를 찾습니다. query port가 차단되어 있거나 올바르게 매핑되지 않은 경우, 플레이어가 직접 연결할 수 있더라도 서버가 어떤 서버 목록에도 나타나지 않습니다.

해결 방법: GPanel을 열고 Network 탭으로 이동하세요. game port와 query port가 모두 나열되어 있고 올바르게 할당되었는지 확인하세요. 포트가 확실하지 않은 경우 서버 IP 및 포트 찾는 방법을 참고하세요. 서버 목록 표시 문제를 해결하는 동안 직접 연결하려면 Steam 즐겨찾기 방법(설정 가이드에 설명됨)을 사용하세요.

비밀번호 오류로 인해 서버가 시작되지 않음

원인: 비밀번호가 5자 미만이거나, 비어 있거나, 비밀번호 문자열에 서버 이름이 포함되어 있습니다.

해결 방법: GPanel의 Startup 탭으로 이동하여 Password 변수를 업데이트하세요. 다음 요구 사항을 모두 충족하는지 확인하세요:

최소 5자 이상
ServerName을 부분 문자열로 포함하지 않음
비워 두지 않음

저장 후 서버를 재시작하세요.

월드가 로드되지 않음 / 새 월드가 대신 생성됨

원인: WorldName 시작 변수가 월드 파일의 파일명과 일치하지 않거나, 필요한 두 개의 월드 파일(.fwl 또는 .db) 중 하나만 존재합니다.

해결 방법:

SFTP로 연결하여 다음 경로로 이동하세요:
```
/.config/unity3d/IronGate/Valheim/worlds_local/
```
<WorldName>.fwl과 <WorldName>.db가 모두 존재하는지 확인하세요.
GPanel의 WorldName 시작 변수가 파일명과 정확히 일치하는지 확인하세요(대소문자 구분, 확장자 제외).
새 월드가 생성된 경우, 서버를 중지하고 새로 생성된 월드 파일을 삭제하거나 이름을 변경한 다음, 백업 파일을 복원하고 재시작하세요.

플레이어가 연결할 수 없음

원인: 플레이어가 Valheim 서버에 연결할 수 없는 데에는 여러 가지 가능한 이유가 있습니다.

해결 방법: 다음 점검 사항을 순서대로 진행하세요:

서버가 아직 시작 중임: Valheim은 특히 모드가 있는 경우 완전히 시작되는 데 몇 분이 걸릴 수 있습니다. 연결하기 전에 콘솔에 서버가 준비되었다고 표시될 때까지 기다리세요.
잘못된 포트: 게임 내 브라우저를 통해 연결하는 플레이어는 game port를 사용해야 합니다. Steam 즐겨찾기를 통해 서버를 추가하는 플레이어는 query port를 사용해야 합니다. 할당된 포트는 GPanel의 Network 탭에서 확인하세요.
비밀번호 불일치: 플레이어가 올바른 서버 비밀번호를 입력하는지 확인하세요. 비밀번호는 대소문자를 구분합니다.
모드 버전 불일치: Valheim Plus 또는 기타 강제 적용 모드가 설치된 경우, 모든 플레이어가 정확히 동일한 버전을 가지고 있어야 합니다. 자세한 내용은 모드 설치 가이드를 참고하세요.

BepInEx 모드가 로드되지 않음

원인: BepInEx 파일이 잘못된 디렉터리에 배치되었거나, doorstop 라이브러리가 서버 루트에서 누락되었습니다.

해결 방법:

SFTP를 통해 BepInEx/ 폴더가 valheim_server.x86_64와 함께 서버 루트 디렉터리에 있는지 확인하세요.
doorstop_libs/ 폴더도 서버 루트에 존재하며 libdoorstop_x64.so를 포함하는지 확인하세요. Pterodactyl 기반 패널에서는 doorstop이 환경 변수를 통해 로드됩니다 — run_bepinex.sh 스크립트는 사용되지 않으며 존재할 필요도 없습니다.
모드 .dll 파일이 루트나 다른 하위 디렉터리가 아닌 BepInEx/plugins/ 안에 있는지 확인하세요.
서버를 재시작하고 서버 콘솔 로그에서 BepInEx 초기화 메시지나 오류 출력을 확인하세요.

예상되는 디렉터리 구조는 다음과 같습니다:

/ (server root)
  valheim_server.x86_64
  BepInEx/
    plugins/        ← mod .dll files go here
    config/
    patchers/
  doorstop_libs/
    libdoorstop_x64.so

모드 추가 후 서버 충돌 또는 불안정

원인: 모드가 현재 Valheim 버전과 호환되지 않거나, 다른 모드와 충돌하거나, 잘못 구성되었습니다.

해결 방법:

GPanel의 서버 콘솔 출력에서 특정 모드나 플러그인 이름을 언급하는 오류 메시지를 확인하세요.
BepInEx/plugins/에서 모든 모드를 제거하고 서버를 재시작하여 모드 없이 정상적으로 실행되는지 확인하세요.
모드를 한 번에 하나씩 다시 추가하고 각 추가 사이에 재시작하여 어떤 모드가 충돌을 일으키는지 식별하세요.
모드의 Thunderstore 또는 Nexus 페이지에서 호환성 참고 사항과 필요한 종속성을 확인하세요.

Valheim 게임 업데이트 후: 모드 제작자가 업데이트된 버전을 출시할 때까지 모드가 작동하지 않을 수 있습니다. 업데이트 전에는 서버가 안정적이었으나 업데이트 후 충돌이 발생하는 경우, 업데이트된 버전이 제공될 때까지 모드를 일시적으로 제거하세요.

크로스플레이가 작동하지 않음

원인: 크로스플레이 시작 변수가 활성화되지 않았거나, 모드가 크로스플레이 기능을 방해하고 있습니다.

해결 방법:

GPanel의 Startup 탭으로 이동하여 ENABLE_CROSSPLAY를 1로 설정하세요.
서버를 재시작하세요.
대부분의 BepInEx 모드는 크로스플레이와 호환되지 않는다는 점에 유의하세요. 모드가 설치되어 있고 크로스플레이 플레이어가 연결할 수 없는 경우, 모드와 크로스플레이 지원 중 하나를 선택해야 할 수 있습니다.

Valheim 문제 해결 - 지식베이스

Support

Categories

Valheim 문제 해결