ShadowTracePlugin

ShadowTracePlugin предоставляет серверную функциональность для мода ShadowTrace, позволяя администраторам анализировать активность игроков в реальном времени.

ShadowTracePlugin — это мощное серверное дополнение, разработанное специально для платформы Paper. Оно обеспечивает необходимую функциональность на стороне сервера, которая позволяет использовать функции визуализации в игровом моде ShadowTrace. Плагин интегрируется с CoreProtect для анализа и отслеживания активности по добыче блоков конкретными игроками за определенный период времени.

Обрабатывая данные CoreProtect асинхронно, плагин позволяет визуально отображать места добычи руды. Это помогает администраторам и модераторам выявлять потенциальное использование X-ray как в режиме реального времени, так и постфактум. Передача данных в клиентский мод осуществляется напрямую через каналы сообщений плагинов.

Основные возможности плагина включают:

• Просмотр истории добычи руды игроками
• Отображение точных координат добытых блоков
• Фильтрация запросов по игроку и временному интервалу (например, 1m, 1h, 1d)
• Поддержка до 300 блоков за один поиск для оптимального отображения
• Работа с данными как онлайн, так и офлайн игроков
• Использование кастомной системы пакетов для эффективной передачи данных

Для использования команд игрокам необходимо право доступа shadowtrace.command.shadowtrace.

Команда /shadowtrace getores [player] [time] позволяет получить и визуализировать активность по добыче руды конкретного игрока в заданном интервале. Плагин извлекает данные из CoreProtect и отправляет их в мод ShadowTrace для отображения в игре.

/shadowtrace getores Steve 2h

Аргументы команды:

• [player] — цель проверки
• [time] — временной диапазон (1m = 1 минута, 1h = 1 час, 1d = 1 день)

Команда /shadowtrace blocks [player] [time] [blocks] используется для визуализации событий разрушения конкретных типов блоков игроком в указанное окно времени.

/shadowtrace blocks Steve 1d DIAMOND_ORE,GOLD_ORE,SPAWNER

• [player] — цель проверки
• [time] — временной диапазон (1m, 1h, 1d)
• [blocks] — список типов блоков через запятую (имена в формате enum, например, DIAMOND_ORE)

Настройки конфигурации в config.yml:

query:
  # Max blockquery per blocktype.
  max-blocks-per-type: 800

Доступные сообщения в messages.yml включают уведомления об ошибках аргументов, отсутствии прав, отсутствии данных в мире и статусе перезагрузки конфигурации.

Мод ShadowTrace требует наличия этого плагина на сервере для корректной работы. Также плагину требуется наличие CoreProtect.