视觉警报 (V2.4) (V2.1) (V2.0) (视觉指示器模组) x 客户端 x 僵尸追踪器和动物追踪器定位器

TechFreqs 视觉警报（视觉指示器模组），适用于《七日杀》(V2.0)，通过在指南针上为附近实体（僵尸、被动动物和敌对动物）提供视觉指示器，并在可配置半径（默认25米）内生效。

僵尸追踪者
动物追踪
敌对动物追踪者

重要通知：

• 由于我之前忘了提到，由于一些小问题，它并不总是对睡眠中的僵尸做出反应，除非它们被唤醒，特别是在POIS等地带。不过，唤醒僵尸是一个快速的过程，这个模组会尽量在睡眠区域识别出哪些是活着的僵尸。

兼容性：

• 支持最新版本的 7D2D x(V2.4) 稳定版
• 不支持EAC！（DLL）——使用此模组时必须关闭反作弊系统。

最新更新日志： V1.3

• 已更新至7D2D的V2.4版本
• 在配置json中添加了新的配置选项，将指南针图标和屏幕图标分开显示，而不是使用单一的显示图标选项。
• 文件保存时自动重新加载，每60秒检查一次，不会影响性能。（尝试过控制台命令重新加载，但对我无效）
• 优化代码，使调试日志的输出更清晰，记录检测到的僵尸或动物数量，并实现更平滑的图标和视觉检测
• 优化导航对象的代码，使其每个实体仅注册一次，自动追踪占用更少的CPU资源，同时保持相同的视觉效果，而旧方法则需要手动注册并为每个实体更新时钟周期，以实现巨大的性能提升
• 将代码从600行优化至约300行。
• 更新了距离标签（例如“僵尸，18.3米”或“[近距离]”）
• 更新了设置组合，因为在我看来它没有达到我期望的模块化程度。
• 添加了ShowMapIcons的配置项，但实际上它是一个集地图图标、距离和标签于一体的版本，因为我不想为每个地图设置单独配置这些选项。
• 增加了一些混搭，以增加多样性

多版本支持： "ShowDistance": true, 或 false 或 true 或 false "ShowLabels": true, 或 true 或 false 或 true "ShowCompassIcons": true, 保留为 true "ShowOnScreenIcons": true, 或 false 或 false 或 True "ShowMapIcons": true, 或 false 或 true 或 false 如果你想要变化，这个混搭非常棒！

注意事项/错误报告： 所以目前你可以将所有这些都设置为 true，但唯一不起作用的是如果你将指南针设置为 false，那不会生效，即使其他设置为 true。所以请保持指南针图标显示开启，其他所有选项都可以自由开关。

新配置选项：

{
  "ToggleKey": "Semicolon",           // 任何 Unity 按键代码（例如 "F10"、"Keypad0"）
  "DetectionRadius": 30.0,            // 检测实体的距离
  "UpdateInterval": 5.0,              // 更新间隔（建议1-30秒）
  "DebugLogging": false,              // 用调试信息刷屏控制台
  "ShowDistance": true,               // 显示 "18.3m" 或 "[Close]"
  "ShowLabels": true,                 // 在图标上显示名称
  "ShowCompassIcons": true,           // 在指南针上显示（屏幕顶部）
  "ShowOnScreenIcons": true,          // 在世界中显示浮动图标
  "ShowMapIcons": true,               // 在地图上显示图标、名称、距离
  "AutoEnable": true                  // 游戏加载时自动启用
}

最新更新日志： V1.2

• 已为 2.1 B7 稳定版更新。

之前的更新日志： V1.1

• 更新配置文件 JSON，加入新模式

"ShowDistance": false,
"ShowLabels": true,
"ShowIcons": false

这样用户就可以配置是否显示距离、标签或图标在屏幕上或关闭它们...

主要特色包括： 简短版本：

• 完全客户端实现，使用EntityPlayerLocal和NavObjectManager检测玩家附近的动物、僵尸 ( 但尚未在服务器上测试，不过我认为如果客户端和服务器都将此模组安装到他们的模组文件夹中，应该可以正常工作 )
• 可配置的JSON，可在配置文件中自定义检测半径（25.0）和更新间隔（5.0）以及按键切换按钮（Semicolon），此外还有调试日志的详细日志消息（true）。
• 在模组的调试日志中添加了调试感谢及故障排除信息
• 开启或关闭模组时的提示消息

