Report System (Репорт систем)

Плагин для серверов Майнкрафт на Velocity, который помогает принимать и разбирать жалобы игроков по всей сети серверов. Для каждой жалобы он создаёт отдельный текстовый канал в Discord, а данные хранит в MariaDB.

Возможности

• Игрок отправляет жалобу на игрока с причиной, а администрация просматривает открытые и закрытые обращения, сведения о конкретной жалобе и историю жалоб отправителя или обвиняемого.
• При закрытии обращения можно сохранить веб-расшифровку переписки из канала Discord, включая прикреплённые изображения и файлы.
• Защита от спама ограничивает число жалоб за заданное время и повторные жалобы на одного игрока.
• Можно запретить жалобы на сотрудников с правом reports.protect, ограничить число одновременных открытых обращений и запретить игроку использовать команду жалоб.
• Сообщения, звуки уведомлений и права редактируются в config.yml.

Команды

• /report <player> <reason> — отправить жалобу.
• /reports — открыть список жалоб.
• /reports view-open — посмотреть свои открытые жалобы.
• /reports reload — перезагрузить конфиг и языковые файлы.
• /reports info <id> — показать сведения о жалобе.
• /reports close <id> — закрыть жалобу.
• /reports delete <id> — удалить жалобу из базы данных.
• /reports admin view-open и /reports admin view-closed — показать все открытые или закрытые жалобы в сети.
• /reports admin view-player sent <p> [status] — показать жалобы, отправленные игроком.
• /reports admin view-player received <p> [status] — показать жалобы на игрока.
• /reports admin ban-session <p> и /reports admin unban-session <p> — запретить или вновь разрешить игроку отправлять жалобы.

Права

• reports.report — отправка жалоб, если в конфиге включено требование права.
• reports.reload — перезагрузка конфига и языковых файлов.
• reports.info, reports.close, reports.delete — просмотр, закрытие и удаление жалоб.
• reports.admin.view — просмотр всех обращений и жалоб отдельных игроков.
• reports.admin.ban — запрет и разблокировка отправки жалоб.
• reports.bypassratelimit — обход ограничения частоты жалоб.
• reports.protect — защита сотрудника от жалоб.

Настройка

Основные параметры находятся в config.yml:

• max-open-reports — лимит открытых жалоб у одного игрока;
• rate-limit и same-player-rate-limit — ограничение частоты жалоб;
• protect-staff и protect-permission — защита сотрудников;
• close-comment-required и min-close-comment-length — обязательный комментарий при закрытии;
• discord-bot — токен бота, идентификаторы Discord-сервера, категории и канала журнала;
• database — подключение к MariaDB;
• lang — игровые сообщения;
• discord-bot.transcripts — создание веб-расшифровок и сохранение вложений.

Для расшифровок в discord-bot.transcripts.enabled укажите true, а ключ сервиса — в key и media-save-api-key.

Требования

Нужны прокси Velocity, база данных MariaDB и зарегистрированный бот Discord. В Discord заранее создайте категорию для каналов жалоб и отдельный канал журнала.