Vintage Story 모드 설치
이 가이드는 Vintage Story 전용 서버에서 모드를 설치, 관리, 제거하는 방법을 다룹니다. 초기 서버 설정 및 구성에 대해서는 Vintage Story 서버 설정 가이드를 참조하세요. 관리자 명령어 및 권한에 대해서는 Vintage Story 관리자 명령어를 참조하세요.
서버 패널: 모든 서버 관리는 GPanel(gpanel.legionhosting.net)을 통해 이루어집니다. 모드 파일을 업로드하려면 File Manager 또는 SFTP를 사용하세요.
모드 다운로드
Vintage Story에는 활발한 모딩 커뮤니티가 있습니다. 모드는 .zip 또는 .cs 파일로 배포됩니다.
- 공식 모드 데이터베이스(mods.vintagestory.at)를 둘러보세요.
- 원하는 모드를 찾아 서버의 Vintage Story 버전과 호환되며 서버 측 사용을 지원하는지 확인하세요.
- 모드 파일(일반적으로
.zip파일)을 다운로드합니다.
모드 설치
- GPanel Console 탭에서 서버를 중지합니다.
- GPanel에서 Files 탭을 열고 서버 루트의
Mods/디렉터리로 이동합니다. - 모드
.zip파일을Mods/디렉터리에 직접 업로드합니다. zip 파일의 압축을 풀지 마세요 -- Vintage Story는 zip 아카이브에서 모드를 읽습니다. - 서버를 시작합니다. 콘솔 출력에 어떤 모드가 로드되었는지 표시됩니다. 새로 추가한 모드와 관련된 오류가 있는지 확인하세요.
클라이언트 측 모드 필요: 많은 Vintage Story 모드는 플레이어가 자신의 클라이언트에 동일한 모드를 설치해야 합니다. 모드가 새로운 블록, 아이템 또는 메커니즘을 추가하는 경우, 모드가 없는 플레이어는 접속할 수 없거나 문제가 발생합니다. 플레이어가 접속하기 전에 필요한 모드를 알려주세요.
설치하기 전에 버전 호환성을 확인하세요. 한 버전의 Vintage Story용으로 제작된 모드는 다른 버전에서 작동하지 않을 수 있습니다. 항상 모드 버전이 서버의 게임 버전과 일치하는지 확인하세요. 호환되지 않는 모드를 설치하면 서버가 시작되지 않을 수 있습니다.
모드 제거
- 서버를 중지합니다.
- GPanel 파일 관리자에서
Mods/디렉터리로 이동합니다. - 제거하려는 모드 파일을 삭제합니다.
- 서버를 시작합니다. 월드에 블록이나 아이템을 추가한 모드를 제거하면 해당 객체가 사라지거나 오류 자리표시자로 대체될 수 있다는 점에 유의하세요.
모드 서버를 위한 버전 고정
모드를 실행 중이라면, 자동 업데이트로 인해 모드 호환성이 깨지는 것을 방지하기 위해 서버를 특정 게임 버전에 고정하는 것이 강력히 권장됩니다. GPanel에서 RELEASE_VERSION 시작 변수를 latest 대신 원하는 정확한 버전 번호(예: 1.19.8)로 설정하세요. 버전 관리에 대한 자세한 내용은 Vintage Story 서버 설정 가이드를 참조하세요.
관련 문서
도움이 필요하신가요?
이 가이드에서 다루지 않은 문제가 발생하면 지원 티켓을 열고 서버의 IP 주소, 문제 설명, GPanel의 관련 콘솔 출력을 포함해 주세요.
