Плагин XRayAlerts 1.0.0

XRayAlerts — серверный плагин для Paper и Spigot, предупреждающий сотрудников с нужным разрешением, когда игрок находит заданную руду или предмет. Он относится к категориям management, utility и economy и служит средством наблюдения, а не автоматического наказания. Автор — tjrgg; лицензия и её канонический идентификатор SPDX — MIT.

Клиентская установка не поддерживается, серверная сторона обязательна: игрокам не нужен дополнительный компонент.

Назначение и границы задачи​

Плагин помогает персоналу быстрее замечать добычу материалов, значимых для правил или экономики сервера. Администратор задаёт отслеживаемые блоки, а XRayAlerts формирует уведомление с данными об игроке, предмете и количестве результата.

Сигнал не доказывает использование x-ray: руда могла быть найдена случайно, по известной генерации или в ранее разведанной шахте. Персоналу следует:

• сопоставить уведомление с маршрутом и поведением игрока;
• при необходимости применить другие способы проверки;
• принять решение по правилам сервера, а не по одному сообщению.

Плагин не заменяет античит, журнал блоков или ручное наблюдение.

Скриншоты и внешний вид​

Аудитория и сценарии выбора​

Плагин рассчитан на Paper- и Spigot-серверы, где редкие ресурсы влияют на баланс, торговлю или честность соревнования. Он создаёт отдельный канал оповещений без клиентского мода.

XRayAlerts стоит рассмотреть, если:

• нужны сигналы о выбранных материалах;
• сотрудники готовы анализировать их вручную;
• требуется разграничить получение, отключение и игнорирование предупреждений;
• важен выбор между отчётом по каждому блоку и по жиле.

Если сигналы никто не обрабатывает или та же функция уже реализована, польза ограничена. Порядок реакции лучше определить заранее.

Режимы, сообщения и права​

В режиме block предупреждение отправляется для каждого отслеживаемого блока и показывает количество выпавших предметов. Он подробен, но при разработке жилы создаёт больше сообщений. В режиме vein одно уведомление появляется при добыче первого блока жилы, снижая нагрузку на персонал. Точный алгоритм границ жилы не раскрыт, поэтому нестандартную генерацию нужно проверять отдельно.

Текст настраивается, поддерживает цветовые и форматирующие коды, а также подстановки игрока, количества и предмета. Официальный пример включает древние обломки и обычные с глубинными варианты алмазной, изумрудной и золотой руды; это не обязательный список.

Подтверждены три разрешения:

• xrayalerts.receive — получение предупреждений;
• xrayalerts.toggle — включение и отключение их для себя;
• xrayalerts.ignore — действия игрока не вызывают предупреждений.

Команда /xrayalerts toggle переключает состояние у пользователя с xrayalerts.toggle. Право ignore следует выдавать ограниченно: оно исключает учётную запись из мониторинга.

Совместимость, файл и зависимости​

Подтверждены Minecraft 1.21 и 1.21.1; платформы — Bukkit, Paper и Spigot. Официальное описание ориентировано на Paper и Spigot, упоминает 1.21+ и отсутствие тестов ранних версий. Другие сочетания проверяют отдельно.

Распределение по сторонам:

• server — required;
• client — unsupported.

Подтверждённый файл — XRayAlerts-1.0.0.jar, версия 1.0.0, размер 9357 байт. Обязательные project dependencies не указаны, но это не гарантирует совместимость с любыми плагинами, изменённой генерацией или обработкой добычи.

Установка​

JAR помещают в папку plugins совместимого сервера. Распаковывать его не требуется.

Практическая последовательность:

• Штатно остановить сервер.
• Сохранить резервную копию папки plugins и настроек.
• Проверить имя, размер и контрольную сумму файла.
• Поместить JAR в папку plugins.
• Запустить сервер и просмотреть журнал загрузки.
• Настроить режим, текст и перечень блоков.
• Выдать разрешения нужным ролям.
• Выполнить тестовую добычу в контролируемой области.

Проверку лучше проводить на тестовом экземпляре или отдельном участке мира.

Проверка результата​

