Цей посібник охоплює команди консолі 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.