Minecraft plugin zMenu

🔌 Про плагін zMenu

zMenu — це плагін для Minecraft серверів, який дозволяє створювати кастомні графічні інтерфейси (GUIs) та меню через YAML‑конфігурацію без програмування. zMenu призначений для адміністраторів серверів, які потребують професійних інвентарів і інтерактивних меню для модулів, магазинів, селекторів серверів або внутрішніх інструментів.

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

zMenu вирішує задачу швидкого створення складних інтерфейсів у Minecraft без коду. zMenu дає змогу зменшити потребу в окремих плагінах під кожен GUI, централізувати меню і налаштування, а також інтегрувати дії (команди, звуки, телепорти) з інших плагінів. zMenu підтримує роботу на Spigot/Paper і пропонує API для розширень.

⚙ Основні можливості

• Створення необмеженої кількості інвентарів (9–54 слоти) через YAML. zMenu підтримує multi‑page та автоматичну пагінацію. ()
• Потужна система кнопок і дій: повідомлення, виконання команд (під гравцем або консоллю), видача предметів, телепорт та інші дії (28+ типів дій згідно з документацією). ()
• Підтримка PlaceholderAPI і MiniMessage (форматування), інтеграції з Vault, LuckPerms, ItemsAdder, Oraxen, HeadDatabase та іншими плагінами. ()
• Система вимог для відображення/приховування кнопок за пермами, кількістю предметів, балансом, досвідом тощо. ()
• Player Data: збереження даних гравця, глобальні плейсхолдери, шаблони (patterns) для повторюваних елементів інвентаря. ()
• Підтримка баз даних: SQLite, MySQL / MariaDB для збереження даних інвентарів/гравців. ()
• API для розширення: можна додавати власні кнопки, дії та плейсхолдери. ()
• Anti‑dupe механізми та реаль‑тайм оновлення інвентарів. ()

🧩 Кому підійде

• Адміністратори Survival, RPG і мереж серверів, які потребують кастомних GUI. zMenu підходить як для невеликих, так і для великих проєктів, де потрібна централізація меню. ()

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

• Меню селекторів серверів, інтерактивні магазини, GUI для телепорту/варпів.
• Панелі адміністрації або системи покарань, що запускають серії дій при кліку.
• Інтеграція з ItemsAdder/Oraxen для відображення кастомних предметів у меню.

⌨️ Команди

Плагін не додає фіксованих команд «із коробки» — всі команди для відкриття інвентарів створюються адміністратором у папці commands/ за схемою, описаною у документації. У документації наведено приклади конфігурацій команд (наприклад basic_command, advanced_command, punish, openbook) — ці приклади є частиною офіційної документації і використовуються як шаблони. ()

Плагін не додає нових команд за замовчуванням; адміністратор визначає команди у plugins/zMenu/commands/.

🔐 Права доступу (permissions)

zMenu працює через пер‑командні permission‑вузли, які задаються у YAML для кожної команди/кнопки. Офіційна документація показує приклади permission‑вузлів у конфігураціях, але повний перелік вузлів залежить від ваших конфігурацій і не жорстко закодований у плагіні. Приклади, що згадуються в офіційних прикладах:

(Документація радить використовувати зовнішні плагіни для управління правами, наприклад LuckPerms.) ()

⚙ Інсталяція

📥 Встановлення

• Завантажте .jar плагіна з офіційного джерела (Spigot/Modrinth/GitHub згідно з офіційним сайтом).
• Помістіть .jar у папку plugins/ вашого сервера.
• Повністю перезапустіть сервер (не рекомендується використовувати /reload).
• Перевірте консолю на наявність помилок під час завантаження.

📦 Залежності

Підтверджені інтеграції/рекомендовані плагіни (перераховані в офіційній документації):

• PlaceholderAPI. ()
• Vault. ()
• LuckPerms. ()
• ItemsAdder, Oraxen, HeadDatabase (інтеграції для кастомних предметів/голів). ()

(Залежності використовуються для додаткових можливостей; базова робота плагіна можлива без частини інтеграцій.)

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

• Після першого запуску плагін створює свою папку у plugins/zMenu/ і прикладні файли конфігурації.
• zMenu використовує конфігурацію у YAML (інвентарі, кнопки, дії, permission‑вузли, підключення до БД).
• Підтримка баз даних: SQLite (локально) і MySQL / MariaDB (конфігурується у файлі конфігурації). ()

🧠 Додаткова інформація

Відомі конфлікти

• Конфлікти можуть виникати з іншими плагінами, що перехоплюють ті самі команди або обробляють інвентарі/кліки; тестуйте зміни у staging перед production. ()
• Деякі розширені функції доступні лише при наявності відповідних інтеграцій (ItemsAdder/Oraxen).

Обмеження

• zMenu призначений для серверів на Spigot/Paper (література в документації вказує підтримку для версій 1.19–1.21+). Для специфічних версій перевіряйте офіційну документацію. ()

FAQ

1. Чи є у zMenu готові команди для гравців?

• Ні — команди для відкриття меню створюються адміністратором у commands/. Документація містить приклади конфігурацій. ()

2. Чи підтримується PlaceholderAPI?

• Так, zMenu офіційно підтримує PlaceholderAPI. ()

3. Чи можна інтегрувати кастомні моделі/предмети?

• Так — підтримуються інтеграції з ItemsAdder і Oraxen для показу кастомних предметів у меню. ()

4. Чи є платна версія/додаток?

• На сторінці плагіна згадується розширення zMenu+ (додаткові функції в якості аддону). Деталі та функціонал описані на сторінці ресурсу. ()

Статистика та підтримка

• Документація та офіційний сайт надають посилання на Discord для підтримки. Інформація про збір статистики (bStats) не вказана у доступних офіційних розділах документації — інформація відсутня в офіційних джерелах. ()

Джерела: офіційний сайт плагіна та документація, сторінка ресурсу на Spigot. ()