이 가이드는 필수 최초 인증 단계, 기본 서버 구성, 플레이어가 서버에 접속하는 방법을 포함하여 Legion Hosting에서 Hytale 전용 서버를 설정하는 과정을 단계별로 안내합니다.

사전 준비 사항

• Legion Hosting에서 활성화된 Hytale 서버
• 환영 이메일에서 받은 GPanel 자격 증명 (찾을 수 없는 경우 스팸 폴더를 확인하세요)
• PC에 설치된 Hytale
• GPanel에서 확인한 서버의 IP 주소와 포트 (gpanel.legionhosting.net에서 로그인)

1단계 — GPanel에 로그인하고 서버 시작하기

1. 브라우저를 열고 https://gpanel.legionhosting.net으로 이동합니다.
2. 환영 이메일에 있는 Email과 Password를 입력하고 Login을 클릭합니다.
3. 서버 목록에서 Hytale 서버를 클릭하여 엽니다.
4. Console 탭에서 상태 표시기가 Offline으로 표시됩니다. Start 버튼을 클릭합니다.
5. 서버가 필요한 파일을 다운로드하고 설치할 때까지 기다립니다. Hytale 서버 파일이 설정되는 동안 첫 시작에는 2~5분이 걸릴 수 있습니다.
6. 콘솔 출력을 확인합니다. 서버가 결국 일시 중지되고 URL과 장치 코드가 포함된 인증 프롬프트를 표시합니다. 이 시점에서 서버를 닫거나 재시작하지 마세요.

2단계 — 서버 인증하기

Hytale은 첫 시작 시 서버 인증을 요구합니다. 이 단계를 완료하기 전까지 서버는 플레이어 접속을 수락하지 않습니다.

1. GPanel 콘솔에서 URL과 장치 코드가 포함된 메시지를 찾습니다. 다음과 유사하게 표시됩니다:

   To authenticate, visit: https://auth.hytale.com/device
   Enter the code: XXXX-XXXX

2. 아무 기기(PC, 휴대폰, 태블릿)의 웹 브라우저에서 인증 URL을 엽니다.
3. Hytale 계정(게임을 플레이할 때 사용하는 계정)으로 로그인합니다.
4. 요청이 표시되면 콘솔에 표시된 장치 코드를 입력합니다.
5. 인증을 확인합니다. 브라우저에 성공 메시지가 표시됩니다.
6. GPanel로 돌아가 콘솔을 확인합니다. 몇 초 안에 서버가 시작 과정을 계속하고 상태가 Running으로 변경됩니다.

3단계 — 접속 정보 찾기

1. GPanel에서 Console 탭(또는 서버 개요 영역)을 클릭합니다.
2. 페이지 상단 근처에 표시된 IP Address와 Port를 확인합니다.
3. 형식은 IP:Port이며, 예를 들어 192.0.2.10:25565와 같습니다. 서버에 참여하려는 사람에게 이 정보를 공유하면 됩니다.

접속 정보를 찾는 자세한 안내는 서버 IP와 포트 찾는 방법을 참조하세요.

4단계 — 기본 서버 구성

Hytale 전용 서버는 GPanel Startup 탭을 통해 주요 설정을 제공합니다. 이 변수들은 수동 파일 편집 없이 가장 일반적인 서버 옵션을 제어합니다.

Startup 변수 사용하기

1. GPanel에서 Startup 탭을 클릭합니다.
2. 구성 가능한 변수 목록이 표시됩니다. 값을 편집하고 Save를 클릭하거나 Enter를 누릅니다.
3. 변경한 후 새 설정이 적용되도록 Console 탭에서 서버를 재시작합니다.

일반 설정

구성 파일 편집하기

Startup 탭에서 사용할 수 없는 고급 설정의 경우 GPanel 파일 관리자를 통해 서버 구성 파일을 직접 편집할 수 있습니다.

1. GPanel에서 Files 탭을 클릭합니다.
2. 서버의 루트 디렉터리를 탐색하여 구성 파일을 찾습니다 (Hytale 업데이트에 따라 다를 수 있습니다).
3. 파일을 클릭하여 내장 텍스트 편집기에서 엽니다. 변경한 후 Save Content를 클릭합니다.
4. 변경 사항이 적용되도록 서버를 중지한 후 재시작합니다.

