Cloth Config API — mod pour les écrans de configuration dans Minecraft

Cloth Config API — mod pour les écrans de configuration dans Minecraft

Cloth Config API est une bibliothèque exigée par des dizaines de modifications dans Minecraft afin d'afficher leurs réglages sous forme de menu en jeu plutôt que dans un fichier texte. En elle-même, elle n'ajoute rien au jeu : ni objets, ni blocs, ni nouvelles mécaniques. C'est une dépendance — sans elle, les mods qui l'ont liée ne se lancent pas et affichent une erreur dans la liste des modifications.

Quand le mod est nécessaire

La bibliothèque ne s'installe pas seule, mais avec d'autres modifications. On peut savoir si elle est nécessaire pour un pack précis de deux manières :

• Dans la description du mod sur Modrinth ou CurseForge, Cloth Config API est indiqué dans la liste Dependencies.

• Le jeu se ferme au lancement du pack et, dans le journal (logs/latest.log), apparaît une mention de l'absence de cloth-config ou de cloth-config-2.

Le nom interne cloth-config-2 appartient au même mod : c'est l'identifiant apparu à partir de la deuxième version majeure de la bibliothèque. Si quelqu'un écrit « il faut cloth-config-2 », il s'agit de la version moderne de Cloth Config API.

Comment ouvrir les paramètres du mod

Sur Forge et NeoForge, la liste des modifications installées est intégrée au menu principal du jeu — l'option Mods. À côté de chaque mod ayant lié Cloth Config apparaît une icône de paramètres. Le clic ouvre un écran distinct avec tous les paramètres propres à cette modification précise.

Sur Fabric, il n'y a pas de liste standard des mods dans le chargeur ; l'accès aux écrans de Cloth Config se fait donc via un outil externe d'affichage des modifications — il montre la liste de ce qui est installé et permet de cliquer sur le bouton à côté de l'élément voulu.

Paramètres du mod à l'aide de Cloth Config 

À quoi ressemble l'écran lui-même

Tous les écrans du mod sont construits selon le même schéma : à gauche, les catégories de paramètres ; au centre, les paramètres eux-mêmes ; en bas, les boutons Enregistrer et Annuler. Chaque paramètre est affiché par un élément d'interface correspondant au type de sa valeur. 

En haut de l'écran, pour les configurations comportant des dizaines de paramètres, se trouve un champ de recherche — il filtre la liste par nom. À côté des paramètres pour lesquels l'auteur de la modification a défini une description, une info-bulle explicative apparaît au survol du curseur.

Si l'on saisit une valeur hors de la plage autorisée ou dans un format non admis, le champ est mis en surbrillance et le bouton d'enregistrement reste inactif tant que l'erreur n'est pas corrigée. À côté de chaque paramètre se trouve un bouton de réinitialisation — il ramène la valeur à celle que l'auteur de la modification a définie comme valeur par défaut.

Conclusion

Cloth Config API est une dépendance d'infrastructure : sans elle, une partie des modifications ne se lance tout simplement pas, mais le mod lui-même n'apporte rien de visible en jeu sans d'autres mods liés. Son rôle est de ramener les réglages des différentes modifications de Minecraft à un standard visuel commun plutôt qu'à une dizaine d'interfaces de types divers. Sur Fabric et dans les packs multiplateformes, Cloth Config API reste le standard commun le plus répandu.