Удобно использовать две учётные записи: одна добывает выбранный блок, другая имеет receive и наблюдает за сообщениями. Отдельно проверяются пользователь без этого права, переключение toggle и намеренно выданное ignore.

Контрольный список:

• плагин загрузился без явной ошибки отключения;
• отслеживаемый материал вызывает предупреждение;
• имя, количество и предмет отображаются корректно;
• пользователь с receive видит сигнал, а без receive — нет;
• toggle меняет состояние получателя;
• block формирует события по отдельным блокам;
• vein создаёт ожидаемое сводное событие;
• ignore действует только для выбранной учётной записи.

Изменённые дропы, инструменты и генерацию проверяют отдельно. Статическая проверка структуры JAR не подтверждает реальное поведение.

Ограничения, безопасность и лицензия​

XRayAlerts видит только предусмотренные логикой и настройками события. Отсутствие сигнала не доказывает отсутствие нарушения: материал мог не входить в список, событие — обрабатываться иначе, а получатель — отключить сообщения.

Основные ограничения:

• подтверждены только перечисленные версии;
• ранние версии Minecraft официально не тестировались;
• границы нестандартных жил подробно не описаны;
• универсальная совместимость со сторонними плагинами не заявлена;
• качество контроля зависит от настроек, прав и действий персонала;
• динамический запуск предоставленного файла не выполнялся.

JAR получен по официальному HTTPS и локально сверен с опубликованными хешами. SHA-512: 1cbcbae02c11a828b7caf3401a6043068e2aa4e9ac0791636d3e5d1a7d0bc4f94a7e9baa4480141358368786d2a2117183854118ceb2adf310e286b1beb2a4f2. SHA-1: db789b4becfd95c301484f8dfdcdffa28dd1a74d. Архив прошёл статическую проверку структуры и путей, но не запускался динамически.

MIT разрешает локализацию при соблюдении её условий. Нужно сохранять название XRayAlerts, авторство tjrgg и сведения о лицензии; редакционные выводы не приписываются автору.

Безопасное обновление и откат​

Перед обновлением сохраняют рабочий JAR, конфигурацию и данные. Новую версию сначала проверяют на копии сервера с тем же значимым окружением.

Порядок обновления:

• Зафиксировать текущую версию и настройки.
• Остановить тестовый экземпляр и создать резервную копию.
• Заменить только JAR XRayAlerts.
• Проверить журнал загрузки.
• Повторить тесты block, vein, receive, toggle и ignore.
• Перенести обновление на основной сервер после проверки.

Для отката сервер останавливают и возвращают прежний JAR с совместимой копией данных. Новую конфигурацию со старым файлом используют только после проверки.

Диагностика​

Если предупреждений нет, последовательно проверяют загрузку плагина, версию платформы, список monitored-blocks, право receive, состояние toggle и наличие ignore у добывающего игрока. Если сообщений слишком много, оценивают режим block и состав списка; vein может уменьшить поток, но требует теста.

При неверном тексте проверяют подстановки и форматирование, при дублировании — параллельную обработку другим плагином. Для отчёта сохраняют:

• версии Minecraft, платформы и XRayAlerts;
• фрагмент журнала загрузки;
• выбранный режим и материал;
• права обеих тестовых учётных записей;
• точную последовательность действий;
• сведения о средствах, меняющих добычу или генерацию.

FAQ​

Нужен ли XRayAlerts на клиенте?​

Нет. Клиентская сторона обозначена как unsupported, серверная — required. JAR устанавливается только в папку plugins сервера.

Доказывает ли предупреждение использование x-ray?​

Нет. Оно фиксирует предусмотренное событие добычи. Решение требует контекста и, при необходимости, других методов проверки.

Какие версии подтверждены?​

В предоставленных метаданных подтверждены Minecraft 1.21 и 1.21.1. Другие сочетания следует проверять на отдельном экземпляре.

Можно ли получать одно сообщение на жилу?​

Да. Для этого предназначен режим vein. Режим block сообщает о каждом отслеживаемом блоке.

Как удалить плагин с возможностью возврата?​

Остановить сервер, сохранить JAR и данные XRayAlerts, затем удалить файл из plugins. Для возврата восстановить совместимую резервную копию.