Dieses Handbuch behandelt Headless-Konsolenbefehle, Sitzungsverwaltung, Mod-Loader-Einrichtung und Fehlerbehebung für Ihren Resonite-Server. Für die Ersteinrichtung siehe Resonite Headless Server-Einrichtungsanleitung.
1. Headless-Konsolenbefehle
Der Resonite Headless-Server akzeptiert Befehle über die GPanel-Konsole. Der Server reagiert auf den Befehl shutdown für ein ordnungsgemäßes Herunterfahren.
| Befehl | Beschreibung |
|---|---|
worlds |
Alle aktiven Weltsitzungen auflisten. |
focus <world_index> |
Eine bestimmte Welt für Befehle fokussieren. |
status |
Status der fokussierten Welt anzeigen. |
users |
Benutzer in der fokussierten Welt auflisten. |
kick <username> |
Einen Benutzer aus der fokussierten Welt entfernen. |
ban <username> |
Einen Benutzer aus der fokussierten Welt sperren. |
silence <username> |
Einen Benutzer in der fokussierten Welt stummschalten. |
unsilence <username> |
Stummschaltung eines Benutzers aufheben. |
respawn <username> |
Einen Benutzer zum Weltursprung respawnen. |
role <username> <role> |
Rolle eines Benutzers festlegen (Admin, Builder, Moderator, Guest, Spectator). |
name <session_name> |
Die fokussierte Sitzung umbenennen. |
accessLevel <level> |
Ändern, wer beitreten kann (Anyone, RegisteredUsers, Contacts, ContactsPlus, Private). |
maxUsers <count> |
Maximale Benutzeranzahl für die fokussierte Welt ändern. |
save |
Die fokussierte Welt speichern. |
close |
Die fokussierte Welt schließen. |
restart |
Die fokussierte Welt neu starten. |
invite <username> |
Einen Benutzer in die fokussierte Welt einladen. |
message <text> |
Eine Nachricht an die fokussierte Welt senden. |
shutdown |
Den gesamten Headless-Server ordnungsgemäß herunterfahren. |
2. Zugangsstufen
Steuern Sie mit der Einstellung accessLevel, wer Ihren Weltsitzungen beitreten kann:
| Stufe | Beschreibung |
|---|---|
| Anyone | Offen für alle Resonite-Benutzer. |
| RegisteredUsers | Nur registrierte Resonite-Konten. |
| Contacts | Nur Benutzer auf der Kontaktliste des Headless-Kontos. |
| ContactsPlus | Kontakte und Kontakte von Kontakten. |
| Private | Nur auf Einladung. |
3. Benutzerrollen
Weisen Sie Rollen zu, um zu steuern, was Benutzer in Ihrer Welt tun können:
| Rolle | Beschreibung |
|---|---|
| Admin | Volle Kontrolle über die Welt. |
| Builder | Kann Objekte bauen und verändern. |
| Moderator | Kann Benutzer kicken/sperren und den Chat moderieren. |
| Guest | Standard-Benutzerzugang. |
| Spectator | Kann beobachten, aber nicht interagieren. |
Legen Sie Standardrollen in Config.json mit defaultUserRoles fest oder weisen Sie sie pro Benutzer mit dem Konsolenbefehl role zu.
4. Mehrere Welten
Der Headless-Server kann mehrere Welten gleichzeitig hosten. Fügen Sie zusätzliche Einträge zum Array startWorlds in Headless/Config/Config.json hinzu:
"startWorlds": [
{
"isEnabled": true,
"sessionName": "World 1",
"maxUsers": 16,
"accessLevel": "Anyone",
"loadWorldPresetName": "SpaceWorld"
},
{
"isEnabled": true,
"sessionName": "World 2",
"maxUsers": 8,
"accessLevel": "Contacts",
"loadWorldPresetName": "Grid"
}
]Verwenden Sie focus 0 und focus 1 in der Konsole, um zwischen den Welten zu wechseln.
5. Mod-Loader
Resonite unterstützt Mods über den ResoniteModLoader. Zum Aktivieren:
- Setzen Sie
ENABLE_MODLOADERauftrueim Startup-Tab. - Installieren Sie den Server neu oder starten Sie ihn neu -- die Mod-Loader-DLLs werden automatisch heruntergeladen.
- Platzieren Sie Mod-DLLs im Verzeichnis
rml_mods/per SFTP. - Starten Sie den Server neu, um die Mods zu laden.
Mod-Loader-Dateien:
Libraries/ResoniteModLoader.dll-- Der Haupt-Mod-Loader.rml_libs/0Harmony.dll-- Erforderliche Abhängigkeit.rml_mods/-- Platzieren Sie hier Ihre Mod-DLLs.
6. Fehlerbehebung
- Server startet nicht: Überprüfen Sie, ob die Anmeldedaten in
Config.jsonkorrekt sind. Der Headless-Server muss sich mit einem gültigen Resonite-Konto authentifizieren. - Welt erscheint nicht im Browser: Prüfen Sie, ob
hideFromPublicListingnicht auftruegesetzt ist. Stellen Sie sicher, dassaccessLeveldie suchenden Benutzer zulässt. - "World running..." erscheint nicht: Überprüfen Sie die Konsole auf Fehler. Der Name des Welt-Presets könnte falsch sein.
- Mods werden nicht geladen: Überprüfen Sie, ob
ENABLE_MODLOADERauftruegesetzt ist und die Mod-DLLs sich inrml_mods/befinden. Prüfen Sie die Konsole auf Mod-Loader-Fehler. - Hohe Ressourcenauslastung: Reduzieren Sie
tickRateinConfig.jsonoder verringern SiemaxConcurrentAssetTransfers. Komplexe benutzererstellte Inhalte können ressourcenintensiv sein.
Verwandte Artikel
- Resonite Headless Server-Einrichtungsanleitung
- So finden Sie Ihre Server-IP und den Port
- Dateien per SFTP hochladen
Brauchen Sie Hilfe?
Wenn Sie weitere Unterstützung benötigen, eröffnen Sie ein Support-Ticket mit Ihren Serverdetails und eventuellen Fehlermeldungen aus der GPanel-Konsole.
