Plugin Minecraft BKCommonLib

🔌 À propos de BKCommonLib

BKCommonLib est une bibliothèque côté serveur et un plugin pour les serveurs Minecraft qui centralise les utilitaires de bas niveau, les aides à la réflexion, le remappage à l'exécution et de petits frameworks, afin que les autres plugins n'aient pas besoin d'utiliser NMS (les internals du serveur Minecraft) directement. Il est conçu comme une seule couche de compatibilité : lorsque Minecraft ou des forks du serveur modifient leurs internals, BKCommonLib est mis à jour afin que les plugins dépendants n'aient souvent rien à changer eux-mêmes.

🎯 Objectif

Fournir une couche de compatibilité et d'utilitaires stable et réutilisable pour les développeurs de plugins et les administrateurs de serveurs. BKCommonLib réduit la quantité de code spécifique à une version que les auteurs de plugins doivent distribuer et expose des API de plus haut niveau pour la gestion des packets, les conversions, les frameworks de commandes et d'autres opérations de bas niveau.

⚙️ Fonctionnalités

• Génération et remappage de classes à l'exécution via le système de reflection/template de Mountiplex.
• Utilitaires intégrés pour le framework de commandes (intégration avec Cloud Command Framework).
• Framework de base pour plugins avec aides au cycle de vie, vérifications de dépendances et API pratiques pour enregistrer des listeners et des commandes.
• Utilitaires de conversion de types (conversions automatiques entre les types Bukkit et les types internes lorsque nécessaire).
• Utilitaires et couches de compatibilité pour de nombreux forks et versions de serveur afin que les plugins évitent d'utiliser NMS directement.

🧩 À qui cela s'adresse

• Aux développeurs de plugins qui veulent une couche de compatibilité multi-version et des utilitaires de reflection.
• Aux administrateurs de serveurs qui gèrent des réseaux avec de nombreux plugins tiers reposant sur une bibliothèque de compatibilité commune.
• Aux opérateurs techniques de serveurs qui ont besoin d'un comportement cohérent entre les forks de Paper/Spigot.

🏗️ Exemples d'utilisation

• Un plugin utilise BKCommonLib pour gérer les différences de packets entre les versions de Minecraft afin que le fichier jar du plugin puisse rester inchangé d'une mise à jour à l'autre.
• Un développeur utilise les utilitaires de framework de commandes inclus pour implémenter des commandes annotées avec prise en charge des suggestions et de la gestion des permissions.
• Un serveur exécute des plugins qui dépendent de BKCommonLib pour réduire la fréquence des mises à jour immédiates après la sortie d'une version de Minecraft.

⚙️ Installation

📥 Configuration

• Téléchargez le fichier jar officiel de BKCommonLib depuis la distribution officielle du plugin (placez le jar fourni dans le dossier plugins/ de votre serveur).
• Redémarrez le serveur pour que le plugin se charge au démarrage.
• Vérifiez la sortie de la console du serveur pour trouver les messages de démarrage de BKCommonLib afin de confirmer qu'il s'est initialisé correctement.

📦 Dépendances

• BKCommonLib est distribué comme un plugin de bibliothèque ; aucune dépendance supplémentaire à des plugins Bukkit/Spigot n'est requise pour la bibliothèque principale elle-même.

🧠 Notes techniques

• Les logiciels de serveur compatibles confirmés incluent les forks de Spigot et de Paper (le projet liste explicitement Spigot, PaperMC, Purpur et d'autres forks courants).
• Le projet indique une compatibilité avec les versions de Minecraft 1.8 et plus récentes lors de l'utilisation de la dernière version de BKCommonLib.
• BKCommonLib est publié sous licence MIT.
• Le projet intègre/obfusque des bibliothèques tierces (par exemple Cloud Command Framework, ASM, Javassist, Objenesis, SnakeYAML et Gson), comme indiqué par l'auteur.

🤝 Quand ce plugin est utile

Si vous maintenez des plugins ou gérez un serveur où plusieurs plugins ont besoin d'un accès cohérent aux fonctionnalités de bas niveau du serveur sans que chacun gère NMS, BKCommonLib fournit une couche de compatibilité partagée et des utilitaires pour développeurs qui réduisent le code spécifique à une version par plugin et la charge de maintenance.