Plugin Minecraft ProtocolLib

🔌 À propos de ProtocolLib

ProtocolLib est une bibliothèque de plugins Minecraft qui expose le protocole réseau à d'autres plugins. Elle fournit une API pour lire, modifier, annuler et envoyer des paquets bruts entre le serveur et le client, sans obliger les plugins à dépendre des internals obfusqués du serveur.

🎯 Objectif

ProtocolLib existe pour rendre le travail au niveau des paquets fiable et facile à maintenir pour les développeurs de plugins. Il centralise l'accès aux paquets derrière une API stable afin que plusieurs plugins puissent inspecter et modifier le trafic de paquets sans se brancher directement sur les classes internes du serveur.

⚙️ Fonctionnalités

• API de type événement pour intercepter les paquets entrants et sortants.
• Accesseurs en lecture/écriture pour les champs courants des paquets (chaînes, ints, vecteurs, etc.).
• Possibilité d'annuler des paquets ou d'en modifier le contenu avant qu'ils n'atteignent leur destination.
• Utilitaire pour construire et envoyer des paquets côté serveur.
• Masque les classes obfusquées du serveur derrière un système de lecture/écriture basé sur des indices afin d'améliorer la stabilité entre versions.
• Distribué sous forme de jar côté serveur et utilisable comme dépendance de compilation pour les builds de plugins.

🧩 Pour qui c'est fait

• Développeurs de plugins qui ont besoin d'un contrôle au niveau des paquets (cosmétiques, déguisements, effets client personnalisés, utilitaires réseau).
• Administrateurs de serveurs qui exécutent des plugins dépendant d'un accès direct au protocole.

🏗️ Exemples d'utilisation

• Écouter les paquets de chat pour mettre en place un filtre côté serveur avant l'application des messages.
• Envoyer à un joueur un paquet d'explosion fabriqué pour créer un effet côté client sans modifier l'état du monde.
• Implémenter des déguisements, des animations personnalisées ou d'autres visuels uniquement côté client nécessitant une manipulation des paquets.

⌨️ Commandes

ProtocolLib ne fournit pas de commandes destinées aux utilisateurs ; c'est une bibliothèque pour développeurs plutôt qu'un plugin de fonctionnalités.

⚙️ Installation

📥 Mise en place

• Téléchargez le jar officiel de ProtocolLib et placez-le dans le dossier plugins/ de votre serveur.
• Redémarrez le serveur et vérifiez la console pour confirmer que le plugin se charge sans erreur.
• Lors du développement d'un plugin utilisant ProtocolLib, ajoutez ProtocolLib comme dépendance de compilation et déclarez-le (ou soft-depend) dans le manifeste de votre plugin.

📦 Dépendances

• ProtocolLib n'a pas besoin d'autres plugins serveur pour fonctionner ; il est destiné à être utilisé par d'autres plugins comme bibliothèque.

🧾 Configuration

• ProtocolLib crée ses propres fichiers de configuration au premier lancement. La configuration spécifique au plugin est gérée par les plugins qui utilisent ProtocolLib.

🧠 Notes techniques

• ProtocolLib fournit un point d'entrée ProtocolManager pour enregistrer des écouteurs de paquets et envoyer des paquets par programmation.
• Le projet est वितribué sous licence GPL-2.0.
• Les coordonnées Maven/Gradle sont publiées pour être utilisées comme dépendance de compilation.
• ProtocolLib est maintenu avec des considérations de compatibilité pour une large gamme de versions de serveurs Minecraft ; il cible principalement les logiciels serveurs dérivés de Bukkit.

🤝 Quand ce plugin est utile

Si votre projet doit inspecter ou modifier le protocole brut de Minecraft (pour des effets côté client, des visuels personnalisés ou des hooks au niveau réseau), ProtocolLib centralise et stabilise ce travail afin que plusieurs plugins puissent interagir avec les paquets en toute sécurité.