Diese Anleitung behandelt Headless-Konsolenbefehle, Weltverwaltung, Benutzerrollen, den NeosModLoader und Fehlerbehebung für Ihren NeosVR Dedicated Server. NeosVR ist ein soziales VR-Metaverse mit leistungsstarken Erstellungswerkzeugen. Für die Ersteinrichtung, Config.json-Konfiguration und Verbindungsanweisungen siehe NeosVR Server-Einrichtungsanleitung.
1. Zugriff auf die Konsole
Verwalten Sie Ihren NeosVR Headless-Server über den Tab Console in GPanel. Alle Befehle werden direkt in die Konsole eingegeben.
2. Headless-Konsolenbefehle
Weltverwaltung
| Befehl | Beschreibung |
|---|---|
worlds | Alle laufenden Welten mit ihren Indizes auflisten. |
focus <world_index> | Fokus auf eine bestimmte Welt nach Index wechseln. |
startWorldURL <record_url> | Eine neue Welt aus einer Neos-Datensatz-URL starten. |
startWorldTemplate <template> | Eine Welt aus einer integrierten Vorlage starten (z.B. SpaceWorld). |
save | Die aktuell fokussierte Welt speichern. |
close | Die aktuell fokussierte Welt schließen. |
restart | Die aktuell fokussierte Welt neu starten. |
Sitzungsverwaltung
| Befehl | Beschreibung |
|---|---|
sessionURL | Die Sitzungs-URL für die fokussierte Welt anzeigen. |
sessionID | Die Sitzungs-ID für die fokussierte Welt anzeigen. |
name <new_name> | Den Sitzungsnamen der fokussierten Welt ändern. |
accessLevel <level> | Zugangsstufe ändern: Anyone, RegisteredUsers, ContactsPlus, Contacts, Private. |
maxUsers <count> | Die maximale Benutzeranzahl für die Sitzung festlegen. |
hideFromListing <true/false> | Sichtbarkeit im öffentlichen Sitzungsbrowser umschalten. |
description <text> | Die Sitzungsbeschreibung festlegen. |
Benutzerverwaltung
| Befehl | Beschreibung |
|---|---|
users | Alle Benutzer in der fokussierten Welt auflisten. |
kick <username> | Einen Benutzer aus der Welt entfernen. |
ban <username> | Einen Benutzer aus der Welt bannen. |
silence <username> | Einen Benutzer stummschalten (Stimme deaktivieren). |
unsilence <username> | Einen zuvor stummgeschalteten Benutzer wieder aktivieren. |
respawn <username> | Einen Benutzer am Spawnpunkt der Welt respawnen. |
role <username> <role> | Einem Benutzer eine Rolle zuweisen (siehe Abschnitt 3). |
Serversteuerung
| Befehl | Beschreibung |
|---|---|
status | Serverstatus und Ressourcenverbrauch anzeigen. |
shutdown | Den Headless-Server ordnungsgemäß herunterfahren. |
gc | Garbage Collection erzwingen, um Speicher freizugeben. |
tickRate <rate> | Die Server-Tickrate zur Laufzeit ändern. |
3. Benutzerrollen
NeosVR verwendet eine Rollenhierarchie für Weltberechtigungen:
| Rolle | Beschreibung |
|---|---|
Admin | Volle Weltkontrolle. Kann alles ändern, Benutzer verwalten und Welteinstellungen anpassen. |
Builder | Kann Objekte in der Welt erstellen und bearbeiten. |
Moderator | Kann Benutzer kicken/bannen und Sitzungseinstellungen verwalten. |
Guest | Basiszugang. Kann mit vorhandenen Objekten interagieren, aber nicht bauen. |
Spectator | Nur-Ansicht-Zugang. Kann nicht mit der Welt interagieren. |
Rollen über die Konsole zuweisen: role <username> Admin
Sie können auch Standardrollen in Config.json über die Einstellung defaultUserRoles festlegen.
4. NeosModLoader
NeosModLoader ermöglicht das Laden von Community-erstellten Mods in den Headless-Server.
- Setzen Sie ENABLE_MODLOADER auf
truein den GPanel Startup-Variablen. - Laden Sie Mods vom NeosModLoader GitHub herunter.
- Laden Sie Mod-
.dll-Dateien über SFTP in das Verzeichnisnml_mods/hoch. - Starten Sie den Server neu, um die Mods zu laden.
5. Fehlerbehebung
Server startet nicht
- Überprüfen Sie, ob Ihre STEAM_USER- und STEAM_PASS-Daten korrekt sind.
- Stellen Sie sicher, dass das SRCDS_BETAPASS (Headless-Beta-Passwort) aus dem Neos Patreon Discord aktuell ist.
- Wenn Sie Steam Guard 2FA verwenden, geben Sie den Code in STEAM_AUTH ein und starten Sie umgehend neu.
Welt lädt nicht
- Überprüfen Sie, ob
Config.jsongültiges JSON ist (keine nachgestellten Kommas, korrekte Klammern). - Stellen Sie sicher, dass
loginCredentialundloginPasswordinConfig/Config.jsonkorrekt gesetzt sind. - Stellen Sie sicher, dass die Welt-URL oder der Vorlagenname gültig ist.
Benutzer können nicht beitreten
- Überprüfen Sie, ob
accessLevelnicht aufPrivategesetzt ist, es sei denn, dies ist beabsichtigt. - Stellen Sie sicher, dass
maxUsersnicht erreicht wurde. - Stellen Sie sicher, dass der Headless-Client angemeldet ist (überprüfen Sie die Konsolenausgabe auf eine Anmeldebestätigung).
Verwandte Artikel
- NeosVR Server-Einrichtungsanleitung
- So finden Sie Ihre Server-IP und Port
- Dateien über SFTP hochladen
Brauchen Sie Hilfe?
Wenn Sie Probleme mit Ihrem NeosVR-Server haben, die hier nicht behandelt werden, erstellen Sie ein Support-Ticket und geben Sie Ihre Server-IP, eine Beschreibung des Problems und relevante Fehlermeldungen aus der GPanel-Konsole an.
