Soulmask Intermédiaire 12 min de lecture

Configurer son serveur Soulmask : paramètres de lancement et GameXishu.json expliqués

Guide complet pour configurer votre serveur Soulmask : paramètres de lancement, ports, modes PvE/PvP, mots de passe, sauvegardes, GameXishu.json et panel GM expliqués pas à pas.

Configurer son serveur Soulmask : paramètres de lancement et GameXishu.json expliqués

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 :

NiveauFichier / MéthodeCe que ça contrôle
Paramètres de lancementLigne de commande du serveurPorts, mode PvE/PvP, joueurs max, mots de passe, carte, sauvegardes
GameplayGameXishu.json ou Panel GM in-gameXP, 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ètreDéfautDescription
-Port=N8777Port de jeu principal (TCP/UDP)
-QueryPort=N27015Port de requête Steam (UDP) — nécessaire pour apparaître dans le navigateur serveur
-EchoPort=N18888Port 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ètreDéfautDescription
-SteamServerName="nom"Nom affiché dans la liste des serveurs Steam
-MaxPlayers=N50Nombre 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ètreDescription
-pveActive le mode PvE — pas de dégâts entre joueurs
-pvpActive 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ètreDéfautDescription
-saving=N300Intervalle de sauvegarde automatique en secondes (5 min par défaut)
-backup=N900Intervalle de backup en secondes (15 min par défaut)
-initbackupCré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)

CarteValeur de lancementDescription
Forêt de BrumeLevel01_MainCarte originale — jungle, ruines, montagnes
Sables MouvantsDLC_Level01_MainCarte 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ètreDéfautDescription
-GongHuiMaxMember=N20Nombre maximum de membres par tribu/guilde
-gamedistindex=N0Index de région (0–7) pour les événements et fuseaux horaires
-serverid=NIdentifiant serveur pour le mode cluster
-KaiQiKuaFuActive 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=30

Les 4 modes de jeu expliqués

Soulmask propose 4 modes de jeu distincts, chacun modifiant profondément l’expérience :

ModeStyle de jeuPublic cible
SurvieProgression classique, exploration, craftLa majorité des joueurs
TribuGestion de colonie, automatisation, arbres technologiques, réputationJoueurs orientés gestion/simulation
GuerrierProgression accélérée, pas de dégradation de bâtiments, pas d’invasionsJoueurs orientés combat rapide
PvPCombat 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.json

Sur 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égorieExemples de paramètresCe que ça contrôle
XP et progressionExpRatio, MaxLevel, ShuLianDuExpRatioVitesse de montée en niveau et compétences
Récolte et ressourcesCaiJiDiaoLuoRatio, CaiKuangDiaoLuoRatio, FaMuDiaoLuoRatioQuantité de ressources récoltées
SurvieShiWuXiaoHaoRatio, ShuiXiaoHaoRatio, NaiJiuXiShuFaim, soif, durabilité des outils
CombatDamageYeShengRatio, BeDamageByYeShengRatioDégâts infligés et reçus
Tribu et animauxGeRenMaxZhaoMuCount, DongWuDamageRatio, FanZhiJianGeRatioRecrutement, taming, élevage
BâtimentsJianZhuFuLanKaiGuan, JianZhuFuLanMulDégradation et réparation
InvasionsRuQinKaiGuan, RuQinQiangDuXiShuRaids PNJ sur votre base
PvPPVP_GAPVPDamageRatio, PVP_ShangHaiRatio_JinZhanDégâts entre joueurs
Temps et mondeGameWorldTimePower, GameWorldDayTimePortionVitesse 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 :

  1. Connectez-vous à votre serveur en jeu
  2. Ouvrez la console avec la touche ` ou ~
  3. Tapez : GM key VotreMotDePasseAdmin
  4. 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

  1. Arrêtez le serveur depuis votre panel
  2. Ouvrez le File Manager
  3. Naviguez jusqu’au fichier à éditer
  4. Copiez le fichier en .bak avant toute modification
  5. Modifiez les valeurs souhaitées
  6. Si vous éditez GameXishu.json, modifiez les 3 sections (0, 1, 2) avec les mêmes valeurs
  7. Cliquez sur Save Content
  8. Redémarrez le serveur
  9. 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.

Pour aller plus loin