Плагін Minecraft InteractionVisualizer

🔌 Про InteractionVisualizer

InteractionVisualizer — це плагін Minecraft, який відображає візуалізації та анімації на боці клієнта для функціональних блоків і пов’язаних сутностей (наприклад: crafting table, furnace, enchantment table). Візуальні ефекти надсилаються гравцям через packets і не створюють блоки або сутності на боці сервера — це суто клієнтські відображення, які не впливають на стан світу.

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

Плагін робить взаємодію гравців із поширеними функціональними блоками видимою для гравців поруч, показуючи предмети, прогрес, holograms та анімації під час використання GUI. Він призначений для власників серверів, які хочуть більш насичений і зрозумілий візуальний зворотний зв’язок, коли гравці взаємодіють із інтерфейсами в світі.

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

• Візуалізує багато функціональних блоків і відповідних предметів/сутностей з анімаціями (crafting table, furnace, enchantment table та інші).
• Лише клієнтські відображення: візуалізація не створює постійні або взаємодіючі сутності сервера.
• Перемикачі відображення для кожного блоку та глобальні перемикачі модулів.
• Стан перемикача гравця зберігається в базі даних (SQLite за замовчуванням; підтримується MySQL).
• Для стану перемикача гравця доступні placeholders PlaceholderAPI.
• Надає developer API / wiki для аддонів.
• Ураховує інтеграції з поширеними плагінами для вимкнення або налаштування анімацій (vanish-плагіни, OpenInv тощо).

🧩 Для кого це

• Сервери Survival і SMP, яким потрібен більш занурювальний візуальний зворотний зв’язок для взаємодії з блоками.
• Декоративні/roleplay-сервери, які віддають перевагу охайному клієнтському візуалу без зміни даних світу.
• Адміністратори серверів, яким потрібен необов’язковий контроль візуальних ефектів для кожного гравця.

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

• Показувати предмети, що з’являються на crafting table, коли гравець заповнює слоти рецепта, щоб гравці поруч бачили прогрес.
• Відображати hologram прогресу furnace і візуальні предмети, що з’являються, коли гравець взаємодіє з UI furnace.
• Дати гравцям змогу перемикати, які модулі відображення вони бачать (itemstands, dropped items, holograms).

⌨️ Команди

🔐 Permissions

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

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

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

📦 Залежності

• ProtocolLib (потрібен для старіших версій сервера / обробки packets, де це зазначено).
• LightAPI Fork (потрібен для старіших версій, де він використовується).

Додаткові/необов’язкові інтеграції, зазначені проєктом (використовуються для налаштування поведінки): EssentialsX, OpenInv, PlaceholderAPI, SuperVanish, PremiumVanish, CMI.

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

• Плагін за замовчуванням зберігає перемикачі для кожного гравця в SQLite та підтримує MySQL для постійного зберігання між серверами.
• Кожне відображення блоку та модуль можна вимкнути через конфіг плагіна.

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

• Створено на основі API Spigot; також заявлено сумісність із Paper і кількома сучасними збірками серверів.
• Відображення лише на боці клієнта і не створюють сутностей сервера, які можна вбити, або постійних сутностей.
• Плагін пропонує developer API для сторонніх аддонів, а переклади підтримує спільнота.
• У проєкті вказано обмеження: він може не працювати на Minecraft 1.10.2 або нижче.

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

Якщо вам потрібен ненав’язливий, декоративний візуальний зворотний зв’язок для взаємодії гравців без зміни стану на боці сервера, InteractionVisualizer надає анімації на основі packets і керування для кожного гравця, щоб підсилити занурення, не змінюючи світ.