Окно логов CoreProtect с фильтрами и карточка инспектора в углу экрана.
Spigot · Paper · Purpur · Folia 1.16.5–26.2 | Fabric: 7 версий клиента | CoreProtect CE 24+
Зачем???
/co lookup выдаёт ответ в чат по четыре строки на страницу, а предметы показывает без описания. На большой проверке после гриферов приходится листать десятки страниц. CoreProtectUI берёт те же данные через официальный API CoreProtect и показывает их в окне, где фильтры выставляются мышкой, а строки сортируются кликом по заголовку.
Нужны две части: плагин на сервере и Fabric-мод у тех, кто смотрит логи. Обычным игрокам мод не нужен, сервер без него работает как раньше.
📜 Журнал
Открывается клавишей J (меняется в настройках управления) или командой /coui.
Каждая строка читается как фраза: «Steve сломал блок Камень, 12 64 -30». Названия блоков, предметов и мобов берутся из языка игры у того, кто смотрит, поэтому у русского модератора будет «Камень», у английского Stone.
Цвет слева у строки показывает тип действия: красный для поломки и изъятия, зелёный для установки, жёлтый для нажатий, бирюзовый для выброшенных предметов, фиолетовый для чата и команд. Откаченные записи помечены плашкой «откат», название в них зачёркнуто.
Клик по координатам телепортирует на место, если есть право coreprotect.teleport.
🎛 Фильтры
- Игрок. При вводе сервер присылает подсказки из тех, кто заходил на сервер или встречался в логах. Можно перечислить несколько через запятую, а с «!» исключить: Steve, !Alex. Есть и служебные #tnt, #fire, #creeper и другие.
- Действия. Выпадающий список с галочками: 18 типов, от поломки блоков до смены ника.
- Объект. Блок, предмет или моб по названию на вашем языке либо по id. Подсказки показывают иконку и id.
- Время. 1h, 6h, 2d3h, 1w или по-русски 2д3ч. Пустое поле значит «за всё время». Есть готовые варианты от часа до 30 дней.
- Радиус. Ползунок от 0 до 256 блоков вокруг вас. На нуле поиск идёт по всему серверу.
🗡 Предметы
Наведите курсор на предмет в строке, и появится обычная подсказка игры: чары, лор, атрибуты, кастомное имя. На Paper предмет передаётся целиком со всеми данными, а если сервер старше клиента, мод обновит данные через встроенный в игру DataFixer.
В поле «Объект» можно искать по части кастомного имени или строке лора. Регистр и цветовые коды не мешают: запрос «меч» найдёт «§bЛегендарный §lМеч».
↕ Сортировка и страницы
Клик по заголовку столбца сортирует по нему: время, игрок, действие, объект, место. Повторный клик меняет направление, так что по времени можно листать и от старых записей к новым.
Страницы внизу: « ‹ 1 2 (3) 4 5 › ». Ещё листают колесо мыши и стрелки.
Результат поиска хранится на сервере 60 секунд, поэтому сортировка и переход по страницам не нагружают базу повторно.
🔍 Инспектор
Включите /co i как обычно, и слева сверху появится карточка блока, на который вы смотрите: иконка, название, координаты и последние изменения в том же виде, что и в журнале. Для сундуков видно, кто что положил и взял. Кликать по блоку ради истории в чате больше не нужно.
🧩 Совместимость
- Плагин: один jar для Spigot, Paper, Purpur и Folia, Minecraft 1.16.5 – 26.2. На Folia используются региональные планировщики.
- Мод: Fabric, семь файлов: 1.16.5, 1.18–1.18.2, 1.19.4, 1.20.2–1.20.4, 1.21.2–1.21.4, 1.21.6–1.21.8 и 26.2. Fabric API ставить не нужно, нужные модули уже внутри.
- CoreProtect: Community Edition 24.0 и новее.
- Превью предметов: на Paper, Folia и свежем Spigot (проверено на 1.21.8) предмет показывается полностью. На Spigot 1.16.5 превью упрощённое: имя, лор и чары.
🛡 Безопасность
Плагин только читает данные через официальный API CoreProtect и ничего не пишет в базу. Права проверяются на сервере при каждом запросе, мод сам ничего не решает. Поиски выполняются асинхронно, есть ограничение частоты запросов на игрока.
📥 Установка
- Положите CoreProtectUI.jar в plugins рядом с CoreProtect 24+ и перезапустите сервер.
- Модераторам установить мод под свою версию игры (файл coreprotectui-1.0.0+ВЕРСИЯ.jar).
- Выдать права, если модераторы не операторы.
/coui открывает журнал (то же, что клавиша J).
/coui reload перечитывает config.yml.
/coui reload перечитывает config.yml.
coreprotectui.use доступ к журналу и карточке инспектора. Дополнительно нужны права самого CoreProtect:
coreprotect.lookup для журнала, coreprotect.inspect для карточки, coreprotect.teleport для телепорта по клику.
coreprotectui.admin команда /coui reload.
По умолчанию оба права у операторов.
coreprotect.lookup для журнала, coreprotect.inspect для карточки, coreprotect.teleport для телепорта по клику.
coreprotectui.admin команда /coui reload.
По умолчанию оба права у операторов.
Код:
# сколько строк максимум собирает один поиск
max-results: 10000
# сколько строк максимум просматривается, когда нужен поиск по имени и лору
max-scan: 100000
# сколько секунд результат хранится для сортировки и страниц
cache-seconds: 60
# пауза между новыми поисками одного игрока, мс
lookup-cooldown-ms: 750
# сколько строк истории в карточке инспектора
inspect-rows: 6❓ Вопросы
Что увидит игрок без мода? Ничего нового. /co lookup и /co i работают как обычно, /coui подскажет установить мод.
Что с огромной базой? Один поиск собирает до 10 000 строк (меняется в конфиге). Если упёрлись в предел, журнал скажет об этом, и стоит сузить фильтры: указать игрока, время или радиус.
А через ViaVersion? Тестировалось только при одинаковой версии клиента и сервера. Если сервер новее клиента, превью предмета откатится к имени, лору и чарам.
