[SBW]Drone Detector [1.20.1]

DetectorUAV — детектор приближения БПЛА для Forge 1.20.1

Лёгкий мод для клиента, который добавляет портативный детектор БПЛА с минимальным HUD (в правом нижнем углу), пользовательским звуковым сигналом и диапазоном сканирования, управляемым сервером. Работает даже из инвентаря, когда переключен ВКЛ, отображает список ближайших дронов с их текущими именами (обновляется, когда Superb Warfare переименовывает связанный дрон) и показывает приблизительное расстояние. Звуковой сигнал срабатывает только для ближайшего БПЛА.

✨ Особенности

• Детектор в виде предмета (переключение ВКЛ/ВЫКЛ через правый клик; состояние сохраняется в NBT).

• HUD в правом нижнем углу: компактная шкала + список (до 5) с именем и ≈расстоянием (не загромождает интерфейс).

• Сигнал только для ближайшего БПЛА; тон/интервал масштабируются в зависимости от расстояния.

• Работает из инвентаря: если детектор включён и находится где-либо в вашем инвентаре, отслеживание и HUD активны.

• Поддержка Superb Warfare: считывает отображаемое имя каждый тик, поэтому, когда SBW переименовывает связанный дрон, HUD автоматически показывает обновлённое имя.

• Радиус, управляемый сервером (авторитетный): синхронизируется с клиентами при входе и после перезагрузки.

• Только клиентская настройка: громкость, диапазон тона, период сигнала, размер списка HUD.

• Пользовательский звук (drone_detector:detector_beep) с субтитрами.

• Расширяемый список целей через data tag.

📦 Требования

• Minecraft: 1.20.1

• Forge: 47.2.x

• (Опционально) Superb Warfare (для обнаружения сущностей БПЛА)

🔧 Установка

1. Установите мод и на клиент, и на сервер (для мультиплеера).

2. Запустите игру один раз для создания конфигурационных файлов.

3. (Опционально) Добавьте/настройте типы сущностей БПЛА через тег (см. ниже).

⚙️ Конфигурация

Сервер (авторитетные игровые настройки)
serverconfig/drone_detector-server.toml

[detector]
# Радиус сканирования в метрах
range = 64.0

Клиент (только HUD и звук)
config/drone_detector-client.toml

[audio]
onlyNearestBeep = true
beepMinPeriod = 6
beepMaxPeriod = 40
beepVolume = 0.8
beepPitchMinFar = 0.7
beepPitchMaxNear = 1.8

[hud]
enabled = true
listCount = 5
# (HUD по умолчанию расположен в правом нижнем углу для сохранения чистоты интерфейса)

🔊 Пользовательский звук сигнала

Мод регистрирует звук drone_detector:detector_beep.

Структура файлов

assets/drone_detector/sounds.json
assets/drone_detector/sounds/detector_beep.ogg
assets/drone_detector/lang/en_us.json
assets/drone_detector/lang/ru_ru.json

sounds.json

{
  "detector_beep": {
    "subtitle": "subtitles.drone_detector.detector_beep",
    "sounds": [{ "name": "drone_detector:detector_beep", "stream": false }]
  }
}

Хотите заменить звук сигнала без пересборки? Используйте ресурс-пак, переопределяющий тот же путь.

🎯 Что считается БПЛА

По умолчанию мод нацелен на дроны из Superb Warfare и любые сущности в указанном ниже теге типов сущностей. Расширьте его с помощью дата-паков, чтобы включить собственные сущности:

data/drone_detector/tags/entity_types/drone_targets.json

{
  "replace": false,
  "values": [
    "sbw:fpv_drone",
    "sbw:swarm_drone",
    "superbwarfare:fpv_drone"
  ]
}

🕹️ Как использовать

• Создайте/получите предмет Детектор БПЛА.

• Правый клик для переключения ВКЛ/ВЫКЛ.

• Держите его в руке или где-либо в инвентаре (если ВКЛ), чтобы активировать HUD и звуковые сигналы.

• Приближайтесь к дронам: шкала заполняется по мере приближения; список показывает текущие имена и ≈расстояние.

🤝 Мультиплеер и синхронизация

• Сервер устанавливает радиус сканирования; клиенты получают его при входе и после перезагрузки конфигурации сервера.

• Клиенты управляют только HUD и звуком.

🗺️ Локализация

• Включены локализации en_us, ru_ru (субтитры и строки предметов).

🧩 Совместимость

• Разработан для Forge 1.20.1.

• Работает совместно с Superb Warfare; автоматически распознаёт изменения имён связанных дронов.

🐞 Известные проблемы / Примечания

• Если ваш пользовательский тип БПЛА не обнаруживается, добавьте его тип сущности в тег drone_targets.

• Чрезмерно большой радиус на сервере может незначительно увеличить нагрузку на клиент при сканировании (значение по умолчанию безопасно)