Sécuriser son serveur Soulmask : whitelist, ban et anti-grief

Soulmask propose un système de permissions natif beaucoup plus puissant que ce que beaucoup d’admins pensent : 5 listes (whitelist comptes, ban comptes, whitelist IP, ban IP, mute) activables via un système de bitmask. Ce guide vous explique comment sécuriser votre serveur Soulmask étape par étape, avec les vraies commandes vérifiées sur la documentation communautaire de référence.

⚠️ Prérequis : la majorité des actions de sécurité nécessitent un mot de passe admin configuré au lancement (-adminpsw="MonAdminSecret"). Sans ça, les commandes gm ne fonctionnent pas en jeu.

Où gérer la sécurité ? (in-game vs fichier vs startup)

Bonne nouvelle : éditer des fichiers .txt n’est pas obligatoire. Soulmask propose 3 niveaux d’accès pour gérer la sécurité, du plus simple au plus technique :

Astuce pratique : pour 99% des admins, les commandes gm en jeu suffisent. Vous n’aurez à toucher aux fichiers .txt que si vous voulez importer une liste de 50+ Steam IDs d’un coup. Et le fichier GameXishu.json n’est pas concerné par la sécurité — il sert uniquement au gameplay.

Dans la suite du guide, chaque action est marquée :

• ✅ = exécutable en jeu via la console
• ⚙️ = argument de démarrage (Startup du panel)
• 📄 = édition de fichier .txt (avancé, serveur arrêté)

Les 3 piliers de la sécurité Soulmask

Aucun pilier ne suffit seul. Combinez-les pour une sécurité solide.

Pilier 1 : Le système de permissions Soulmask

Les 5 types de permissions

Soulmask gère 5 listes distinctes identifiées par un ID (0 à 4) et un fichier dédié dans WS/Saved/ :

Bon à savoir : ajouter un joueur à la blacklist comptes le kick immédiatement, même si la liste n’est pas encore activée globalement.

Activer les listes : l’argument -serverpm

Sans configuration, toutes les listes sont désactivées au démarrage du serveur. Pour qu’elles soient persistantes, vous devez ajouter l’argument -serverpm=<mask> à la ligne de commande de lancement, où <mask> est la somme des masks des listes que vous voulez activer.

Exemples concrets de masks à utiliser :

Sur HebergTonServ, ajoutez cet argument dans la section Startup ou Variables de démarrage de votre panel Pterodactyl, puis redémarrez le serveur.

Les commandes admin in-game

✅ C’est ici que tout se passe au quotidien. Une fois connecté en jeu avec le mot de passe admin (gm key VotreMotDePasseAdmin), vous disposez de 4 commandes simples pour gérer toutes les listes — aucune édition de fichier nécessaire.

gm EnableServerPermissionList <type> <0|1>
gm AddServerPermissionList <type> <SteamID|IP>
gm RemoveServerPermissionList <type> <SteamID|IP>
gm ShowServerPermissionDetails

Pilier 1 — Cas pratique : bannir un joueur

Étape 1 : Activer la ban list de manière permanente

Ajoutez à votre ligne de commande de lancement :

-serverpm=2

Redémarrez le serveur.

Étape 2 : Trouver le Steam ID du joueur

Le Steam ID complet d’un joueur n’est pas affiché en jeu — seulement les 6 derniers chiffres apparaissent à côté de son pseudo. Pour récupérer son ID complet, ouvrez le log serveur :

WS/Saved/Logs/WS.log

Sur HebergTonServ, accédez-y via le File Manager ou téléchargez-le en SFTP. Cherchez le pseudo du joueur dans le log : son Steam ID (17 chiffres, format 7656110XXXXXXXXXX) apparaît à chaque connexion.

Joueurs Epic Games : leur ID est au format xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx|xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx (deux blocs hexadécimaux séparés par |). Mettez-le entre guillemets dans la commande.

Étape 3 : Bannir le joueur

