Aquesta guia cobreix la configuració d'administrador, les comandes d'administrador dins del joc, la configuració de RCON i les comandes de gestió del servidor per al vostre servidor dedicat de Soulmask a Legion Hosting. Per a la configuració del servidor, consulteu la Guia de configuració del servidor de Soulmask.
Panell del servidor: Tota la gestió del servidor es fa a través de GPanel a gpanel.legionhosting.net. Utilitzeu el gestor de fitxers o SFTP per editar els fitxers de configuració.
Configurar privilegis d'administrador
Soulmask utilitza un sistema d'administrador basat en contrasenya. Per convertir-vos en administrador, heu de configurar una contrasenya d'administrador a la configuració d'inici del servidor i després autenticar-vos dins del joc.
Pas 1: Configurar la contrasenya d'administrador
- A GPanel, seleccioneu el vostre servidor de Soulmask.
- Feu clic a la pestanya Startup.
- Configureu la variable
ADMIN_PASSWORDamb una contrasenya forta i única. Això correspon al paràmetre de línia de comandes-adminpsw. - Reinicieu el servidor perquè el canvi tingui efecte.
Manteniu la vostra contrasenya d'administrador en secret. Qualsevol persona que conegui la contrasenya d'administrador pot obtenir privilegis complets de GM al vostre servidor. Compartiu-la només amb coadministradors de confiança.
Pas 2: Autenticar-se dins del joc
- Uniu-vos al vostre servidor de Soulmask com a jugador.
- Obriu la consola del joc prement la tecla ` (accent greu/titlla) o Numpad - (menys del teclat numèric).
- Escriviu la comanda següent i premeu Enter:
gm key YOUR_ADMIN_PASSWORD - Si la contrasenya és correcta, veureu un missatge de confirmació i obtindreu privilegis d'administrador GM (Game Master).
- També podeu fer clic al botó "Become the admin" que apareix a la interfície del panell GM.
Autenticació basada en sessió. Heu de tornar a autenticar-vos cada vegada que us uniu al servidor. L'estat d'administrador no es guarda entre sessions -- haureu d'executar
gm key cada vegada que inicieu sessió.
Comandes d'administrador dins del joc
Un cop autenticat com a administrador, obriu la consola (` o Numpad -) i introduïu les comandes. Totes les comandes d'administrador comencen amb el prefix gm.
Gestió de jugadors
| Comanda | Descripció |
|---|---|
gm AddExp [value] |
Afegeix punts d'experiència general al vostre personatge. |
gm Addmjexp [value] |
Afegeix experiència de màscara al vostre personatge (puja de nivell la màscara). |
gm Addshoulieexp [value] |
Afegeix experiència de caça al vostre personatge. |
gm XiDian |
Reinicia tots els punts d'habilitat del vostre personatge, permetent redistribuir-los. |
gm FuHuo |
Reviu el vostre personatge (utilitzeu-lo quan estigueu mort). |
gm ZiSha 1 |
Mata el vostre propi personatge (comanda de suïcidi). |
gm shanhao |
Elimina el vostre compte/personatge del servidor. Utilitzeu-ho amb molta precaució -- és irreversible. |
gm ShowInfo 1 |
Mostra informació detallada sobre el vostre propi personatge (estadístiques, IDs, posició). |
gm ShowInfo 0 |
Mostra informació detallada sobre el personatge o NPC seleccionat actualment. |
gm ChongZhiRenWu |
Reinicia tots els tutorials i missions guia del vostre personatge. |
Navegació i visibilitat
| Comanda | Descripció |
|---|---|
gm Go [x] [y] [z] |
Teletransporta a coordenades del món específiques. Utilitzeu GPS per trobar les vostres coordenades actuals primer. |
GPS |
Mostra les vostres coordenades actuals del món (X, Y, Z). Útil per a objectius de teletransport. |
gm SetAttr YinShen 1 |
Activa la invisibilitat. Els monstres i els NPC no us poden detectar. |
gm SetAttr YinShen 0 |
Desactiva la invisibilitat. Torna a la visibilitat normal. |
gm ShowMap |
Revela el mapa sencer, desbloquejant tota la boira de guerra del vostre personatge. |
Control de NPC i del món
| Comanda | Descripció |
|---|---|
gm ZhaoMu |
Recluta instantàniament el NPC seleccionat a la vostra tribu. |
gm ClearAllNpc |
Elimina tots els NPC no jugadors del servidor. Utilitzeu-ho amb precaució -- afecta tots els NPC de tot el servidor. |
gm ClearSelect |
Elimina l'entitat seleccionada/apuntada actualment (NPC, criatura o objecte). |
gm ShuaXinZhiBei |
Actualitza i fa recréixer tota la vegetació propera i les plantes recol·lectables. |
gm KeJiShu |
Desbloqueja tots els nodes de l'arbre tecnològic del vostre personatge. |
Gestió d'invasions i calor
| Comanda | Descripció |
|---|---|
gm ShowReDu |
Mostra el gràfic de calor d'invasió actual, mostrant els nivells d'amenaça a les diferents àrees. |
gm ClearAllReDu |
Esborra tota la calor d'invasió del mapa, reiniciant els nivells d'amenaça a zero. |
gm AddReDu [value] |
Augmenta manualment la calor d'invasió per la quantitat especificada. Una calor més alta atrau més invasions. |
Servidor i depuració
| Comanda | Descripció |
|---|---|
gm exit |
Apaga el servidor de forma segura amb una partida guardada. Aquesta és la manera més segura d'aturar el servidor des del joc. |
Debuginfo 1 |
Activa la superposició de monitoratge de rendiment del servidor, mostrant la taxa de ticks, el recompte d'entitats i l'ús de recursos. |
Debuginfo 0 |
Desactiva la superposició de monitoratge de rendiment del servidor. |
Utilitzeu les comandes amb moderació. Les comandes d'administrador poden afectar significativament l'estabilitat del servidor i l'experiència dels jugadors. Generar grans quantitats d'entitats, esborrar NPC de tot el servidor o modificar ràpidament les dades del món pot causar retard o bloquejos. Proveu les comandes primer en un període de baixa població.
Comandes de gestió del servidor
Aquestes comandes s'utilitzen per a la gestió general del servidor i es poden executar tant dins del joc (mitjançant la consola) com de forma remota (mitjançant RCON/Telnet).
Control del servidor
| Comanda | Descripció |
|---|---|
SaveWorld |
Força una partida guardada immediata del món a memòria (i opcionalment a disc). Utilitzeu-ho abans de realitzar operacions de risc. |
SaveAndExit [seconds] |
Guarda el món i apaga el servidor després del nombre de segons especificat. Els jugadors reben un compte enrere d'avís. |
StopCloseServer |
Cancel·la un apagament pendent que s'havia iniciat amb SaveAndExit. |
shutdown [seconds] |
Inicia un apagament controlat del servidor amb el compte enrere especificat en segons. |
broadcast [message] |
Envia un missatge global a tots els jugadors connectats. Útil per a anuncis i avisos. |
Administració de jugadors (remota)
| Comanda | Descripció |
|---|---|
List_AllPlayers |
Llista tots els comptes de jugadors registrats al servidor (connectats i desconnectats). |
List_OnlinePlayers |
Llista tots els jugadors connectats actualment amb els seus Steam IDs i noms de personatge. |
List_Guilds |
Llista totes les tribus (gremis) al servidor amb el recompte de membres. |
kick [PlayerName] |
Expulsa un jugador del servidor pel nom del personatge. |
ban [PlayerName] |
Prohibeix l'accés d'un jugador al servidor. No podrà tornar a connectar-se. |
CreateItemForPlayer [SteamID] [ItemID] [Amount] |
Afegeix objectes directament a l'inventari d'un jugador específic pel Steam ID. |
GotoPosition [SteamID] [x] [y] [z] |
Teletransporta un jugador específic a coordenades del món. |
FlyMode [SteamID] [0/1] |
Activa (1) o desactiva (0) el mode fantasma/vol per a un jugador. |
Informació del servidor
| Comanda | Descripció |
|---|---|
ServerFPS |
Mostra la taxa de ticks actual del servidor (FPS). Els servidors saludables haurien de mantenir 30+ FPS. |
Show_Coefficient_Settings |
Llista tots els coeficients de joc actuals de GameXishu.json. |
Set_Coefficient [key] [value] |
Modifica un coeficient de joc en temps real sense editar fitxers. Els canvis tenen efecte immediatament. |
List_AllTalent [level] |
Mostra tots els dons naturals (talents) disponibles al nivell especificat. |
Depuració i avançat
| Comanda | Descripció |
|---|---|
Dump_AllActorPositions |
Exporta totes les posicions d'actors a un fitxer de dades per depurar l'estat del món. |
DrawActorImage |
Genera una visualització de les posicions d'actors al mapa. |
ExecScriptCommands [filename] |
Executa un fitxer per lots de comandes. Útil per executar múltiples comandes alhora. |
Accés RCON
RCON (Remote Console) us permet executar comandes del servidor de forma remota sense estar connectat al joc. Soulmask suporta tant RCON com Telnet per a l'administració remota.
Activar RCON
RCON està desactivat per defecte i s'ha d'activar mitjançant paràmetres d'inici:
- A GPanel, aneu a la pestanya Startup.
- Afegiu els paràmetres següents (a través de paràmetres d'inici addicionals o contactant amb el suport perquè els afegeixin):
-rconpsw="YOUR_RCON_PASSWORD" -rconport=19000 - Reinicieu el servidor.
Seguretat de RCON. La implementació de RCON de Soulmask utilitza una llista blanca d'IP per seguretat. Només les adreces IP de la llista blanca poden connectar-se al servei RCON. Consulteu la documentació del servidor o els fitxers de configuració per trobar la ubicació de la llista blanca si necessiteu afegir la vostra IP.
Connectar-se via RCON
Un cop activat RCON, podeu connectar-vos utilitzant qualsevol client RCON estàndard:
- Descarregueu un client RCON com rcon-cli o una eina amb interfície gràfica com mcrcon.
- Connecteu-vos al vostre servidor utilitzant:
- Host: L'adreça IP del vostre servidor
- Port: El port RCON (per defecte
19000) - Password: La contrasenya RCON que heu configurat amb
-rconpsw
- Un cop connectat, escriviu
helpper veure una llista de comandes disponibles.
Accés Telnet
Soulmask també suporta administració basada en Telnet a l'Echo Port (per defecte 18888). Telnet està restringit només a connexions locals per defecte i no requereix reenviament de ports addicional. Això s'utilitza principalment per a l'administració amb scripts a la mateixa màquina del servidor.
Exemple de sessió RCON
# 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
StopCloseServerApagament correcte del servidor
Hi ha diversos mètodes segurs per apagar un servidor de Soulmask. Utilitzeu sempre un d'aquests per prevenir la pèrdua de dades:
- Botó Stop de GPanel: El mètode més senzill. Feu clic a Stop a la pestanya Console de GPanel.
- Comanda dins del joc: Autentiqueu-vos com a administrador i executeu
gm exitper guardar i apagar. - RCON/Telnet: Executeu
shutdown [seconds]oSaveAndExit [seconds]per a un apagament amb compte enrere que doni temps als jugadors per preparar-se.
Eviteu forçar l'aturada del servidor. Utilitzar el botó Kill de GPanel o forçar la terminació del procés ometrà el pas de guardat. Qualsevol progrés des de l'última còpia de seguretat automàtica a disc es perdrà. Utilitzeu Kill només com a últim recurs quan el servidor no respongui completament.
Consells per als administradors del servidor
- Configureu còpies de seguretat automàtiques. Utilitzeu
-initbackupi-backupinterval=30per crear instantànies de seguretat regulars. - Monitoreu els FPS del servidor. Utilitzeu la comanda
ServerFPSregularment. Si la taxa de ticks baixa per sota de 15-20 FPS, el servidor té dificultats i pot necessitar optimització o un reinici. - Utilitzeu
Set_Coefficientper a l'ajust en directe. Podeu ajustar els paràmetres de joc en temps real sense reiniciar el servidor. ExecuteuShow_Coefficient_Settingsprimer per veure els valors actuals. - Programeu reinicis regulars. Reinicieu el servidor diàriament per alliberar fuites de memòria i aplicar les actualitzacions pendents.
- Aviseu abans del manteniment. Utilitzeu sempre la comanda
broadcastper avisar els jugadors abans de reinicis o finestres de manteniment del servidor. - Utilitzeu
SaveWorldabans d'operacions de risc. Forceu un guardat abans de fer canvis significatius com esborrar NPC o modificar coeficients.
Articles relacionats
- Soulmask Server Setup Guide
- How to Find Your Server IP and Port
- How to Upload Files via SFTP
- Getting Started with Your New Server
Necessiteu ajuda?
Si necessiteu més assistència amb les comandes d'administrador de Soulmask o la gestió del servidor, si us plau obriu un tiquet de suport i el nostre equip estarà encantat d'ajudar-vos.
