[SBW]无人机探测器

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

一个轻量级、对客户端友好的模组，添加了一个手持无人机探测器，带有极简 HUD（右下角）、自定义蜂鸣声和服务器控制的扫描范围。即使放在物品栏中只要开启就能工作，会列出附近无人机及其当前名称（当 Superb Warfare 重命名关联无人机时会更新）并显示大致距离。蜂鸣声仅对最近的无人机触发。

✨ 特性

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

右下角 HUD：紧凑条 + 列表（最多 5 个），显示名称和 ≈距离（不会使界面杂乱）。

仅对最近的无人机发出蜂鸣声；音调和间隔随距离缩放。

物品栏中即可工作：只要探测器物品在你物品栏的任意位置处于开启状态，追踪和 HUD 就会工作。

Superb Warfare 支持：每 tick 读取显示名称，因此当 SBW 重命名关联无人机时，HUD 会自动显示更新后的名称。

服务器控制的半径（权威）：加入时以及重新加载时同步到客户端。

仅客户端自定义：音量、音调范围、蜂鸣周期、HUD 列表大小。

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

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

📦 需求

Minecraft：1.20.1

Forge：47.2.x

（可选）Superb Warfare（用于探测 UAV 实体）

🔧 安装

将模组同时放在客户端和服务器上（用于多人游戏）。

启动一次以生成配置文件。

（可选）通过标签添加/调整 UAV 实体类型（见下文）。

⚙️ 配置

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

[detector]

扫描半径，单位为米

range = 64.0

客户端（仅 HUD 和音频） 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 按设计位于右下角，以保持界面整洁）

🔊 自定义蜂鸣声

该模组注册了 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 }] } }

想在不重新构建的情况下替换蜂鸣声？使用资源包覆盖相同路径即可。

🎯 什么算作 UAV

默认情况下，该模组以 Superb Warfare 无人机以及下方实体类型标签中的任何内容为目标。通过数据包扩展它，以包含你自己的实体：

data/drone_detector/tags/entity_types/drone_targets.json

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

🕹️ 如何使用

合成/生成 UAV Detector 物品。

右键切换开/关。

将其拿在手中或放在物品栏的任意位置（如果处于开启状态）以激活 HUD + 蜂鸣声。

接近无人机：随着你靠近，条会填充；列表显示当前名称和 ≈距离。

🤝 多人游戏与同步

服务器设置扫描半径；客户端在登录时以及服务器配置重新加载后接收该半径。

客户端仅控制 HUD 和音频。

🗺️ 本地化

包含 en_us、ru_ru（字幕和物品字符串）。

🧩 兼容性

专为 Forge 1.20.1 设计。

可与 Superb Warfare 一起使用；会自动识别关联无人机名称的变化。

🐞 已知问题 / 备注

如果你的自定义 UAV 类型未被探测到，请将其实体类型添加到 drone_targets 标签中。

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

📣 致谢与许可

作者：Liko

模组 ID：drone_detector

许可：Apache 2.0

🧭 路线图

配置中可选的 HUD 位置偏移（保持最小占用）。

列表中的每个实体图标（微小的 16×16）。

用于临时静音蜂鸣声的按键绑定。

📝 问题反馈

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

禁止重新上传此项目！ Опубликовывать проект на иных сайтах запрещено!