대량 파일 전송이나 대용량 업로드의 경우 브라우저 파일 관리자 대신 SFTP를 통해 연결하세요. 자세한 안내는 SFTP로 파일 업로드하는 방법을 참조하세요.

5단계 — Hytale 서버에 접속하기

1. PC에서 Hytale을 실행합니다.
2. 메인 메뉴에서 Multiplayer 또는 Server Browser 옵션으로 이동합니다.
3. Direct Connect(또는 IP로 참여하는 동등한 옵션)를 선택합니다.
4. 3단계에서 확인한 서버의 IP:Port를 입력합니다. 예를 들어 192.0.2.10:25565입니다.
5. 4단계에서 서버 비밀번호를 설정했다면 요청 시 입력합니다.
6. Connect를 클릭합니다. 몇 초 안에 서버 월드에 로드됩니다.

확인

접속한 후 모든 것이 작동하는지 확인하세요:

1. 캐릭터가 게임 월드에 성공적으로 로드되어야 합니다.
2. GPanel Console 탭을 확인하세요. 플레이어가 서버에 참여했음을 나타내는 로그 항목이 표시되어야 합니다.
3. 친구에게 동일한 IP와 포트로 접속하도록 요청하여 외부 연결을 확인하세요.
4. 서버 상태는 Running으로 유지되어야 하며 콘솔 출력에 오류가 없어야 합니다.

문제 해결

서버가 시작되지 않거나 시작 중 멈춤

• 콘솔 출력에서 오류 메시지를 확인하세요. 최초 설치 시 서버가 필요한 파일을 다운로드하는 데 몇 분이 걸릴 수 있습니다.
• 서버가 인증을 기다리는 중이라면 2단계에 설명된 장치 로그인을 완료하세요.
• 인증 후에도 오류가 계속되면 GPanel의 Settings 탭에서 서버를 재설치해 보세요 (이렇게 하면 서버 데이터가 삭제됩니다 — 먼저 중요한 파일을 백업하세요).

인증 코드가 만료되었거나 실패함

• 장치 코드는 제한된 시간 동안만 유효합니다. 만료된 경우 서버를 재시작하여 새 코드를 생성하세요.
• 게임을 소유한 유효한 Hytale 계정으로 로그인하고 있는지 확인하세요.
• 인증 페이지가 로드되지 않으면 다른 브라우저를 사용하거나 브라우저 캐시를 지워 보세요.

서버에 접속할 수 없음

• GPanel에서 서버 상태가 Running으로 표시되는지 확인하세요. Offline 또는 Starting으로 표시되면 완전히 시작될 때까지 기다리세요.
• IP 주소와 포트를 다시 확인하세요. 콜론 뒤에 포트 번호를 포함했는지 확인하세요.
• 접속을 시도하기 전에 서버가 인증 단계를 성공적으로 완료했는지 확인하세요.
• 서버를 막 시작했다면 완전히 초기화될 때까지 1~2분 기다린 후 접속을 시도하세요.
• 올바른 접속 정보를 찾는 데 도움이 필요하면 서버 IP와 포트 찾는 방법을 참조하세요.

설정 변경 사항이 적용되지 않음

• Startup 변수 변경은 서버 전체 재시작이 필요합니다. 저장 후 Console 탭의 Restart 버튼을 사용하세요.
• 구성 파일을 직접 편집하는 경우 변경 사항을 저장하기 전에 서버가 중지되어 있는지 확인하세요. 일부 게임은 종료 시 구성 파일을 덮어쓰며, 이로 인해 편집 내용이 취소될 수 있습니다.

서버가 예기치 않게 충돌하거나 오프라인이 됨

• 서버가 오프라인이 되기 전에 콘솔 출력에서 오류 메시지나 충돌 로그를 확인하세요.
• Hytale은 얼리 액세스 상태입니다 — 게임 버그로 인해 충돌이 발생할 수 있습니다. 서버를 재시작해 보세요.
• 충돌이 반복적으로 발생하면 오류 메시지를 복사하여 지원 티켓을 열어 저희 팀이 조사할 수 있도록 하세요.

도움이 필요하신가요?

위에서 다루지 않은 문제가 발생하면 지원 티켓을 열고 다음을 포함해 주세요:

• GPanel의 서버 이름
• 문제에 대한 설명과 발생 시점
• GPanel 콘솔의 오류 메시지 (관련된 줄을 복사하여 붙여넣기)