Configurer son serveur Soulmask : paramètres de lancement et GameXishu.json expliqués
Vous venez de louer votre serveur Soulmask et vous voulez personnaliser le mode de jeu, le nombre de joueurs, les mots de passe ou les multiplicateurs de gameplay ? Ce guide détaille chaque paramètre important — des arguments de lancement au fichier GameXishu.json — pour que votre serveur corresponde exactement à ce que vous et votre tribu recherchez.
Toutes les infos techniques sont vérifiées à partir de la documentation communautaire et des retours serveur actuels. Si vous n’avez pas encore de serveur, commencez par louer un serveur Soulmask chez HebergTonServ — installation automatique, 20 Go de RAM et support 24/7.
⚠️ Règle d’or : toujours arrêter le serveur avant d’éditer un fichier de configuration. Les modifications faites serveur allumé seront écrasées à l’arrêt.
Les deux niveaux de configuration
Soulmask se configure à deux niveaux :
| Niveau | Fichier / Méthode | Ce que ça contrôle |
|---|---|---|
| Paramètres de lancement | Ligne de commande du serveur | Ports, mode PvE/PvP, joueurs max, mots de passe, carte, sauvegardes |
| Gameplay | GameXishu.json ou Panel GM in-game | XP, récolte, combat, survie, tribu, bâtiments, invasions, PvP |
Les paramètres de lancement sont prioritaires sur les fichiers de configuration.
Paramètres de lancement
Ces arguments se configurent dans la ligne de commande de démarrage du serveur. Chez un hébergeur Soulmask comme HebergTonServ, vous les modifiez depuis la section Startup ou Variables de démarrage de votre panel.
Réseau et ports
| Paramètre | Défaut | Description |
|---|---|---|
-Port=N | 8777 | Port de jeu principal (TCP/UDP) |
-QueryPort=N | 27015 | Port de requête Steam (UDP) — nécessaire pour apparaître dans le navigateur serveur |
-EchoPort=N | 18888 | Port console Telnet (TCP) |
Chez HebergTonServ, ces ports sont préconfigurés automatiquement. Pas besoin d’y toucher sauf configuration avancée (cluster).
Joueurs et mots de passe
| Paramètre | Défaut | Description |
|---|---|---|
-SteamServerName="nom" | — | Nom affiché dans la liste des serveurs Steam |
-MaxPlayers=N | 50 | Nombre maximum de joueurs (max technique : 70) |
-PSW="motdepasse" | — | Mot de passe pour rejoindre le serveur (optionnel) |
-adminpsw="motdepasse" | — | Mot de passe administrateur pour le panel GM in-game |
Mode de jeu
| Paramètre | Description |
|---|---|
-pve | Active le mode PvE — pas de dégâts entre joueurs |
-pvp | Active le mode PvP — dégâts entre joueurs activés |
Un seul à la fois. Si aucun n’est spécifié, le serveur démarre en PvE par défaut.
Sauvegardes
| Paramètre | Défaut | Description |
|---|---|---|
-saving=N | 300 | Intervalle de sauvegarde automatique en secondes (5 min par défaut) |
-backup=N | 900 | Intervalle de backup en secondes (15 min par défaut) |
-initbackup | — | Crée un backup automatique à chaque démarrage du serveur |
Conseil : sur un serveur actif, réduisez
-savingà180(3 min) pour minimiser la perte de progression en cas de crash.
Carte (map)
| Carte | Valeur de lancement | Description |
|---|---|---|
| Forêt de Brume | Level01_Main | Carte originale — jungle, ruines, montagnes |
| Sables Mouvants | DLC_Level01_Main | Carte DLC — désert égyptien, pyramides |
La carte se définit dans le premier argument de la ligne de commande, avant les flags.
Tribu et cluster
| Paramètre | Défaut | Description |
|---|---|---|
-GongHuiMaxMember=N | 20 | Nombre maximum de membres par tribu/guilde |
-gamedistindex=N | 0 | Index de région (0–7) pour les événements et fuseaux horaires |
-serverid=N | — | Identifiant serveur pour le mode cluster |
-KaiQiKuaFu | — | Active le mode cross-serveur (cluster) |
Exemple de ligne de commande complète
WSServer-Win64-Shipping.exe Level01_Main -server -log -UTF8Output -forcepassthrough -MULTIHOME=0.0.0.0 -Port=8777 -QueryPort=27015 -EchoPort=18888 -SteamServerName="Ma Tribu FR" -MaxPlayers=50 -PSW="MonMotDePasse" -adminpsw="AdminSecret42" -pve -saving=180 -backup=600 -initbackup -GongHuiMaxMember=30Les 4 modes de jeu expliqués
Soulmask propose 4 modes de jeu distincts, chacun modifiant profondément l’expérience :
| Mode | Style de jeu | Public cible |
|---|---|---|
| Survie | Progression classique, exploration, craft | La majorité des joueurs |
| Tribu | Gestion de colonie, automatisation, arbres technologiques, réputation | Joueurs orientés gestion/simulation |
| Guerrier | Progression accélérée, pas de dégradation de bâtiments, pas d’invasions | Joueurs orientés combat rapide |
| PvP | Combat entre joueurs activé (combinable avec les 3 modes ci-dessus) | Compétiteurs |
Le mode (Survie/Tribu/Guerrier) se choisit à la création du monde. Le PvE/PvP se choisit via les paramètres de lancement (-pve ou -pvp).
GameXishu.json : le fichier de gameplay
Emplacement
WS/Saved/GameplaySettings/GameXishu.jsonSur HebergTonServ, ouvrez le File Manager depuis votre panel, naviguez dans WS/Saved/GameplaySettings/ et cliquez sur GameXishu.json pour l’éditer.
Important : ce fichier n’apparaît qu’après le premier démarrage du serveur. Si vous ne le trouvez pas, lancez le serveur une fois puis arrêtez-le.
Structure du fichier
GameXishu.json contient 3 sections numérotées ("0", "1", "2") avec des paramètres identiques. Chaque section correspond à un mode de jeu. Pour que vos modifications s’appliquent quel que soit le mode, éditez les 3 sections avec les mêmes valeurs.
{
"0": {
"ExpRatio": 1,
"CaiJiDiaoLuoRatio": 1,
"ShiWuXiaoHaoRatio": 1,
...
},
"1": {
"ExpRatio": 1,
"CaiJiDiaoLuoRatio": 1,
"ShiWuXiaoHaoRatio": 1,
...
},
"2": {
"ExpRatio": 1,
"CaiJiDiaoLuoRatio": 1,
"ShiWuXiaoHaoRatio": 1,
...
}
}Catégories de paramètres
Le fichier contient plus de 150 paramètres regroupés en grandes catégories :
| Catégorie | Exemples de paramètres | Ce que ça contrôle |
|---|---|---|
| XP et progression | ExpRatio, MaxLevel, ShuLianDuExpRatio | Vitesse de montée en niveau et compétences |
| Récolte et ressources | CaiJiDiaoLuoRatio, CaiKuangDiaoLuoRatio, FaMuDiaoLuoRatio | Quantité de ressources récoltées |
| Survie | ShiWuXiaoHaoRatio, ShuiXiaoHaoRatio, NaiJiuXiShu | Faim, soif, durabilité des outils |
| Combat | DamageYeShengRatio, BeDamageByYeShengRatio | Dégâts infligés et reçus |
| Tribu et animaux | GeRenMaxZhaoMuCount, DongWuDamageRatio, FanZhiJianGeRatio | Recrutement, taming, élevage |
| Bâtiments | JianZhuFuLanKaiGuan, JianZhuFuLanMul | Dégradation et réparation |
| Invasions | RuQinKaiGuan, RuQinQiangDuXiShu | Raids PNJ sur votre base |
| PvP | PVP_GAPVPDamageRatio, PVP_ShangHaiRatio_JinZhan | Dégâts entre joueurs |
| Temps et monde | GameWorldTimePower, GameWorldDayTimePortion | Vitesse du cycle jour/nuit |
Les noms des paramètres sont en pinyin chinois (romanisation du mandarin). Ce guide et notre tuto dédié à la difficulté fournissent les traductions de chaque paramètre.
Pour le détail complet de chaque paramètre avec ses valeurs et son impact gameplay, consultez notre guide dédié : Régler la difficulté de son serveur Soulmask.
Méthode alternative : le panel GM in-game
Soulmask propose un panel d’administration in-game (GM Menu) pour modifier les paramètres de gameplay sans éditer de fichier :
- Connectez-vous à votre serveur en jeu
- Ouvrez la console avec la touche ` ou ~
- Tapez :
GM key VotreMotDePasseAdmin - Un menu graphique s’ouvre avec toutes les catégories de réglages
Avantage : interface visuelle, pas de risque de casser le JSON. Inconvénient : certains paramètres peuvent ne pas persister correctement entre les redémarrages — pour des modifications permanentes, préférez l’édition directe de
GameXishu.json.
Workflow : modifier la configuration sans casser le serveur
- Arrêtez le serveur depuis votre panel
- Ouvrez le File Manager
- Naviguez jusqu’au fichier à éditer
- Copiez le fichier en
.bakavant toute modification - Modifiez les valeurs souhaitées
- Si vous éditez
GameXishu.json, modifiez les 3 sections (0, 1, 2) avec les mêmes valeurs - Cliquez sur Save Content
- Redémarrez le serveur
- Vérifiez en jeu que les changements sont bien appliqués
FAQ
Mon fichier GameXishu.json n’existe pas, que faire ?
Lancez le serveur une première fois, attendez qu’il soit complètement démarré, puis arrêtez-le proprement. Le fichier sera généré dans WS/Saved/GameplaySettings/.
PvE ou PvP, je peux changer en cours de route ?
Oui, il suffit de modifier le paramètre de lancement (-pve ou -pvp) et de redémarrer le serveur.
Quelle carte choisir entre Forêt de Brume et Sables Mouvants ?
Forêt de Brume (Level01_Main) est la carte originale avec jungle, ruines et montagnes. Sables Mouvants (DLC_Level01_Main) est la carte DLC thème égyptien avec désert, pyramides et dirigeables. Les deux sont jouables sur serveur dédié.
Pourquoi les noms de paramètres sont en chinois ?
Soulmask est développé par CampFire Studio, un studio chinois. Les noms des paramètres dans GameXishu.json sont en pinyin (romanisation du mandarin). Par exemple, ShiWuXiaoHaoRatio signifie “ratio de consommation de nourriture”.
Faut-il modifier les 3 sections du GameXishu.json ?
Oui, les sections "0", "1" et "2" correspondent aux différents modes de jeu. Pour être sûr que vos modifications s’appliquent, éditez les 3 sections avec les mêmes valeurs.
Comment activer le mot de passe admin pour le GM Panel ?
Ajoutez le paramètre -adminpsw="VotreMotDePasse" dans la ligne de commande de démarrage. En jeu, ouvrez la console et tapez GM key VotreMotDePasse.
Conclusion
Bien configurer votre serveur Soulmask — des paramètres de lancement au fichier GameXishu.json — vous permet de créer exactement l’expérience tribale que votre communauté recherche. Pour aller plus loin dans le réglage du gameplay, consultez notre guide complet sur la difficulté Soulmask.
Pour un hébergeur Soulmask avec panel intuitif, File Manager intégré, 20 Go de RAM et support 24/7, HebergTonServ est la référence en France dès 25,90€/mois.



