установка и первый запуск
выполняется один раз
что нужно
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
у вас должны быть.
порядок действий
от нарушения до выданного наказания
шаг 1 — F6 на нарушителе
наведите прицел на нарушителя (до 64 блоков) и нажмите
F6
. мод сам определит ник, сделает скриншот и откроет меню. ник виден в левом верхнем углу. если под прицелом никого не было, введите ник вручную:
Tab
дополняет его из списка онлайна, повторный Tab переключает на следующий вариант.
шаг 2 — правило
выберите раздел (1 — общие положения, 2 — чат, 3 — orbit, 4 — quad), затем правило. в списке только те правила, за которые есть наказание.
шаг 3 — срок
если у правила диапазон («от … до …»), выставьте срок ползунком, у некоторых правил последний шаг — «навсегда». если срок фиксированный, ползунка нет, срок показан строкой «срок: … (фиксированный)».
шаг 4 — «наказать»
мод отправит отчёт в базу и после успешной отправки сам выдаст команду в чат от вашего имени. когда придёт зелёное «Наказание выдано», всё готово. пока идёт отправка, кнопка заблокирована, а статус показывает шаг.
если отчёт не отправился, команда наказания не выдаётся . выдавать наказание без отчёта и доказательств нельзя.
что мод делает сам
| действие | как |
|---|---|
| ник нарушителя | по прицелу при нажатии F6, можно поправить вручную |
| скриншот | в момент нажатия F6, до открытия меню. прикладывается к бану, для мута не нужен |
| лог чата | последние 300 сообщений с временем |
| отчёт | уходит в базу наказаний по кнопке «наказать» |
| команда |
/tempban
или
/tempmute
в чат, только после успешной отправки отчёта. в причине: название правила, ваш ник и контакт @quazar_administrator
|
скриншот делается в момент нажатия
F6
, до открытия меню. убедитесь, что в кадре нарушитель и нарушение.
мут: правила чата
ник, срок и лог чата — скриншот не нужен
что делать
F6
→ раздел 2 → правило → срок (если есть ползунок) → «наказать». меню вложений для мута нет: скриншот и файлы не прикладываются.
что уходит в базу
дамп чата: последние
300
сообщений с временем в формате
[18:52:03] <ник> текст
. в дамп входят обычный чат, ответы команд и личные сообщения, которые вы получили или отправили (
/m
,
/w
,
/tell
,
/msg
,
/r
,
/reply
). автообъявления сервера (по фильтру из конфига) в дамп не попадают.
ограничения дампа
дамп собирается из того, что видел ваш клиент: сообщений до вашего входа на сервер в нём нет, при выходе с сервера он очищается, а старше 300 сообщений затираются новыми. поэтому выдавайте мут сразу , пока нарушение в пределах последних 300 сообщений.
в дамп попадает личная переписка, которую видел ваш клиент. это личные данные: используйте только для разбора и не пересылайте за пределы команды (регламент администрации, раздел 10).
бан: доказательства
автоскриншот, дополнительные файлы и лог чата
автоскриншот
делается по
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). мод наличие видео не проверяет, прикрепляйте сами |
гриферство: скриншоты логов
правило 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 → правило гриферства → «снять скрины».
когда мод не подходит
наказания вручную командой
чего нет в моде
п. 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"
ошибки и что делать
если «наказать» ответило красным
| сообщение | что делать |
|---|---|
| Укажите ник нарушителя | введите ник в поле слева вверху |
| Некорректный ник: допустимы латиница, цифры, _ и . | проверьте ник: пробелы и русские буквы недопустимы |
| Не удалось сохранить автоскриншот, нажмите F6 заново | закройте меню и снова нажмите F6 на нарушителе |
| Гриферство: сделайте хотя бы 1 скрин | режим съёмки (раздел 5) |
| Укажите реальный report_api_url… / Не задан … | конфиг не настроен: обратитесь к главной администрации |
| VDS отклонил токен (HTTP 401 / 403) | токен неверный или заменён: возьмите новый у главной администрации |
| Сервер VDS не найден / Не удалось подключиться / не ответил вовремя / Ошибка сети | проверьте интернет и повторите «наказать». команда в чат не уходила. если не проходит, выдайте наказание вручную (раздел 6) и сообщите главной администрации |
| VDS ответил HTTP 5xx / не вернул ссылку / вернул не JSON | сбой на стороне базы: повторите позже и сообщите главной администрации |
| Файл «…» больше 100 МБ / Файл не найден | обрежьте видео или выберите файл заново |
| Отчёт отправлен, но команду выдать не удалось | отчёт уже в базе: выдайте наказание вручную и не нажимайте «наказать» повторно, иначе отчёт задвоится |
| Мод отключён на этом сервере | вы не на сервере QUAZAR или его адреса нет в списке конфига |
мод не проверяет ответ плагина на команду. после «Наказание выдано» посмотрите чат: если плагин написал, что игрок не найден или не хватает прав, наказание не выдано , а отчёт уже сохранён. выдайте его вручную и сообщите главной администрации.
внутренний регламент QUAZAR · администрация. распространение запрещено.
← admin hub