Barotrauma 모드 설치 가이드
이 가이드는 Legion Hosting에서 호스팅되는 Barotrauma 전용 서버에 Steam Workshop 모드를 설치, 관리, 업데이트하는 방법을 다룹니다. 모드는 서버에 커스텀 잠수함, 생물, 아이템, 게임플레이 변경 사항을 추가할 수 있습니다.
목차
전용 서버에서 모드가 작동하는 방식
Barotrauma는 잠수함, 생물, 아이템, 게임플레이 개편을 포함한 커스텀 콘텐츠를 위한 Steam Workshop 모드를 지원합니다. 전용 서버에서는 모드가 Workshop에서 자동으로 다운로드되지 않습니다. 모드 파일을 수동으로 서버에 전송해야 합니다.
Workshop 모드 설치하기
호스팅 서버에 모드를 설치하는 권장 방법은 먼저 로컬 PC에서 다운로드한 다음 파일을 서버에 업로드하는 것입니다.
단계별 설치
- 자신의 PC에서 Steam Workshop의 모드를 구독하고 Barotrauma를 한 번 실행하여 다운로드합니다.
- PC에서 다운로드된 모드 폴더를 찾습니다. Workshop 모드는 일반적으로 다음 위치에 저장됩니다:
Steam\steamapps\workshop\content\602960\<ModID>\<ModID>는 모드의 Workshop URL에 있는 숫자 ID입니다. - SFTP를 통해 서버에 연결하거나 GPanel에서 파일 관리자를 엽니다.
- Barotrauma 서버 폴더의
LocalMods/디렉터리로 이동합니다. 디렉터리가 없으면 생성합니다. - 전체 모드 폴더(모드의 숫자 ID로 이름이 지정된 폴더)를
LocalMods/에 업로드합니다. - 다음 섹션에 설명된 대로
serversettings.xml에서 모드를 구성합니다. - 변경 사항이 적용되도록 서버를 다시 시작합니다.
filelist.xml 파일이 포함되어 있어야 합니다. 이 파일이 없으면 서버가 모드를 감지하지 못합니다.
serversettings.xml에서 모드 구성하기
모드 파일을 업로드한 후, 서버 구성에 모드를 등록해야 합니다. serversettings.xml을 열고 설치된 콘텐츠 패키지 목록에 모드를 추가합니다.
serversettings.xml을 편집하기 전에 항상 서버를 중지하세요. 서버는 종료 시 이 파일을 덮어쓰므로, 서버가 실행 중일 때 변경한 내용은 손실됩니다.
올바른 내부 이름은 모드의 filelist.xml을 참조하세요. 정확한 구성 형식은 Barotrauma 버전에 따라 다르지만, 일반적으로 모드는 serversettings.xml 내의 ContentPackage 항목에 나타납니다.
모드 로딩 확인하기
모드를 구성하고 서버를 다시 시작한 후:
- GPanel에서 서버 콘솔을 엽니다.
- 모드 이름이나 ID를 참조하는 로그 줄을 찾습니다. 성공적으로 로드된 모드는 시작 시퀀스 중에 나타납니다.
- 모드를 참조하는
[ERROR]줄이 보이면, 모든 파일이 올바르게 업로드되었는지, 그리고 모드가 서버 버전과 호환되는지 확인하세요.
모드를 최신 상태로 유지하기
서버는 Workshop 업데이트를 자동으로 가져오지 않습니다. 모드 제작자가 업데이트를 푸시하면, 업데이트된 파일을 수동으로 다시 다운로드하고 다시 업로드해야 합니다.
업데이트 절차
- 로컬 PC에서 Steam 클라이언트가 모드의 최신 버전을 다운로드했는지 확인합니다(필요한 경우 구독을 취소했다가 다시 구독하여 새로운 다운로드를 강제합니다).
- SFTP를 통해 서버에 연결합니다.
- GPanel에서 서버를 중지합니다.
LocalMods/<ModID>/로 이동하여 내용을 새로 다운로드한 파일로 교체합니다.- 서버를 시작합니다.
모드 호환성
모드 충돌은 서버 문제의 가장 흔한 원인 중 하나입니다. 다음 지침을 염두에 두세요:
| 문제 | 원인 | 해결책 |
|---|---|---|
| 시작 시 서버 충돌 | 두 모드가 동일한 게임 콘텐츠(아이템, 생물 등)를 수정함 | 모든 모드를 비활성화한 다음, 하나씩 다시 활성화하여 충돌을 찾으세요 |
| 접속 시 플레이어 연결 끊김 | 클라이언트-서버 모드 버전 불일치 | 모든 플레이어와 서버가 동일한 모드 버전을 가지고 있는지 확인하세요 |
| 서버 로그의 콘텐츠 오류 | 누락된 종속성 또는 오래된 모드 | 모드의 Workshop 페이지에서 필요한 종속성을 확인하고 업데이트하세요 |
| 모드가 싱글플레이어에서는 작동하지만 서버에서는 작동하지 않음 | 클라이언트 측 전용 모드 | 모드의 Workshop 설명을 확인하세요. 일부 모드는 클라이언트 전용이며 서버에 설치하면 안 됩니다 |
모드 제거하기
- GPanel에서 서버를 중지합니다.
serversettings.xml을 열고 모드의 콘텐츠 패키지 항목을 제거합니다.- SFTP 또는 GPanel 파일 관리자를 통해
LocalMods/에서 모드 폴더를 삭제합니다. - 서버를 시작합니다.
