Vintage Story 서버 설정 가이드

이 가이드는 최초 시작, GPanel 변수, 버전 관리, 서버 구성, 월드 설정, 플레이어 연결, 저장 관리 등 Legion Hosting으로 호스팅되는 Vintage Story 전용 서버를 설정하고 구성하는 방법을 다룹니다. 모드 설치에 대해서는 Vintage Story 모드 설치를 참조하세요. 관리자 설정 및 명령어에 대해서는 Vintage Story 관리자 명령어를 참조하세요.

---

최초 시작

GPanel에서 Vintage Story 서버를 처음 시작하면 서버가 공식 Vintage Story API에서 게임 파일을 자동으로 다운로드하고 기본 월드를 생성합니다. 이 초기 시작은 파일을 다운로드하고 추출하는 동안 몇 분이 걸릴 수 있습니다.

1. GPanel에 로그인하고 Vintage Story 서버를 선택합니다.
2. 시작하기 전에 Startup 탭을 검토하여 원하는 버전 브랜치(stable, unstable 또는 pre-release)를 확인합니다.
3. Console 탭에서 Start를 클릭합니다. 서버가 게임 파일을 다운로드하고 설치하는 동안 콘솔 출력의 진행 메시지를 확인하세요.
4. 서버가 연결을 수신 대기 중이라는 메시지가 표시되면 서버가 준비된 것입니다. 기본 serverconfig.json 파일이 자동으로 생성됩니다.

---

GPanel 시작 변수

핵심 서버 설정은 GPanel의 Startup 탭을 통해 제어됩니다. 서버를 시작하기 전에 이를 검토하고 조정하세요.

시작 변수를 업데이트한 후에는 변경 사항을 적용하기 위해 GPanel에서 서버를 다시 시작하세요.

---

버전 관리

Vintage Story는 세 가지 릴리스 브랜치를 제공합니다. 브랜치 선택은 GPanel의 FILES_BRANCH 시작 변수를 통해 설정됩니다.

특정 버전 고정

기본적으로 RELEASE_VERSION은 latest로 설정되어 있으며, 이는 서버가 시작될 때마다 선택한 브랜치에서 사용 가능한 최신 버전을 다운로드하고 설치한다는 의미입니다(더 새로운 버전이 있는 경우). 자동 업데이트를 방지하고 서버를 특정 버전에 고정하려면:

1. GPanel의 Startup 탭으로 이동합니다.
2. RELEASE_VERSION을 latest에서 원하는 정확한 버전 번호(예: 1.19.8)로 변경합니다.
3. 서버를 다시 시작합니다. 더 새로운 릴리스와 관계없이 고정된 버전만 사용합니다.

---

serverconfig.json

주요 서버 구성 파일은 서버 루트 디렉터리에 위치한 serverconfig.json입니다. 이 파일은 최초 시작 시 자동으로 생성됩니다. 편집하기 전에 서버를 중지한 다음, 변경 사항을 적용하기 위해 다시 시작하세요.

1. GPanel Console 탭에서 서버를 중지합니다.
2. Files 탭을 열고 serverconfig.json을 클릭하여 편집합니다.
3. 필요한 설정을 수정합니다(아래 표 참조).
4. 파일을 저장하고 서버를 시작합니다.

주요 설정

serverconfig.json의 주요 설정에 대한 최소 예시:

{
  "ServerName": "My Legion VS Server",
  "WelcomeMessage": "Welcome! Enjoy your stay.",
  "MaxClients": 16,
  "Password": "",
  "AllowPvP": true,
  "SpawnRadius": 50,
  "MapSizeX": 1024000,
  "MapSizeZ": 1024000,
  "WorldSeed": ""
}

---

월드 구성

Vintage Story는 serverconfig.json의 설정을 기반으로 월드를 생성합니다. 월드 생성은 주어진 월드의 최초 시작 시에만 발생합니다 -- 월드가 생성된 후 생성 설정을 변경해도 기존 지형이 소급하여 변경되지는 않습니다.

월드 생성 설정

