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