Player Dossier

Мод для модераторов Minecraft (Fabric 26.3, Java 25): локальное ведение личных заметок об игроках, мгновенный доступ к истории нарушений с VanillaSquad Banlist, визуальные индикаторы над модельками игроков в 3D мире и быстрая проверка игрока в прицеле по NUM 0.

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

1. 3D Индикаторы над модельками игроков в мире:

• Фиолетовая точка (●) над головой игрока: в вашей базе есть личные заметки об этом игроке.
• Жёлтая точка (●) над головой игрока: у игрока есть свежие или активные нарушения в банлисте VanillaSquad.
• Обе точки (● ●): у игрока есть и персональные модераторские заметки, и нарушения на сервере.
• Индикаторы отображаются исключительно в 3D пространстве над моделью персонажа (не засоряют чат и список игроков Tab).

2. Быстрая проверка в прицеле (NUM 0):

• При наведении прицела на игрока в мире (до 64 блоков) и нажатии горячей клавиши NUM 0 мод автоматически отправляет серверные команды проверки:
• • /ping <никнейм>
  • /playtime <никнейм>
  • /history <никнейм>
• Отправка команд защищена очередью с паузой в 2 тика (100 мс) между пакетами, чтобы предотвратить кик или блокировку серверным анти-спамом.
• Клавиша полностью настраивается в Настройки -> Управление -> Назначение клавиш -> Досье игроков.
• Также доступно через чат-команду: /dossier inspect <никнейм> или /banlist inspect <никнейм>.

3. Личные заметки модератора:

• Хранение персональных заметок об игроках (подозрения, проверенные факты, история предупреждений, улики, ссылки на логи и координаты).
• Категоризация по цветным тегам: ПОДОЗРЕНИЕ, ЧИТЫ, ГРИФЕРСТВО, ПРЕДУПРЕЖДЕНИЕ, ПРОВЕРЕН, ЗАМЕТКА.
• Быстрый поиск в реальном времени по нику, тегу, автору или содержимому заметки.
• Полное управление (создание, редактирование, удаление, просмотр).
• Надёжное локальное хранение в формате JSON с атомарной записью и резервным копированием (config/playerdossier/notes.json).

4. Интеграция с VanillaSquad Banlist & Подгрузка страниц:

• Получение актуального списка блокировок и предупреждений напрямую с https://vanillasquad.com/banlist.
• Кнопка [+5 Стр.] в интерфейсе и команда /banlist sync [страницы] для фоновой выкачки архива нарушений.
• Вежливый троттлинг (120 мс пауза между страницами) и дедупликация записей.
• Локальное сохранение кэша банлиста на диск (config/playerdossier/banlist_cache.json) с доступностью офлайн.
• Цветовая индикация типов наказаний:
• • Бан (красный)
  • Предупреждение (желтый / золото)
  • Мут (синий / циан)
  • Кик / Прочее
• Отображение статуса наказания (Активно, Истекло), модератора, даты выдачи и срока действия.

5. Сводное досье игрока (Player Dossier):

• При выборе любого игрока открывается объединённая карточка:
• • Все ваши личные модераторские заметки по игроку.
  • Вся публичная история наказаний этого игрока на сервере VanillaSquad.
  • Быстрое добавление новой заметки в один клик.
  • Копирование ника игрока в буфер обмена по клику.

6. Интерфейс и управление:

• Открытие UI по горячей клавише: по умолчанию O (Настройки -> Управление -> Назначение клавиш -> Досье игроков).
• Быстрая проверка прицелом: по умолчанию NUM 0.
• Чат-команды клиента:
• • /dossier — открыть главное меню досье
  • /dossier <ник> — открыть досье конкретного игрока
  • /dossier banlist или /banlist — открыть вкладку банлиста
  • /banlist sync [кол-во] — фоновая загрузка следующих страниц банлиста
  • /dossier inspect <ник> — выполнить пакет команд /ping, /playtime, /history
• Полная совместимость с ModMenu.
• Адаптивная пагинация, поддержка скролла колёсиком мыши и клавиш Page Up / Page Down.
• Полная русская и английская локализация.