Connectez-vous en jeu, ouvrez la console (` ou ~), tapez votre mot de passe admin :

gm key VotreAdminPassword

Puis bannissez le joueur :

gm AddServerPermissionList 1 76561100000000000

Le joueur est immédiatement déconnecté avec le message « Account banned by the admin. » S’il tente de revenir, il verra « Your account has been banned from accessing and logging into the server! ».

Étape 4 : Vérifier l’état des bans

gm ShowServerPermissionDetails

Affiche la liste complète des bans actifs.

Étape 5 : Débannir un joueur

gm RemoveServerPermissionList 1 76561100000000000

Whitelist : transformer son serveur en serveur privé

Pour un serveur Soulmask 100% privé (entre amis, communauté fermée), activez la whitelist comptes :

1. Ajoutez -serverpm=1 (ou plus si combiné) à la ligne de commande

2. Récupérez les Steam ID de tous vos joueurs autorisés (via le log lors d’une première connexion ou via leur profil Steam)

3. Pour chaque joueur autorisé :

   gm AddServerPermissionList 0 <SteamID>

4. Vérifiez avec gm ShowServerPermissionDetails

Important : une fois la whitelist activée, tout joueur non listé verra « Server is still self-testing! » en tentant de se connecter. Pensez à whitelister vos propres comptes admin avant d’activer la liste, sinon vous serez kické vous aussi.

Bans IP : pour les cas extrêmes

Les bans IP sont utiles contre les joueurs qui rachètent un compte Steam pour contourner un ban. Méthode :

1. Activer la blacklist IP : -serverpm=8 (ou combiné avec d’autres masks)

2. Récupérer l’IP du joueur dans WS/Saved/Logs/WS.log

3. Ajouter l’IP :

   gm AddServerPermissionList 3 12.34.56.78

Limite à connaître : ajouter une IP à la blacklist ne déconnecte pas les joueurs déjà connectés depuis cette IP. Combinez avec un kick manuel ou redémarrage.

Mute : modérer le chat sans bannir

Pour réduire au silence un joueur problématique sans le bannir :

1. Activer le mute : -serverpm=16 (ou combiné)

2. Mute la personne :

   gm AddServerPermissionList 4 <SteamID>

Le joueur ne pourra plus écrire dans le chat (aucun canal). Le joueur n’est pas notifié de son mute — il verra simplement que ses messages ne s’affichent pas.

Édition manuelle des fichiers de listes

📄 Méthode avancée — réservée aux imports en masse. Pour la gestion quotidienne (1 ban par-ci, 1 whitelist par-là), restez sur les commandes gm en jeu. L’édition de fichier ne sert que si vous voulez importer 50+ Steam IDs d’un coup.

Si vous préférez gérer les listes hors-ligne (pratique pour importer une whitelist en masse), tous les fichiers se trouvent dans WS/Saved/ :

WS/Saved/WhiteAccountList.txt
WS/Saved/BlackAccountList.txt
WS/Saved/WhiteIPList.txt
WS/Saved/BlackIPList.txt
WS/Saved/BanSpeek.txt

Format : un Steam ID (ou IP) par ligne, sans guillemets ni virgules.

Règle critique : éditez ces fichiers uniquement serveur arrêté. Si vous éditez serveur démarré, vos modifications seront écrasées au prochain arrêt. Pour modifier en live, utilisez les commandes gm.

Pilier 2 : Mots de passe robustes

Mot de passe serveur (rejoindre)

Argument de lancement :

-PSW="UnMotDePasseFortDe16CaracteresMinimum"

Empêche les inconnus de rejoindre, même si votre serveur apparaît dans la liste publique Steam.

Mot de passe admin (commandes gm)

Argument de lancement :

-adminpsw="UnAutreMotDePasseAdminUltraSecret"

Bonnes pratiques :

• Jamais le même mot de passe pour -PSW et -adminpsw
• Minimum 16 caractères, avec majuscules, chiffres et symboles
• Ne partagez le mot de passe admin qu’avec vos co-admins de confiance (ils auront un pouvoir total sur le serveur via les commandes gm)
• Régénérez les mots de passe à chaque départ d’un admin

Pilier 3 : Protection infrastructure

Les permissions et mots de passe ne suffisent pas si votre infrastructure est attaquable. Un hébergeur Soulmask sérieux doit fournir :

HebergTonServ inclut tous ces points dans son offre Soulmask à 25,90€/mois : Anti-DDoS Pletx 5 Tbps, sauvegardes quotidiennes automatiques, panel Pterodactyl en HTTPS et 2FA disponible.

Workflow complet : sécuriser un serveur fraîchement créé

1. Définir vos mots de passe (-PSW et -adminpsw) à la création du serveur
2. Activer les listes que vous voulez utiliser via -serverpm=<mask> (minimum recommandé : 2 pour la ban list)
3. Vous connecter en jeu, exécuter gm key VotreAdminPassword
4. Whitelister vos co-admins : gm AddServerPermissionList 0 <leurSteamID> (si whitelist active)
5. Vérifier la config : gm ShowServerPermissionDetails
6. Sauvegarder le serveur depuis le panel
7. Documenter dans un fichier privé (Discord admins, Notion…) : la liste des Steam ID admins, les bans actifs avec raison, les mots de passe (chiffrés)

FAQ

Soulmask a-t-il une vraie whitelist comme Minecraft ?

Oui. La whitelist comptes (type 0) bloque tout joueur non listé avec le message « Server is still self-testing! ». C’est une whitelist stricte au niveau Steam ID, plus robuste que les whitelists basées sur le nom.

Que se passe-t-il si je banni mon propre compte par erreur ?

Vous serez kické immédiatement. Pour vous débannir :

• Si vous avez l’accès au File Manager : arrêtez le serveur, ouvrez WS/Saved/BlackAccountList.txt, supprimez votre Steam ID, redémarrez
• Sinon : un autre admin doit exécuter gm RemoveServerPermissionList 1 <votreSteamID>

Comment trouver mon propre Steam ID ?

Connectez-vous une première fois sur le serveur, puis cherchez votre pseudo dans WS/Saved/Logs/WS.log. Votre Steam ID (17 chiffres) apparaît à côté.

La ban list est-elle conservée si je migre mon serveur ?

Oui. Les fichiers WhiteAccountList.txt, BlackAccountList.txt, etc. sont stockés dans WS/Saved/. Sauvegardez ce dossier avant migration et restaurez-le sur le nouveau serveur — l’argument -serverpm doit aussi être recopié dans la nouvelle ligne de commande.

Mes commandes gm ne fonctionnent pas, que vérifier ?

Trois choses :

1. Avez-vous bien défini -adminpsw="..." au lancement du serveur ?
2. Avez-vous bien tapé gm key VotreMotDePasse (sans guillemets) avant les autres commandes ?
3. La console est-elle bien activée (touche ` ou ~) ?

