Decoy

Decoy — это античит системы «honeypot», который расставляет невидимые ловушки в окружении игроков для выявления использования x-ray, killaura, ESP и reach.

Decoy работает по принципу «тихого» обнаружения: плагин создает невидимые для обычных игроков объекты, которые активируются только при взаимодействии с ними сторонним ПО. Ловушки генерируются в повторяющемся цикле и полностью соответствуют ванильной генерации блоков и сущностей.

Плагин использует различные типы ловушек, которые невозможно заметить в обычном игровом процессе:

• Ловушки руды: фейковые жилы руды, созданные с использованием ванильных алгоритмов формирования (blob generation). Размеры жилы соответствуют типу руды (например, алмазы в жилах по 4-8 блоков, изумруды по одному). Ловушки размещаются за твердыми стенами, не дают дропа и мгновенно восстанавливаются при попытке разрушения.
• Ловушки сущностей: невидимые стойки для брони (armor stands), предназначенные для поимки killaura и reach. Система помечает игроков, атакующих сущностей, которые они не должны видеть или которые находятся вне радиуса досягаемости в 4 блока.
• NPC-ловушки: невидимые стойки с парящими тегами имен игроков. Эти объекты видны только читам с ESP или радарами сущностей.
• Ловушки сундуков: сундуки с ценными ресурсами, замурованные в камень. При попытке взаимодействия инвентарь не открывается, а игрок получает отметку.
• Поддержка Незера: создание ловушек из древних обломков, незеринового золота и кварца в мирах Незера с корректной заменой блоков на незерит, базальт и черный камень.

Система анализирует действия игроков и накапливает флаги подозрительной активности. Один флаг помечает игрока как подозрительного, а достижение порога в 3 или более флагов (настраивается) подтверждает факт использования читов.

• Отслеживание пути добычи: плагин фиксирует недавние разрушения блоков и вычисляет количество блоков, добытых игроком по прямой линии в сторону ловушки (beeline detection).
• Логирование в SQLite: все срабатывания сохраняются с UUID игрока, типом нарушения, координатами и дистанцией подхода. Данные сохраняются после перезагрузки сервера.
• Восстановление после краша: активные блоки ловушек отслеживаются в базе данных и возвращаются в исходное состояние при запуске сервера.

Decoy поддерживает отправку уведомлений через Discord Webhooks. Сообщения содержат красивые вставки (embeds) с аватаркой игрока, цветовой индикацией серьезности нарушения, историей флагов, координатами и данными о пути добычи. Отправка уведомлений полностью асинхронна и не создает нагрузки на сервер.

Основные параметры настраиваются в файле config.yml. Вы можете регулировать интервалы обновления, радиус размещения и пороги наказаний.

Для настройки автоматических наказаний используйте секцию punish.tiers. Плагин поддерживает выполнение любых консольных команд с использованием плейсхолдеров {player} и {count}.

punish:
  enabled: true
  tiers:
    - flags: 3
      commands:
        - "kick {player} Suspicious activity detected"
    - flags: 5
      commands:
        - "tempban {player} 1d Automated ban - xray detected ({count} flags)"
    - flags: 10
      commands:
        - "ban {player} Confirmed cheating - xray ({count} flags)"