Это руководство охватывает консольные команды headless-сервера, управление мирами, роли пользователей, NeosModLoader и устранение неполадок для вашего выделенного сервера NeosVR. NeosVR — это социальная VR-метавселенная с мощными инструментами создания. Для первоначальной настройки, конфигурации Config.json и инструкций по подключению см. Руководство по настройке сервера NeosVR.
1. Доступ к консоли
Управляйте вашим headless-сервером NeosVR через вкладку Console в GPanel. Все команды вводятся непосредственно в консоль.
2. Консольные команды headless-сервера
Управление мирами
| Команда | Описание |
|---|---|
worlds | Вывести список всех запущенных миров с их индексами. |
focus <world_index> | Переключить фокус на конкретный мир по индексу. |
startWorldURL <record_url> | Запустить новый мир из URL записи Neos. |
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 | Корректно завершить работу headless-сервера. |
gc | Принудительно запустить сборку мусора для освобождения памяти. |
tickRate <rate> | Изменить частоту тиков сервера во время работы. |
3. Роли пользователей
NeosVR использует иерархию ролей для прав в мире:
| Роль | Описание |
|---|---|
Admin | Полный контроль над миром. Может изменять что угодно, управлять пользователями и менять настройки мира. |
Builder | Может создавать и редактировать объекты в мире. |
Moderator | Может кикать/банить пользователей и управлять настройками сессии. |
Guest | Базовый доступ. Может взаимодействовать с существующими объектами, но не может строить. |
Spectator | Доступ только для просмотра. Не может взаимодействовать с миром. |
Назначайте роли через консоль: role <username> Admin
Вы также можете задать роли по умолчанию в Config.json, используя настройку defaultUserRoles.
4. NeosModLoader
NeosModLoader позволяет загружать созданные сообществом моды в headless-сервер.
- Установите ENABLE_MODLOADER в
trueв стартовых переменных Startup в GPanel. - Скачайте моды с GitHub NeosModLoader.
- Загрузите файлы модов
.dllв каталогnml_mods/через SFTP. - Перезапустите сервер для загрузки модов.
5. Устранение неполадок
Сервер не запускается
- Убедитесь, что ваши STEAM_USER и STEAM_PASS верны.
- Убедитесь, что SRCDS_BETAPASS (пароль headless-беты) актуален и взят из Discord Neos Patreon.
- Если используется двухфакторная аутентификация Steam Guard, укажите код в STEAM_AUTH и сразу перезапустите.
Мир не загружается
- Проверьте, что
Config.jsonявляется корректным JSON (без замыкающих запятых, с правильными скобками). - Убедитесь, что
loginCredentialиloginPasswordправильно заданы вConfig/Config.json. - Убедитесь, что URL мира или имя пресета корректны.
Пользователи не могут присоединиться
- Проверьте, что
accessLevelне установлен вPrivate, если это не задумано. - Убедитесь, что
maxUsersне достигнут. - Убедитесь, что headless вошёл в систему (проверьте вывод консоли на подтверждение входа).
Связанные статьи
- Руководство по настройке сервера NeosVR
- Как найти IP и порт вашего сервера
- Как загружать файлы через SFTP
Нужна помощь?
Если вы столкнулись с проблемами на вашем сервере NeosVR, которые не описаны здесь, создайте тикет в поддержку и укажите IP вашего сервера, описание проблемы и любые соответствующие сообщения об ошибках из консоли GPanel.
