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

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

Launch once to generate configs.

(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! Опубликовывать проект на иных сайтах запрещено!