LibJF — Bibliothèque technique et noyau pour le support de mods tiers dans Minecraft

LibJF — Bibliothèque technique et noyau pour le support de mods tiers dans Minecraft

LibJF est une bibliothèque modulaire de l'auteur JFronny, contenant un ensemble de composants partagés pour ses propres mods. Sur le PC d'un joueur, ce mod n'est généralement pas installé seul, mais comme une dépendance obligatoire — sans lui, les mods respectifs ne démarreront pas. LibJF n'ajoute ni recettes, ni créatures, ni nouveaux blocs à Minecraft. Sa tâche est différente : extraire les fonctionnalités répétitives — format de configuration, système de traduction, serveur HTTP local, deux tags utilitaires — dans un projet séparé et les réutiliser à travers différents mods du même développeur.

Rôle dans un Modpack

La bibliothèque est divisée en modules distincts, chacun responsable de sa propre tâche : le format des fichiers de configuration et leur menu en jeu, les tags d'objets, la traduction, les composants réseau. Les mods dépendant de LibJF ne chargent que les modules qu'ils utilisent réellement. Par conséquent, après le premier lancement du jeu, ce n'est pas un seul fichier qui apparaît dans le dossier config/, mais plusieurs — un par module actif.

L'un des effets de base que le joueur remarquera tout de suite est le rechargement automatique des configurations. Le paramètre watchForChanges est activé par défaut : si vous modifiez un fichier de configuration fonctionnant via LibJF, les modifications seront appliquées sans redémarrer le jeu.

Tags universels pour les objets et armures

LibJF ajoute deux tags disponibles à la fois pour les autres mods et pour les datapacks vanilla :

Les tags eux-mêmes sont vides — ils sont remplis par un datapack ou un mod tiers. Pour rendre, par exemple, un ensemble complet en cuir "impénétrable" en survie, il suffit de créer un petit datapack qui ajoute minecraft:leather_helmet, minecraft:leather_chestplate, minecraft:leather_leggings et minecraft:leather_boots au fichier de tag libjf:overpowered.

Sous-système de traduction

Le module libjf-translate-v1 donne aux autres mods du développeur l'accès à un service de traduction de chaînes. La bibliothèque elle-même ne traduit rien dans le chat ou l'interface — elle détermine seulement par quel service externe les requêtes passeront si un mod consommateur les appelle. Quatre options de fournisseurs sont supportées :

• Google — interface publique de Google Translate (valeur par défaut).

• DeepLX — implémentation ouverte de l'API DeepL.

• LibreTranslate — solution open-source auto-hébergée ; nécessite de spécifier manuellement l'adresse de l'instance.

• Noop — un bouchon qui renvoie le texte d'entrée tel quel ; utile pour les tests et pour désactiver complètement la traduction.

Un paramètre séparé throttleMillis définit la pause minimale entre les appels au service. Cette restriction est nécessaire pour éviter les bannissements temporaires de l'API gratuite lors de requêtes fréquentes d'un mod.

Serveur Web local

Le module libjf-web-v1 lance un petit serveur HTTP à l'intérieur du jeu. Il est utilisé par les autres mods de l'auteur lorsqu'il est nécessaire de fournir au client plus qu'un simple paquet réseau — par exemple, une page statique ou un fichier de prévisualisation. Sur l'espace de travail standard d'un joueur, ce module est généralement silencieux : le port n'est ouvert que localement (127.0.0.1), et le partage de fichiers est désactivé.

Les administrateurs de serveurs privés peuvent activer le partage de fichiers arbitraires à partir du dossier config/wwwroot en tant que ressources statiques via un paramètre de configuration séparé — il s'agit d'une fonctionnalité optionnelle, non activée par défaut.

Conclusion

LibJF est une bibliothèque de dépendances requise lorsqu'un modpack contient un mod du même développeur ou un datapack qui utilise les tags libjf:overpowered ou libjf:shulker_boxes_illegal. Contrairement à d'autres bibliothèques de cette catégorie, elle se distingue par une architecture modulaire et la présence d'un serveur HTTP local associé à une couche de traduction, ce que la plupart des bibliothèques auxiliares n'offrent pas. Pour un modpack classique Minecraft Java Edition vanilla, il n'y a aucune raison d'installer LibJF ; pour les modpacks contenant des mods de JFronny, c'est un composant obligatoire.