Home

HLib

HLib — публичная библиотека-плагин с общим API для разработчиков Minecraft-плагинов. Она предоставляет готовые решения для текста, задач, конфигураций, предметов, баз данных, сторонних плагинов и PacketEvents без необходимости копировать одинаковый код между проектами.

Текущая версия: 7.9 · Скачать HLib.jar · Исходный код

С чего начать

Задача	Страница
Установить HLib и подключить к проекту	Быстрый старт
Отправить сообщение, запустить задачу, создать предмет	Основной API
Создать типизированный YAML-файл	Конфигурации
Подключить MySQL, MariaDB или Redis	Базы данных
Использовать LuckPerms, WorldGuard, TAB, CMI и другие плагины	Интеграции
Читать или отправлять пакеты PacketEvents	Пакеты
Найти назначение конкретного класса	Каталог API
Собрать проект или решить ошибку запуска	Сборка и решение проблем

Что даёт HLib

• Цвета &a, HEX, градиенты и Adventure-компоненты.
• Сообщения, title, action bar и boss bar для Paper/Bukkit и Velocity.
• Async-планировщик для обеих платформ и sync-задачи для Bukkit.
• YAML-конфигурации на основе Java-классов и аннотаций.
• ItemBuilder, NBT, custom model data и item model.
• HikariCP для MySQL/MariaDB и Jedis для Redis.
• Адаптеры сторонних плагинов.
• Интеграция PacketEvents с нативными packet wrappers.
• Утилиты для cooldown, времени, чисел, опыта, мира и переводов.
• Общая GeoLite2 City с локалью и обновлением при запуске, Telegram transport с HTTP/SOCKS-прокси.

Поддерживаемая основа

Компонент	Фактическая конфигурация версии 7.9
Java	собственные классы: bytecode 25; сборка: JDK 25
Paper compile classpath	API 1.21.11-R0.1-SNAPSHOT
Paper	paper-plugin.yml объявляет API 1.21.11
Velocity	annotation processor 4.2.1-SNAPSHOT; compile API из libs/Velocity.jar

Один HLib.jar содержит paper-plugin.yml и metadata Velocity. Paper descriptor требует API 1.21.11; пакетные функции используют отдельный PacketEvents 2.14.0. Старые Bukkit/Paper не поддерживаются. Java для запуска выбирайте по требованиям сервера и его плагинов.

Перед использованием

1. HLib пока не публикуется в Maven-репозиторий. Для компиляции скачайте release JAR и подключите его через compileOnly(files("libs/HLib.jar")).
2. HLib должен быть установлен отдельным плагином. Не встраивайте его в JAR своего плагина.
3. PlaceholderAPI необязателен: без него подстановка PAPI пропускается. Для предметов ItemsAdder/Nexo установите соответствующий плагин.
4. На Velocity передавайте в Informer.send объект Component: строковый путь использует plugin messaging, для которого в этом репозитории нет готового backend-обработчика.
5. На системах, отличных от Windows, HLib синхронно проверяет обновление при загрузке. Недоступный сервис останавливает платформу; найденное обновление заменяет текущий JAR и также приводит к остановке для перезапуска.

Документация генерируется из docs/wiki, параметры — из gradle.properties. Номер версии обновляется автоматически; изменения поведения API требуют правки соответствующей страницы в исходниках.