Questa guida copre la configurazione admin, i comandi admin in-game, la configurazione RCON e i comandi di gestione del server per il tuo server dedicato Soulmask su Legion Hosting. Per la configurazione e l'impostazione del server, vedi Guida alla Configurazione del Server Soulmask.
Pannello del Server: Tutta la gestione del server viene effettuata tramite GPanel su gpanel.legionhosting.net. Usa il File Manager o SFTP per modificare i file di configurazione.
Impostare i Privilegi di Admin
Soulmask utilizza un sistema admin basato su password. Per diventare admin, devi impostare una password admin nella configurazione di avvio del server e poi autenticarti in-game.
Passo 1: Imposta la Password Admin
- In GPanel, seleziona il tuo server Soulmask.
- Clicca sulla scheda Startup.
- Imposta la variabile
ADMIN_PASSWORDsu una password forte e unica. Questa corrisponde al parametro a riga di comando-adminpsw. - Riavvia il server affinché la modifica abbia effetto.
Mantieni segreta la tua password admin. Chiunque conosca la password admin può ottenere privilegi GM completi sul tuo server. Condividila solo con co-admin fidati.
Passo 2: Autenticati In-Game
- Unisciti al tuo server Soulmask come giocatore.
- Apri la console in-game premendo il tasto ` (apostrofo inverso/tilde) o Numpad - (meno del tastierino numerico).
- Digita il seguente comando e premi Invio:
gm key YOUR_ADMIN_PASSWORD - Se la password è corretta, vedrai un messaggio di conferma e otterrai i privilegi di admin GM (Game Master).
- Puoi anche cliccare sul pulsante "Diventa l'admin" che appare nell'interfaccia del pannello GM.
Autenticazione basata sulla sessione. Devi riautenticarti ogni volta che ti unisci al server. Lo stato di admin non viene salvato tra le sessioni -- dovrai eseguire
gm key ogni volta che effettui l'accesso.
Comandi Admin In-Game
Una volta autenticato come admin, apri la console (` o Numpad -) e inserisci i comandi. Tutti i comandi admin iniziano con il prefisso gm.
Gestione dei Giocatori
| Comando | Descrizione |
|---|---|
gm AddExp [value] |
Aggiungi punti esperienza generali al tuo personaggio. |
gm Addmjexp [value] |
Aggiungi esperienza maschera al tuo personaggio (sale di livello la maschera). |
gm Addshoulieexp [value] |
Aggiungi esperienza di caccia al tuo personaggio. |
gm XiDian |
Reimposta tutti i punti abilità per il tuo personaggio, permettendo la rispecializzazione. |
gm FuHuo |
Rianima il tuo personaggio (usalo quando sei morto). |
gm ZiSha 1 |
Uccide il tuo personaggio (comando di suicidio). |
gm shanhao |
Elimina il tuo account/personaggio dal server. Usalo con estrema cautela -- è irreversibile. |
gm ShowInfo 1 |
Visualizza informazioni dettagliate sul tuo personaggio (statistiche, ID, posizione). |
gm ShowInfo 0 |
Visualizza informazioni dettagliate sul personaggio o NPC attualmente selezionato. |
gm ChongZhiRenWu |
Reimposta tutti i tutorial e le missioni guida per il tuo personaggio. |
Navigazione e Visibilità
| Comando | Descrizione |
|---|---|
gm Go [x] [y] [z] |
Teletrasportati a coordinate del mondo specifiche. Usa GPS per trovare prima le tue coordinate attuali. |
GPS |
Visualizza le tue coordinate attuali del mondo (X, Y, Z). Utile per i target di teletrasporto. |
gm SetAttr YinShen 1 |
Abilita l'invisibilità. Mostri e NPC non possono rilevarti. |
gm SetAttr YinShen 0 |
Disabilita l'invisibilità. Ritorna alla visibilità normale. |
gm ShowMap |
Rivela l'intera mappa, sbloccando tutta la nebbia di guerra per il tuo personaggio. |
Controllo NPC e Mondo
| Comando | Descrizione |
|---|---|
gm ZhaoMu |
Recluta istantaneamente l'NPC selezionato nella tua tribù. |
gm ClearAllNpc |
Rimuovi tutti gli NPC non giocatori dal server. Usalo con cautela -- influisce su tutti gli NPC a livello di server. |
gm ClearSelect |
Rimuove l'entità attualmente selezionata (NPC, creatura o oggetto). |
gm ShuaXinZhiBei |
Aggiorna e fa ricrescere tutta la vegetazione vicina e le piante raccolibili. |
gm KeJiShu |
Sblocca tutti i nodi dell'albero tecnologico per il tuo personaggio. |
Gestione delle Invasioni e del Calore
| Comando | Descrizione |
|---|---|
gm ShowReDu |
Visualizza il grafico attuale del calore di invasione, mostrando i livelli di minaccia in diverse aree. |
gm ClearAllReDu |
Cancella tutto il calore di invasione sulla mappa, reimpostando i livelli di minaccia a zero. |
gm AddReDu [value] |
Aumenta manualmente il calore di invasione della quantità specificata. Un calore più alto attira più invasioni. |
Server e Debug
| Comando | Descrizione |
|---|---|
gm exit |
Spegne in modo controllato il server con un salvataggio. Questo è il modo più sicuro per fermare il server da in-game. |
Debuginfo 1 |
Abilita l'overlay di monitoraggio delle prestazioni del server, mostrando il tick rate, i conteggi delle entità e l'utilizzo delle risorse. |
Debuginfo 0 |
Disabilita l'overlay di monitoraggio delle prestazioni del server. |
Usa i comandi con parsimonia. I comandi admin possono avere un impatto significativo sulla stabilità del server e sull'esperienza dei giocatori. Generare grandi quantità di entità, cancellare gli NPC a livello di server o modificare rapidamente i dati del mondo può causare lag o crash. Testa prima i comandi durante un periodo di bassa affluenza.
Comandi di Gestione del Server
Questi comandi sono utilizzati per la gestione a livello di server e possono essere eseguiti sia in-game (tramite console) che da remoto (tramite RCON/Telnet).
Controllo del Server
| Comando | Descrizione |
|---|---|
SaveWorld |
Forza un salvataggio immediato del mondo in memoria (e opzionalmente su disco). Usalo prima di eseguire operazioni rischiose. |
SaveAndExit [seconds] |
Salva il mondo e spegne il server dopo il numero di secondi specificato. I giocatori ricevono un conto alla rovescia di avviso. |
StopCloseServer |
Annulla uno spegnimento in sospeso che è stato avviato con SaveAndExit. |
shutdown [seconds] |
Avvia uno spegnimento controllato del server con il conto alla rovescia specificato in secondi. |
broadcast [message] |
Invia un messaggio globale a tutti i giocatori connessi. Utile per annunci e avvisi. |
Amministrazione dei Giocatori (Remota)
| Comando | Descrizione |
|---|---|
List_AllPlayers |
Elenca tutti gli account giocatore registrati sul server (online e offline). |
List_OnlinePlayers |
Elenca tutti i giocatori attualmente connessi con i loro Steam ID e nomi dei personaggi. |
List_Guilds |
Elenca tutte le tribù (gilde) sul server con i conteggi dei membri. |
kick [PlayerName] |
Espelli un giocatore dal server per nome del personaggio. |
ban [PlayerName] |
Banna un giocatore dal server. Non potrà riconnettersi. |
CreateItemForPlayer [SteamID] [ItemID] [Amount] |
Aggiungi oggetti direttamente all'inventario di un giocatore specifico tramite Steam ID. |
GotoPosition [SteamID] [x] [y] [z] |
Teletrasporta un giocatore specifico a coordinate del mondo. |
FlyMode [SteamID] [0/1] |
Abilita (1) o disabilita (0) la modalità fantasma/volo per un giocatore. |
Informazioni sul Server
| Comando | Descrizione |
|---|---|
ServerFPS |
Visualizza l'attuale tick rate del server (FPS). I server sani dovrebbero mantenere oltre 30 FPS. |
Show_Coefficient_Settings |
Elenca tutte le impostazioni di coefficiente di gameplay attuali da GameXishu.json. |
Set_Coefficient [key] [value] |
Modifica un coefficiente di gameplay in tempo reale senza modificare i file. Le modifiche hanno effetto immediato. |
List_AllTalent [level] |
Visualizza tutti i doni naturali (talenti) disponibili al livello specificato. |
Debug e Avanzato
| Comando | Descrizione |
|---|---|
Dump_AllActorPositions |
Esporta tutte le posizioni degli attori in un file di dati per il debug dello stato del mondo. |
DrawActorImage |
Genera una visualizzazione delle posizioni degli attori sulla mappa. |
ExecScriptCommands [filename] |
Esegui un file batch di comandi. Utile per eseguire più comandi contemporaneamente. |
Accesso RCON
RCON (Remote Console) ti consente di eseguire comandi del server da remoto senza essere connesso al gioco. Soulmask supporta sia RCON che Telnet per l'amministrazione remota.
Abilitare RCON
RCON è disabilitato per impostazione predefinita e deve essere abilitato tramite i parametri di avvio:
- In GPanel, vai alla scheda Startup.
- Aggiungi i seguenti parametri (tramite parametri di avvio aggiuntivi o contattando il supporto per averli aggiunti):
-rconpsw="YOUR_RCON_PASSWORD" -rconport=19000 - Riavvia il server.
Sicurezza RCON. L'implementazione RCON di Soulmask utilizza una whitelist IP per la sicurezza. Solo gli indirizzi IP nella whitelist possono connettersi al servizio RCON. Controlla la documentazione del server o i file di configurazione per la posizione della whitelist se devi aggiungere il tuo IP.
Connettersi via RCON
Una volta abilitato RCON, puoi connetterti utilizzando qualsiasi client RCON standard:
- Scarica un client RCON come rcon-cli o uno strumento GUI come mcrcon.
- Connettiti al tuo server utilizzando:
- Host: L'indirizzo IP del tuo server
- Porta: La porta RCON (predefinita
19000) - Password: La password RCON che hai impostato con
-rconpsw
- Una volta connesso, digita
helpper vedere un elenco dei comandi disponibili.
Accesso Telnet
Soulmask supporta anche l'amministrazione basata su Telnet sulla Echo Port (predefinita 18888). Telnet è limitato alle connessioni locali per impostazione predefinita e non richiede port forwarding aggiuntivo. Questo è utilizzato principalmente per l'amministrazione tramite script sulla stessa macchina server.
Esempio di Sessione 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
StopCloseServerSpegnimento Corretto del Server
Ci sono diversi metodi sicuri per spegnere un server Soulmask. Usa sempre uno di questi per prevenire la perdita di dati:
- Pulsante Stop di GPanel: Il metodo più semplice. Clicca Stop nella scheda Console di GPanel.
- Comando in-game: Autenticati come admin ed esegui
gm exitper salvare e spegnere. - RCON/Telnet: Esegui
shutdown [seconds]oSaveAndExit [seconds]per uno spegnimento con conto alla rovescia che dia ai giocatori il tempo di prepararsi.
Evita di terminare forzatamente il server. Utilizzare il pulsante Kill di GPanel o terminare forzatamente il processo salterà la fase di salvataggio. Qualsiasi progresso dall'ultimo backup automatico su disco andrà perso. Usa Kill solo come ultima risorsa quando il server è completamente non responsivo.
Consigli per gli Amministratori del Server
- Imposta backup automatici. Usa
-initbackupe-backupinterval=30per creare regolari snapshot di backup. - Monitora gli FPS del server. Usa regolarmente il comando
ServerFPS. Se il tick rate scende sotto i 15-20 FPS, il server sta avendo difficoltà e potrebbe necessitare di ottimizzazione o riavvio. - Usa
Set_Coefficientper la regolazione in tempo reale. Puoi regolare le impostazioni di gameplay in tempo reale senza riavviare il server. Esegui primaShow_Coefficient_Settingsper vedere i valori attuali. - Pianifica riavvii regolari. Riavvia il server giornalmente per cancellare le perdite di memoria e applicare eventuali aggiornamenti in sospeso.
- Trasmetti prima della manutenzione. Usa sempre il comando
broadcastper avvisare i giocatori prima dei riavvii del server o delle finestre di manutenzione. - Usa
SaveWorldprima di operazioni rischiose. Forza un salvataggio prima di apportare modifiche significative come cancellare gli NPC o modificare i coefficienti.
Articoli Correlati
- Guida alla Configurazione del Server Soulmask
- Come Trovare l'IP e la Porta del Tuo Server
- Come Caricare File via SFTP
- Per Iniziare con il Tuo Nuovo Server
Hai Bisogno di Aiuto?
Se hai bisogno di ulteriore assistenza con i comandi admin di Soulmask o la gestione del server, ti preghiamo di aprire un ticket di supporto e il nostro team sarà felice di aiutarti.