长版本： 实体检测： 扫描检测半径内的僵尸（EntityZombie）、动物（EntityAnimal）和敌对实体（EntityEnemy），在指南针上以不同的图标和颜色显示（红色代表僵尸，绿色代表被动动物，橙色代表敌对动物）。

可配置设置： 从config.json加载，允许自定义： ToggleKey（默认：分号）用于启用/禁用检测器。 DetectionRadius (默认：25米) 用于实体探测范围。 扫描频率的更新间隔（默认值：5秒）。 DebugLogging（默认值：true）用于切换详细调试日志，禁用后可减少控制台信息冗余。

导航对象集成： 使用游戏的导航对象管理器，将实体注册为带有适当精灵图的指南针标记（例如，僵尸使用ui_game_symbol_zombie，郊狼使用ui_game_symbol_tracking_wolf），并为未识别的实体提供后备精灵图。

敌对动物支持：检测多种敌对动物（如动物熊、僵尸熊、恐狼），并使用特定图标及橙色标记进行区分。

调试反馈： 初始化时输出感谢消息，并记录扫描总结（例如："扫描完成：25米范围内有2个僵尸，3个被动动物，1个敌对动物"）。

配置 JSON 示例说明：

切换键： 描述：指定切换实体检测器开关的按键（例如，显示/隐藏指南针上的实体标记）。 类型：字符串 (必须匹配Unity中有效的KeyCode枚举值，例如"Semicolon"、"F1")。 默认："分号" 目的：让玩家在游戏过程中通过单次按键启用/禁用探测器。 示例：将按键设为"F1"，即可将切换键变为F1。

检测范围： 描述：定义检测实体的半径（以米为单位），范围内实体（僵尸、动物、敌对动物）会被发现并显示在指南针上。 类型：浮点数（正数）。 默认值：25.0 用途：控制模组扫描实体的范围，以平衡性能与实用性。 示例：设置为50.0可将检测范围增加到50米。

UpdateInterval： 描述：设置实体扫描之间的时间间隔（以秒为单位）。 类型：浮点数（正数）。 默认：5.0 目的：决定模组更新罗盘上实体位置的频率，影响性能和响应速度。 示例：设为 2.0 时，扫描将每 2 秒进行一次，以获得更频繁的更新。

DebugLogging： 描述：在控制台中启用或禁用详细调试日志（例如，每个实体的检测、NavObject注册详情）。 类型：布尔值（true 或 false）。 默认： true 目的：设置为false时，会减少详细日志的输出以降低控制台冗余信息，同时保留必要日志（如初始化、报错、扫描摘要等）。 示例：设置为 false 可最小化控制台输出，以获得更干净整洁的体验。

示例配置代码

{
  "ToggleKey": "Semicolon",
  "DetectionRadius": 25.0,
  "UpdateInterval": 5.0,
  "DebugLogging": true
}

灵感源自 zAlert(2.0) 由 bdubyah 编写 他们在屏幕上添加了附近动物和敌人的指示器，并添加了纯粹通过XML实现的、范围在25格内的增益效果。他们对A19版本进行了重制，因为之前该版本在击杀经验值方面存在干扰问题。他们表示这个模组应该可以正常运行，因为它是一个服务端模组。 然而，从头到尾，我的版本都深受其启发，而我也希望能帮助社区。这个模组再次大量使用了我在TechFreq的近距离矿石探测器中的旧代码，并以此为基础开发了这个专注于客户端（或许也支持服务器端）的新模组或DLL，采用不同的方法在指南针窗口上提供更多的警报提示。

免责声明： 使用此模组即表示您承认TechFreq不对因其使用引起的任何问题、崩溃或冲突负责。 使用风险自负。在安装任何类型的模组前，请先备份您的游戏文件。 感谢下载，祝您玩得愉快！

安装： 确保Mod目录中存在Harmony Mod，因为它是必需的。 下载Mod文件，解压Mod文件。 请备份您的世界、存档和/或游戏文件。 将它们放入你的《7 Days to Die》游戏的Mods目录中。 EAC 必须禁用，尽管我希望未来能够改变这一点，目前 DLLS 不受 EAC 支持，但 XML 没有问题。 这仅为客户端内容，但或许这也涉及服务器端与客户端的兼容性？ 无需进一步设置，尽情享受吧！

