Плагин hAntiFarmKills | Защита статистики убийств от фарма повторных убийств v1.0

---

hAntiFarmKills ведёт собственную статистику PvP-убийств и защищает её от фарма одной и той же жертвы.

После засчитанного убийства повторный килл того же игрока тем же убийцей не увеличит счётчик до окончания настроенного кулдауна. Проверка работает отдельно для каждой пары убийца → жертва, поэтому убийства других противников учитываются независимо.

---

• собственный постоянный счётчик PvP-убийств;
• защита статистики от повторного убийства одной жертвы;
• общий кулдаун и отдельные значения для конкретных миров;
• полное отключение плагина в выбранных мирах;
• настройка учёта самоубийств;
• переводы названий миров для сообщений;
• просмотр статистики игроков и таблицы лидеров;
• SQLite по умолчанию или подключение MySQL;
• кэширование статистики и пакетное сохранение в отдельном потоке;
• настраиваемые многострочные сообщения с MiniMessage;
• интеграция с PlaceholderAPI;
• API-события для других плагинов;
• перезагрузка всех настроек без перезапуска сервера.

---

При кулдауне 60 секунд:

1. первое убийство игрока засчитывается;
2. повторное убийство этой же жертвы раньше 60 секунд не увеличивает статистику;
3. убийство другого игрока засчитывается независимо;
4. после окончания кулдауна следующая победа над первой жертвой снова засчитывается.

Таймер отсчитывается от последнего засчитанного убийства. Попытка фарма его не продлевает. Значение 0 отключает кулдаун.

---

Общие правила и настройки отдельных миров задаются в config.yml:


worldCooldowns переопределяет общий кулдаун для указанных миров, а worldTranslations задаёт понятные названия миров в сообщениях игрокам.

---

В messages.yml настраиваются:

• уведомление убийцу о незачтённом повторном килле;
• подтверждение успешно засчитанного убийства;
• сообщение жертве с именем убийцы, миром и координатами смерти;
• ответы команд, заголовок и строки топа.

Сообщения поддерживают MiniMessage, HEX-цвета, форматирование, click- и hover-события. Каждый шаблон может быть одной строкой или списком строк.

Доступны контекстные переменные: {prefix}, {killer}, {victim}, {cooldown}, {world}, {x}, {y}, {z}, {player}, {kills}, {count}, {position} и {name}.

---

hAntiFarmKills сохраняет UUID, последнее известное имя и количество засчитанных убийств. Имена автоматически обновляются при входе игрока, поэтому в топе корректно отображаются и ранее игравшие пользователи.

• SQLite — локальный файл data.db, работает сразу после установки;
• MySQL — подключение к удалённой базе через storage.yml;
• автоматическое создание таблицы;
• настраиваемый интервал и размер пакетного сохранения;
• отдельный поток для операций с базой данных.

---

• /hantifarmkills reload — перезагрузить конфигурацию, сообщения, логи и хранилище;
• /hantifarmkills stats [игрок] — показать количество засчитанных убийств;
• /hantifarmkills top [количество] — показать топ игроков по убийствам.

• hantifarmkills.reload — перезагрузка плагина;
• hantifarmkills.stats — просмотр статистики;
• hantifarmkills.top — просмотр топа.

Все права по умолчанию доступны операторам. Команда поддерживает автодополнение подкоманд и имён онлайн-игроков.

---

%hantifarmkills_kills% — количество засчитанных убийств игрока.

Для разработчиков доступны два Bukkit-события:

• FarmKillDetectEvent — срабатывает при обнаружении повторного убийства;
• KillRegisteredEvent — срабатывает после добавления убийства в статистику.

---

• config.yml — кулдауны, миры, размер топа, префикс и переводы;
• messages.yml — игровые сообщения и ответы команд;
• storage.yml — SQLite/MySQL и параметры сохранения;
• logs.yml — диагностические сообщения плагина.

---

• Сервер: Paper 1.21.x;
• Java: 21;
• Обязательные плагины: отсутствуют;
• Необязательная интеграция: PlaceholderAPI.

---

1. Остановите сервер и поместите hAntiFarmKills-1.0.jar в папку plugins.
2. Запустите сервер для создания файлов конфигурации.
3. Настройте кулдауны и миры в config.yml.
4. При необходимости выберите MySQL в storage.yml.
5. Настройте сообщения и выдайте нужные права.
6. Перезапустите сервер или выполните /hantifarmkills reload.