ProtocolLib: навіщо він потрібен
Бібліотека для роботи з мережевими пакетами: які плагіни її потребують, чому вона ламається першою під час оновлення версії та як це виправити.
Оновлено 13 серпня 2026 р.
ProtocolLib дає плагінам доступ до мережевих пакетів між клієнтом і сервером. Сам по собі він нічого не робить, але без нього не працюють багато популярних плагінів.
Кому він потрібен
Голограми старого покоління, деякі античити, плагіни скінів і NPC, кастомні інтерфейси, а також плагіни, які перевизначають відображення блоків.
Ключова особливість
ProtocolLib прив'язаний до внутрішньої будови конкретної версії Minecraft тісніше, ніж звичайний плагін. Саме тому після оновлення сервера він ламається першим:
[ProtocolLib] Unsupported server version
Єдине виправлення — оновити ProtocolLib до збірки для вашої версії. Іноді потрібна dev-збірка: реліз виходить пізніше.
Що відбувається, коли він ламається
Плагіни, які від нього залежать, не завантажаться: у лозі буде NoClassDefFoundError або помилка завантаження із зазначенням залежності — Відсутня залежність.
Навантаження
Перехоплення пакетів не безкоштовне. Якщо ProtocolLib потрібен лише одному плагіну, а ви цим плагіном не користуєтеся, видаліть обидва. На сервері з великою кількістю гравців це помітно під час профілювання — Spark.
Перевірка
/protocol dump
покаже версію та статус. Якщо плагін скаржиться на несумісність, але сервер начебто працює, частина функцій уже тихо вимкнена.
