Плагин-библиотека для серверов Майнкрафт на Paper, с которой разработчики создают встроенные игровые диалоги: меню с кнопками, полями ввода и действиями на сервере. API написан с упором на Kotlin, но подходит и для плагинов на Java.
Возможности
- Создание диалогов
MultiAction,List,Links,Noticeи окон подтверждения. - Кнопки с привязанными серверными действиями через
CustomAction. - Текстовые блоки и показ предметов с названием, описанием, зачарованиями и подсказкой.
- Поля для текста, многострочного текста, чисел и диапазонов, переключателей и выбора одного варианта.
- Вложенные меню:
ListDialogоткрывает выбранный дочерний диалог. - Настройка заголовка, действия после нажатия кнопки, кнопки выхода и раскладки кнопок по колонкам.
Как пользоваться
Добавьте библиотеку в проект через Maven-репозиторий JitPack. При запуске своего плагина обязательно вызовите DialogApi.initialize(this) в onEnable(): этот шаг подключает обработку нажатий CustomAction и значений из полей ввода.
Диалог собирают через DialogDataBuilder, затем выбирают подходящий построитель, например MultiActionDialogBuilder, и открывают игроку:
player.openDialog(dialog)
В Java используется:
PlayerOpener.INSTANCE.openDialog(player, dialog);
Для действия кнопки зарегистрируйте уникальный ключ ResourceLocation через CustomKeyRegistry.register(...). Его namespace лучше сделать идентификатором своего плагина, а path — понятным именем действия в snake_case, например myplugin:open_main_menu.
У каждого поля ввода задавайте уникальный key. Обработчик InputReader получает отправленные игроком значения по этому ключу через values.getValue("ключ") или перебор values.list.
Требования
Нужен сервер Paper и плагин, который использует API. Для функций с кнопками и вводом необходимо выполнить DialogApi.initialize(this) при включении плагина.
