이 가이드는 Legion Hosting에서 호스팅되는 Resonite 헤드리스 서버를 설정하고 구성하는 방법을 다룹니다. Resonite는 사용자가 생성한 월드에서 제작하고, 창작하고, 소통할 수 있는 소셜 VR 플랫폼입니다. 세션 관리 및 관리자 명령어에 대해서는 Resonite 서버 관리자 가이드를 참조하세요.
1. 서버 접속
- GPanel에 로그인합니다.
- 서버 목록에서 Resonite 서버를 선택합니다.
- 서버는 GPanel의 Console 탭과 Resonite 헤드리스 구성을 통해 관리됩니다.
참고: 전용 IP가 없는 경우 포트는 무작위로 할당됩니다. Resonite 헤드리스 서버는 주로 JSON 구성 파일과 세션 브라우저를 통해 연결되지만, 할당된 포트는 여전히 네트워크 통신에 사용됩니다.
2. 시작 변수
GPanel의 Startup 탭에서 다음 설정을 구성하세요:
| 변수 | 환경 변수 이름 | 기본값 | 설명 |
|---|---|---|---|
| 모드 로더 활성화 | ENABLE_MODLOADER |
false | 커스텀 모드를 위한 ResoniteModLoader를 활성화합니다 (true/false). |
| 자동 업데이트 | AUTO_UPDATE |
1 | 시작 시 서버를 자동으로 업데이트합니다 (1=예, 0=아니오). |
중요: Resonite 헤드리스는 헤드리스 접근 권한이 포함된 Patreon 구독이 필요합니다. 설치에는 베타 비밀번호(인게임에서 Resonite 봇에게
/headlessCode를 메시지로 보내 획득)가 필요합니다. 이는 호스팅 제공업체에 의해 구성됩니다.
3. 구성 파일
주 구성 파일은 Headless/Config/Config.json입니다. SFTP를 통해 편집하세요. 주요 설정:
{
"tickRate": 60.0,
"maxConcurrentAssetTransfers": 4,
"loginCredential": "your_username",
"loginPassword": "your_password",
"startWorlds": [
{
"isEnabled": true,
"sessionName": "My World",
"maxUsers": 32,
"accessLevel": "Anyone",
"loadWorldPresetName": "SpaceWorld",
"autoRecover": true,
"autoSleep": true,
"saveOnExit": false
}
]
}4. Config.json 설정 참조
| 설정 | 기본값 | 설명 |
|---|---|---|
tickRate | 60.0 | 서버 시뮬레이션 틱 레이트입니다. |
maxConcurrentAssetTransfers | 4 | 동시 에셋 다운로드 최대 개수입니다. |
loginCredential | (비어 있음) | 헤드리스용 Resonite 계정 사용자 이름입니다. |
loginPassword | (비어 있음) | Resonite 계정 비밀번호입니다. |
5. 월드 구성
startWorlds 배열의 각 항목은 월드 세션을 정의합니다. 주요 월드 설정:
| 설정 | 기본값 | 설명 |
|---|---|---|
isEnabled | true | 이 월드를 시작할지 여부입니다. |
sessionName | null | 세션의 표시 이름입니다. |
maxUsers | 32 | 월드의 최대 사용자 수입니다. |
accessLevel | Anyone | 접속 가능한 대상: Anyone, RegisteredUsers, Contacts, ContactsPlus, Private. |
loadWorldPresetName | SpaceWorld | 로드할 프리셋 월드입니다 (예: SpaceWorld, Grid, BasicEmpty). |
loadWorldURL | null | 프리셋 대신 로드할 커스텀 월드의 URL입니다. |
autoRecover | true | 충돌 후 월드를 자동으로 복구합니다. |
autoSleep | true | 사용자가 없을 때 월드를 절전 상태로 전환합니다. |
saveOnExit | false | 서버 종료 시 월드 상태를 저장합니다. |
autosaveInterval | -1.0 | 자동 저장 간격(초)입니다 (-1 = 비활성화). |
hideFromPublicListing | null | 이 세션을 공개 목록에서 숨깁니다. |
awayKickMinutes | -1.0 | AFK 사용자가 추방되기까지의 시간(분)입니다 (-1 = 비활성화). |
idleRestartInterval | -1.0 | 월드가 비어 있는 상태가 이 시간(초) 동안 지속되면 재시작합니다 (-1 = 비활성화). |
forcedRestartInterval | -1.0 | 사용자와 관계없이 이 시간(초) 이후 강제로 재시작합니다 (-1 = 비활성화). |
6. 서버 접속
- PC 또는 VR 헤드셋에서 Resonite를 실행합니다.
- 세션 브라우저를 엽니다 (Dash Menu > Worlds).
- 세션 이름으로 서버를 검색합니다.
- Join을 클릭하여 월드에 입장합니다.
비공개 세션의 경우, 헤드리스 계정이 사용자를 초대하거나 구성에서 autoInviteUsernames를 사용해야 합니다.
7. 최초 설정 체크리스트
Headless/Config/Config.json을 편집하여 Resonite 계정에 대한loginCredential과loginPassword를 설정합니다.- 월드의
sessionName을 설정합니다. loadWorldPresetName을 선택하거나 커스텀 월드를 위한loadWorldURL을 제공합니다.- 접속 가능한 대상을 제어하기 위해
accessLevel을 설정합니다. - 서버를 시작하고 콘솔에
World running...이 표시되는지 확인합니다.
관련 문서
도움이 필요하신가요?
Resonite 서버에 문제가 발생하면 지원 티켓을 열고 서버 세부 정보, 문제에 대한 설명, 그리고 GPanel 콘솔의 오류 메시지를 함께 포함해 주세요.
