Плагін Minecraft SuperVanish

🔌 Про SuperVanish

SuperVanish — це плагін Minecraft для серверів Bukkit/Spigot, який дозволяє адміністраторам і персоналу сервера ставати повністю невидимими для інших гравців. Його мета — забезпечити непомітний стан vanish, придатний для модерації та тестування, а також надати API, щоб інші плагіни могли взаємодіяти зі станом vanish.

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

Основне призначення плагіна — модерація та адміністративний моніторинг: дати змогу довіреному персоналу спостерігати за поведінкою гравців, не з’являючись у списку гравців, повідомленнях про вхід/вихід або в світі для більшості гравців. Він призначений для власників серверів, адміністраторів і розробників плагінів, яким потрібна надійна реалізація vanish.

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

• Повністю приховує гравців у vanish від інших гравців (видимість у світі).
• Ховає гравців у vanish у списку гравців (tab) з налаштовуваним виглядом для спостерігачів.
• Коригує повідомлений онлайн-лічильник гравців/список сервера, коли доступний ProtocolLib.
• Багаторівнева система прав, щоб точно налаштувати, хто кого може бачити.
• Зберігає стан vanish під час приєднань, перезапусків і перезавантажень.
• Додаткові точки інтеграції, які потребують ProtocolLib для розширених пакетних функцій.
• Додаткова рекомендація встановити OpenInv для кращої поведінки "silent chest".
• Публічний VanishAPI для інших плагінів: методи для приховування/показу гравців, перевірки невидимих гравців і прослуховування PlayerHideEvent/PlayerShowEvent.

🧩 Для кого це

• Сервери Survival і SMP, яким потрібні приховані інструменти модерації.
• Сервери, яким потрібен vanish API для інших плагінів модерації або утиліт.
• Адміністратори, яким потрібні налаштовувані правила видимості та керування tablist.

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

• Модератор стає невидимим, щоб розслідувати скаргу на гріф без попередження підозрюваних.
• Плагін звертається до VanishAPI, щоб виключити гравців у vanish із механік гри або звітів.
• Оператори сервера приховують свою присутність під час прямих тестів, щоб імітувати умови лише для гравців.

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

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

• Завантажте офіційний JAR плагіна та помістіть його в каталог plugins/ вашого сервера.
• Перезапустіть сервер і переконайтеся, що SuperVanish завантажився, перевіривши логи консолі.
• Якщо використовуєте ProtocolLib для розширених функцій, встановіть також ProtocolLib і перезапустіть сервер.

📦 Залежності

• ProtocolLib (необов’язково): потрібен для пакетних функцій, таких як зміна кількості гравців і деякі функції action-bar.
• OpenInv (необов’язкова рекомендація): покращує поведінку silent chest під час взаємодії з інвентарями у стані vanish.

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

• Платформа: реалізовано як плагін Bukkit/Spigot і надає Java API для інших плагінів.
• API: надає VanishAPI з методами для приховування/показу гравців, перевірки статусу vanish і отримання списків невидимих гравців; включає PlayerHideEvent і PlayerShowEvent для інтеграцій на основі подій.
• Збереження: може повертати списки всіх невидимих гравців (онлайн і офлайн) через API; отримання всіх невидимих гравців може потребувати доступу до бази даних і має використовуватися обережно поза main thread.
• Ліцензія: випущено під ліцензією MIT, а вихідний код доступний у репозиторії проєкту.

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

Якщо вам потрібна реалізація vanish, що інтегрується з іншими плагінами та підтримує тонкі правила видимості для модерації, SuperVanish надає налаштований vanish на основі API з необов’язковими інтеграціями ProtocolLib/OpenInv для кращої роботи.