Ten przewodnik obejmuje komendy konsoli headless, zarządzanie światami, role użytkowników, NeosModLoader oraz rozwiązywanie problemów dla Twojego dedykowanego serwera NeosVR. NeosVR to społecznościowy metawers VR z potężnymi narzędziami do tworzenia. Aby zapoznać się z początkową konfiguracją, ustawieniami Config.json oraz instrukcjami połączenia, zobacz Przewodnik konfiguracji serwera NeosVR.
1. Dostęp do konsoli
Zarządzaj swoim serwerem headless NeosVR poprzez zakładkę Console w GPanel. Wszystkie komendy wpisuje się bezpośrednio do konsoli.
2. Komendy konsoli headless
Zarządzanie światami
| Komenda | Opis |
|---|---|
worlds | Wyświetla listę wszystkich działających światów z ich indeksami. |
focus <world_index> | Przełącza fokus na konkretny świat według indeksu. |
startWorldURL <record_url> | Uruchamia nowy świat z adresu URL rekordu Neos. |
startWorldTemplate <template> | Uruchamia świat z wbudowanego szablonu (np. SpaceWorld). |
save | Zapisuje aktualnie sfokusowany świat. |
close | Zamyka aktualnie sfokusowany świat. |
restart | Ponownie uruchamia aktualnie sfokusowany świat. |
Zarządzanie sesjami
| Komenda | Opis |
|---|---|
sessionURL | Wyświetla adres URL sesji sfokusowanego świata. |
sessionID | Wyświetla ID sesji sfokusowanego świata. |
name <new_name> | Zmienia nazwę sesji sfokusowanego świata. |
accessLevel <level> | Zmienia poziom dostępu: Anyone, RegisteredUsers, ContactsPlus, Contacts, Private. |
maxUsers <count> | Ustawia maksymalną liczbę użytkowników w sesji. |
hideFromListing <true/false> | Przełącza widoczność w publicznej przeglądarce sesji. |
description <text> | Ustawia opis sesji. |
Zarządzanie użytkownikami
| Komenda | Opis |
|---|---|
users | Wyświetla listę wszystkich użytkowników w sfokusowanym świecie. |
kick <username> | Wyrzuca użytkownika ze świata. |
ban <username> | Banuje użytkownika ze świata. |
silence <username> | Wycisza użytkownika (wyłącza jego głos). |
unsilence <username> | Wyłącza wyciszenie wcześniej wyciszonego użytkownika. |
respawn <username> | Odradza użytkownika w punkcie odrodzenia świata. |
role <username> <role> | Przypisuje rolę użytkownikowi (zobacz Sekcja 3). |
Kontrola serwera
| Komenda | Opis |
|---|---|
status | Wyświetla status serwera i zużycie zasobów. |
shutdown | Bezpiecznie wyłącza serwer headless. |
gc | Wymusza odśmiecanie pamięci, aby ją zwolnić. |
tickRate <rate> | Zmienia tick rate serwera w czasie działania. |
3. Role użytkowników
NeosVR używa hierarchii ról dla uprawnień w świecie:
| Rola | Opis |
|---|---|
Admin | Pełna kontrola nad światem. Może modyfikować wszystko, zarządzać użytkownikami i zmieniać ustawienia świata. |
Builder | Może tworzyć i edytować obiekty w świecie. |
Moderator | Może wyrzucać/banować użytkowników i zarządzać ustawieniami sesji. |
Guest | Podstawowy dostęp. Może wchodzić w interakcje z istniejącymi obiektami, ale nie może budować. |
Spectator | Dostęp tylko do podglądu. Nie może wchodzić w interakcje ze światem. |
Przypisz role przez konsolę: role <username> Admin
Możesz również ustawić domyślne role w Config.json, używając ustawienia defaultUserRoles.
4. NeosModLoader
NeosModLoader umożliwia ładowanie modów stworzonych przez społeczność do serwera headless.
- Ustaw ENABLE_MODLOADER na
truew zmiennych Startup w GPanel. - Pobierz mody z GitHub NeosModLoader.
- Prześlij pliki modów
.dlldo katalogunml_mods/przez SFTP. - Uruchom ponownie serwer, aby załadować mody.
5. Rozwiązywanie problemów
Serwer się nie uruchamia
- Sprawdź, czy Twoje STEAM_USER i STEAM_PASS są poprawne.
- Upewnij się, że SRCDS_BETAPASS (hasło beta headless) jest aktualne z Discorda Neos Patreon.
- Jeśli używasz uwierzytelniania dwuskładnikowego Steam Guard, podaj kod w STEAM_AUTH i niezwłocznie uruchom ponownie.
Świat się nie ładuje
- Sprawdź, czy
Config.jsonjest prawidłowym plikiem JSON (bez końcowych przecinków, prawidłowe nawiasy). - Sprawdź, czy
loginCredentialiloginPasswordsą poprawnie ustawione wConfig/Config.json. - Upewnij się, że adres URL świata lub nazwa presetu są prawidłowe.
Użytkownicy nie mogą dołączyć
- Sprawdź, czy
accessLevelnie jest ustawiony naPrivate, chyba że jest to zamierzone. - Sprawdź, czy nie osiągnięto limitu
maxUsers. - Upewnij się, że serwer headless jest zalogowany (sprawdź dane wyjściowe konsoli pod kątem potwierdzenia logowania).
Powiązane artykuły
- Przewodnik konfiguracji serwera NeosVR
- Jak znaleźć IP i port swojego serwera
- Jak przesyłać pliki przez SFTP
Potrzebujesz pomocy?
Jeśli napotkasz problemy z serwerem NeosVR, które nie zostały tu omówione, otwórz zgłoszenie do pomocy technicznej i dołącz IP swojego serwera, opis problemu oraz wszelkie istotne komunikaty o błędach z konsoli GPanel.