• WorldSeed: 지형 레이아웃, 바이옴 배치, 자원 분포를 결정합니다. 다른 사람들과 동일한 월드 레이아웃을 공유하려면 특정 시드를 설정하거나, 무작위로 생성된 월드의 경우 비워 두세요.
• MapSizeX / MapSizeZ: 최대 플레이 가능 영역을 제어합니다. 값이 작을수록 더 좁은 월드가 생성되며 자원 사용을 줄일 수 있습니다. 맵 가장자리에 도달한 플레이어는 해당 방향으로 더 이상 이동할 수 없습니다.
• WorldConfig: serverconfig.json 내의 WorldConfig 객체를 사용하면 지형 규모, 기후 패턴, 지질학적 특징과 같은 월드 생성 매개변수를 세밀하게 조정할 수 있습니다. 이는 고급 설정입니다 -- 기본값이 대부분의 서버에서 잘 작동합니다.

시드 선택

시드는 임의의 텍스트 문자열이나 숫자가 될 수 있습니다. Vintage Story 커뮤니티의 플레이어들은 흥미로운 월드 레이아웃을 위한 시드를 공유합니다. 특정 유형의 지형이나 스폰 위치를 원한다면 Vintage Story 포럼이나 커뮤니티 사이트에서 권장 시드를 검색하세요.

---

연결 방법

플레이어는 게임 내 멀티플레이어 메뉴를 통해 Vintage Story 서버에 연결합니다.

직접 연결

1. Vintage Story를 실행하고 메인 메뉴에서 Multiplayer를 클릭합니다.
2. Direct Connect를 클릭합니다.
3. 다음 형식으로 서버의 IP 주소와 게임 포트를 입력합니다:

   your.server.ip:port

   할당된 IP와 포트는 GPanel의 Network 탭에서 확인하세요.
4. Connect를 클릭합니다. 서버에 비밀번호가 있으면 메시지가 표시될 때 입력합니다.

서버 브라우저

1. Vintage Story를 실행하고 메인 메뉴에서 Multiplayer를 클릭합니다.
2. 서버 브라우저가 공개 서버 목록을 로드합니다. 검색창을 사용하여 이름(serverconfig.json의 ServerName 값)으로 서버를 찾습니다.
3. 목록에서 서버를 클릭하고 Join을 클릭합니다.

---

저장 관리

Vintage Story 월드 데이터는 서버에 저장되며 게임플레이 중 자동으로 저장됩니다.

월드 데이터 위치

월드 저장 파일은 서버의 data/ 디렉터리에 저장됩니다. 정확한 경로는 월드 이름에 따라 다릅니다. GPanel Files 탭 또는 SFTP를 통해 이러한 파일에 접근할 수 있습니다.

월드 백업

1. 깨끗한 백업을 보장하기 위해 서버를 중지합니다(저장 도중 파일이 기록되지 않도록).
2. SFTP를 통해 서버에 연결합니다. 연결 방법은 SFTP를 통한 파일 업로드 방법을 참조하세요.
3. 전체 data/ 디렉터리를 로컬 컴퓨터로 다운로드합니다.
4. 백업을 안전한 위치에 보관합니다. 특정 시점으로 롤백해야 할 경우를 대비해 날짜가 표시된 여러 백업을 보관하는 것을 고려하세요.

월드 재설정

완전히 새로운 월드를 시작하려면:

1. GPanel Console 탭에서 서버를 중지합니다.
2. 기존 월드 데이터를 보관하려면 백업합니다(위 참조).
3. GPanel 파일 관리자에서 data/ 디렉터리로 이동하여 월드 저장 파일을 삭제합니다.
4. 선택적으로 serverconfig.json의 WorldSeed를 업데이트하여 다른 월드 레이아웃을 생성합니다.
5. 서버를 시작합니다. 현재 구성 설정을 사용하여 새 월드가 처음부터 생성됩니다.

---

관련 문서

• Vintage Story 모드 설치
• Vintage Story 관리자 명령어
• 서버 IP 및 포트 찾는 방법
• SFTP를 통한 파일 업로드 방법
• 서버 시작 가이드

---

도움이 필요하신가요?

이 가이드에서 다루지 않은 문제가 발생하면 지원 티켓을 열고 서버의 IP 주소, 문제 설명, GPanel의 관련 콘솔 출력을 포함해 주세요.