AuMenus

AuMenus — это высокопроизводительный плагин для создания графических интерфейсов на платформах Paper и Folia. Он предлагает продвинутые функции, такие как встроенный редактор, система требований и поддержка анимации предметов, не требуя сторонних зависимостей.

AuMenus представляет собой современную альтернативу DeluxeMenus, разработанную специально для платформ Paper и Folia. Основное отличие проекта заключается в его открытом исходном коде (лицензия MIT), отсутствии обязательных зависимостей и нативной поддержке многопоточного планировщика Folia.

Плагин включает в себя инструменты для упрощения работы администратора, включая встроенный инструмент миграции конфигураций из DeluxeMenus, который позволяет перенести существующие настройки одной командой.

🛠 Основные возможности

AuMenus предоставляет широкий функционал для создания сложных интерфейсов:

• MiniMessage Formatting: поддержка современных градиентов, текста при наведении и событий клика. Совместим с устаревшими цветовыми кодами для упрощения миграции.
• Система требований: управление доступом к меню и предметам через проверку прав, денег, опыта, метаданных, регулярных выражений, математических формул и местоположения.
• Встроенный редактор: возможность редактирования меню прямо в игре методом drag-and-drop (перемещение предметов, добавление новых слотов, очистка через поднятие предмета).
• Пагинация: поддержка многостраничных меню с автоматическими действиями prev_page и next_page, а также плейсхолдерами {page} и {max_page}.
• Плавные переходы: при смене страниц или открытии меню одинакового размера окно переиспользуется без мерцания.
• Целевой игрок: просмотр данных другого игрока через флаг -p:playername в командах.
• Постоянные метаданные: хранение строк, чисел и булевых значений для каждого игрока напрямую в объекте игрока через PersistentDataContainer.
• Ввод текста: поддержка ввода через интерфейс наковальни (Anvil) и через чат.
• Шаблоны предметов: создание переиспользуемых объектов в папке templates/ с заменой переменных.
• Схемы размещения (Pattern Layouts): расстановка предметов по сетке символов вместо ручного подсчета слотов.
• Анимация предметов: циклическая смена кадров с настройкой интервалов и эффектов.
• Индикаторы прогресса: визуальное заполнение ряда слотов на основе соотношения значений из плейсхолдеров.
• Динамические заголовки: обновление названия инвентаря по таймеру с использованием живых плейсхолдеров.
• Автоматические списки игроков: генерация страниц для каждого онлайн-игрока на основе одного шаблона.
• Предикатные меню: автоматическая маршрутизация игрока в разные меню на основе проверки условий.

⚙ Технические особенности и интеграции

Плагин спроектирован с учетом современных стандартов разработки и предоставляет гибкие возможности для интеграции:

• Developer API: возможность регистрации кастомных типов действий и требований другими плагинами, а также программное открытие меню.
• Поддержка сторонних систем: совместимость с HeadDatabase, ItemsAdder, Oraxen и Nexo.
• События клика: поддержка действий для разных типов нажатий (левая, правая, Shift+левая, Shift+правая, средняя кнопка мыши).
• Офлайн-плейсхолдеры: поддержка данных игроков, находящихся в автономном режиме.
• Переключение серверов: поддержка BungeeCord и Velocity.
• Коулдауны: глобальные настройки и индивидуальные ограничения для каждого меню.

📑 Дополнительная информация

Для подробного изучения документации рекомендуется использовать официальную Wiki проекта.

Wiki: github.com/auvq/AuMenus/wiki