Ce guide couvre la configuration administrateur, les commandes d'administration en jeu, la configuration RCON et les commandes de gestion du serveur pour votre serveur dédié Soulmask sur Legion Hosting. Pour la configuration du serveur, consultez le Guide de configuration du serveur Soulmask.
Panneau de gestion : Toute la gestion du serveur se fait via GPanel à l'adresse gpanel.legionhosting.net. Utilisez le gestionnaire de fichiers ou SFTP pour modifier les fichiers de configuration.
Définir les privilèges administrateur
Soulmask utilise un système d'administration basé sur un mot de passe. Pour devenir administrateur, vous devez définir un mot de passe admin dans la configuration de démarrage du serveur puis vous authentifier en jeu.
Étape 1 : Définir le mot de passe administrateur
- Dans GPanel, sélectionnez votre serveur Soulmask.
- Cliquez sur l'onglet Startup.
- Définissez la variable
ADMIN_PASSWORDavec un mot de passe fort et unique. Cela correspond au paramètre de ligne de commande-adminpsw. - Redémarrez le serveur pour que le changement prenne effet.
Gardez votre mot de passe admin secret. Toute personne connaissant le mot de passe admin peut obtenir les privilèges GM complets sur votre serveur. Ne le partagez qu'avec des co-administrateurs de confiance.
Étape 2 : S'authentifier en jeu
- Rejoignez votre serveur Soulmask en tant que joueur.
- Ouvrez la console en jeu en appuyant sur la touche ` (accent grave/tilde) ou Numpad - (moins du pavé numérique).
- Tapez la commande suivante et appuyez sur Entrée :
gm key YOUR_ADMIN_PASSWORD - Si le mot de passe est correct, vous verrez un message de confirmation et obtiendrez les privilèges administrateur GM (Game Master).
- Vous pouvez également cliquer sur le bouton "Become the admin" qui apparaît dans l'interface du panneau GM.
Authentification par session. Vous devez vous ré-authentifier à chaque fois que vous rejoignez le serveur. Le statut d'administrateur n'est pas sauvegardé entre les sessions -- vous devrez exécuter
gm key à chaque connexion.
Commandes d'administration en jeu
Une fois authentifié en tant qu'administrateur, ouvrez la console (` ou Numpad -) et entrez les commandes. Toutes les commandes d'administration commencent par le préfixe gm.
Gestion des joueurs
| Commande | Description |
|---|---|
gm AddExp [value] |
Ajouter des points d'expérience générale à votre personnage. |
gm Addmjexp [value] |
Ajouter de l'expérience de masque à votre personnage (fait monter le masque en niveau). |
gm Addshoulieexp [value] |
Ajouter de l'expérience de chasse à votre personnage. |
gm XiDian |
Réinitialiser tous les points de compétence de votre personnage, permettant une redistribution. |
gm FuHuo |
Ressusciter votre personnage (à utiliser quand vous êtes mort). |
gm ZiSha 1 |
Tuer votre propre personnage (commande de suicide). |
gm shanhao |
Supprimer votre compte/personnage du serveur. Utilisez avec une extrême prudence -- cette action est irréversible. |
gm ShowInfo 1 |
Afficher des informations détaillées sur votre propre personnage (statistiques, identifiants, position). |
gm ShowInfo 0 |
Afficher des informations détaillées sur le personnage ou PNJ actuellement ciblé. |
gm ChongZhiRenWu |
Réinitialiser tous les tutoriels et quêtes de guide pour votre personnage. |
Navigation et visibilité
| Commande | Description |
|---|---|
gm Go [x] [y] [z] |
Se téléporter à des coordonnées spécifiques du monde. Utilisez GPS pour trouver vos coordonnées actuelles d'abord. |
GPS |
Afficher vos coordonnées mondiales actuelles (X, Y, Z). Utile pour les cibles de téléportation. |
gm SetAttr YinShen 1 |
Activer l'invisibilité. Les monstres et PNJ ne peuvent pas vous détecter. |
gm SetAttr YinShen 0 |
Désactiver l'invisibilité. Retour à la visibilité normale. |
gm ShowMap |
Révéler la carte entière, déverrouillant tout le brouillard de guerre pour votre personnage. |
Contrôle des PNJ et du monde
| Commande | Description |
|---|---|
gm ZhaoMu |
Recruter instantanément le PNJ ciblé dans votre tribu. |
gm ClearAllNpc |
Supprimer tous les PNJ non-joueurs du serveur. Utilisez avec prudence -- affecte tous les PNJ sur l'ensemble du serveur. |
gm ClearSelect |
Supprimer l'entité actuellement sélectionnée/ciblée (PNJ, créature ou objet). |
gm ShuaXinZhiBei |
Rafraîchir et faire repousser toute la végétation et les plantes récoltables à proximité. |
gm KeJiShu |
Débloquer tous les nœuds de l'arbre technologique pour votre personnage. |
Gestion des invasions et de la chaleur
| Commande | Description |
|---|---|
gm ShowReDu |
Afficher le graphique actuel de chaleur d'invasion, montrant les niveaux de menace dans différentes zones. |
gm ClearAllReDu |
Effacer toute la chaleur d'invasion sur la carte, remettant les niveaux de menace à zéro. |
gm AddReDu [value] |
Augmenter manuellement la chaleur d'invasion de la quantité spécifiée. Une chaleur plus élevée attire davantage d'invasions. |
Serveur et débogage
| Commande | Description |
|---|---|
gm exit |
Arrêter le serveur proprement avec une sauvegarde. C'est la manière la plus sûre d'arrêter le serveur depuis le jeu. |
Debuginfo 1 |
Activer la superposition de surveillance des performances du serveur, affichant le taux de tick, le nombre d'entités et l'utilisation des ressources. |
Debuginfo 0 |
Désactiver la superposition de surveillance des performances du serveur. |
Utilisez les commandes avec parcimonie. Les commandes d'administration peuvent avoir un impact significatif sur la stabilité du serveur et l'expérience des joueurs. Faire apparaître un grand nombre d'entités, supprimer des PNJ sur tout le serveur ou modifier rapidement les données du monde peut provoquer des ralentissements ou des plantages. Testez les commandes pendant une période de faible affluence en premier.
Commandes de gestion du serveur
Ces commandes sont utilisées pour la gestion à l'échelle du serveur et peuvent être exécutées en jeu (via la console) et à distance (via RCON/Telnet).
Contrôle du serveur
| Commande | Description |
|---|---|
SaveWorld |
Forcer une sauvegarde immédiate du monde en mémoire (et éventuellement sur disque). À utiliser avant d'effectuer des opérations risquées. |
SaveAndExit [seconds] |
Sauvegarder le monde et arrêter le serveur après le nombre de secondes spécifié. Les joueurs reçoivent un compte à rebours d'avertissement. |
StopCloseServer |
Annuler un arrêt en attente qui a été initié avec SaveAndExit. |
shutdown [seconds] |
Initier un arrêt propre du serveur avec le compte à rebours spécifié en secondes. |
broadcast [message] |
Envoyer un message global à tous les joueurs connectés. Utile pour les annonces et les avertissements. |
Administration des joueurs (à distance)
| Commande | Description |
|---|---|
List_AllPlayers |
Lister tous les comptes joueurs enregistrés sur le serveur (en ligne et hors ligne). |
List_OnlinePlayers |
Lister tous les joueurs actuellement connectés avec leurs Steam ID et noms de personnage. |
List_Guilds |
Lister toutes les tribus (guildes) sur le serveur avec le nombre de membres. |
kick [PlayerName] |
Expulser un joueur du serveur par nom de personnage. |
ban [PlayerName] |
Bannir un joueur du serveur. Il ne pourra plus se reconnecter. |
CreateItemForPlayer [SteamID] [ItemID] [Amount] |
Ajouter des objets directement dans l'inventaire d'un joueur spécifique par Steam ID. |
GotoPosition [SteamID] [x] [y] [z] |
Téléporter un joueur spécifique aux coordonnées du monde. |
FlyMode [SteamID] [0/1] |
Activer (1) ou désactiver (0) le mode fantôme/vol pour un joueur. |
Informations du serveur
| Commande | Description |
|---|---|
ServerFPS |
Afficher le taux de tick actuel du serveur (FPS). Les serveurs en bonne santé devraient maintenir plus de 30 FPS. |
Show_Coefficient_Settings |
Lister tous les paramètres de coefficients de jeu actuels depuis GameXishu.json. |
Set_Coefficient [key] [value] |
Modifier un coefficient de jeu en temps réel sans éditer de fichiers. Les changements prennent effet immédiatement. |
List_AllTalent [level] |
Voir tous les dons naturels (talents) disponibles au niveau spécifié. |
Débogage et avancé
| Commande | Description |
|---|---|
Dump_AllActorPositions |
Exporter toutes les positions des acteurs dans un fichier de données pour le débogage de l'état du monde. |
DrawActorImage |
Générer une visualisation des positions des acteurs sur la carte. |
ExecScriptCommands [filename] |
Exécuter un fichier batch de commandes. Utile pour exécuter plusieurs commandes à la fois. |
Accès RCON
RCON (Remote Console) vous permet d'exécuter des commandes serveur à distance sans être connecté au jeu. Soulmask prend en charge RCON et Telnet pour l'administration à distance.
Activer RCON
RCON est désactivé par défaut et doit être activé via les paramètres de démarrage :
- Dans GPanel, allez dans l'onglet Startup.
- Ajoutez les paramètres suivants (via les paramètres de démarrage supplémentaires ou en contactant le support pour les faire ajouter) :
-rconpsw="YOUR_RCON_PASSWORD" -rconport=19000 - Redémarrez le serveur.
Sécurité RCON. L'implémentation RCON de Soulmask utilise une liste blanche d'IP pour la sécurité. Seules les adresses IP autorisées peuvent se connecter au service RCON. Consultez la documentation du serveur ou les fichiers de configuration pour l'emplacement de la liste blanche si vous devez ajouter votre IP.
Se connecter via RCON
Une fois RCON activé, vous pouvez vous connecter en utilisant n'importe quel client RCON standard :
- Téléchargez un client RCON tel que rcon-cli ou un outil avec interface graphique comme mcrcon.
- Connectez-vous à votre serveur en utilisant :
- Hôte : L'adresse IP de votre serveur
- Port : Le port RCON (par défaut
19000) - Mot de passe : Le mot de passe RCON que vous avez défini avec
-rconpsw
- Une fois connecté, tapez
helppour voir la liste des commandes disponibles.
Accès Telnet
Soulmask prend également en charge l'administration par Telnet sur le port Echo (par défaut 18888). Telnet est restreint aux connexions locales uniquement par défaut et ne nécessite pas de redirection de port supplémentaire. Ceci est principalement utilisé pour l'administration scriptée sur la machine du serveur elle-même.
Exemple de session 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
StopCloseServerArrêt correct du serveur
Il existe plusieurs méthodes sûres pour arrêter un serveur Soulmask. Utilisez toujours l'une d'entre elles pour éviter la perte de données :
- Bouton Stop de GPanel : La méthode la plus simple. Cliquez sur Stop dans l'onglet Console de GPanel.
- Commande en jeu : Authentifiez-vous en tant qu'administrateur et exécutez
gm exitpour sauvegarder et arrêter. - RCON/Telnet : Exécutez
shutdown [seconds]ouSaveAndExit [seconds]pour un arrêt avec compte à rebours qui laisse aux joueurs le temps de se préparer.
Évitez de forcer l'arrêt du serveur. Utiliser le bouton Kill de GPanel ou forcer la terminaison du processus sautera l'étape de sauvegarde. Toute progression depuis la dernière sauvegarde automatique sur disque sera perdue. N'utilisez Kill qu'en dernier recours lorsque le serveur est complètement non réactif.
Conseils pour les administrateurs de serveur
- Configurez des sauvegardes automatiques. Utilisez
-initbackupet-backupinterval=30pour créer des instantanés de sauvegarde réguliers. - Surveillez les FPS du serveur. Utilisez la commande
ServerFPSrégulièrement. Si le taux de tick descend en dessous de 15-20 FPS, le serveur est en difficulté et pourrait nécessiter une optimisation ou un redémarrage. - Utilisez
Set_Coefficientpour l'ajustement en direct. Vous pouvez modifier les paramètres de jeu en temps réel sans redémarrer le serveur. Exécutez d'abordShow_Coefficient_Settingspour voir les valeurs actuelles. - Planifiez des redémarrages réguliers. Redémarrez le serveur quotidiennement pour libérer les fuites de mémoire et appliquer les mises à jour en attente.
- Annoncez avant la maintenance. Utilisez toujours la commande
broadcastpour avertir les joueurs avant les redémarrages du serveur ou les fenêtres de maintenance. - Utilisez
SaveWorldavant les opérations risquées. Forcez une sauvegarde avant d'effectuer des modifications significatives comme la suppression de PNJ ou la modification de coefficients.
Articles connexes
- Guide de configuration du serveur Soulmask
- Comment trouver l'IP et le port de votre serveur
- Comment téléverser des fichiers via SFTP
- Premiers pas avec votre nouveau serveur
Besoin d'aide ?
Si vous avez besoin d'une assistance supplémentaire concernant les commandes d'administration Soulmask ou la gestion du serveur, veuillez ouvrir un ticket de support et notre équipe sera ravie de vous aider.
