Diese Anleitung behandelt die Admin-Einrichtung, In-Game-Admin-Befehle, RCON-Konfiguration und Serververwaltungsbefehle für Ihren Soulmask Dedicated Server bei Legion Hosting. Für Server-Einrichtung und Konfiguration siehe Soulmask Server-Einrichtungsanleitung.
Server-Panel: Die gesamte Serververwaltung erfolgt über GPanel unter gpanel.legionhosting.net. Verwenden Sie den Dateimanager oder SFTP, um Konfigurationsdateien zu bearbeiten.
Admin-Berechtigungen einrichten
Soulmask verwendet ein passwortbasiertes Admin-System. Um Admin zu werden, müssen Sie ein Admin-Passwort in der Server-Startkonfiguration festlegen und sich dann im Spiel authentifizieren.
Schritt 1: Admin-Passwort festlegen
- Wählen Sie in GPanel Ihren Soulmask-Server aus.
- Klicken Sie auf den Startup-Tab.
- Setzen Sie die Variable
ADMIN_PASSWORDauf ein starkes, einzigartiges Passwort. Dies entspricht dem Befehlszeilenparameter-adminpsw. - Starten Sie den Server neu, damit die Änderung wirksam wird.
Halten Sie Ihr Admin-Passwort geheim. Jeder, der das Admin-Passwort kennt, kann volle GM-Berechtigungen auf Ihrem Server erhalten. Teilen Sie es nur mit vertrauenswürdigen Co-Admins.
Schritt 2: Im Spiel authentifizieren
- Treten Sie Ihrem Soulmask-Server als Spieler bei.
- Öffnen Sie die In-Game-Konsole durch Drücken der `-Taste (Gravis/Tilde) oder Numpad - (Nummernblock Minus).
- Geben Sie den folgenden Befehl ein und drücken Sie Enter:
gm key YOUR_ADMIN_PASSWORD - Wenn das Passwort korrekt ist, erhalten Sie eine Bestätigungsmeldung und GM (Game Master) Admin-Berechtigungen.
- Sie können auch die Schaltfläche "Become the admin" klicken, die im GM-Panel-Interface erscheint.
Sitzungsbasierte Authentifizierung. Sie müssen sich jedes Mal neu authentifizieren, wenn Sie dem Server beitreten. Der Admin-Status wird nicht zwischen Sitzungen gespeichert -- Sie müssen
gm key bei jeder Anmeldung erneut ausführen.
In-Game-Admin-Befehle
Sobald Sie als Admin authentifiziert sind, öffnen Sie die Konsole (` oder Numpad -) und geben Sie Befehle ein. Alle Admin-Befehle beginnen mit dem Präfix gm.
Spielerverwaltung
| Befehl | Beschreibung |
|---|---|
gm AddExp [value] |
Allgemeine Erfahrungspunkte zu Ihrem Charakter hinzufügen. |
gm Addmjexp [value] |
Maskenerfahrung zu Ihrem Charakter hinzufügen (leveled die Maske). |
gm Addshoulieexp [value] |
Jagderfahrung zu Ihrem Charakter hinzufügen. |
gm XiDian |
Alle Fähigkeitspunkte Ihres Charakters zurücksetzen, um eine Neuverteilung zu ermöglichen. |
gm FuHuo |
Ihren Charakter wiederbeleben (verwenden, wenn tot). |
gm ZiSha 1 |
Den eigenen Charakter töten (Selbstmord-Befehl). |
gm shanhao |
Ihr Konto/Ihren Charakter vom Server löschen. Mit äußerster Vorsicht verwenden -- dies ist nicht rückgängig zu machen. |
gm ShowInfo 1 |
Detaillierte Informationen über Ihren eigenen Charakter anzeigen (Werte, IDs, Position). |
gm ShowInfo 0 |
Detaillierte Informationen über den aktuell anvisierten Charakter oder NPC anzeigen. |
gm ChongZhiRenWu |
Alle Tutorials und Anleitungsquests für Ihren Charakter zurücksetzen. |
Navigation und Sichtbarkeit
| Befehl | Beschreibung |
|---|---|
gm Go [x] [y] [z] |
Zu bestimmten Weltkoordinaten teleportieren. Verwenden Sie zuerst GPS, um Ihre aktuellen Koordinaten zu ermitteln. |
GPS |
Ihre aktuellen Weltkoordinaten anzeigen (X, Y, Z). Nützlich für Teleportationsziele. |
gm SetAttr YinShen 1 |
Unsichtbarkeit aktivieren. Monster und NPCs können Sie nicht entdecken. |
gm SetAttr YinShen 0 |
Unsichtbarkeit deaktivieren. Zur normalen Sichtbarkeit zurückkehren. |
gm ShowMap |
Die gesamte Karte aufdecken und allen Kriegsnebel für Ihren Charakter entfernen. |
NPC- und Weltsteuerung
| Befehl | Beschreibung |
|---|---|
gm ZhaoMu |
Den anvisierten NPC sofort in Ihren Stamm rekrutieren. |
gm ClearAllNpc |
Alle Nicht-Spieler-NPCs vom Server entfernen. Mit Vorsicht verwenden -- betrifft alle NPCs serverweit. |
gm ClearSelect |
Die aktuell ausgewählte/anvisierte Entität entfernen (NPC, Kreatur oder Objekt). |
gm ShuaXinZhiBei |
Alle nahegelegene Vegetation und erntbare Pflanzen auffrischen und nachwachsen lassen. |
gm KeJiShu |
Alle Technologiebaum-Knoten für Ihren Charakter freischalten. |
Invasions- und Bedrohungsmanagement
| Befehl | Beschreibung |
|---|---|
gm ShowReDu |
Das aktuelle Invasions-Bedrohungsdiagramm anzeigen, das die Bedrohungsstufen in verschiedenen Gebieten zeigt. |
gm ClearAllReDu |
Alle Invasionsbedrohung auf der Karte zurücksetzen und die Bedrohungsstufen auf null setzen. |
gm AddReDu [value] |
Invasionsbedrohung manuell um den angegebenen Wert erhöhen. Höhere Bedrohung zieht mehr Invasionen an. |
Server und Debug
| Befehl | Beschreibung |
|---|---|
gm exit |
Den Server mit Speicherung ordnungsgemäß herunterfahren. Dies ist der sicherste Weg, den Server im Spiel zu stoppen. |
Debuginfo 1 |
Server-Leistungsüberwachungs-Overlay aktivieren, das Tickrate, Entity-Anzahlen und Ressourcenverbrauch anzeigt. |
Debuginfo 0 |
Das Server-Leistungsüberwachungs-Overlay deaktivieren. |
Befehle sparsam verwenden. Admin-Befehle können die Serverstabilität und das Spielerlebnis erheblich beeinflussen. Das Spawnen großer Mengen von Entitäten, das serverweite Entfernen von NPCs oder das schnelle Ändern von Weltdaten kann Verzögerungen oder Abstürze verursachen. Testen Sie Befehle zunächst in Zeiten mit wenigen Spielern.
Serververwaltungsbefehle
Diese Befehle werden für die serverweite Verwaltung verwendet und können sowohl im Spiel (über die Konsole) als auch remote (über RCON/Telnet) ausgeführt werden.
Serversteuerung
| Befehl | Beschreibung |
|---|---|
SaveWorld |
Eine sofortige Weltspeicherung in den Arbeitsspeicher erzwingen (und optional auf die Festplatte). Verwenden Sie dies vor riskanten Operationen. |
SaveAndExit [seconds] |
Die Welt speichern und den Server nach der angegebenen Anzahl von Sekunden herunterfahren. Spieler erhalten einen Warnungs-Countdown. |
StopCloseServer |
Ein ausstehendes Herunterfahren abbrechen, das mit SaveAndExit initiiert wurde. |
shutdown [seconds] |
Ein ordnungsgemäßes Server-Herunterfahren mit dem angegebenen Countdown in Sekunden einleiten. |
broadcast [message] |
Eine globale Nachricht an alle verbundenen Spieler senden. Nützlich für Ankündigungen und Warnungen. |
Spielerverwaltung (Remote)
| Befehl | Beschreibung |
|---|---|
List_AllPlayers |
Alle auf dem Server registrierten Spielerkonten auflisten (online und offline). |
List_OnlinePlayers |
Alle aktuell verbundenen Spieler mit ihren Steam-IDs und Charakternamen auflisten. |
List_Guilds |
Alle Stämme (Gilden) auf dem Server mit Mitgliederanzahl auflisten. |
kick [PlayerName] |
Einen Spieler anhand des Charakternamens vom Server kicken. |
ban [PlayerName] |
Einen Spieler vom Server bannen. Er kann sich nicht mehr erneut verbinden. |
CreateItemForPlayer [SteamID] [ItemID] [Amount] |
Gegenstände direkt zum Inventar eines bestimmten Spielers per Steam-ID hinzufügen. |
GotoPosition [SteamID] [x] [y] [z] |
Einen bestimmten Spieler zu Weltkoordinaten teleportieren. |
FlyMode [SteamID] [0/1] |
Geist-/Flugmodus für einen Spieler aktivieren (1) oder deaktivieren (0). |
Serverinformationen
| Befehl | Beschreibung |
|---|---|
ServerFPS |
Die aktuelle Server-Tickrate (FPS) anzeigen. Gesunde Server sollten 30+ FPS aufrechterhalten. |
Show_Coefficient_Settings |
Alle aktuellen Gameplay-Koeffizienten-Einstellungen aus GameXishu.json auflisten. |
Set_Coefficient [key] [value] |
Einen Gameplay-Koeffizienten zur Laufzeit ändern, ohne Dateien zu bearbeiten. Änderungen werden sofort wirksam. |
List_AllTalent [level] |
Alle natürlichen Gaben (Talente) anzeigen, die auf der angegebenen Stufe verfügbar sind. |
Debug und Erweitert
| Befehl | Beschreibung |
|---|---|
Dump_AllActorPositions |
Alle Aktor-Positionen zur Fehlerdiagnose des Weltzustands in eine Datendatei exportieren. |
DrawActorImage |
Eine Visualisierung der Aktor-Positionen auf der Karte generieren. |
ExecScriptCommands [filename] |
Eine Batch-Datei mit Befehlen ausführen. Nützlich für die gleichzeitige Ausführung mehrerer Befehle. |
RCON-Zugang
RCON (Remote Console) ermöglicht es Ihnen, Serverbefehle remote auszuführen, ohne mit dem Spiel verbunden zu sein. Soulmask unterstützt sowohl RCON als auch Telnet für die Remote-Administration.
RCON aktivieren
RCON ist standardmäßig deaktiviert und muss über Startparameter aktiviert werden:
- Gehen Sie in GPanel zum Startup-Tab.
- Fügen Sie die folgenden Parameter hinzu (über zusätzliche Startparameter oder indem Sie den Support kontaktieren, um sie hinzufügen zu lassen):
-rconpsw="YOUR_RCON_PASSWORD" -rconport=19000 - Starten Sie den Server neu.
RCON-Sicherheit. Die RCON-Implementierung von Soulmask verwendet eine IP-Whitelist zur Sicherheit. Nur IP-Adressen auf der Whitelist können sich mit dem RCON-Dienst verbinden. Prüfen Sie die Server-Dokumentation oder Konfigurationsdateien für den Whitelist-Speicherort, wenn Sie Ihre IP hinzufügen müssen.
Über RCON verbinden
Sobald RCON aktiviert ist, können Sie sich mit jedem Standard-RCON-Client verbinden:
- Laden Sie einen RCON-Client herunter, z.B. rcon-cli oder ein GUI-Tool wie mcrcon.
- Verbinden Sie sich mit Ihrem Server unter Verwendung von:
- Host: Die IP-Adresse Ihres Servers
- Port: Der RCON-Port (Standard
19000) - Passwort: Das RCON-Passwort, das Sie mit
-rconpswfestgelegt haben
- Sobald verbunden, geben Sie
helpein, um eine Liste der verfügbaren Befehle zu sehen.
Telnet-Zugang
Soulmask unterstützt auch Telnet-basierte Administration über den Echo-Port (Standard 18888). Telnet ist standardmäßig auf lokale Verbindungen beschränkt und erfordert keine zusätzliche Portweiterleitung. Dies wird hauptsächlich für skriptgesteuerte Administration auf der Servermaschine selbst verwendet.
Beispiel-RCON-Sitzung
# Connect to RCON (using rcon-cli as example)
rcon -a your.server.ip:19000 -p YOUR_RCON_PASSWORD
# Check server performance
ServerFPS
# List online players
List_OnlinePlayers
# Send a global message
broadcast Server restart in 10 minutes!
# Initiate a 600-second (10-minute) shutdown countdown
SaveAndExit 600
# Cancel the shutdown if needed
StopCloseServerOrdnungsgemäßes Herunterfahren des Servers
Es gibt mehrere sichere Methoden, einen Soulmask-Server herunterzufahren. Verwenden Sie immer eine davon, um Datenverlust zu vermeiden:
- GPanel Stop-Schaltfläche: Die einfachste Methode. Klicken Sie auf Stop im GPanel Console-Tab.
- In-Game-Befehl: Authentifizieren Sie sich als Admin und führen Sie
gm exitaus, um zu speichern und herunterzufahren. - RCON/Telnet: Führen Sie
shutdown [seconds]oderSaveAndExit [seconds]für ein Herunterfahren mit Countdown aus, das Spielern Zeit zur Vorbereitung gibt.
Vermeiden Sie das erzwungene Beenden des Servers. Die Verwendung der GPanel Kill-Schaltfläche oder das erzwungene Beenden des Prozesses überspringt den Speichervorgang. Jeglicher Fortschritt seit der letzten automatischen Sicherung auf die Festplatte geht verloren. Verwenden Sie Kill nur als letzten Ausweg, wenn der Server vollständig nicht mehr reagiert.
Tipps für Server-Administratoren
- Automatische Backups einrichten. Verwenden Sie
-initbackupund-backupinterval=30, um regelmäßige Backup-Snapshots zu erstellen. - Server-FPS überwachen. Verwenden Sie den Befehl
ServerFPSregelmäßig. Wenn die Tickrate unter 15-20 FPS fällt, hat der Server Probleme und benötigt möglicherweise Optimierung oder einen Neustart. Set_Coefficientfür Live-Tuning verwenden. Sie können Gameplay-Einstellungen zur Laufzeit anpassen, ohne den Server neu zu starten. Führen Sie zuerstShow_Coefficient_Settingsaus, um aktuelle Werte zu sehen.- Regelmäßige Neustarts planen. Starten Sie den Server täglich neu, um Speicherlecks zu bereinigen und ausstehende Updates anzuwenden.
- Vor Wartungsarbeiten ankündigen. Verwenden Sie immer den Befehl
broadcast, um Spieler vor Server-Neustarts oder Wartungsfenstern zu warnen. SaveWorldvor riskanten Operationen verwenden. Erzwingen Sie eine Speicherung, bevor Sie bedeutende Änderungen vornehmen, wie das Entfernen von NPCs oder das Ändern von Koeffizienten.
Verwandte Artikel
- Soulmask Server-Einrichtungsanleitung
- So finden Sie Ihre Server-IP und Ihren Port
- So laden Sie Dateien per SFTP hoch
- Erste Schritte mit Ihrem neuen Server
Brauchen Sie Hilfe?
Wenn Sie weitere Unterstützung bei Soulmask-Admin-Befehlen oder der Serververwaltung benötigen, eröffnen Sie bitte ein Support-Ticket und unser Team hilft Ihnen gerne weiter.