制作人员名单： 感谢 TechFreq 和人工智能，比如 ChatGPT、微软 CoPilot 人工智能，或者来自 Twitter/X 的 Grok AI，帮助我创建了这个模组。同时，凭借对游戏修改的少量知识，以及边学习边实践的过程，如果没有它们和整个模组社区的集思广益，我无法完成这个工作。 我非常感激任何对我制作的模组提出的反馈意见。

支持提示： 对于那些想要支持'TechFreqs'作品的人，本MOD可能会也可能不会跨平台发布。通过7daystodiemods网站从ModsFire（带广告，按下载计费）下载，如果发布在那里或其他MOD站点上，将对我帮助极大——不过请注意！ (尽管每次下载有10美分) 你也可以直接使用NexusMods网站上的镜像链接，这些链接同样提供直接下载，但不会通过点击或下载次数产生收益，而是通过不同的捐赠积分系统运作。除了下载、分享给朋友、留言评论以及在模组页面点赞之外，支持TechFreq的最佳方式就是这些了。但若你愿意更进一步（虽然并非必要），也可以通过PayPal或ko-fi页面的捐赠链接支持我，这同样能帮到我很多！ 然而，捐款并非强制要求，但每一份支持都能在过程中提供帮助，并推动未来更多的模组、音乐和错误修复。再次感谢您的阅读，感谢您一直以来的支持以及查看这篇模组帖子。

社交媒体： 如果你欣赏'TechFreqs'的工作并想要表示支持，可以使用这个捐赠链接，虽非必需。Kofi页面：https://ko-fi.com/techfreq 总的来说，我很感激大家查看模组帖子、分享和享受任何模组本身。再次感谢！祝游戏愉快！ 喜欢这个模组吗？有反馈、创意或需要故障排除吗？ 在Discord上和我们一起聊天、分享迷因、获取更多模组更新吧！ 加入TechFreq Pretty Rad Squad服务器！https://discord.com/invite/SQCnGjNUhw 至于 TechFreqs 的音乐，它属于免版税音乐，可用于您的项目或日常聆听！ 源音乐文件可用，欢迎随时询问，Discord 上有更多内容！TechFreqs 社交链接：https://beacons.ai/techfreq 今天来看看幕后的一些氛围！再次感谢您查看模组发布帖子。

许可协议：CC BY-NC-SA 4.0 此模组遵循知识共享署名-非商业性使用-相同方式共享4.0国际许可协议。您可在《七日杀》中用于个人游玩。修改或分享需标注TechFreq署名，链接至模组页面，且衍生作品须使用相同许可协议。如有任何修改需求，请通过beacons.ai/techfreq联系我获取授权。 请查看 LICENSE.txt 或 http://creativecommons.org/licenses/by-nc-sa/4.0/ 了解完整的条款。 注意：展示此模组的盈利性视频/博客是被允许的，前提是注明对TechFreq的致谢。

===来自TechFeqs矿石探测器模组的技术部件=== 如果你读到这里，我表示很感激，这是让一切在后台运作的秘诀。 但代码改编自TechFreqs的距离矿石探测器模组。

实体扫描逻辑： UpdateEntityDetectorCoroutine和UpdateEntityDetector中的核心循环会遍历player.world.Entities.dict，以便检测一定半径范围内的实体，这种方式与矿石探测器扫描资源或兴趣点的方法类似。

导航对象注册： 使用NavObjectManager.Instance.RegisterNavObject在指南针上显示实体的方法，可能与矿石探测器标记矿脉或资源的方式类似。

配置系统： 在你的模组中，基于 JSON 的配置文件（config.json）用于设置诸如半径和更新间隔等参数，这是一种常见的模式，允许用户自定义。

和谐补丁： EntityPlayerLocal.Update上的HarmonyPatch用于处理切换键输入，这是一种标准的玩家输入处理技术，可能与矿石探测器共享以实现功能的启用/禁用。

调试日志结构： 使用MOD_PREFIX和结构化的调试日志（例如初始化和错误信息）遵循类似的日志记录风格，以便调试和用户反馈。

主要区别在于将焦点从矿石转移到了实体（僵尸、动物）上，并增加了处理敌对动物和彩色指南针标记的额外逻辑。