QUAZAR · admin · регламент

punishmod

как выдавать баны и муты через мод punishmod: от F6 до отчёта в базе. мод сам делает скриншот, собирает лог чата, отправляет отчёт и выдаёт наказание.

раздел 01

установка и первый запуск

выполняется один раз

что нужно

Minecraft 1.21.11, Fabric Loader 0.19.5 или новее, Fabric API для 1.21.11 и Java 21 или новее.

установка

положите punishmod-1.0.0.jar(кликабельно) и Fabric API в вашу сборку.

проверка

в настройках управления появится категория Punish Mod с клавишами F6 (меню наказаний) и F7 (скриншот при гриферстве). клавиши можно переназначить.

где работает

если в конфиге указан список серверов, мод работает только на них, на остальных пишет «Мод отключён на этом сервере».

мод клиентский: сервер о нём ничего не знает. команда наказания уходит в чат от вашего имени, поэтому права на /tempban и /tempmute у вас должны быть.

раздел 02

порядок действий

от нарушения до выданного наказания

шаг 1 — F6 на нарушителе

наведите прицел на нарушителя (до 64 блоков) и нажмите F6 . мод сам определит ник, сделает скриншот и откроет меню. ник виден в левом верхнем углу. если под прицелом никого не было, введите ник вручную: Tab дополняет его из списка онлайна, повторный Tab переключает на следующий вариант.

шаг 2 — правило

выберите раздел (1 — общие положения, 2 — чат, 3 — orbit, 4 — quad), затем правило. в списке только те правила, за которые есть наказание.

шаг 3 — срок

если у правила диапазон («от … до …»), выставьте срок ползунком, у некоторых правил последний шаг — «навсегда». если срок фиксированный, ползунка нет, срок показан строкой «срок: … (фиксированный)».

шаг 4 — «наказать»

мод отправит отчёт в базу и после успешной отправки сам выдаст команду в чат от вашего имени. когда придёт зелёное «Наказание выдано», всё готово. пока идёт отправка, кнопка заблокирована, а статус показывает шаг.

если отчёт не отправился, команда наказания не выдаётся . выдавать наказание без отчёта и доказательств нельзя.

что мод делает сам

действие как
ник нарушителя по прицелу при нажатии F6, можно поправить вручную
скриншот в момент нажатия F6, до открытия меню. прикладывается к бану, для мута не нужен
лог чата последние 300 сообщений с временем
отчёт уходит в базу наказаний по кнопке «наказать»
команда /tempban или /tempmute в чат, только после успешной отправки отчёта. в причине: название правила, ваш ник и контакт @quazar_administrator

скриншот делается в момент нажатия F6 , до открытия меню. убедитесь, что в кадре нарушитель и нарушение.

раздел 03

мут: правила чата

ник, срок и лог чата — скриншот не нужен

что делать

F6 → раздел 2 → правило → срок (если есть ползунок) → «наказать». меню вложений для мута нет: скриншот и файлы не прикладываются.

что уходит в базу

дамп чата: последние 300 сообщений с временем в формате [18:52:03] <ник> текст . в дамп входят обычный чат, ответы команд и личные сообщения, которые вы получили или отправили ( /m , /w , /tell , /msg , /r , /reply ). автообъявления сервера (по фильтру из конфига) в дамп не попадают.

ограничения дампа

дамп собирается из того, что видел ваш клиент: сообщений до вашего входа на сервер в нём нет, при выходе с сервера он очищается, а старше 300 сообщений затираются новыми. поэтому выдавайте мут сразу , пока нарушение в пределах последних 300 сообщений.

в дамп попадает личная переписка, которую видел ваш клиент. это личные данные: используйте только для разбора и не пересылайте за пределы команды (регламент администрации, раздел 10).

раздел 04

бан: доказательства

автоскриншот, дополнительные файлы и лог чата

автоскриншот

делается по F6 и обязателен: без него «наказать» вернёт ошибку. в меню под слайдером видно превью, клик по миниатюре открывает его на весь экран.

лог чата

прикладывается автоматически, как и для мута.

дополнительные файлы

кнопка «прикрепить ещё файл...» открывает окно выбора. принимаются png , jpg , jpeg , mp4 , mov , avi , всего до 5 файлов. текстовые файлы (.txt, логи) мод не принимает, лог нужно снять скриншотом. убрать файл из списка — кнопка «x» рядом.

размер

картинки мод уменьшает и сжимает сам. видео отправляются как есть, лимит 100 МБ: если файл больше, обрежьте нужный фрагмент.

хранение

копии скриншотов остаются у вас в папке .minecraft/punishmod/evidence . по регламенту администрации доказательства хранятся минимум 30 дней после наказания, не чистите папку раньше.

что нужно для правила

