JamLib — une bibliothèque technique pour d'autres mods Minecraft

JamLib — une bibliothèque technique pour d'autres mods Minecraft

JamLib est un mod-bibliothèque pour Minecraft qui, à lui seul, n'ajoute au jeu ni objets, ni blocs, ni mobs, ni structures. C'est un wrapper utilitaire qui offre aux auteurs d'autres mods ce qui suit : une abstraction de plateforme entre les loaders, un système de fichiers de configuration prêt à l'emploi et un détecteur de fichiers jar reconditionnés. Sans cette bibliothèque, les mods qui la requièrent ne se lanceront tout simplement pas.

Ce que fait le mod

La bibliothèque résout trois tâches à la fois pour le développeur :

• Des abstractions de plateforme basées sur Architectury — le même code fonctionne sur Fabric, Forge, NeoForge et Quilt sans branches séparées.

• Une API de configuration au format JSON5 avec un écran de réglages automatique dans le jeu.

• Une vérification du fichier jar d'un mod à la recherche de signes de reconditionnement depuis des «miroirs» pirates.

Du point de vue du joueur, la bibliothèque n'ajoute rien au gameplay. La seule chose que l'on peut remarquer est l'apparition d'une entrée dans le menu des mods pour tout mod utilisant JamLib pour ses réglages. Si de tels mods sont présents dans le pack, la fenêtre correspondante affichera une page avec des curseurs, des interrupteurs et des champs de saisie, générée automatiquement.

Configurations JSON5

Le JSON standard n'autorise pas les commentaires dans le code. JSON5, avec lequel la bibliothèque fonctionne via la dépendance Jankson, le permet. En pratique, cela signifie que les fichiers de réglages des mods construits sur JamLib ressemblent à des .json5 et contiennent déjà des commentaires décrivant chaque paramètre avec sa valeur par défaut juste au-dessus.

Les fichiers conservent les modifications de l'utilisateur lors de la réécriture : si vous ajoutez votre propre note sur une ligne commençant par //, elle restera en place après le prochain enregistrement de la configuration. Les bibliothèques JSON standard ne savent pas faire cela.

Les écrans de réglages sont générés séparément. Sur Fabric et Quilt, l'interface est reprise via le menu des mods standard ; sur Forge et NeoForge, via l'API intégrée des écrans de configuration du loader. Les auteurs de mods n'ont pas besoin d'écrire une interface graphique à la main : JamLib prend les champs de la classe de configuration et construit pour eux des widgets avec validation — plage de nombres, expression régulière pour une chaîne, avertissement sur la nécessité de redémarrer le jeu.

Détecteur de mods reconditionnés

Une fonction distincte vérifie si le fichier .jar du mod installé a été téléchargé depuis une source officielle. Certains sites reconditionnent des mods sous leur propre nom et y ajoutent parfois des logiciels tiers. JamLib compare le nom réel du fichier au champ JamLib-File-Name présent dans son manifeste. S'ils ne correspondent pas, un avertissement s'affiche dans le chat après le chargement du monde. Le message s'affiche une fois par fichier suspect, après quoi le nom de ce .jar est mémorisé.

Cette vérification ne concerne que les mods dont les auteurs ont volontairement ajouté JamLib-File-Name à leur manifeste (c'est-à-dire des mods du même développeur ou de ceux qui ont intégré cette fonction manuellement). La bibliothèque ne scanne pas tous les .jar du dossier mods à la recherche de virus ou de code malveillant — ce n'est pas un antivirus.

Conclusion

JamLib libère un développeur de mod de l'écriture manuelle d'un système de configuration et d'une abstraction de plateforme pour quatre loaders à la fois. Installer JamLib n'a de sens qu'associé à un mod dépendant qui le requiert. Si un pack ne contient aucun mod de JamCoreModding ni d'un autre auteur tiers basé sur cette bibliothèque, le .jar de JamLib restera simplement dans le dossier mods sans rôle actif.