Forge Config API Port — Minecraft Java Edition

Minecraft vanilla ne contient pas d'outils intégrés pour configurer facilement les paramètres du jeu ou des modifications, ce qui oblige les développeurs à créer leurs propres systèmes de sauvegarde des configurations. Le chargeur de mods Forge propose une solution clé en main sous la forme de son propre système de configuration, mais Fabric n'a historiquement pas de standard unique pour cela. C'est pourquoi les créateurs de mods multiplateformes doivent écrire du code de configuration distinct pour chaque chargeur, consacrant beaucoup de temps à des tâches routinières. La bibliothèque Forge Config API Port résout ce problème en portant l'interface de configuration éprouvée de Forge sur Fabric et Quilt.

Comment fonctionne la bibliothèque

Forge Config API Port agit comme un intermédiaire entre le code de la modification et le système de fichiers du jeu. Elle recrée entièrement les packages originaux net.minecraftforge.common.ForgeConfigSpec et net.neoforged.fml.config dans l'environnement Fabric. Le développeur écrit la description de la configuration une seule fois en utilisant la syntaxe standard de Forge, et la bibliothèque crée automatiquement les fichiers correspondants sur le disque et gère leur chargement.

Format des fichiers de configuration TOML

La bibliothèque enregistre tous les paramètres au format TOML. Ce format offre une structure pratique pour la lecture et l'édition à l'aide d'un simple éditeur de texte. Chaque paramètre peut contenir des commentaires, des valeurs par défaut, ainsi que des limites claires pour les valeurs autorisées (nombre minimal et maximal). Les fichiers de configuration apparaissent automatiquement dans le dossier config du répertoire racine du jeu après le premier lancement de la modification. Ils ont l'extension .toml et le nom spécifié par le développeur du mod.

Synchronisation automatique et rechargement dynamique

L'une des fonctionnalités les plus importantes de Forge Config API Port est la prise en charge intégrée de la synchronisation et du rechargement dynamique des configurations :

• Synchronisation entre le serveur et le client (Sync) : lorsqu'un joueur se connecte au serveur, le serveur envoie automatiquement ses paramètres au client. Cela évite les conflits dus à des versions de configuration différentes entre les joueurs sur le serveur.

• Rechargement dynamique (Reload) : la bibliothèque surveille les modifications des fichiers TOML en temps réel. Si vous modifiez et enregistrez le fichier de configuration pendant le jeu, Forge Config API Port mettra immédiatement à jour les paramètres en mémoire vive sans avoir à redémarrer le client Minecraft.

Ces mécanismes fonctionnent automatiquement, évitant aux développeurs d'avoir à coder eux-mêmes les interactions réseau pour synchroniser les valeurs de configuration.

Importance pour les joueurs et les développeurs

Pour les joueurs ordinaires, Forge Config API Port n'ajoute aucun contenu visible, nouveau bloc ou objet. Son rôle est d'assurer le bon fonctionnement des autres modifications. Sans l'installation de cette bibliothèque, le jeu ne démarrera tout simplement pas si d'autres mods font référence à ses classes. Cette modification est principalement requise pour les utilisateurs de Fabric, car Forge et NeoForge intègrent ces fonctions par défaut dans leur structure.

Pour les développeurs, la bibliothèque est un outil indispensable lors de la création de projets multiplateformes. Elle permet de :

1. Économiser des centaines de lignes de code qui étaient auparavant consacrées au développement d'une logique de sauvegarde des paramètres distincte pour chaque chargeur.

2. Garantir la même expérience d'administration des mods pour les utilisateurs finaux, car les fichiers de configuration ont une structure identique sur Fabric et Forge.

3. Utiliser les puissants outils de validation des valeurs de Forge, qui corrigent automatiquement les saisies incorrectes des utilisateurs en rétablissant les valeurs par défaut en cas d'erreur.

Modifications dépendantes populaires

Le développeur de la bibliothèque, connu sous le pseudonyme Fuzs (ou Fuzs_), l'utilise dans tous ses mods populaires. Voici quelques exemples connus :

• Easy Magic : un mod qui modifie la mécanique de la table d'enchantement, permettant de conserver les objets dans l'inventaire de la table et ajoutant de nouvelles méthodes pour améliorer les enchantements.

• Trading Post: un bloc qui regroupe les offres commerciales de tous les villageois environnants dans une interface unique.

• Visuality : un mod d'effets visuels qui ajoute des particules réalistes de terre, d'étincelles et d'éclaboussures d'eau lors de diverses actions des créatures.

• Easy Shulker Boxes : permet d'interagir avec les boîtes de shulker directement depuis l'inventaire sans avoir à les poser au sol.

En dehors des projets de Fuzs, des centaines d'autres développeurs utilisent Forge Config API Port pour porter leurs créations de Forge vers Fabric, offrant ainsi aux joueurs l'accès à une immense bibliothèque de contenus de qualité.