Java API RU

Java API и расширения

Язык: English | Русский

UIcore предоставляет Java API для плагинов, которым нужно добавлять действия меню, поставлять данные, проверять условия или регистрировать собственные компоненты. API находится в отдельном от реализации модуле.

Зависимость Maven

<dependency>
  <groupId>org.orvencraft.uicore</groupId>
  <artifactId>uicore-api</artifactId>
  <version>1.0.0</version>
  <scope>provided</scope>
</dependency>

Укажи UIcore как softdepend, если расширение может работать без него, или как обязательную зависимость. Собирай расширение против API-артефакта и используй интерфейсы API вместо классов реализации.

Возможности API

• Регистрировать обработчики действий с пространством имён для взаимодействий с меню.
• Передавать простые значения в текст и свойства элементов.
• Добавлять собственные условия видимости и взаимодействия.
• Регистрировать повторно используемые компоненты, создающие определения элементов.
• Обновлять открытое меню игрока после изменения данных.

Используй стабильные ID с пространством имён, например example:player_level. Проверяй входные параметры, ограничивай объём работы и соблюдай требования планировщика сервера при обращении к Bukkit-объектам. На Folia доступ к игроку и миру должен выполняться в соответствующем регионе.

Документация

Полное описание см. в английском руководстве по API расширений, примерах использования API и исходном коде примера расширения.