В этом руководстве рассматриваются команды консоли headless, управление сессиями, настройка загрузчика модов и устранение неполадок для вашего сервера Resonite. Для первоначальной настройки см. статью Руководство по настройке headless-сервера Resonite.
1. Команды консоли headless
Headless-сервер 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 |
Корректно завершить работу всего headless-сервера. |
2. Уровни доступа
Контролируйте, кто может присоединяться к вашим сессиям миров, с помощью настройки accessLevel:
| Уровень | Описание |
|---|---|
| Anyone | Открыт для всех пользователей Resonite. |
| RegisteredUsers | Только зарегистрированные аккаунты Resonite. |
| Contacts | Только пользователи из списка контактов аккаунта headless. |
| ContactsPlus | Контакты и контакты контактов. |
| Private | Только по приглашению. |
3. Роли пользователей
Назначайте роли, чтобы контролировать, что пользователи могут делать в вашем мире:
| Роль | Описание |
|---|---|
| Admin | Полный контроль над миром. |
| Builder | Может строить и изменять объекты. |
| Moderator | Может исключать/банить пользователей и модерировать чат. |
| Guest | Стандартный доступ пользователя. |
| Spectator | Может наблюдать, но не взаимодействовать. |
Задайте роли по умолчанию в Config.json с помощью defaultUserRoles или назначайте их для каждого пользователя с помощью команды консоли role.
4. Несколько миров
Headless-сервер может размещать несколько миров одновременно. Добавьте дополнительные записи в массив startWorlds в файле Headless/Config/Config.json:
"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. Чтобы включить:
- Установите
ENABLE_MODLOADERвtrueна вкладке Startup. - Переустановите или перезапустите сервер — DLL-файлы загрузчика модов будут скачаны автоматически.
- Поместите DLL-файлы модов в каталог
rml_mods/через SFTP. - Перезапустите сервер для загрузки модов.
Файлы загрузчика модов:
Libraries/ResoniteModLoader.dll— Основной загрузчик модов.rml_libs/0Harmony.dll— Обязательная зависимость.rml_mods/— Поместите сюда DLL-файлы ваших модов.
6. Устранение неполадок
- Сервер не запускается: Убедитесь, что учётные данные для входа в
Config.jsonверны. Headless должен аутентифицироваться с действующим аккаунтом Resonite. - Мир не появляется в браузере: Проверьте, что
hideFromPublicListingне установлен вtrue. Убедитесь, чтоaccessLevelразрешает доступ для ищущих пользователей. - Не появляется "World running...": Проверьте наличие ошибок в консоли. Имя предустановки мира может быть неверным.
- Моды не загружаются: Убедитесь, что
ENABLE_MODLOADERустановлен вtrue, а DLL-файлы модов находятся вrml_mods/. Проверьте консоль на наличие ошибок загрузчика модов. - Высокое потребление ресурсов: Уменьшите
tickRateвConfig.jsonили снизьтеmaxConcurrentAssetTransfers. Сложный пользовательский контент может быть ресурсоёмким.
Похожие статьи
- Руководство по настройке headless-сервера Resonite
- Как найти IP-адрес и порт вашего сервера
- Как загружать файлы через SFTP
Нужна помощь?
Если вам нужна дополнительная помощь, создайте тикет в поддержку с данными вашего сервера и любыми сообщениями об ошибках из консоли GPanel.
