YetAnotherConfigLib (YACL) : Une bibliothèque moderne pour configurer les mods de Minecraft

YetAnotherConfigLib (YACL) est une bibliothèque de configuration destinée aux mods Minecraft, conçue pour générer des interfaces graphiques claires et cohérentes directement intégrées au style du jeu, tout en fournissant une API complète pour la lecture et l’écriture de fichiers de configuration.

Pensé avant tout comme un outil pour les développeurs, ce mod pour Minecraft répond à un besoin précis : proposer une alternative moderne aux bibliothèques de configuration existantes, souvent limitées, spécialisées ou devenues difficiles à faire évoluer. YACL s’adresse ainsi aux créateurs de mods côté client comme à ceux qui doivent gérer des paramètres partagés entre client et serveur, sans imposer de surcouche inutile.

Caractéristiques du mod YetAnotherConfigLib

Une interface de configuration fidèle à Minecraft

YACL génère des écrans de configuration qui s’intègrent naturellement à l’interface vanilla. Typographies, espacements, comportements au clavier : l’ensemble respecte les codes visuels du jeu. Cette cohérence évite toute rupture lors de l’ouverture d’un menu de paramètres et facilite la prise en main, y compris pour des configurations complexes réparties en catégories et groupes repliables.

Un système de contrôleurs flexible

Chaque option n’est pas liée à un affichage figé. Un paramètre booléen peut, par exemple, être présenté sous forme de case à cocher ou de bouton ON/OFF, tandis qu’une valeur numérique peut utiliser un champ libre ou un curseur. YACL permet également de créer des contrôleurs personnalisés lorsque les composants fournis ne suffisent pas, offrant une grande liberté dans la conception des interfaces.

Illustration du mod Minecraft YetAnotherConfigLib montrant le lien entre interface de configuration en jeu et code développeur, avec génération dynamique des paramètres et menus natifs intégrés à Minecraft.

Des descriptions riches et interactives

Les options peuvent être accompagnées de textes explicatifs détaillés, avec gestion du survol et du clic grâce au système de composants textuels de Minecraft. YACL accepte aussi l’affichage d’images WebP, y compris animées, ou leur remplacement par des sections graphiques entièrement personnalisées. Cette approche rend les écrans de configuration plus lisibles et pédagogiques.

Organisation avancée et accessibilité

Les paramètres peuvent être structurés en onglets, catégories et groupes repliables, ce qui limite la surcharge visuelle. L’ensemble est compatible avec une navigation complète au clavier, un point important pour l’accessibilité et l’usage avec des outils comme Controlify. Cette attention portée à l’ergonomie distingue YACL des bibliothèques plus anciennes.

Sérialisation intégrée des configurations

Au-delà de l’interface graphique, YACL fournit une API de configuration capable de gérer automatiquement la sauvegarde et le chargement des paramètres. Les développeurs peuvent s’appuyer sur une sérialisation basée sur GSON, avec prise en charge du format JSON5, ce qui simplifie la gestion des fichiers et réduit les erreurs liées au code manuel.

Utilisation du mod YetAnotherConfigLib

YACL repose sur une structure simple : des catégories qui contiennent des groupes, eux-mêmes composés d’options. Chaque option est définie via un builder, auquel sont associés un nom, une description, une liaison vers la valeur réelle et un contrôleur d’affichage.

Pour afficher l’interface, le mod génère dynamiquement un écran à partir de cette configuration. Sur Fabric, l’intégration avec Mod Menu permet d’ouvrir cet écran depuis la liste des mods. Sur NeoForge, un point d’extension équivalent est disponible via la liste de mods intégrée.

Interface de configuration du mod Minecraft YetAnotherConfigLib affichant différents contrôleurs de paramètres comme des interrupteurs, curseurs numériques et champs de saisie, organisés dans une interface proche du style vanilla. — Aperçu de l’interface générée par YACL, avec plusieurs types de contrôleurs pour ajuster finement les paramètres d’un mod, des options booléennes aux valeurs numériques avancées.

Une documentation détaillée est proposée sur le wiki officiel du projet pour accompagner les premiers pas et couvrir les cas avancés, notamment l’usage de l’API de configuration sans interface graphique côté serveur.

Télécharger YetAnotherConfigLib