BS-BanHammer

BS-BanHammer — функциональный плагин для серверов Paper и Folia, позволяющий автоматизировать модерацию с использованием системы пресетов и визуальных эффектов.

BS-BanHammer предоставляет комплексный инструментарий для модерации, объединяя визуальную составляющую наказаний с глубокой базой данных и автоматизацией действий персонала.

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

• Пресеты банов (Shift + ПКМ): циклическое переключение между неограниченным количеством типов банов с кастомной длительностью, причиной, возможностью IP-бана и звуковыми эффектами.
• Пресеты кика и тюрьмы (Shift + ЛКМ): отдельный список для мгновенного исключения или заключения в тюрьму.
• Визуальная обратная связь: активный пресет отображается в actionbar.

1. Shift + Right-Click → Switch to "7 Day Ban" preset
2. Right-Click on griefer → Instantly banned for 7 days with lightning!
3. Shift + Left-Click → Switch to "30 Min Jail" preset
4. Left-Click on spammer → Jailed for 30 minutes

Каждое наказание сопровождается спецэффектами, которые можно настраивать для каждого пресета отдельно:

• Удары молнии в локации игрока
• Звуки грома и взрывов
• Частицы (критические удары и дым)
• Опциональный отбрасывающий эффект (knockback)

Для хранения данных плагин поддерживает два типа баз данных:

Система включает автоматическую очистку истекших наказаний, отслеживание статистики персонала и лидеров, а также анонимизацию IP в соответствии с GDPR.

Помимо стандартных банов, плагин поддерживает:

• Система мутов (блокировка чата и команд)
• Система тюрем (Jail): автоматически использует конфигурации Essentials Jail при наличии плагина, иначе использует встроенную систему.
• Система предупреждений (Warning): автоматический бан после достижения лимита предупреждений.
• IP-баны с поддержкой анонимизации.
• Система апелляций: игроки могут подавать запросы через /appeal, а модераторы рассматривать их через /bh approve/deny.

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

Для разработчиков доступен API и система событий:

PlayerPunishEvent      // Cancellable, fired before punishment
PlayerPunishedEvent    // Fired after successful punishment
PlayerUnpunishedEvent  // Fired when punishment removed

pm.banPlayer(staff, victim, reason, duration, ipBan)
pm.mutePlayer(staff, victim, reason, duration)
pm.jailPlayer(staff, victim, reason, duration)
pm.getHistory(playerUuid, limit)

Пример конфигурации пресетов в config.yml:

presets:
  warning:
    displayName: "Warning Ban"
    reason: "First offense"
    duration: "1h"
    ipBan: false
    sound: "BLOCK_NOTE_BLOCK_PLING"

  serious:
    displayName: "7 Day Ban"
    reason: "Serious rule violation"
    duration: "7d"
    ipBan: false
    sound: "BLOCK_NOTE_BLOCK_BASS"

Для отображения кастомных текстур необходимо скачать отдельный ресурспак. Сотрудники увидят подсказку со ссылкой на скачивание при входе на сервер (настраивается в config.yml).

Для версий Minecraft 1.21.x рекомендуется использовать версию 3.1.1 плагина. Версия 4.0.0+ требует Java 25 и оптимизирована для Paper 26.1.x.