이 가이드는 NeosVR 전용 서버의 헤드리스 콘솔 명령어, 월드 관리, 사용자 역할, NeosModLoader, 문제 해결을 다룹니다. NeosVR은 강력한 제작 도구를 갖춘 소셜 VR 메타버스입니다. 초기 설정, Config.json 구성 및 연결 방법은 NeosVR 서버 설정 가이드를 참고하세요.
1. 콘솔 접근
GPanel의 Console 탭을 통해 NeosVR 헤드리스 서버를 관리합니다. 모든 명령어는 콘솔에 직접 입력합니다.
2. 헤드리스 콘솔 명령어
월드 관리
| 명령어 | 설명 |
|---|---|
worlds | 실행 중인 모든 월드를 인덱스와 함께 나열합니다. |
focus <world_index> | 인덱스로 특정 월드로 포커스를 전환합니다. |
startWorldURL <record_url> | Neos 레코드 URL에서 새 월드를 시작합니다. |
startWorldTemplate <template> | 내장 템플릿에서 월드를 시작합니다 (예: SpaceWorld). |
save | 현재 포커스된 월드를 저장합니다. |
close | 현재 포커스된 월드를 닫습니다. |
restart | 현재 포커스된 월드를 재시작합니다. |
세션 관리
| 명령어 | 설명 |
|---|---|
sessionURL | 포커스된 월드의 세션 URL을 표시합니다. |
sessionID | 포커스된 월드의 세션 ID를 표시합니다. |
name <new_name> | 포커스된 월드의 세션 이름을 변경합니다. |
accessLevel <level> | 접근 레벨을 변경합니다: Anyone, RegisteredUsers, ContactsPlus, Contacts, Private. |
maxUsers <count> | 세션의 최대 사용자 수를 설정합니다. |
hideFromListing <true/false> | 공개 세션 브라우저에서 표시 여부를 전환합니다. |
description <text> | 세션 설명을 설정합니다. |
사용자 관리
| 명령어 | 설명 |
|---|---|
users | 포커스된 월드의 모든 사용자를 나열합니다. |
kick <username> | 월드에서 사용자를 추방합니다. |
ban <username> | 월드에서 사용자를 차단합니다. |
silence <username> | 사용자를 음소거합니다 (음성을 차단). |
unsilence <username> | 이전에 음소거된 사용자의 음소거를 해제합니다. |
respawn <username> | 월드의 스폰 지점에서 사용자를 리스폰합니다. |
role <username> <role> | 사용자에게 역할을 할당합니다 (섹션 3 참고). |
서버 제어
| 명령어 | 설명 |
|---|---|
status | 서버 상태와 리소스 사용량을 표시합니다. |
shutdown | 헤드리스 서버를 정상적으로 종료합니다. |
gc | 메모리를 확보하기 위해 가비지 컬렉션을 강제 실행합니다. |
tickRate <rate> | 런타임에 서버 틱 레이트를 변경합니다. |
3. 사용자 역할
NeosVR은 월드 권한을 위해 역할 계층을 사용합니다:
| 역할 | 설명 |
|---|---|
Admin | 전체 월드 제어. 모든 것을 수정하고, 사용자를 관리하고, 월드 설정을 변경할 수 있습니다. |
Builder | 월드에서 객체를 생성하고 편집할 수 있습니다. |
Moderator | 사용자를 추방/차단하고 세션 설정을 관리할 수 있습니다. |
Guest | 기본 접근. 기존 객체와 상호작용할 수 있지만 빌드할 수 없습니다. |
Spectator | 보기 전용 접근. 월드와 상호작용할 수 없습니다. |
콘솔을 통해 역할을 할당합니다: role <username> Admin
defaultUserRoles 설정을 사용하여 Config.json에서 기본 역할을 설정할 수도 있습니다.
4. NeosModLoader
NeosModLoader를 사용하면 커뮤니티에서 제작한 모드를 헤드리스 서버에 로드할 수 있습니다.
- GPanel Startup 변수에서 ENABLE_MODLOADER를
true로 설정합니다. - NeosModLoader GitHub에서 모드를 다운로드합니다.
- SFTP를 통해 모드
.dll파일을nml_mods/디렉터리에 업로드합니다. - 모드를 로드하려면 서버를 재시작합니다.
모드 호환성: 모든 모드가 헤드리스 클라이언트와 호환되는 것은 아닙니다. 설치하기 전에 각 모드의 문서를 확인하여 헤드리스 지원 여부를 확인하세요.
5. 문제 해결
서버가 시작되지 않음
- STEAM_USER와 STEAM_PASS가 올바른지 확인합니다.
- SRCDS_BETAPASS(헤드리스 베타 비밀번호)가 Neos Patreon Discord의 최신 정보로 업데이트되어 있는지 확인합니다.
- Steam Guard 2FA를 사용하는 경우 STEAM_AUTH에 코드를 입력하고 즉시 재시작합니다.
월드가 로드되지 않음
Config.json이 유효한 JSON인지 확인합니다 (후행 쉼표 없음, 올바른 괄호).Config/Config.json에서loginCredential과loginPassword가 올바르게 설정되어 있는지 확인합니다.- 월드 URL 또는 프리셋 이름이 유효한지 확인합니다.
사용자가 참여할 수 없음
- 의도한 경우가 아니라면
accessLevel이Private으로 설정되어 있지 않은지 확인합니다. maxUsers에 도달하지 않았는지 확인합니다.- 헤드리스가 로그인되어 있는지 확인합니다 (콘솔 출력에서 로그인 확인).
관련 문서
도움이 필요하신가요?
여기에서 다루지 않은 NeosVR 서버 문제가 발생하면 지원 티켓을 개설하고 서버 IP, 문제 설명, GPanel 콘솔의 관련 오류 메시지를 포함해 주세요.
