CPVisualizer — приватная визуализация истории CoreProtect
Администраторам серверов на Paper часто не хватает наглядности при разборе инцидентов. Команды CoreProtect выдают сухие списки координат, а восстановить картину происшествия по строкам лога неудобно. Плагин CPVisualizer решает эту задачу: он превращает записи CoreProtect в интерактивный интерфейс, где история блоков и контейнеров отображается прямо в инвентаре. При этом результаты поиска видит только тот администратор, который его запустил.
Что умеет CPVisualizer
CPVisualizer для Minecraft работает как надстройка над CoreProtect и не заменяет его. Плагин читает уже записанную историю и показывает её в виде GUI, по которому удобно кликать. Основные возможности:
- Просмотр действий с блоками и контейнерами в графическом интерфейсе.
- Подсветка найденных позиций через BlockDisplay — причём приватная, только для инициатора поиска.
- Поиск по одному игроку или сразу по всем онлайн- и офлайн-игрокам.
- Фильтрация по конкретному материалу блока либо по всем типам сразу.
- Отслеживание установки, разрушения, взаимодействия, а также добавления и изъятия предметов из контейнеров.
- Фильтры по времени, миру и радиусу, постраничная выдача результатов.
- Детали каждого события и телепортация к точке.
Отдельно стоит отметить приватность. Каждая поисковая сессия независима, а подсветка блоков не сохраняется на сервере и не мешает другим администраторам. История и реальные блоки при визуализации никогда не изменяются — это только просмотр.
Поддерживаемые версии и зависимости
Плагин рассчитан на Paper 26.3 и Java 25. Для работы требуется сборка CoreProtect, совместимая с этой версией Paper, с включённым API 12. CoreProtect — отдельная обязательная зависимость, CPVisualizer его не включает. Существует также неофициальный порт совместимости с CoreProtect 24.1, распространяемый отдельно вместе с исходным кодом и лицензией. Folia и другие серверные платформы не поддерживаются.
Клиентский мод не нужен, ProtocolLib тоже не требуется. Версия 1.1.1 получила полностью англоязычные меню и сообщения.
Как установить CPVisualizer
Установка не вызовет сложностей даже у новичка. Порядок действий такой:
- Остановите сервер.
- Установите совместимую с Paper 26.3 сборку CoreProtect и включите API 12.
- Поместите файл CPVisualizer-1.1.1-paper26.3.jar в папку plugins/.
- Запустите Paper 26.3 с Java 25 и выполните команду /cpv от имени оператора.
Если вы предпочитаете не возиться с файлами вручную, обратите внимание на лаунчер foxygame.net: в его каталоге дополнений CPVisualizer устанавливается в один клик вместе с нужной сборкой CoreProtect, а версии под Paper подбираются автоматически. Тем, кто собирает сервер сам, стоит заранее проверить, что Java 25 активна, иначе плагин просто не запустится.
Команды и примеры поиска
Всё управление строится вокруг команды /cpv. Чтобы найти все действия, введите /cpv player all, затем /cpv block all, /cpv action ALL, /cpv time 24h и /cpv radius 100, после чего запустите /cpv search. Поддерживаются и сокращённые формы вроде /cpv blocks all, /cpv bloks all, а также символ *. Системные акторы CoreProtect, имена которых начинаются с #, исключаются из результатов по всем игрокам. Радиусный поиск охватывает квадрат по X/Z включительно на всех высотах.
Права и лимиты
По умолчанию разрешения выданы операторам: cpvisualizer.use, cpvisualizer.search и cpvisualizer.teleport. Право cpvisualizer.admin включает их все и дополнительно разрешает /cpv reload. Глобальный поиск по всем игрокам и блокам охватывает только загруженные миры. Итоговый лимит по умолчанию — 500 событий. Типы исторических контейнеров определяются по сохранившимся логам, а неоднозначные варианты попадают в выдачу только при выборе всех блоков. Если вы упёрлись в лимит, сузьте время или радиус.
Тестирование и надёжность
Все 14 автоматизированных тестов прошли как против официального Maven API CoreProtect, так и против порта совместимости. Интеграционные проверки выполнены на Paper 26.3 build 169 с SQLite: фильтрация, несколько миров, приватные непостоянные отображения и откат/восстановление CoreProtect работают корректно. Визуальная проверка с двумя реальными игровыми клиентами, MySQL, WorldEdit и Folia пока не проводилась — учитывайте это при развёртывании на продакшене.
Лицензия и происхождение
CPVisualizer распространяется под лицензией MIT. CoreProtect сохраняет собственную лицензию Artistic License 2.0 и авторство. Разработчики честно указывают: реализация и документация создавались с помощью ИИ на основе требований проекта, а затем прошли автоматические и серверные интеграционные проверки. Сам плагин никаких ИИ-сервисов не использует.
Итог
CPVisualizer — удобный инструмент для тех, кто устал разбирать инциденты по строчкам логов. Он не заменяет CoreProtect, а делает его историю наглядной и приватной. Если вам нужен быстрый способ скачать CPVisualizer и сразу перейти к делу, начните с каталога foxygame.net, а при ручной установке внимательно проверьте версии Paper, Java и CoreProtect — тогда плагин заработает с первого запуска.