Ten przewodnik obejmuje komendy konsoli headless, zarządzanie sesjami, konfigurację mod loadera oraz rozwiązywanie problemów dla Twojego serwera Resonite. Informacje o początkowej konfiguracji znajdziesz w artykule Przewodnik konfiguracji serwera headless Resonite.
1. Komendy konsoli headless
Serwer headless Resonite przyjmuje komendy za pośrednictwem konsoli GPanel. Serwer reaguje na komendę shutdown w celu poprawnego zamknięcia.
| Komenda | Opis |
|---|---|
worlds |
Wyświetla listę wszystkich aktywnych sesji świata. |
focus <world_index> |
Skoncentruj się na określonym świecie do wydawania komend. |
status |
Pokaż status wybranego świata. |
users |
Wyświetl listę użytkowników w wybranym świecie. |
kick <username> |
Wyrzuć użytkownika z wybranego świata. |
ban <username> |
Zbanuj użytkownika w wybranym świecie. |
silence <username> |
Wycisz użytkownika w wybranym świecie. |
unsilence <username> |
Wyłącz wyciszenie użytkownika. |
respawn <username> |
Odrodź użytkownika w punkcie początkowym świata. |
role <username> <role> |
Ustaw rolę użytkownika (Admin, Builder, Moderator, Guest, Spectator). |
name <session_name> |
Zmień nazwę wybranej sesji. |
accessLevel <level> |
Zmień, kto może dołączyć (Anyone, RegisteredUsers, Contacts, ContactsPlus, Private). |
maxUsers <count> |
Zmień maksymalną liczbę użytkowników dla wybranego świata. |
save |
Zapisz wybrany świat. |
close |
Zamknij wybrany świat. |
restart |
Zrestartuj wybrany świat. |
invite <username> |
Zaproś użytkownika do wybranego świata. |
message <text> |
Wyślij wiadomość do wybranego świata. |
shutdown |
Poprawnie zamknij cały serwer headless. |
2. Poziomy dostępu
Kontroluj, kto może dołączyć do Twoich sesji świata za pomocą ustawienia accessLevel:
| Poziom | Opis |
|---|---|
| Anyone | Otwarte dla wszystkich użytkowników Resonite. |
| RegisteredUsers | Tylko zarejestrowane konta Resonite. |
| Contacts | Tylko użytkownicy z listy kontaktów konta headless. |
| ContactsPlus | Kontakty oraz kontakty kontaktów. |
| Private | Tylko na zaproszenie. |
3. Role użytkowników
Przypisuj role, aby kontrolować, co użytkownicy mogą robić w Twoim świecie:
| Rola | Opis |
|---|---|
| Admin | Pełna kontrola nad światem. |
| Builder | Może budować i modyfikować obiekty. |
| Moderator | Może wyrzucać/banować użytkowników i moderować czat. |
| Guest | Standardowy dostęp użytkownika. |
| Spectator | Może obserwować, ale nie wchodzić w interakcje. |
Ustaw domyślne role w Config.json za pomocą defaultUserRoles lub przypisz je poszczególnym użytkownikom za pomocą komendy konsoli role.
4. Wiele światów
Serwer headless może hostować wiele światów jednocześnie. Dodaj kolejne wpisy do tablicy startWorlds w pliku 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"
}
]Użyj focus 0 i focus 1 w konsoli, aby przełączać się między światami.
5. Mod Loader
Resonite obsługuje mody za pośrednictwem ResoniteModLoader. Aby włączyć:
- Ustaw
ENABLE_MODLOADERnatruena karcie Startup. - Zainstaluj ponownie lub zrestartuj serwer — biblioteki DLL mod loadera zostaną pobrane automatycznie.
- Umieść pliki DLL modów w katalogu
rml_mods/za pośrednictwem SFTP. - Zrestartuj serwer, aby załadować mody.
Pliki mod loadera:
Libraries/ResoniteModLoader.dll— Główny mod loader.rml_libs/0Harmony.dll— Wymagana zależność.rml_mods/— Umieść tutaj swoje pliki DLL modów.
6. Rozwiązywanie problemów
- Serwer się nie uruchamia: Sprawdź, czy dane logowania w
Config.jsonsą poprawne. Headless musi uwierzytelnić się za pomocą ważnego konta Resonite. - Świat nie pojawia się w przeglądarce: Sprawdź, czy
hideFromPublicListingnie jest ustawione natrue. Upewnij się, żeaccessLevelzezwala wyszukującym użytkownikom. - Nie pojawia się "World running...": Sprawdź, czy w konsoli nie ma błędów. Nazwa presetu świata może być nieprawidłowa.
- Mody się nie ładują: Sprawdź, czy
ENABLE_MODLOADERma wartośćtruei czy pliki DLL modów znajdują się wrml_mods/. Sprawdź konsolę pod kątem błędów mod loadera. - Wysokie zużycie zasobów: Zmniejsz
tickRatewConfig.jsonlub obniżmaxConcurrentAssetTransfers. Złożone treści tworzone przez użytkowników mogą być zasobożerne.
Powiązane artykuły
- Przewodnik konfiguracji serwera headless Resonite
- Jak znaleźć adres IP i port serwera
- Jak przesyłać pliki przez SFTP
Potrzebujesz pomocy?
Jeśli potrzebujesz dalszej pomocy, otwórz zgłoszenie do pomocy technicznej wraz ze szczegółami serwera oraz wszelkimi komunikatami o błędach z konsoli GPanel.
