ProtocolLib: зачем он нужен
Библиотека работы с сетевыми пакетами: какие плагины её требуют, почему она первой ломается при обновлении версии и как это лечить.
Обновлено 13 августа 2026 г.
ProtocolLib даёт плагинам доступ к сетевым пакетам между клиентом и сервером. Сама по себе она ничего не делает, но без неё не работают многие популярные плагины.
Кто её требует
Голограммы старого поколения, некоторые античиты, плагины скинов и NPC, кастомные интерфейсы, плагины, подменяющие отображение блоков.
Главная особенность
ProtocolLib привязана к внутренностям конкретной версии Minecraft теснее, чем обычный плагин. Поэтому после обновления сервера она ломается первой:
[ProtocolLib] Unsupported server version
Лечение одно — обновить ProtocolLib до сборки под вашу версию. Иногда нужна dev-сборка: релиз выходит позже.
Что происходит при поломке
Плагины, зависящие от неё, не загрузятся: в логе будет NoClassDefFoundError или отказ загрузки с указанием зависимости — Missing dependency.
Нагрузка
Перехват пакетов не бесплатен. Если ProtocolLib нужна одному плагину, которым вы не пользуетесь, — снимите оба. На сервере с большим онлайном это заметно в профилировании — Spark.
Проверка
/protocol dump
покажет версию и статус. Если плагин ругается на несовместимость, а сервер вроде работает — часть функций уже отключена молча.