Това ръководство обхваща headless конзолни команди, управление на светове, потребителски роли, NeosModLoader и отстраняване на неизправности за вашия dedicated сървър NeosVR. NeosVR е социална VR метавселена с мощни инструменти за създаване. За първоначална настройка, конфигуриране на Config.json и инструкции за свързване вижте Ръководство за настройка на NeosVR сървър.
1. Достъп до конзолата
Управлявайте вашия NeosVR headless сървър чрез раздела Console в GPanel. Всички команди се въвеждат директно в конзолата.
2. Headless конзолни команди
Управление на светове
| Команда | Описание |
|---|---|
worlds | Изброява всички работещи светове с техните индекси. |
focus <world_index> | Превключва фокуса към конкретен свят по индекс. |
startWorldURL <record_url> | Стартира нов свят от Neos record URL. |
startWorldTemplate <template> | Стартира свят от вграден шаблон (напр. SpaceWorld). |
save | Запазва текущо фокусирания свят. |
close | Затваря текущо фокусирания свят. |
restart | Рестартира текущо фокусирания свят. |
Управление на сесии
| Команда | Описание |
|---|---|
sessionURL | Показва session URL за фокусирания свят. |
sessionID | Показва session ID за фокусирания свят. |
name <new_name> | Сменя името на сесията на фокусирания свят. |
accessLevel <level> | Сменя нивото на достъп: Anyone, RegisteredUsers, ContactsPlus, Contacts, Private. |
maxUsers <count> | Задава максималния брой потребители за сесията. |
hideFromListing <true/false> | Превключва видимостта в публичния session browser. |
description <text> | Задава описанието на сесията. |
Управление на потребители
| Команда | Описание |
|---|---|
users | Изброява всички потребители във фокусирания свят. |
kick <username> | Изритва потребител от света. |
ban <username> | Банира потребител от света. |
silence <username> | Заглушава потребител (изключва гласа му). |
unsilence <username> | Отзаглушава предварително заглушен потребител. |
respawn <username> | Преражда потребител на spawn точката на света. |
role <username> <role> | Назначава роля на потребител (вижте Раздел 3). |
Контрол на сървъра
| Команда | Описание |
|---|---|
status | Показва състоянието на сървъра и използването на ресурсите. |
shutdown | Изключва коректно headless сървъра. |
gc | Принудително garbage collection за освобождаване на памет. |
tickRate <rate> | Сменя tick rate на сървъра по време на изпълнение. |
3. Потребителски роли
NeosVR използва йерархия от роли за разрешенията в света:
| Роля | Описание |
|---|---|
Admin | Пълен контрол над света. Може да модифицира всичко, да управлява потребители и да сменя настройките на света. |
Builder | Може да създава и редактира обекти в света. |
Moderator | Може да изритва/банира потребители и да управлява настройките на сесията. |
Guest | Основен достъп. Може да взаимодейства със съществуващи обекти, но не може да строи. |
Spectator | Достъп само за гледане. Не може да взаимодейства със света. |
Назначете роли чрез конзолата: role <username> Admin
Можете също така да зададете роли по подразбиране в Config.json, използвайки настройката defaultUserRoles.
4. NeosModLoader
NeosModLoader позволява зареждане на мoдове, създадени от общността, в headless сървъра.
- Задайте ENABLE_MODLOADER на
trueв стартиращите променливи на GPanel Startup. - Изтеглете мoдове от NeosModLoader GitHub.
- Качете
.dllфайловете на мoдовете в директориятаnml_mods/чрез SFTP. - Рестартирайте сървъра, за да заредите мoдовете.
5. Отстраняване на неизправности
Сървърът не стартира
- Проверете дали вашите STEAM_USER и STEAM_PASS са правилни.
- Уверете се, че SRCDS_BETAPASS (headless beta password) е актуален от Neos Patreon Discord.
- Ако използвате Steam Guard 2FA, предоставете кода в STEAM_AUTH и рестартирайте бързо.
Светът не зарежда
- Проверете дали
Config.jsonе валиден JSON (без trailing запетаи, правилни скоби). - Проверете дали
loginCredentialиloginPasswordса зададени правилно вConfig/Config.json. - Уверете се, че URL на света или името на пресета е валидно.
Потребителите не могат да се присъединят
- Проверете дали
accessLevelне е зададено наPrivate, освен ако не е по замисъл. - Проверете дали
maxUsersне е достигнато. - Уверете се, че headless е влязъл (проверете изхода на конзолата за потвърждение за вход).
Свързани статии
- Ръководство за настройка на NeosVR сървър
- Как да намерите IP и порт на вашия сървър
- Как да качвате файлове чрез SFTP
Нуждаете се от помощ?
Ако срещнете проблеми с вашия NeosVR сървър, които не са обхванати тук, отворете тикет за поддръжка и включете IP на вашия сървър, описание на проблема и всички относими съобщения за грешки от GPanel конзолата.
