Configurer son serveur: les config.json

Le fichier config.json est un élément central de la configuration de votre serveur, permettant de définir des paramètres cruciaux pour l’expérience de jeu.

Qu’il s’agisse de règles générales, de spécificités pour un monde ou de l’intégration de mods, ces fichiers JSON sont votre tableau de bord.

Les paramètres globaux du serveur

Le fichier config.json principal, situé à la racine de votre dossier serveur contient les réglages qui s’appliquent à l’ensemble de votre serveur, ou « univers » comme Hytale l’appelle. C’est un véritable fichier de configuration serveur qui influence l’expérience de tous les joueurs.

Localisation : [Dossier de votre serveur]/config.json

Conseil : 
Les modifications manuelles pendant que le serveur est en cours d’exécution risquent d’être écrasées. Pensez toujours à arrêter votre serveur, modifier le fichier, puis le redémarrer pour que les changements prennent effet.

Les paramètres spécifiques aux mondes

Chaque monde dans votre univers Hytale possède son propre fichier de configuration, vous permettant de personnaliser des aspects uniques pour différentes zones de jeu. C’est idéal pour créer des mondes créatifs dédiés à la construction ou des serveurs d’exploration avec des règles distinctes.

Localisation : [Dossier de votre serveur]/universe/worlds/<nom_du_monde>/config.json

Voici un aperçu des règles de jeu et de comportement de monde que vous pouvez ajuster :

Conseil : 
Ces paramètres sont essentiels pour définir l’ambiance et les règles d’un monde spécifique, comme un serveur en mode exploration ou une arène de combat.

Les paramètres spécifiques aux mods/plugins

Les mods et plugins apportent une profondeur incroyable à Hytale, et chacun peut avoir son propre fichier de configuration.

Hytale utilise un « Codec system » pour sérialiser et désérialiser les données JSON, ce qui permet aux développeurs de créer des fichiers de configuration personnalisés et robustes.

Localisation : [Dossier de votre serveur]/plugins/com.yourgroup_YourPluginName/YourPluginConfig.example.json

Ces fichiers permettent aux utilisateurs de personnaliser le comportement d’un plugin sans modifier son code. Si un fichier de configuration est manquant, le système le générera automatiquement avec des valeurs par défaut.

Structure d’un fichier de configuration de plugin (exemple) :

{
  "LuckIncreaseChance": 0.40,
  "MaxPlayers": 100,
  "ServerMessage": "Welcome to the custom server!",
  "EnableFeature": true,
  "BannedWords": ["swear", "inappropriate"],
  "DropRateMultiplier": 1.0,
  "DebugMode": false
}

Conseil : 
Pour éviter les conflits et assurer la compatibilité, les développeurs de plugins utilisent des « Codecs » spécifiques et s’assurent que leurs clés JSON suivent une convention (PascalCase, par exemple "ServerName" et non "serverName"). Si vous êtes un administrateur, respectez scrupuleusement la casse des clés.

Meilleures pratiques et dépannage

• Sauvegardes : Avant toute modification des fichiers config.json, effectuez toujours une sauvegarde de votre serveur et de vos mondes. C’est la règle d’or !
• Syntaxe JSON : Les fichiers config.json doivent respecter la structure JSON stricte. Une virgule ou une accolade mal placée peut empêcher votre serveur ou vos plugins de démarrer. Utilisez un validateur JSON en ligne si vous avez des doutes.
• Redémarrage : La plupart des changements de configuration nécessitent un redémarrage complet du serveur pour prendre effet. Pour certains plugins, un rechargement (reload) peut suffire, mais cela doit être spécifiquement implémenté par le développeur du plugin (Doc #1).
• Documentation : Chaque mod ou plugin de qualité doit fournir sa propre documentation pour ses fichiers de configuration. Référez-vous à cette documentation pour comprendre les options spécifiques.
• Logs : En cas de problème, consultez les fichiers de log de votre serveur (logs/) pour identifier les erreurs. Ils peuvent indiquer quelle partie du config.json pose problème.
• Mods/Plugins : Les fichiers de configuration des plugins serveur sont stockés dans le dossier mods/ (ou earlyplugins/ pour les plugins de bas niveau) de votre serveur.