Плагін Minecraft MyCommand

🔌 Про MyCommand

MyCommand — це плагін Minecraft для створення власних команд, псевдонімів і інтерактивних інтерфейсів на основі команд без написання Java. Він надає YAML-орієнтовану систему для визначення команд, які запускають інші команди, надсилають форматований текст, відкривають GUI, запускають скрипти та взаємодіють із подіями.

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

MyCommand створено для адміністраторів серверів, яким потрібні гнучкі власні команди, ярлики та інтерфейси для адміністрування й гравців. Він вирішує проблему додавання кастомної поведінки команд (затримки, warmup, cooldown, tab-completion, placeholders) і легких GUI-інтеракцій без розробки повноцінного плагіна.

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

• Створення нових команд і псевдонімів, за бажанням із реєстрацією для tab completion.
• Запуск кількох команд із однієї власної команди (виконання з console або гравцем).
• Затримки, warmup і cooldown для команд.
• Перевизначення інших команд або створення ярликів/псевдонімів.
• Тригери команд з предметів, блоків, табличок, книг, NPC та item frames.
• GUI-елементи: IconMenu на основі chest, ActionBar, BossBar, Title, Scoreboard, Anvil GUI та Sign GUI.
• Підтримка placeholders і умовних конструкцій у стилі скриптів для динамічної поведінки.
• Інтеграція з економікою (опційно через Vault) і деякі самостійні економічні функції.
• Підтримка подій гравців (join/quit/death) і запланованих завдань.
• Опційна SQL-база даних гравців і підтримка кількох файлів для необмеженої кількості команд.
• Функції, пов'язані з BungeeCord, і окрема версія для Bungee для команд на боці proxy.
• HTTP-запити (GET/POST) і підтримка форматування MiniMessage, де це доступно.
• Використовує bStats для збору метрик.

🧩 Для кого це

• Сервери Survival і SMP, яким потрібні власні команди та меню без кодування.
• Сервери з великою кількістю адміністрування або економіки, яким потрібні власні shop/command-потоки.
• Proxy-мережі, що потребують централізованої або proxy-логіки команд.
• Оператори серверів, яким потрібні умовні конструкції та placeholders для динамічних результатів.

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

• Визначити одну команду, яка запускає послідовність console-команд, щоб відкрити shop, видати предмети та записати покупку.
• Створити GUI-меню для покарання/телепортації за допомогою записів chest GUI та підказок anvil/sign.
• Надати короткі псевдоніми, що відповідають довшим командам перемикання серверів BungeeCord із tab completion.

⌨️ Команди

Офіційна документація містить адміністративні команди для керування плагіном. Приклади, наведені проєктом:

(Зверніться до офіційної документації команд плагіна для повного списку та точного синтаксису.)

🔐 Дозволи

Проєкт документує permission nodes для адміністративних дій. Приклади з офіційного списку дозволів:

(Дивіться документацію плагіна щодо дозволів для повної карти permission.)

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

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

• Завантажте офіційний .jar плагіна та помістіть його в папку plugins/ вашого сервера.
• Запустіть або перезапустіть сервер і перевірте логи console, щоб підтвердити, що плагін завантажився.
• Якщо плагін не завантажується, перевірте, чи присутні або оновлені потрібні/необов'язкові плагіни підтримки (див. Dependencies).

📦 Dependencies

• ProtocolLib — зазначено як важливий, якщо плагін не завантажується або для деяких функцій.
• Vault — опційно, потрібен для інтеграції з економікою.
• PlaceholderAPI — опційно, для розширеної підтримки placeholders.

Встановлюйте лише ті залежності, які підтверджено для потрібних вам функцій; багато інтеграцій є опційними.

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

• Плагін налаштовується через YAML-файли та підтримує кілька файлів команд, щоб уникати лімітів команд.
• Для кастомної бази даних гравців доступне збереження в SQL (опційно), а також підтримуються багатофайлові налаштування.
• Є окремий компонент BungeeCord для обробки команд на боці proxy.
• Проєкт надсилає метрики через bStats.
• Форматування MiniMessage та підтримка tab-completion доступні в підтримуваних середовищах.

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

Якщо вам потрібні гнучкі власні команди на основі файлів, умовні скрипти та командні потоки через GUI без написання Java, MyCommand надає налаштовану платформу для цих потреб і додає інтеграції з proxy та економікою там, де це потрібно.