Плагін Minecraft CommandButtons

🔌 Про CommandButtons

CommandButtons — це плагін Minecraft для прив’язки команд до взаємодії з блоками. Він дає змогу адміністраторам сервера прикріплювати набори команд до блоків (кнопок, табличок, натискних плит або клікабельних блоків), щоб ці команди запускалися, коли гравець взаємодіє з налаштованим блоком. Плагін підтримує запуск команд від імені консолі та/або від імені гравця, який активував блок, а також надає внутрішньоігровий GUI-редактор для керування кнопками та їхніми властивостями.

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

Плагін вирішує проблему створення інтерактивних елементів світу, які виконують адміністративні або ігрові дії без потреби, щоб гравці вводили команди. Типові варіанти використання — телепорт-табло, вибір наборів, дії, які можна придбати, та кастомні механіки, що запускаються через взаємодію з блоками.

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

• Прив’язка необмеженої кількості команд до однієї command button (команди консолі та гравця).
• Внутрішньоігровий GUI-редактор для створення та редагування command button і їхніх локацій.
• Кулдауни для окремих гравців і глобальні; кулдауни зберігаються після перезапуску сервера.
• Додаткова економічна інтеграція через Vault для стягнення плати з гравців за використання кнопок.
• Власні permission nodes для обмеження використання певних кнопок.
• Налаштовувані повідомлення через файл messages.
• Кілька локацій для однієї command button, тож одна конфігурація може працювати для багатьох блоків.
• Базові команди для створення, редагування та перезавантаження даних плагіна.

🧩 Для кого

• Адміністратори сервера та будівельники, які хочуть клікабельні елементи світу, що виконують команди.
• Сервери мініігор і лобі, яким потрібні інтерактивні меню або табло для телепорту/вибору наборів.
• Сервери, що використовують економічні плагіни й хочуть механіку оплати за кожне використання.

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

• Телепорт-табло на спавні, де кожна кнопка переносить гравця, який натиснув її, до іншої арени.
• Стіна вибору наборів: натискання кнопки запускає набір команд для видачі китів і повідомлень.
• Дія з оплатою: кнопка списує ігрову валюту та виконує команду нагороди.

⌨️ Команди

🔐 Дозволи

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

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

• Завантажте офіційний jar плагіна та помістіть його в директорію plugins/ сервера.
• Перезапустіть сервер і перевірте логи консолі, щоб переконатися, що плагін завантажився правильно.
• Використовуйте надані команди /commandbuttons, щоб створювати та редагувати конфігурації кнопок у грі.

📦 Залежності

• Необов’язково: Vault для ввімкнення функцій економічної оплати. Потрібен економічний плагін, який інтегрується з Vault (наприклад, економіка EssentialsX), щоб використовувати функцію оплати за кожне використання.

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

• Плагін надає GUI-редактор і створює файли конфігурації/повідомлень для налаштування.
• Кулдауни зберігаються після перезапуску сервера.
• Підтримуються режими виконання команд від консолі та від гравця; команди, виконані як гравець, використовуватимуть його дозволи (команди, що потребують вищих дозволів, ніж у гравця, не запустяться при виконанні як гравець).
• Для економічних функцій потрібні Vault і сумісний економічний плагін.

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

Використовуйте CommandButtons, коли вам потрібні налаштовувані дії, прив’язані до локації, що запускаються взаємодією гравця (кнопки, таблички, плити) із вбудованими кулдаунами, перевірками дозволів і додатковою економічною оплатою, керовані через внутрішньоігровий редактор.