Това ръководство обхваща headless конзолни команди, управление на сесии, настройка на mod loader и отстраняване на проблеми за вашия Resonite сървър. За първоначална настройка, вижте Ръководство за настройка на Resonite headless сървър.
1. Команди на headless конзолата
Resonite headless сървърът приема команди чрез 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. Mod Loader
Resonite поддържа модове чрез ResoniteModLoader. За активиране:
- Задайте
ENABLE_MODLOADERнаtrueв раздела Startup. - Преинсталирайте или рестартирайте сървъра -- DLL файловете на mod loader-а ще бъдат изтеглени автоматично.
- Поставете DLL файловете на модовете в директорията
rml_mods/чрез SFTP. - Рестартирайте сървъра, за да заредите модовете.
Файлове на mod loader:
Libraries/ResoniteModLoader.dll-- Основният mod loader.rml_libs/0Harmony.dll-- Необходима зависимост.rml_mods/-- Поставете DLL файловете на вашите модове тук.
6. Отстраняване на проблеми
- Сървърът не стартира: Проверете дали данните за вход в
Config.jsonса правилни. Headless трябва да се удостовери с валиден Resonite акаунт. - Светът не се появява в браузъра: Проверете дали
hideFromPublicListingне е зададено наtrue. Уверете се, чеaccessLevelпозволява на търсещите потребители. - "World running..." не се появява: Проверете за грешки в конзолата. Името на предварително зададения свят може да е неправилно.
- Модовете не се зареждат: Проверете дали
ENABLE_MODLOADERеtrueи дали DLL файловете на модовете са вrml_mods/. Проверете конзолата за грешки на mod loader-а. - Високо използване на ресурси: Намалете
tickRateвConfig.jsonили намалетеmaxConcurrentAssetTransfers. Сложното потребителско съдържание може да изисква много ресурси.
Свързани статии
- Ръководство за настройка на Resonite headless сървър
- Как да намерите IP адреса и порта на вашия сървър
- Как да качвате файлове чрез SFTP
Имате нужда от помощ?
Ако имате нужда от допълнителна помощ, отворете тикет за поддръжка с данните на вашия сървър и всички съобщения за грешки от GPanel конзолата.