Les bans Soulmask sont-ils définitifs ou temporaires ?

Soulmask ne propose pas de bans temporaires natifs. Tous les bans sont permanents jusqu’à suppression manuelle. Pour des bans temporaires, gardez une trace externe (Discord, fichier admin) avec la date de débannissement et utilisez gm RemoveServerPermissionList 1 <SteamID> à la date prévue.

Puis-je bannir un joueur Epic Games ?

Oui. Son ID est au format xxxxxxxxxxxx|xxxxxxxxxxxx et doit être mis entre guillemets dans la commande :

gm AddServerPermissionList 1 "dfd0bd1a93ea428cbea6bfef1eddabca|000271a62147b0a0a1e4428759c26092"

Conclusion

Sécuriser un serveur Soulmask repose sur 3 piliers complémentaires : permissions natives (5 listes activables via -serverpm), mots de passe robustes (-PSW + -adminpsw), et protection d’infrastructure côté hébergeur. Le système de permissions de Soulmask est plus puissant que la moyenne des jeux survival — exploitez-le pleinement pour un serveur sain et durable.

Pour un hébergeur Soulmask sécurisé fournissant Anti-DDoS Pletx, sauvegardes auto, panel HTTPS et support FR 24/7, HebergTonServ reste la référence dès 25,90€/mois.

Pour aller plus loin

• Configurer son serveur Soulmask : paramètres de lancement et GameXishu.json
• Régler la difficulté de son serveur Soulmask
• Location serveur Soulmask Anti-DDoS dès 25,90€/mois