Плагін Minecraft CommandPanels

🔌 Про CommandPanels

CommandPanels — це плагін Minecraft, що надає систему GUI/menu на основі YAML для серверів. Він зосереджений на панелях на основі інвентарю, діалогових (form) панелях і панелях, сумісних із Floodgate, для гравців Bedrock. Проєкт містить онлайн-редактор і структурований формат для створення інтерактивних меню, що працюють на даних, виконують команди, показують динамічні placeholders і реагують на логіку та дозволи.

🎯 Призначення

Плагін призначений для адміністраторів серверів і розробників, яким потрібні гнучкі, програмовані GUI для магазинів, kit-ів, лобі, інструментів модерації або власних робочих процесів. Він створений так, щоб панелі могли виконувати команди, перевіряти умови, анімувати предмети та надавати сесійні або постійні дані для використання в інших системах.

⚙️ Можливості

• Панелі інвентарю з взаємодією з предметами, розкладкою слотів і ланцюжками анімацій.
• Діалогові панелі для структурованих форм і введення від гравців.
• Підтримка панелей Floodgate для показу сумісних панелей гравцям Bedrock (через налаштування Geyser/Floodgate).
• Inline-логіка та умови (оператори типу AND/OR/NOT) для керування видимістю та поведінкою.
• Система команд/дій: хуки відкриття/закриття, дії кліку, дії кліку поза панеллю та умовне виконання команд.
• Підтримка PlaceholderAPI та динамічні оновлення placeholders усередині панелей.
• Дані панелі для сесії та постійного зберігання, доступні між панелями та командами.
• Періодичні оновлення та спостерігач дозволів, який може запускати повторний повний розбір логіки, коли дозволи змінюються.
• Онлайн-редактор із живим попереднім переглядом YAML і перевіркою структури.

🧩 Для кого це

Для адміністраторів і розробників плагінів, які керують сучасними серверами, сумісними з Paper, і потребують гнучких GUI-меню: сервери Survival/SMP, мережі мініігор, PvP-хаби та сервери, яким потрібні власні інтерфейси для адміністрування та модерації.

🏗️ Приклади використання

• Створити GUI для kit-а або магазину, який виконує команди сервера та вимагає певних дозволів або економічного балансу.
• Зробити меню навігації хабу з анімованими предметами та умовною видимістю залежно від рангу гравця.
• Надати сумісне з Bedrock меню, використовуючи спеціальні варіанти панелей Floodgate.

⌨️ Commands

(Команди та їхні дозволи взяті з офіційної документації CommandPanels.)

🔐 Permissions

⚙️ Встановлення

📥 Налаштування

• Завантажте офіційний файл CommandPanels .jar і помістіть його в папку plugins/ на вашому сервері.
• Запустіть сервер, щоб згенерувати дані плагіна.
• Після першого запуску перевірте plugins/CommandPanels на наявність config.yml і папки panels/, що містить файли визначення панелей.

📦 Dependencies

• PlaceholderAPI — необов’язково, але рекомендовано для динамічних placeholders.
• Floodgate — необов’язково для підтримки панелей Bedrock (Floodgate).

🧾 Конфігурація

• Панелі визначаються як YAML-файли, розміщені в каталозі panels/. Для зручної організації підтримуються підпапки.
• Плагін згенерує приклади панелей, якщо каталог panels/ буде видалено, а потім плагін перезапущено.

🧠 Технічні примітки

• Офіційна документація та релізи вказують Paper і Folia (форки Paper) як підтримувані серверні платформи для сучасних релізів v4.
• Гілка релізів v4 зосереджена на новіших версіях серверів Minecraft; визначення панелей підтримують динамічні placeholders і умовну логіку, що розбирається під час виконання.
• Плагін надає вузли дозволів і API на основі команд для відкриття панелей; його також можна вбудувати як бібліотеку в інші плагіни, завантажуючи YAML панелей і викликаючи дії відкриття.

🤝 Коли цей плагін корисний

Якщо вам потрібна структурована, придатна до скриптування система GUI, що підтримує динамічні дані, умовну логіку, сумісність із Bedrock і онлайн-редактор, CommandPanels пропонує підтверджений підхід на основі YAML, який добре підходить для серверів і мереж на Paper.