Плагін Minecraft PvPManager

🔌 Про PvPManager

PvPManager — це плагін Minecraft для керування поведінкою player-versus-player і правилами сервера, пов’язаними з боєм. Він об’єднує перемикачі PvP, combat tagging, запобігання combat-log, захист новачків і кілька поведінкових механік під час вбивства/респавну в одному налаштовуваному плагіні, орієнтованому на адміністраторів серверів.

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

Основна мета PvPManager — надати централізовані, налаштовувані інструменти для PvP-інтеракцій і крайніх випадків, пов’язаних із боєм, щоб власники серверів могли запровадити послідовні правила (перемикати PvP, карати за combat logging, захищати новачків, керувати винагородами/штрафами за вбивство та обмеженнями під час бою).

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

• Перемикання PvP для окремого гравця, світу або глобально.
• Система combat tag з налаштовуваними таймерами та візуальними індикаторами (action bar/boss bar).
• Запобігання combat-log із налаштовуваними покараннями (скидання inventory, броні/exp, штраф у грошах, вбивство гравця, broadcast/log подій).
• Захист новачків і захист під час respawn/teleport.
• Anti border-hopping (не дає тікати в безпечні зони, коли гравець tagged) та anti kill-abuse тригери.
• Вимкнення дій під час бою (fly, зміна gamemode, команди, enderpearls, встановлення блоків тощо).
• Опції обробки inventory (зберегти, скинути або передати дропи вбивці) та підтримка auto-soup.
• Грошові винагороди/штрафи й команди, що виконуються при вбивстві.
• Інтеграції з PlaceholderAPI та підтримка зональних плагінів (WorldGuard, Towny) і Citizens; додаткові інтеграції для окремих механік.
• Телеметрія та звітування про використання через bStats.

🧩 Для кого це

• Для серверів Survival і SMP, яким потрібні налаштовувані правила PvP.
• Для серверів, де потрібен захист від combat logging і безпечне входження для новачків.
• Для адміністраторів, які хочуть інтегровані правила вбивств/винагород і прості перемикачі PvP без кількох окремих плагінів.

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

• Увімкнути захист новачків на перший час гри та дозволити PvP лише після налаштованого проміжку.
• Позначати гравців під час бою і не давати їм використовувати teleport, команди або входити до безпечних зон, доки тег не закінчиться.
• Карати гравців, які відключаються під час бою, скиданням inventory або застосуванням покарання, визначеного сервером.
• Автоматично винагороджувати вбивць грошима або виконувати власні команди при вбивстві.

⌨️ Команди

Примітки: перелічені команди взяті з офіційної документації плагіна та сторінки ресурсу. Ноди прав доступу для кожної команди документовані проєктом, але тут не наведені.

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

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

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

📦 Залежності

• PlaceholderAPI (необов’язкова інтеграція для placeholders).
• Доступні інтеграції для зональних і NPC-плагінів, таких як WorldGuard, Towny та Citizens (необов’язково, використовується за наявності).

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

• Підтверджено, що підтримуване серверне ПЗ включає Spigot і Paper; підтримка Folia також вказана проєктом.
• Плагін надає API для розробників і публікує dev builds для тестування.
• Проєкт публікує вихідний код і трекінг issue у своєму публічному репозиторії та використовує bStats для телеметрії.
• Протестовані версії Minecraft охоплюють багато релізів; власникам серверів слід звертатися до документації плагіна для точного визначення сумісності з конкретною версією сервера.

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

PvPManager корисний, коли вам потрібен один налаштовуваний плагін для керування перемикачами PvP, combat tagging, покараннями за combat-log і захистом новачків без складання кількох окремих плагінів. Він централізує поширені правила PvP та надає admin-команди й інтеграції для адаптації поведінки до різних серверних конфігурацій.