PaperUI

PaperUI — это библиотека на Java и Kotlin, предназначенная для создания пользовательских интерфейсов на серверах Paper. Она позволяет разработчикам внедрять в свои плагины сложные формы с полями ввода, переключателями и кнопками действий.

Основы работы и архитектура

PaperUI предоставляет класс DialogUI, который служит основой для построения диалоговых окон. Эти окна могут содержать различные типы свойств: текстовые поля, числовые значения с диапазонами, булевы переключатели и выбор из перечислений (enum). Каждый элемент интерфейса настраивается через методы, возвращающие объекты Property, которые хранят текущее состояние и валидацию данных. После создания формы её можно открыть для игрока с помощью метода open().

Интеграция в проект

Для использования библиотеки есть два основных пути. Первый вариант предполагает добавление PaperUI как отдельного плагина в папку plugins сервера, а затем указание его как зависимости в файле plugin.yml или paper-plugin.yml. Второй, более предпочтительный для разработчиков, — включение библиотеки в зависимости собственного плагина через Maven или Gradle. В обоих случаях необходимо добавить репозиторий DiruptioPublic для корректного подтягивания артефактов.

Примеры реализации на Kotlin

Библиотека демонстрирует гибкость на примере создания формы заказа пиццы. В коде определяется перечисление PizzaType с вариантами MARGHERITA, FUNGHI, PROSCIUTTO. Форма содержит поля для выбора типа, добавления сыра, указания радиуса (от 15.0 до 20.0 см), количества и адреса доставки. При нажатии кнопки «Order» формируется сообщение, в котором учитываются все выбранные параметры: тип пиццы, наличие доп. ингредиентов и итоговая стоимость или объем заказа.

Примеры реализации на Java

Для разработчиков, использующих Java, доступны аналогичные возможности. Пример с заказом наркотиков (демонстрация работы с вредоносным контентом в учебных целях) показывает использование метода enumProperty для выбора вещества и doubleProperty для точного дозирования. Более развернутый пример OrderCoffeeUI наследуется от DialogUI и реализует меню заказа кофе. Здесь используется наследование для инкапсуляции логики, а методы actionButton принимают функциональные выражения (lambdas) для выполнения действий при клике, что позволяет чистить код от дублирующейся логики отправки сообщений.