ProtocolLib : à quoi ça sert
Une bibliothèque pour travailler avec les paquets réseau : quels plugins en ont besoin, pourquoi elle casse en premier lors d'une mise à jour de version, et comment la réparer.
Mis à jour le 13 août 2026
ProtocolLib donne aux plugins l'accès aux paquets réseau échangés entre le client et le serveur. À lui seul, il ne fait rien, mais de nombreux plugins populaires ne fonctionnent pas sans lui.
Qui en a besoin
Les hologrammes de l'ancienne génération, certains anticheats, les plugins de skins et de PNJ, les interfaces personnalisées et les plugins qui remplacent l'affichage des blocs.
Caractéristique principale
ProtocolLib est lié aux entrailles d'une version précise de Minecraft plus étroitement qu'un plugin ordinaire. C'est pourquoi, après une mise à jour du serveur, il casse en premier :
[ProtocolLib] Unsupported server version
La seule solution est de mettre ProtocolLib à jour vers une build correspondant à votre version. Il faut parfois une build de développement : la version stable sort plus tard.
Ce qui se passe en cas de casse
Les plugins qui en dépendent ne se chargent pas : le journal affichera NoClassDefFoundError ou un échec de chargement indiquant la dépendance — Dépendance manquante.
Charge
L'interception des paquets n'est pas gratuite. Si un seul plugin a besoin de ProtocolLib et que vous n'utilisez pas ce plugin, supprimez les deux. Sur un serveur avec de nombreux joueurs, cela se remarque lors du profilage — Spark.
Vérification
/protocol dump
affichera la version et l'état. Si le plugin signale une incompatibilité alors que le serveur semble fonctionner, certaines fonctionnalités sont déjà désactivées en silence.
