Valheim 모드 설치 가이드
이 가이드는 Valheim 데디케이트 서버에 BepInEx 모드 프레임워크를 설치하고, Thunderstore 및 Nexus Mods에서 모드를 추가하며, Valheim Plus와 같은 인기 모드 팩을 구성하는 방법을 다룹니다. 기본 서버 설정 및 접속 지침은 Valheim 데디케이트 서버 설정 가이드를 참고하세요.
BepInEx 모드 프레임워크
BepInEx는 Valheim의 표준 모드 로더입니다. 거의 모든 Valheim 모드가 이를 필요로 합니다. 서버 루트 디렉터리에 설치해야 합니다.
서버에 BepInEx 설치하기
- Thunderstore 페이지 또는 BepInEx GitHub 릴리스 페이지에서 최신 BepInEx for Valheim 릴리스를 다운로드합니다. 데디케이트 서버에는 Unix/Linux x64 빌드를 사용하세요.
- 다운로드한 아카이브의 압축을 풉니다.
BepInEx/폴더와doorstop_libs/폴더, 그리고 루트 레벨의 일부 파일이 보일 것입니다. - SFTP를 통해 서버에 접속합니다(SFTP로 파일을 업로드하는 방법 참조).
- 추출된 모든 파일과 폴더를 서버 루트 디렉터리(
valheim_server.x86_64가 포함된 동일한 디렉터리)에 업로드합니다. - GPanel에서 서버를 재시작합니다. BepInEx는 첫 실행 시 폴더 구조를 생성합니다.
BepInEx가 설치된 상태로 처음 재시작한 후,
plugins/, config/, patchers/ 하위 디렉터리를 포함하는 BepInEx/ 폴더가 보일 것입니다. 모든 모드는 BepInEx/plugins/에 들어갑니다.
BepInEx 작동 확인하기
재시작 후, GPanel에서 서버 콘솔 출력에 BepInEx 초기화 메시지가 있는지 확인하세요. 다음과 유사한 줄이 보일 것입니다:
[Message: BepInEx] BepInEx 5.x.x.x - valheim_server
[Info : BepInEx] Loading [BepInEx.Chainloader]이 메시지가 나타나지 않으면 해결책은 Valheim 문제 해결을 참고하세요.
모드 설치하기
BepInEx가 설치되면 대부분의 플러그인에 대해 모드 추가는 동일한 과정을 따릅니다:
- Thunderstore.io 또는 Nexus Mods에서 모드를 다운로드합니다.
- 다운로드한 아카이브의 압축을 풉니다.
- 모드의
.dll파일(및 필요한 구성 또는 에셋 파일)을 SFTP를 통해 서버의BepInEx/plugins/디렉터리에 복사합니다. - 서버를 재시작합니다.
클라이언트 측 모드 vs. 서버 측 모드: 일부 모드는 서버와 각 플레이어의 클라이언트 모두에 설치해야 합니다. 다른 모드는 서버 전용입니다. 어디에 설치해야 하는지 확인하려면 모드의 문서를 확인하세요.
모드 디렉터리 구조
몇 개의 모드를 설치한 후, 서버의 BepInEx 디렉터리는 다음과 같이 보일 것입니다:
/ (server root)
BepInEx/
config/ ← mod configuration files (auto-generated on first run)
plugins/ ← place mod .dll files here
patchers/ ← preloader patchers (rarely used)
doorstop_libs/ ← BepInEx doorstop libraryValheim Plus
Valheim Plus는 가장 인기 있는 서버 수정 팩 중 하나입니다. 게임 메커니즘, 플레이어 스탯, 건설 등에 대한 광범위한 구성 옵션을 제공합니다.
Valheim Plus 설치하기
- Thunderstore 페이지 또는 GitHub 릴리스 페이지에서 최신 서버 빌드의 Valheim Plus를 다운로드합니다. Unix/Linux 서버 빌드를 다운로드하는지 확인하세요.
- 아카이브의 압축을 풉니다. BepInEx와 Valheim Plus 플러그인이 함께 포함되어 있습니다.
- 모든 내용을 SFTP를 통해 서버 루트 디렉터리에 업로드하고, 메시지가 표시되면 기존 BepInEx 파일을 덮어씁니다.
- 서버를 재시작합니다. 구성 파일이 다음 위치에 생성됩니다:
BepInEx/config/valheim_plus.cfg - SFTP를 통해
valheim_plus.cfg를 편집하여 원하는 기능을 활성화하고 구성합니다. 각 섹션 상단에는enabled토글이 있습니다. - 구성을 변경한 후 서버를 재시작합니다.
Valheim Plus는 서버와 클라이언트에서 일치하는 버전이 필요합니다. 플레이어가 접속하려면 자신의 게임 클라이언트에 동일한 버전의 Valheim Plus를 설치해야 합니다. 버전이 일치하지 않으면 연결 실패가 발생합니다.
인기 있는 서버 호환 모드
| 모드 | 설명 | 설치 위치 |
|---|---|---|
| Epic Loot | 마법 아이템 드롭 및 접두/접미사 추가 | 서버 + 클라이언트 |
| Plant Everything | 향상된 농사 및 재배 옵션 | 서버 + 클라이언트 |
| Jotunn (JVL) | 많은 모드에 필요한 모드 프레임워크/라이브러리 | 서버 + 클라이언트 |
| Server Characters | 치트를 방지하기 위해 캐릭터 데이터를 서버에 고정 | 서버 전용 |
| WardIsLove | 확장된 와드/소유권 관리 | 서버 + 클라이언트 |
모드 호환성: Valheim 게임 업데이트 후, 작성자가 업데이트를 출시할 때까지 모드가 작동하지 않을 수 있습니다. 게임 서버를 업데이트하기 전에 항상 모드 페이지에서 호환성 메모를 확인하세요. 업데이트 후 서버가 불안정해지면, 최근에 추가한 모드를 제거하고 원인을 파악하기 위해 한 번에 하나씩 다시 추가하세요.
관련 문서
- Valheim 데디케이트 서버 설정 가이드 — 시작 구성, 접속 및 월드 세이브
- Valheim 문제 해결 — 일반적인 문제 및 해결책
- SFTP로 파일을 업로드하는 방법
모드 설치에 문제가 발생하면 Valheim 문제 해결 가이드를 확인하거나 지원 티켓을 열고 서버의 GPanel 세부 정보와 설치하려는 모드를 포함해 주세요.
