Плагін Minecraft ItemJoin

🔌 Про ItemJoin

ItemJoin — це плагін Minecraft, який автоматично видає гравцям високонастроювані кастомні предмети. Предмети можна видавати під час подій на кшталт join, first-join, respawn, world-switch, region-enter і region-leave. Плагін зосереджений на гнучких визначеннях предметів (itemflags), подіях-тригерах і командах, прив’язаних до предметів, щоб сервери могли надавати меню лобі, стартові набори або контекстні інструменти без кастомних модів клієнта.

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

ItemJoin вирішує проблему надійної видачі гравцям кастомних або інтерактивних предметів, прив’язаних до подій сервера та світів. Це корисно для hub/lobby-серверів, серверів minigame, survival-мереж (де предмети потрібно обмежувати для кожного світу) і мереж, яким потрібні меню на основі предметів або предмети, що запускають команди.

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

• Видача предметів за налаштовуваними тригерами: join, first-join, respawn, world-switch, region-enter/exit та подібними подіями.
• itemflags для кожного предмета, що змінюють поведінку (slot, overwrite, правила stack, блокування руху/підбору, обмеження gamemode, шанс отримання, cooldowns).
• ItemCommands: прив’язка команд до предметів і налаштування контексту виконання (console, player, server, message) та типів дій (клік лівою/правою, клік у інвентарі, physical, multi-click).
• Інтеграція PlaceholderAPI для динамічних назв/lore предметів і підтримки placeholders.
• Підтримка кастомних голів гравців (кастомні textures і owners), зображень на map, tipped arrows, книг, banners, феєрверків, кастомізації шкіряної броні та кастомних рівнів enchant.
• За потреби блокування переміщення предметів або підбору в окремих світах і обмеження предметів за IP-адресою або станом first-join.
• Вбудований у гру GUI-створювач для збирання наборів предметів і вбудований робочий процес імпорту/створення.
• API для інших плагінів: доступне за адресою me.RockinChaos.itemjoin.api.ItemJoinAPI.

🧩 Для кого це

• Власники серверів, яким потрібні автоматичні предмети для лобі/hub або стартові набори.
• Оператори minigame та мереж, яким потрібні предмети, прив’язані до конкретного світу, або компаси меню.
• Розробники, які хочуть систему предметів із можливістю hook через API.

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

• Давати гравцям компас меню під час join, який виконує різні команди при натисканні.
• Надавати одноразові стартові набори під час first-join, одночасно запобігаючи передачі предметів між вказаними світами.
• Створювати інтерактивні предмети, що виконують команди economy/shop із cooldowns і витратами.

⌨️ Команди

Примітка: ці команди та підкоманди взяті з документованого набору команд плагіна. Плагін надає додаткові підкоманди у своїй wiki та згенерованому довідковому виводі.

🔐 Дозволи

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

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

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

• Завантажте офіційний jar-файл ItemJoin і помістіть його в папку plugins/ вашого сервера.
• Переконайтеся, що в plugins/ немає дублікатів jar-файлів ItemJoin (наприклад, ItemJoin(1).jar).
• Перезапустіть сервер, щоб плагін міг згенерувати свою конфігурацію та зареєструвати функції для вашої версії сервера.
• Перевірте логи консолі на підтвердження завантаження плагіна та зверніться до wiki плагіна для детального налаштування.

📦 Залежності

Плагін не має обов’язкових runtime-вимог, але перелічує кілька поширених soft-dependencies та інтеграцій (вони необов’язкові й увімкнені, якщо присутні):

• Vault
• AuthMe
• BetterNick
• HeadDatabase
• PlaceholderAPI
• SkinRestorerX
• TokenEnchant
• WorldEdit
• WorldGuard

Увімкніть або налаштуйте інтеграції за потреби; плагін працює і без них, але такі функції, як placeholders, кастомні голови/скіни та economy-hooks, залежать від відповідних плагінів.

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

• Платформи: підтверджено для серверів у стилі Spigot (Spigot, Bukkit, Paper, Purpur, Folia).
• Підтримуваний/тестований діапазон Minecraft: від 1.8 до 1.21.
• Вихідний код і релізи опубліковано, а проєкт надає API за адресою me.RockinChaos.itemjoin.api.ItemJoinAPI для підключення інших плагінів.
• Ліцензія: LGPL-3.0.

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

Якщо вам потрібна гнучка, налаштовувана система для надання гравцям контекстних та інтерактивних предметів (меню, стартові набори, інструменти для окремих світів) і ви хочете API для інтеграцій, ItemJoin надає ці можливості та підтримує поширені плагіни для placeholders і skin.