Deze gids behandelt het instellen van beheerders, in-game beheerderscommando's, RCON-configuratie en serverbeheerscommando's voor je Soulmask dedicated server op Legion Hosting. Voor serverinstallatie en configuratie, zie Soulmask Server Installatiehandleiding.
Serverpaneel: Al het serverbeheer wordt gedaan via GPanel op gpanel.legionhosting.net. Gebruik de Bestandsbeheerder of SFTP om configuratiebestanden te bewerken.
Beheerdersbevoegdheden instellen
Soulmask gebruikt een op wachtwoord gebaseerd beheerderssysteem. Om beheerder te worden, moet je een beheerderswachtwoord instellen in de serverstartconfiguratie en je vervolgens in-game authenticeren.
Stap 1: Het beheerderswachtwoord instellen
- Selecteer in GPanel je Soulmask server.
- Klik op het tabblad Startup.
- Stel de variabele
ADMIN_PASSWORDin op een sterk, uniek wachtwoord. Dit komt overeen met de opdrachtregelparameter-adminpsw. - Herstart de server om de wijziging door te voeren.
Houd je beheerderswachtwoord geheim. Iedereen die het beheerderswachtwoord kent, kan volledige GM-bevoegdheden krijgen op je server. Deel het alleen met vertrouwde mede-beheerders.
Stap 2: In-game authenticeren
- Neem deel aan je Soulmask server als speler.
- Open de in-game console door op de toets ` (grave/tilde) of Numpad - (numpad min) te drukken.
- Typ het volgende commando en druk op Enter:
gm key YOUR_ADMIN_PASSWORD - Als het wachtwoord correct is, zie je een bevestigingsbericht en krijg je GM (Game Master) beheerdersbevoegdheden.
- Je kunt ook op de knop "Become the admin" klikken die verschijnt in het GM-paneelinterface.
Sessiegebaseerde authenticatie. Je moet je elke keer opnieuw authenticeren wanneer je de server betreedt. Beheerdersstatus wordt niet opgeslagen tussen sessies -- je moet
gm key elke keer uitvoeren wanneer je inlogt.
In-game beheerderscommando's
Eenmaal geauthenticeerd als beheerder, open de console (` of Numpad -) en voer commando's in. Alle beheerderscommando's beginnen met het prefix gm.
Spelersbeheer
| Commando | Beschrijving |
|---|---|
gm AddExp [value] |
Voeg algemene ervaringspunten toe aan je personage. |
gm Addmjexp [value] |
Voeg maskerervaring toe aan je personage (levelt het masker op). |
gm Addshoulieexp [value] |
Voeg jachtervaring toe aan je personage. |
gm XiDian |
Reset alle vaardigheidspunten van je personage, waardoor je opnieuw kunt toewijzen. |
gm FuHuo |
Wiederbeleef je personage (gebruik wanneer je dood bent). |
gm ZiSha 1 |
Dood je eigen personage (zelfmoordcommando). |
gm shanhao |
Verwijder je account/personage van de server. Gebruik met uiterste voorzichtigheid -- dit is onomkeerbaar. |
gm ShowInfo 1 |
Toon gedetailleerde informatie over je eigen personage (statistieken, ID's, positie). |
gm ShowInfo 0 |
Toon gedetailleerde informatie over het momenteel geselecteerde personage of NPC. |
gm ChongZhiRenWu |
Reset alle tutorials en begeleidingsmissies voor je personage. |
Navigatie en zichtbaarheid
| Commando | Beschrijving |
|---|---|
gm Go [x] [y] [z] |
Teleporteer naar specifieke wereldcoördinaten. Gebruik GPS om eerst je huidige coördinaten te vinden. |
GPS |
Toon je huidige wereldcoördinaten (X, Y, Z). Handig voor teleportatiedoelen. |
gm SetAttr YinShen 1 |
Schakel onzichtbaarheid in. Monsters en NPC's kunnen je niet detecteren. |
gm SetAttr YinShen 0 |
Schakel onzichtbaarheid uit. Keer terug naar normale zichtbaarheid. |
gm ShowMap |
Onthul de hele kaart en ontgrendel alle fog of war voor je personage. |
NPC- en wereldbeheer
| Commando | Beschrijving |
|---|---|
gm ZhaoMu |
Rekruteer het geselecteerde NPC direct voor je stam. |
gm ClearAllNpc |
Verwijder alle niet-speler NPC's van de server. Gebruik met voorzichtigheid -- beïnvloedt alle NPC's serverbreed. |
gm ClearSelect |
Verwijder de momenteel geselecteerde entiteit (NPC, wezen of object). |
gm ShuaXinZhiBei |
Vernieuw en laat alle nabijgelegen vegetatie en oogstbare planten opnieuw groeien. |
gm KeJiShu |
Ontgrendel alle technologieboomknooppunten voor je personage. |
Invasie- en hittebeheer
| Commando | Beschrijving |
|---|---|
gm ShowReDu |
Toon de huidige invasiehittekaart, met dreigingsniveaus in verschillende gebieden. |
gm ClearAllReDu |
Wis alle invasiehitte over de kaart en reset dreigingsniveaus naar nul. |
gm AddReDu [value] |
Verhoog handmatig de invasiehitte met het opgegeven bedrag. Hogere hitte trekt meer invasies aan. |
Server en debug
| Commando | Beschrijving |
|---|---|
gm exit |
Sluit de server netjes af met een opslag. Dit is de veiligste manier om de server vanuit het spel te stoppen. |
Debuginfo 1 |
Schakel de serverprestatie-monitoringoverlay in, met tick rate, entiteitsaantallen en resourcegebruik. |
Debuginfo 0 |
Schakel de serverprestatie-monitoringoverlay uit. |
Gebruik commando's spaarzaam. Beheerderscommando's kunnen de serverstabiliteit en spelervaring aanzienlijk beïnvloeden. Het spawnen van grote aantallen entiteiten, het serverbreed verwijderen van NPC's of het snel wijzigen van wereldgegevens kan lag of crashes veroorzaken. Test commando's eerst tijdens een rustige periode.
Serverbeheerscommando's
Deze commando's worden gebruikt voor serverbeheer en kunnen zowel in-game (via console) als op afstand (via RCON/Telnet) worden uitgevoerd.
Serverbeheer
| Commando | Beschrijving |
|---|---|
SaveWorld |
Forceer een onmiddellijke wereldopslag naar het geheugen (en optioneel naar schijf). Gebruik dit voordat je risicovolle bewerkingen uitvoert. |
SaveAndExit [seconds] |
Sla de wereld op en sluit de server af na het opgegeven aantal seconden. Spelers ontvangen een waarschuwingsaftelling. |
StopCloseServer |
Annuleer een lopende afsluiting die is gestart met SaveAndExit. |
shutdown [seconds] |
Start een nette serverafsluiting met de opgegeven aftelling in seconden. |
broadcast [message] |
Stuur een globaal bericht naar alle verbonden spelers. Handig voor aankondigingen en waarschuwingen. |
Spelersbeheer (op afstand)
| Commando | Beschrijving |
|---|---|
List_AllPlayers |
Toon alle spelersaccounts die op de server zijn geregistreerd (online en offline). |
List_OnlinePlayers |
Toon alle momenteel verbonden spelers met hun Steam ID's en personagenamen. |
List_Guilds |
Toon alle stammen (guilds) op de server met ledenaantallen. |
kick [PlayerName] |
Kick een speler van de server op personagenaam. |
ban [PlayerName] |
Ban een speler van de server. Ze kunnen niet opnieuw verbinden. |
CreateItemForPlayer [SteamID] [ItemID] [Amount] |
Voeg items rechtstreeks toe aan de inventaris van een specifieke speler via Steam ID. |
GotoPosition [SteamID] [x] [y] [z] |
Teleporteer een specifieke speler naar wereldcoördinaten. |
FlyMode [SteamID] [0/1] |
Schakel ghost/vliegmodus in (1) of uit (0) voor een speler. |
Serverinformatie
| Commando | Beschrijving |
|---|---|
ServerFPS |
Toon de huidige server tick rate (FPS). Gezonde servers moeten 30+ FPS behouden. |
Show_Coefficient_Settings |
Toon alle huidige gameplay-coëfficiëntinstellingen uit GameXishu.json. |
Set_Coefficient [key] [value] |
Wijzig een gameplay-coëfficiënt tijdens runtime zonder bestanden te bewerken. Wijzigingen worden onmiddellijk van kracht. |
List_AllTalent [level] |
Bekijk alle natuurlijke gaven (talenten) beschikbaar op het opgegeven niveau. |
Debug en geavanceerd
| Commando | Beschrijving |
|---|---|
Dump_AllActorPositions |
Exporteer alle actorposities naar een gegevensbestand voor het debuggen van de wereldstatus. |
DrawActorImage |
Genereer een visualisatie van actorposities op de kaart. |
ExecScriptCommands [filename] |
Voer een batchbestand met commando's uit. Handig om meerdere commando's tegelijk uit te voeren. |
RCON-toegang
RCON (Remote Console) stelt je in staat om servercommando's op afstand uit te voeren zonder met het spel verbonden te zijn. Soulmask ondersteunt zowel RCON als Telnet voor beheer op afstand.
RCON inschakelen
RCON is standaard uitgeschakeld en moet worden ingeschakeld via opstartparameters:
- Ga in GPanel naar het tabblad Startup.
- Voeg de volgende parameters toe (via aanvullende opstartparameters of door contact op te nemen met support om ze toe te laten voegen):
-rconpsw="YOUR_RCON_PASSWORD" -rconport=19000 - Herstart de server.
RCON-beveiliging. De RCON-implementatie van Soulmask gebruikt een IP-whitelist voor beveiliging. Alleen whitelisted IP-adressen kunnen verbinden met de RCON-service. Controleer de serverdocumentatie of configuratiebestanden voor de locatie van de whitelist als je je IP moet toevoegen.
Verbinden via RCON
Zodra RCON is ingeschakeld, kun je verbinden met elke standaard RCON-client:
- Download een RCON-client zoals rcon-cli of een GUI-tool zoals mcrcon.
- Verbind met je server met:
- Host: Het IP-adres van je server
- Port: De RCON-poort (standaard
19000) - Wachtwoord: Het RCON-wachtwoord dat je hebt ingesteld met
-rconpsw
- Eenmaal verbonden, typ
helpom een lijst van beschikbare commando's te zien.
Telnet-toegang
Soulmask ondersteunt ook Telnet-gebaseerd beheer op de Echo Port (standaard 18888). Telnet is standaard beperkt tot alleen lokale verbindingen en vereist geen extra port forwarding. Dit wordt voornamelijk gebruikt voor geautomatiseerd beheer op de servermachine zelf.
Voorbeeld RCON-sessie
# 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
StopCloseServerServer correct afsluiten
Er zijn verschillende veilige methoden om een Soulmask server af te sluiten. Gebruik altijd een van deze om gegevensverlies te voorkomen:
- GPanel Stop-knop: De eenvoudigste methode. Klik op Stop in het GPanel Console-tabblad.
- In-game commando: Authenticeer als beheerder en voer
gm exituit om op te slaan en af te sluiten. - RCON/Telnet: Voer
shutdown [seconds]ofSaveAndExit [seconds]uit voor een aftelling die spelers tijd geeft om zich voor te bereiden.
Vermijd het geforceerd beëindigen van de server. Het gebruik van de GPanel Kill-knop of het geforceerd beëindigen van het proces slaat de opslagstap over. Alle voortgang sinds de laatste automatische schijfback-up gaat verloren. Gebruik Kill alleen als laatste redmiddel wanneer de server volledig niet reageert.
Tips voor serverbeheerders
- Stel automatische back-ups in. Gebruik
-initbackupen-backupinterval=30om regelmatige back-upsnapshots te maken. - Monitor server-FPS. Gebruik het commando
ServerFPSregelmatig. Als de tick rate onder de 15-20 FPS daalt, heeft de server moeite en heeft deze mogelijk optimalisatie of een herstart nodig. - Gebruik
Set_Coefficientvoor live afstemming. Je kunt gameplay-instellingen tijdens runtime aanpassen zonder de server te herstarten. Voer eerstShow_Coefficient_Settingsuit om de huidige waarden te zien. - Plan regelmatige herstarts. Herstart de server dagelijks om geheugenlekken op te ruimen en eventuele openstaande updates toe te passen.
- Kondig onderhoud aan. Gebruik altijd het commando
broadcastom spelers te waarschuwen voordat de server wordt herstart of onderhoud wordt uitgevoerd. - Gebruik
SaveWorldvóór risicovolle bewerkingen. Forceer een opslag voordat je significante wijzigingen aanbrengt zoals het verwijderen van NPC's of het wijzigen van coëfficiënten.
Gerelateerde artikelen
- Soulmask Server Installatiehandleiding
- Hoe je je server-IP en poort kunt vinden
- Bestanden uploaden via SFTP
- Aan de slag met je nieuwe server
Hulp nodig?
Als je verdere hulp nodig hebt met Soulmask beheerderscommando's of serverbeheer, open dan een supportticket en ons team helpt je graag verder.