наказание что делаете вы
мут (раздел 2) ничего, кроме ника и срока. дамп чата прикладывается сам
бан (разделы 1, 3, 4) автоскриншот по F6 делается сам. дополнительные файлы — по ситуации
гриферство (3.1) минимум 1 скриншот через F7, до 5 (раздел 5)
читы (3.2, 4.1) видео проверки и скриншот лога MCheatCheck через «прикрепить ещё файл» (регламент cheat check). мод наличие видео не проверяет, прикрепляйте сами
раздел 05

гриферство: скриншоты логов

правило 3.1: до 5 скриншотов CoreProtect и разрушений

шаг 1 — правило

F6 на нарушителе, раздел 3, правило «3.1 Гриферство (Orbit)». в меню появятся кнопки «снять скрины (закрыть меню)» и «сбросить скрины», счётчик «скрины: 0/5». без хотя бы одного скриншота «наказать» не сработает.

шаг 2 — режим съёмки

нажмите «снять скрины». меню закроется, игра вернётся в обычный режим. выбранное правило, срок и автоскриншот сохраняются.

шаг 3 — съёмка

соберите улики по регламенту CoreProtect ( /co i , /co l ) и нажимайте F7 : каждый кадр сохраняется как доказательство, над панелью предметов видно «Скрин 2/5 сохранён». результат команды в чате виден несколько секунд, поэтому нажимайте F7 сразу после вывода.

что должно быть видно

лог CoreProtect (кто, когда, что), само разрушение или кража, ник нарушителя и, где применимо, время и координаты.

шаг 4 — возврат в меню

нажмите F6 . меню откроется с теми же правилом и сроком, под слайдером будут превью всех скриншотов (клик — на весь экран). лишние можно сбросить кнопкой «сбросить скрины» и снять заново.

шаг 5 — «наказать»

дальше как обычно: проверьте ник и срок и нажмите «наказать».

лимит — 5 скриншотов, после него F7 сообщит о лимите. режим съёмки и скриншоты хранятся 30 минут с момента первого нажатия F6 : после этого F6 начнёт новое наказание, и скриншоты придётся снимать заново.

F7 работает только в режиме съёмки. вне него мод подскажет порядок: F6 → правило гриферства → «снять скрины».

раздел 06

когда мод не подходит

наказания вручную командой

чего нет в моде

п. 1.11 (многочисленные нарушения), п. 3.7 (голосовой чат, другая команда), вариант «бан» по п. 2.7, варны и любые наказания вне диапазона публичных правил (только по согласованию с главной администрацией).

мод недоступен

нет связи с базой, ошибка конфига, мод не запускается. выдайте наказание командой вручную, а отчёт оформите в «#отчет» как раньше (регламент администрации, раздел 09).

формат команды вручную

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

/tempban Griefer777 5d "Гриферство (п. 3.1). Обратная связь - @quazar_administrator"
/tempmute Spammer55 1h "Спам (п. 2.4). Обратная связь - @quazar_administrator"

перм-бан: /tempban Griefer777 9999999d "Гриферство (п. 3.1). Обратная связь - @quazar_administrator"

раздел 07

ошибки и что делать

если «наказать» ответило красным

сообщение что делать
Укажите ник нарушителя введите ник в поле слева вверху
Некорректный ник: допустимы латиница, цифры, _ и . проверьте ник: пробелы и русские буквы недопустимы
Не удалось сохранить автоскриншот, нажмите F6 заново закройте меню и снова нажмите F6 на нарушителе
Гриферство: сделайте хотя бы 1 скрин режим съёмки (раздел 5)
Укажите реальный report_api_url… / Не задан … конфиг не настроен: обратитесь к главной администрации
VDS отклонил токен (HTTP 401 / 403) токен неверный или заменён: возьмите новый у главной администрации
Сервер VDS не найден / Не удалось подключиться / не ответил вовремя / Ошибка сети проверьте интернет и повторите «наказать». команда в чат не уходила. если не проходит, выдайте наказание вручную (раздел 6) и сообщите главной администрации
VDS ответил HTTP 5xx / не вернул ссылку / вернул не JSON сбой на стороне базы: повторите позже и сообщите главной администрации
Файл «…» больше 100 МБ / Файл не найден обрежьте видео или выберите файл заново
Отчёт отправлен, но команду выдать не удалось отчёт уже в базе: выдайте наказание вручную и не нажимайте «наказать» повторно, иначе отчёт задвоится
Мод отключён на этом сервере вы не на сервере QUAZAR или его адреса нет в списке конфига

мод не проверяет ответ плагина на команду. после «Наказание выдано» посмотрите чат: если плагин написал, что игрок не найден или не хватает прав, наказание не выдано , а отчёт уже сохранён. выдайте его вручную и сообщите главной администрации.

внутренний регламент QUAZAR · администрация. распространение запрещено.

← admin hub