[SBW]Drone Detector — UAV Detector for Forge 1.20.1

This lightweight client-friendly mod adds a portable UAV detector to the game with a minimal interface in the bottom-right corner of the screen, a custom beep sound, and server-controlled scanning range. The device continues to work even from the inventory when turned on, displaying a list of nearby drones with their current names (updates automatically when linked drones are renamed in Superb Warfare) and approximate distance to them. The beep sound triggers only for the closest UAV.

Key Features

• Item-based detector — toggled on/off with right-click, state saved in NBT data
• Compact interface — display in bottom-right corner with proximity bar and list of up to 5 drones with names and approximate distance
• Smart beep sound — sounds only for the closest drone, pitch and interval change based on distance
• Works from inventory — detector functions when located in any inventory slot while turned on
• Superb Warfare integration — automatic name updates when drones are renamed in SBW
• Server control — scanning radius is set on the server and synchronized with clients
• Client customization — adjustable volume, pitch range, beep period, and interface list size
• Custom sound — dedicated sound file with subtitles
• Extensible target list — new entity types for detection can be added via data tags

System Requirements

• Minecraft: 1.20.1
• Forge: 47.2.x
• Superb Warfare (optional, for drone detection)

Installation and Configuration

The mod must be installed on both client and server for multiplayer gameplay. Configuration files are automatically generated after the first launch.

Server configuration (serverconfig/drone_detector-server.toml):

[detector]
# Scanning radius in meters
range = 64.0

Client configuration (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

Sound Configuration

The mod registers its own sound file drone_detector:detector_beep. To replace the sound without rebuilding the mod, use resource packs that override the corresponding path.

Target Detection

By default, the mod targets drones from Superb Warfare and entities specified in the tag:

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

Custom entity types for detection can be added via datapacks.

Usage

1. Craft or obtain the UAV Detector item
2. Toggle on/off state with right-click
3. Keep in hand or leave in inventory (when turned on) to activate interface and beep sounds
4. Approach drones — the bar fills as you get closer, the list shows current names and approximate distance

Localization

Includes support for English and Russian languages (subtitles and item names).

Compatibility

Designed for Forge 1.20.1. Fully compatible with Superb Warfare, automatically recognizes changes to linked drone names.