Библиотека для разработки плагинов Paper и Spigot: упрощает работу с конфигами, меню, предметами, командами и базами данных. Подходит разработчикам, которым нужны готовые API с декларативным подходом.
Возможности
- Динамическая база данных создаёт таблицы по Java-классам с аннотацией
@PrimaryKey; для записей доступныfindFirst,findMany,create,updateиdelete. - Подключение к базе данных использует пул соединений HikariCP с настраиваемыми параметрами.
- API меню загружает интерфейсы из YAML, поддерживает условия отображения, отдельные слоты и диапазоны слотов.
- Для меню доступны действия
close,command,console,message,opengui,updateиplaysound. - API команд поддерживает подкоманды, псевдонимы, права и автодополнение.
- API предметов позволяет задавать название, описание, флаги, данные
PersistentDataContainerи владельца головы. - API цветов преобразует коды
&и шестнадцатеричные цвета вида&#RRGGBB. BaseConfigсоздаёт и обновляет YAML-конфиги, загружая их значения в поля Java-объектов.
Как пользоваться
Меню размещаются в папке plugins/<Ваше_имя>/menus. В YAML-предмете поле slot задаёт один слот, а slots принимает список слотов и диапазоны вида 0-8.
Собственные условия для меню регистрируются через Conditions#register; их можно использовать для подсветки предметов или ограничения взаимодействия. Конфигурации создаются на основе BaseConfig, а их значения загружаются методом loadValues().
Требования
Библиотека предназначена для разработки плагинов под Paper и Spigot. Для работы с базой данных требуется настроить строку подключения и параметры доступа к ней.
