ProtocolLib это библиотека, через которую другие плагины работают с сетевыми пакетами Minecraft. Сама она ничего не добавляет в игру, её ставят потому, что этого требует другой плагин. Главный вопрос при установке один: какую сборку взять под вашу версию сервера.
ProtocolLib даёт другим плагинам доступ к пакетам, которыми обмениваются клиент и сервер: их можно читать, менять и отправлять свои. Игрокам он сам по себе ничего не показывает, игровых команд у него нет, только служебные для отладки.
Ставить его нужно тогда, когда этого требует другой плагин. Разработчик прописывает зависимость в plugin.yml строкой depend: [ ProtocolLib ], и без ProtocolLib такой плагин не загрузится, а сервер назовёт в консоли недостающую зависимость. Проект ведёт Dan Mulloy (dmulloy2) с 2012 года, код открыт на GitHub под лицензией GPL-2.0.
Стабильные релизы отстают от Minecraft. Последний из них, 5.4.0, вышел 7 августа 2025 года, и в его коде верхняя поддерживаемая версия 1.21.8. Всё новее закрывает dev-build: постоянно обновляемый пререлиз на GitHub. В его списке изменений есть поддержка 1.21.9, 1.21.10, 1.21.11, 26.1 и 26.2 и исправления для 26.3, файлы последний раз обновлялись 25 сентября 2026 года.
| Версия сервера | Что ставить | Предел в коде |
|---|---|---|
| 1.21.9, 1.21.10, 1.21.11, 26.1–26.3 | dev-build | 26.2 |
| 1.21.2–1.21.8 | 5.4.0 | 1.21.8 |
| 1.20.5–1.21.1 | 5.4.0 или 5.3.0 | 1.21.8 и 1.21.1 |
| 1.8–1.20.4, включая 1.16.5 | 5.3.0 | 1.21.1 |
Нижняя граница в коде у всех этих сборок 1.8. Для 1.16.5 удобнее 5.3.0: в заметках к релизу прямо сказано, что это последняя версия с поддержкой Java 8, а 5.4.0 уже требует Java 17.
Запрос «ProtocolLib 5» означает всю линейку 5.x: от 5.0.0 с поддержкой 1.19 до 5.5.0-SNAPSHOT, которая сейчас лежит в dev-сборке. Линейка 4.x закончилась на 4.8.0 для 1.17 и 1.18.
В релизе 5.4.0 и более ранних файл один, ProtocolLib.jar, он ставится на любое ядро. В dev-сборке файлов два:
Поддержка Folia заявлена в обоих вариантах. Держите в plugins только один файл. При запуске ProtocolLib ищет рядом другие jar с именем на protocollib и, если находит, пишет в консоль Detected multiple ProtocolLib JAR files in the plugin directory! со списком лишних.
load: STARTUP), ещё до загрузки миров.protocol version. Если в ответе есть номер версии и авторы dmulloy2 и Comphenix, библиотека работает.Не включайте ProtocolLib через плагины-перезагрузчики. На этот случай в коде есть отдельная проверка: плагин пишет ProtocolLib does not support plugin reloaders! и отключается. После замены jar перезапускайте сервер полностью.
Если на свежей версии в логе появилось has not yet been tested! Proceed with caution., значит версия сервера выше той, что указана в коде ProtocolLib. Это предупреждение, плагин продолжает работу. Если сервер младше 1.8, ProtocolLib напишет is lower than the minimum. Строки Cannot load ProtocolLib или Cannot enable ProtocolLib означают, что библиотека не запустилась. Тогда первым делом сверьте сборку с таблицей выше.
Все команды служебные и требуют право protocol.admin, по умолчанию оно есть только у операторов. Главная команда /protocol с подкомандами config, check, update, timings, listeners, version и dump. Для разработчиков есть ещё /packet, /filter (второе имя /packet_filter) и /packetlog.
| Право | Что даёт |
|---|---|
| protocol.admin | все команды, проверка обновлений, режим отладки |
| protocol.info | уведомления об обновлениях и отчёты об ошибках |
| protocol.* | оба права сразу |
Для отчёта об ошибке пригодится /protocol dump. Команда сохраняет в папку плагина файл dump с датой в имени: там версии ProtocolLib, сервера и Java, слушатели пакетов и список плагинов, которые используют ProtocolLib. /protocol listeners показывает слушателей прямо в чате.
Обновления проверяются только по странице на SpigotMC: /protocol check сравнивает вашу версию с опубликованной там и даёт ссылку. Сам jar ProtocolLib не скачивает, а обновления dev-сборки смотрите на её странице на GitHub.
Файл появляется в plugins/ProtocolLib после первого запуска. Трогать его обычно не нужно, но несколько параметров полезно знать:
auto updater: notify: true сообщает о новой версии, delay: 43200 задаёт паузу между проверками в секундах, то есть 12 часов;ignore version check: версия Minecraft, для которой ProtocolLib не будет проверять совместимость. В комментарии к параметру авторы советуют сначала сделать бэкап мира;metrics: отправка статистики использования, отключается значением false;debug и detailed error: подробный вывод для разработчиков, при включении плагин предупреждает об этом в консоли.После правки выполните /protocol config или /protocol reload, чтобы перечитать файл.
| Команда | Что делает | Право |
|---|---|---|
/protocol version | версия ProtocolLib и авторы, быстрая проверка, что библиотека включена | protocol.admin |
/protocol check | сравнить свою версию с последней на SpigotMC | protocol.admin |
/protocol update | запустить проверку обновления вручную, результат с ссылкой на SpigotMC | protocol.admin |
/protocol config | перечитать config.yml (то же, что /protocol reload) | protocol.admin |
/protocol listeners | список слушателей пакетов, включая асинхронные | protocol.admin |
/protocol dump | сохранить отчёт dump с датой в папку плагина | protocol.admin |
/protocol timings | включить или выключить замер слушателей, итог в файле timings в папке плагина | protocol.admin |
/packet add client|server [ID start]-[ID stop] [detailed] | начать выводить пакеты выбранных типов | protocol.admin |
/packet remove client|server [ID start]-[ID stop] | убрать типы пакетов из вывода | protocol.admin |
/packet names client|server [ID start]-[ID stop] | показать названия пакетов по номерам | protocol.admin |
/filter add|remove <имя> [ID start]-[ID stop] | программируемый фильтр для /packet, второе имя /packet_filter | protocol.admin |
/packetlog <protocol> <sender> <packet> [console] | писать пакеты в hex в файл log.log или в консоль | protocol.admin |
ProtocolLib уже стоит и настроен в готовых сборках Cloud Delight: права, меню, защита и донат собраны в одно целое. Скачали, запустили, играете.