DetectorUAV — UAV proximity detector for Forge 1.20.1

A lightweight client-friendly mod that adds a handheld UAV detector with a minimal HUD (bottom-right), a custom beep, and server-controlled scan range. Works even from the inventory when switched ON, lists nearby drones with their current names (updates when Superb Warfare renames a linked drone) and shows an approximate distance. The beep triggers only for the closest UAV.

✨ Features

• Item-based detector (toggle ON/OFF via right-click; state saved in NBT).

• HUD in the bottom-right corner: compact bar + list (up to 5) with name and ≈distance (doesn’t clutter the UI).

• Beep only for the nearest UAV; pitch/interval scale with distance.

• Works from inventory: if the detector item is ON anywhere in your inventory, tracking & HUD work.

• Superb Warfare support: reads the display name each tick, so when SBW renames a linked drone, the HUD shows the updated name automatically.

• Server-controlled radius (authoritative): synced to clients on join and when reloaded.

• Client-only customization: volume, pitch range, beep period, HUD list size.

• Custom sound (drone_detector:detector_beep) with subtitles.

• Extensible target list via a data tag.

📦 Requirements

• Minecraft: 1.20.1

• Forge: 47.2.x

• (Optional) Superb Warfare (for UAV entities to detect)

🔧 Installation

1. Put the mod on both client and server (for MP).

2. Launch once to generate configs.

3. (Optional) Add/adjust UAV entity types via the tag (see below).

⚙️ Configuration

Server (authoritative gameplay settings)
serverconfig/drone_detector-server.toml

[detector]
# Scan radius in meters
range = 64.0

Client (HUD & audio only)
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 is bottom-right by design to keep UI clean)

🔊 Custom beep sound

The mod registers drone_detector:detector_beep.

File layout

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 }]
  }
}

Want to swap the beep without rebuilding? Use a resource pack overriding the same path.

🎯 What counts as a UAV

By default the mod targets Superb Warfare drones and anything in the entity type tag below. Extend it with datapacks to include your own entities:

data/drone_detector/tags/entity_types/drone_targets.json

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

🕹️ How to use

• Craft/spawn the UAV Detector item.

• Right-click to toggle ON/OFF.

• Keep it in hand or anywhere in inventory (if ON) to activate HUD + beeps.

• Approach drones: the bar fills as you get closer; the list shows current names and ≈distance.

🤝 Multiplayer & Sync

• The server sets the scan radius; clients receive it on login and after server config reloads.

• Clients control only HUD & audio.

🗺️ Localization

• en_us, ru_ru included (subtitles & item strings).

🧩 Compatibility

• Designed for Forge 1.20.1.

• Works alongside Superb Warfare; recognizes linked drone name changes automatically.

🐞 Known Issues / Notes

• If your custom UAV type isn’t detected, add its entity type to the drone_targets tag.

• Excessively large server radius may slightly increase client scanning costs (default is safe)

📣 Credits & License

• Author: Liko

• Mod ID: drone_detector

• License: Apache 2.0

🧭 Roadmap

• Optional HUD position offset in config (keeping minimal footprint).

• Per-entity icons in the list (tiny 16×16).

• Keybind to temporarily mute beeps.

📝 Issue Reporting

Please include: MC version, Forge version, list of mods, logs, and steps to reproduce.

Reuploading this project is prohibited!

Опубликовывать проект на иных сайтах запрещено!