- Для версий
- 1.8.✘
- 1.9.✘
- 1.10.✘
- 1.11.✘
- 1.12.✘
- 1.13.✘
- 1.14.✘
- 1.15.✘
- 1.16.✘
- 1.17.✘
- 1.18.✘
- 1.19.✘
- 1.20.✘
- 1.21.✘
Актуальные версии
- Для 1.21.4: Используйте эту версию.
- Для 1.21.3:Используйте эту версию.
- Для 1.8 — 1.21.1:Используйте эту версию.
Если ProtocolLib облегчила вам жизнь, подумайте о пожертвовании, спонсорстве проекта или положительном отзыве. Это очень ценно!
Зачем нужен ProtocolLib?
Некоторые задачи невозможно выполнить с помощью стандартного Bukkit API — они требуют работы с Minecraft напрямую. Одной из таких задач является модификация входящих и исходящих пакетов или добавление пользовательских пакетов в поток. Это сложно и часто ломается с выходом новых версий Minecraft из-за обфускации.ProtocolLib — библиотека, предоставляющая доступ к протоколу Minecraft, упрощая работу с пакетами. Она автоматически адаптируется к большинству обновлений Minecraft, что уменьшает необходимость в обновлениях для плагинов.
Полезные ссылки
Перед тем как сообщить об ошибке:
- Обновите ProtocolLib — возможно, проблема уже исправлена.
- Проверьте стек-трейс. Ошибка в ProtocolLib, если она содержит com.comphenix.protocol.
- Просмотрите Wiki на предмет распространённых ошибок.
Как сообщить об ошибке:
- Используйте Issue Tracker.
- Убедитесь, что такой ошибки ещё не было.
- Укажите версию ProtocolLib и Spigot.
- Вставьте стек-трейс через pastebin.
Для админов серверов ProtocolLib:
Просто скачайте ProtocolLib. Он сам по себе ничего не делает, но позволяет другим плагинам работать.Для разработчиков
- Учебник:Устаревший учебник и новая версия в процессе написания.
- TinyProtocol: Лёгкая альтернатива ProtocolLib, работающая с "сырыми" пакетами.
Использование с Maven и Gradle
Maven:
<repositories>
<repository>
<id>dmulloy2-repo</id>
<url>https://repo.dmulloy2.net/repository/public/</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.comphenix.protocol</groupId>
<artifactId>ProtocolLib</artifactId>
<version>4.8.0</version>
</dependency>
</dependencies>
Gradle:
repositories {
maven { url "https://repo.dmulloy2.net/repository/public/" }
}
dependencies {
compileOnly group: "com.comphenix.protocol", name: "ProtocolLib", version: "4.8.0";
}
Команды плагина ProtocolLib:
Основные команды
/protocol — Административная команда с подкомандами:- config — перезагрузить конфигурацию.
- check — проверить новые версии.
- version — показать текущую версию.
- timings — замер CPU времени плагинов.
- listeners — показать плагины, использующие ProtocolLib.
/packetlog <protocol> <sender> <packet> [file/console]
Все команды требуют права protocol.admin
Настройка ProtocolLib
Пример конфигурации:
YAML:
auto updater.notify: true # Уведомлять любого игрока с правом protocol.info, если вышла новая версия ProtocolLib
auto updater.download: false # Автоматически скачивать и устанавливать последнюю версию ProtocolLib. Установка будет завершена при перезагрузке сервера
auto updater.delay: 43200 # Интервал в секундах между проверками наличия обновлений
auto updater.last: 0 # Время последней проверки обновлений (в секундах с 01.01.1970). Установите 0 для принудительной новой проверки
metrics: true # Если TRUE, ProtocolLib отправит анонимные данные использования на mcstats.org. Установите FALSE, чтобы отказаться
background compiler: true # Если TRUE, ProtocolLib улучшит производительность, заменяя рефлексию скомпилированным кодом на лету
ignore version check: None # Принудительно запустить ProtocolLib для указанной версии Minecraft, даже если она несовместима
Примеры плагинов с ProtocolLib
- Lib's Disguises
- Holographic Displays
- Advanced Anti Cheat
- Server List Plus
- FurnitureLib
- AntiAura
- PremiumVanish
Статистика ProtocolLib
ProtocolLib собирает анонимную статистику через BStats. Вы можете отказаться от участия в любой момент.Спонсоры у ProtocolLib
Если ProtocolLib сделала вашу жизнь проще, вы можете поддержать проект через GitHub Sponsors.Особая благодарность:
- Jack1424
- Plutoren
- pebblehost
- Andarius68
- aternosorg
- CyanNex
- Photon
- Yive
Установка плагина ProtocolLib:
- Скачайте плагин.
- Выключите сервер
- Переместите файл .jar в папку /plugins/ вашего сервера.
- Запустите сервер.
- Готово.