이 가이드는 Resonite 서버의 헤드리스 콘솔 명령어, 세션 관리, 모드 로더 설정, 문제 해결을 다룹니다. 최초 설정에 대해서는 Resonite 헤드리스 서버 설정 가이드를 참조하세요.
1. 헤드리스 콘솔 명령어
Resonite 헤드리스 서버는 GPanel 콘솔을 통해 명령어를 받습니다. 서버는 정상적인 종료를 위한 shutdown 명령어에 응답합니다.
| 명령어 | 설명 |
|---|---|
worlds |
모든 활성 월드 세션을 나열합니다. |
focus <world_index> |
명령어를 위해 특정 월드에 포커스를 맞춥니다. |
status |
포커스된 월드의 상태를 표시합니다. |
users |
포커스된 월드의 사용자를 나열합니다. |
kick <username> |
포커스된 월드에서 사용자를 추방합니다. |
ban <username> |
포커스된 월드에서 사용자를 차단합니다. |
silence <username> |
포커스된 월드에서 사용자를 음소거합니다. |
unsilence <username> |
사용자의 음소거를 해제합니다. |
respawn <username> |
사용자를 월드 원점으로 리스폰합니다. |
role <username> <role> |
사용자의 역할을 설정합니다 (Admin, Builder, Moderator, Guest, Spectator). |
name <session_name> |
포커스된 세션의 이름을 변경합니다. |
accessLevel <level> |
접속 가능한 대상을 변경합니다 (Anyone, RegisteredUsers, Contacts, ContactsPlus, Private). |
maxUsers <count> |
포커스된 월드의 최대 사용자 수를 변경합니다. |
save |
포커스된 월드를 저장합니다. |
close |
포커스된 월드를 닫습니다. |
restart |
포커스된 월드를 재시작합니다. |
invite <username> |
포커스된 월드에 사용자를 초대합니다. |
message <text> |
포커스된 월드에 메시지를 보냅니다. |
shutdown |
전체 헤드리스 서버를 정상적으로 종료합니다. |
2. 접근 수준
accessLevel 설정으로 월드 세션에 접속할 수 있는 대상을 제어합니다:
| 수준 | 설명 |
|---|---|
| Anyone | 모든 Resonite 사용자에게 공개됩니다. |
| RegisteredUsers | 등록된 Resonite 계정만 가능합니다. |
| Contacts | 헤드리스 계정의 연락처 목록에 있는 사용자만 가능합니다. |
| ContactsPlus | 연락처 및 연락처의 연락처까지 가능합니다. |
| Private | 초대 전용입니다. |
3. 사용자 역할
월드에서 사용자가 할 수 있는 작업을 제어하기 위해 역할을 할당합니다:
| 역할 | 설명 |
|---|---|
| Admin | 월드에 대한 전체 제어 권한입니다. |
| Builder | 객체를 만들고 수정할 수 있습니다. |
| Moderator | 사용자를 추방/차단하고 채팅을 관리할 수 있습니다. |
| Guest | 표준 사용자 접근 권한입니다. |
| Spectator | 관찰할 수 있지만 상호작용할 수 없습니다. |
Config.json에서 defaultUserRoles를 사용하여 기본 역할을 설정하거나, role 콘솔 명령어로 사용자별로 할당하세요.
4. 다중 월드
헤드리스 서버는 여러 월드를 동시에 호스팅할 수 있습니다. Headless/Config/Config.json의 startWorlds 배열에 추가 항목을 더하세요:
"startWorlds": [
{
"isEnabled": true,
"sessionName": "World 1",
"maxUsers": 16,
"accessLevel": "Anyone",
"loadWorldPresetName": "SpaceWorld"
},
{
"isEnabled": true,
"sessionName": "World 2",
"maxUsers": 8,
"accessLevel": "Contacts",
"loadWorldPresetName": "Grid"
}
]콘솔에서 focus 0과 focus 1을 사용하여 월드 간에 전환하세요.
5. 모드 로더
Resonite는 ResoniteModLoader를 통해 모드를 지원합니다. 활성화하려면:
- Startup 탭에서
ENABLE_MODLOADER를true로 설정합니다. - 서버를 재설치하거나 재시작합니다 -- 모드 로더 DLL이 자동으로 다운로드됩니다.
- SFTP를 통해 모드 DLL을
rml_mods/디렉터리에 배치합니다. - 서버를 재시작하여 모드를 로드합니다.
모드 로더 파일:
Libraries/ResoniteModLoader.dll-- 주 모드 로더입니다.rml_libs/0Harmony.dll-- 필수 종속성입니다.rml_mods/-- 여기에 모드 DLL을 배치합니다.
6. 문제 해결
- 서버가 시작되지 않음:
Config.json의 로그인 자격 증명이 올바른지 확인하세요. 헤드리스는 유효한 Resonite 계정으로 인증해야 합니다. - 월드가 브라우저에 나타나지 않음:
hideFromPublicListing이true로 설정되어 있지 않은지 확인하세요.accessLevel이 검색하는 사용자를 허용하는지 확인하세요. - "World running..."이 나타나지 않음: 콘솔에서 오류를 확인하세요. 월드 프리셋 이름이 잘못되었을 수 있습니다.
- 모드가 로드되지 않음:
ENABLE_MODLOADER가true이고 모드 DLL이rml_mods/에 있는지 확인하세요. 콘솔에서 모드 로더 오류를 확인하세요. - 높은 리소스 사용량:
Config.json의tickRate를 줄이거나maxConcurrentAssetTransfers를 낮추세요. 복잡한 사용자 생성 콘텐츠는 리소스를 많이 사용할 수 있습니다.
관련 문서
도움이 필요하신가요?
추가 지원이 필요하면 지원 티켓을 열고 서버 세부 정보와 GPanel 콘솔의 오류 메시지를 함께 포함해 주세요.
