KaMenu

KaMenu позволяет создавать современные диалоговые окна с использованием YAML, поддерживая динамические кнопки, формы ввода, ползунки и сценарии на JavaScript.

KaMenu — это плагин, построенный вокруг нативной системы Dialog в Minecraft. В отличие от традиционных методов имитации форм через инвентарные экраны, он позволяет создавать полноценные клиентские диалоги с чистой структурой YAML. Это делает интерфейсы более удобными для чтения и взаимодействия: игроки могут вводить текст, двигать ползунки и переключать опции в одном окне.

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

Проект придерживается принципа «YAML прежде всего»: для создания обычных меню не требуется программирование. JavaScript является опциональным инструментом, предназначенным для сложных вычислений, управления живым состоянием и создания многоразовой логики.

• message: однострочный или многострочный контент с поддержкой legacy цветов, MiniMessage, переменных и условий.
• item: ванильные предметы, снаряжение игрока, сторонние предметы, имена, описание (lore), чары, модели и головы игроков.
• Интеграция глифов и спрайтов из ItemsAdder, Oraxen и CraftEngine.
• Интерактивный текст с поддержкой всплывающих подсказок (hover), ссылок, копирования в буфер обмена и обратных вызовов KaMenu.

• input: текстовые поля (однострочные или многострочные).
• slider: числовые ползунки с настраиваемыми диапазонами и шагами.
• dropdown: кнопка выбора, которая переключает варианты при нажатии.
• checkbox: поля ввода типа флаг или подтверждение.

Значения из полей ввода можно извлекать в действиях, условиях или командах с помощью плейсхолдера $(input_id).

KaMenu эффективно обрабатывает данные, объем которых заранее неизвестен (например, списки друзей, онлайн-игроков или результаты базы данных). Функция repeat генерирует кнопки на основе строк, массивов JavaScript или объектов в реальном времени.

• Кастомные разделители для значений (например, player1,player2).
• Поддержка полей объектов через переменные типа {item.name} или {item.id}.
• Встроенная поддержка индексации: {item.index}, {item.page_index} и другие.
• Пагинация по умолчанию: 20 записей на страницу (настраиваемо от 1 до 99).
• Встроенные хранилища list и glist с операциями добавления, удаления и очистки.

Действия выполняются последовательно и поддерживают задержки, условия, селекторы игроков и аргументы. Условия позволяют управлять ветвлением действий, заголовками, видимостью компонентов и значениями по умолчанию для ввода.

Плагин управляет полным циклом работы меню:

• Events.Open: выполнение действий перед открытием или блокировка открытия через return.
• Events.Click: параметрызованные группы действий для нажатий.
• Events.Close: действия при завершении жизненного цикла меню.
• Events.Tasks: периодические задачи, выполняющиеся, пока меню активно.
• Settings.lifetime: автоматическое закрытие истекших меню и остановка их задач.

KaMenu включает встроенную поддержку баз данных SQLite и MySQL без необходимости устанавливать дополнительные плагины.

• [ссылка удалена] хранилище ключ-значение для игрока по UUID.
• gdata: общее хранилище сервера.
• list / glist: списочные хранилища для игроков и сервера соответственно.
• Поддержка PlaceholderAPI для вывода сохраненных значений и содержимого списков.

Для регистрации команд взаимодействия с меню используйте config.yml. Вы можете настроить прямое открытие меню, выполнение очередей действий и динамическое автодополнение (Tab completion).

/km guide
/km list
/km open <menu-id> [player]
/km examples [zh_CN|en_US] [overwrite]
/km language <language-id>
/km reload [all|menu|config|actions|js|lang]
/km pause <register|unregister|info>

Для разработчиков доступен API, позволяющий сторонним плагинам открывать меню из папки menus/, рендерить YAML-строки или регистрировать кастомные обработчики действий.

Меню из файла pause_menu.yml можно скомпилировать в нативный диалог дата-пака и добавить в стандартный экран паузы клиента.

/km pause register

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

При первом запуске плагину требуется доступ к Maven для загрузки библиотек выполнения. Все действия на платформе Folia должны учитывать правила потоков (threading) при использовании кастомного JavaScript или внешних обработчиков.