BKCommonLib — это утилитарная библиотека, которая объединяет общий код для различных плагинов, уменьшая дублирование. Она предоставляет множество функций, отсутствующих в Bukkit.
Библиотека имеет версионирование для каждого плагина: если плагину требуется версия 2, а установлена версия 1, сервер уведомляется, и плагин не включается.
Причины использовать эту библиотеку:
- Доступ к внутренностям Minecraft, если Bukkit не предоставляет API
- Автоматическая совместимость между версиями CraftBukkit
- Работа с векторами, математикой и другими утилитами
- Упрощение работы с YAML, конфигами и файлами данных
- Конвертация пользовательского ввода
- Продвинутая работа с инвентарями
- Уникальные серверные события
- Изменение поведения сущностей (коллизии, движение)
- Настраиваемые сообщения и разрешения
- Работа с асинхронными задачами без хранения ID
- Отправка и манипуляция пакетами
Возможности:
- Общее: PluginBase для метрик, разрешений, локализации; Permission defaults; Localization
- Утилиты: String, Logic, BlockFace, Math; Block utilities; ItemUtil; RecipeUtil; Collections
- Хранение данных: Configuration API; NBT API; DataReader/DataWriter
- Сущности: CommonEntity; EntityController; EntityNetworkController
- Сервисы: Metrics; Conversion; Events и Listeners; Packet services; Task class
