[SBW]Drone Detector

DetectorUAV — Forge 1.20.1 无人机接近探测器

这是一款轻量、兼顾客户端体验的模组，新增了一个手持式无人机探测器，配有简洁的 HUD（位于右下角）、自定义提示音和由服务器控制的扫描范围。探测器开启后，即使放在物品栏中也能正常工作；它会列出附近无人机的当前名称（Superb Warfare 重命名已关联的无人机时，名称也会同步更新），并显示大致距离。提示音只会针对最近的无人机触发。

✨ 功能

• 基于物品的探测器（右键切换开/关；状态保存在 NBT 中）。

• 位于右下角的 HUD：紧凑状态栏和列表（最多 5 架），显示名称和 ≈距离（不会让界面显得杂乱）。

• 只对最近的无人机发出提示音；音高和间隔会随距离变化。

• 可在物品栏中工作：只要探测器物品在物品栏中处于开启状态，追踪和 HUD 就会正常运行。

• 支持 Superb Warfare：每个游戏刻都会读取显示名称，因此 SBW 重命名已关联的无人机后，HUD 会自动显示新名称。

• 由服务器控制探测半径（以服务器设置为准）：玩家加入时以及配置重新加载时，都会同步至客户端。

• 仅限客户端的自定义选项：音量、音高范围、提示音间隔、HUD 列表数量。

• 自定义声音（drone_detector:detector_beep），带字幕。

• 可通过数据标签扩展目标列表。

📦 运行要求

• Minecraft：1.20.1

• Forge：47.2.x

• （可选）Superb Warfare（用于探测无人机实体）

🔧 安装

1. 多人游戏时，请在客户端和服务器端都安装此模组。

2. 启动一次游戏以生成配置文件。

3. （可选）通过标签添加或调整无人机实体类型（见下文）。

⚙️ 配置

服务器 （权威游戏设置）
serverconfig/drone_detector-server.toml

[detector]
# Scan radius in meters
range = 64.0

客户端 （仅控制 HUD 和音频）
config/drone_detector-client.toml

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)

🔊 自定义提示音

该模组注册了 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标签中。

• 服务器扫描半径设置过大可能会略微增加客户端扫描开销（默认值是安全的）

📣 致谢与许可

• 作者：Liko

• 模组 ID：drone_detector

• 许可证：Apache 2.0

🧭 未来计划

• 在配置中添加可选的 HUD 位置偏移设置（保持界面简洁）。

• 在列表中显示各实体对应的图标（小尺寸 16×16）。

• 添加可临时静音提示音的按键绑定。

📝 问题反馈

请提供：MC 版本、Forge 版本、模组列表、日志以及复现步骤。

禁止重新上传本项目！

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