Плагин wGuard 3.2.2 — комплексная система модерации для Paper 1.21+ 3.2.2

wGuard — это модульный плагин модерации с полноценной локализацией (ru/en), GUI, логированием и интеграциями. Подходит для проектов от мини‑серверов до сетей.

Основные возможности​

• Модули:
• Core: конфиги, язык, БД (HikariCP), API/вспомогательные сервисы
• Punishments: бан/бан-IP/мут/варн/кик, снятие наказаний, анонсы, причины
• Reports: жалобы, GUI, карточка репорта, уточнения причин в чате
• ModerationTools: слежка (/spec/unspec), invsee, мод-компас с быстрыми действиями, лог чата, tp
• Stats: статистика модераторов, история наказаний (GUI)
• Integration: Discord Webhook, Telegram Bot, PlaceholderAPI
• Utils: форматирование через MiniMessage, утилиты
• База данных: SQLite/MySQL (автосоздание таблиц)
• Локализация: ru_RU/en_US (все тексты настраиваются в lang/)
• Полный MiniMessage‑стиль сообщений (анонсы, кик‑скрины, hover‑подсказки)
• GUI:
• /report <ник> — меню причин (из конфига), поддержка “нужно уточнение” с вводом в чат
• Карточка репорта: телепорт, отклонение всех, мод-компас, краткий перечень последних репортов
• История наказаний (иконки по типам, модератор, причина, срок, время)
• Мод-компас: бан/мут/варн, тихий режим ON/OFF, быстрый выбор длительности и причин
• Безопасность:
• Блокировка наказаний модераторов/админов (по пермишенам/списку в config)
• Полный запрет чата и приватных команд в муте (список команд в config)
• Логи:
• Таблицы punishments/reports/moderator_stats/chat_logs/suspicious_activity/moderator_actions
• Отчёты в Discord/TG, мод‑лог всех действий
• PlaceholderAPI: %wguard_punishments%, %wguard_reports%

Конфигурация — ключевые блоки​

• database: sqlite/mysql + pool (HikariCP)
• punishments:
• reasons.ru/en — единый список причин (используется TAB и GUI /report)
• mute.blockedCommands — запрещённые команды в муте
• announcePublic, hoverFormat, единицы времени
• reports:
• categories (базовые), needDetailsReasons.ru/en — причины, требующие уточнения в чате
• autoNotifyModerators
• integrations:
• discord.webhookUrl
• telegram.botToken, telegram.chatId
• support — контакт для кик‑скрина при бане
• protection:
• enabled: true
• protectedPermissions: [“wguard.protected”, “wguard.admin”]
• protectedPlayers: []

Сообщения/оформление​

• Вся пользовательская выдача — в lang (ru_RU/en_US), MiniMessage:
• Анонсы наказаний с hover (время/причина)
• Кик‑скрины при бане/кике (модератор, причина, начало, срок, поддержка)
• Уведомления о муте: при попытке писать — оставшееся время + hover (кто/за что)
• Публичные оповещения о снятии наказаний (unmute/unban/unbanip)
• Меню, лоры, названия предметов — единый стиль; GUI‑тексты настраиваются в lang

Интеграции/логирование​

• Discord Webhook/Telegram — уведомления о репортах (с причинами/историей)
• Табличный мод‑лог действий, история наказаний, лог чата, подозрительная активность (скорость, TP, CPS)

Требования и совместимость​

• Paper/Purpur 1.21+ (Java 17+)
• SQLite по умолчанию; MySQL — при наличии
• PlaceholderAPI (optional/provided)

Установка и быстрый старт​

1) Поместите wGuard.jar в plugins/, перезапустите сервер.2) Настройте config.yml (БД, причины, интеграции, защита персонала).3) Отредактируйте lang/ru_RU.yml/en_US.yml под стиль проекта.4) Дайте пермишены группам/ролям (см. выше).

Почему wGuard​

• Полный стек модерации “из коробки”, без перегруза
• Настоящая локализация и единый визуальный стиль
• Чистые GUI и быстрые действия (мод‑компас, карточка репорта)
• Логирование всего, интеграции и API‑дружелюбность

Дорожная карта​

• Цветной lore через Adventure‑компоненты во всех GUI
• Гибкая карточка репорта (пагинация, фильтры)
• Расширение PlaceholderAPI и экспорт отчётов

Готов к продакшену: лаконичный, настраиваемый, быстрый — wGuard закроет потребности вашей команды модерации и упростит ежедневные задачи.