防护模组

守护者 (Safeguard)

一个在 Minecraft 生存模式中为你保驾护航的客户端辅助模组。

---

概述

Safeguard 是一个 Fabric 客户端模组，用于检测游戏中的危险并帮助你规避它们——通过视觉/音频警告，或可选的自动操作（如暂停和断开连接）。

它 不会 添加新的物品、机制或维度。它 不会 让你无敌。它只是尽其所能地在危险来临时向你发出警告并保护你。所有功能都在客户端本地运行——无需服务端支持。

---

测试版须知

Safeguard 目前处于 测试阶段，并以 MVP（最小可行产品） 形式发布——它涵盖了广泛的常见危险，但仍有很大的成长空间。未来更新计划中包含更多功能和优化，例如按物品配置选项、新的检测类型（装备耐久度警告、药水效果 HUD、推荐最佳火把放置位置），以及弹射物轨迹可视化等高级功能。

你在测试阶段的反馈尤为宝贵。如果你遇到 Bug、有改进想法，或想建议新的检测功能，请到 GitHub Issues 提交反馈！

功能特性

所有保护功能都组织在一个 树状结构的开关系统中——每个检测和动作都属于一个分类层级（例如 战斗 → 防苦力怕）。禁用某个分类会同时禁用其下所有子项，让你在不被大量选项淹没的情况下进行精确控制。AFK（暂离）分类默认是关闭的，因此自动暂停和自动退出等激进操作不会干扰正常游戏——当你需要离开时再开启即可。

检测功能

除非另有说明，所有检测功能 默认开启。

分类	检测	警告内容
💥 战斗	防苦力怕	附近的苦力怕，显示距离和引信倒计时
💥 战斗	防偷袭	构成偷袭威胁的敌对生物
💥 战斗	弹射物追踪	朝你飞来的弹射物（箭、火球等）
🌍 环境	防坠落	在洞穴/悬崖上方挖掘、危险坠落，以及可选的自动水桶落地
🌍 环境	防窒息	身处方块内部或下落方块下方（触发通知并显示有多少下落方块）
🌍 环境	熔岩检测	靠近你挖掘路径的熔岩
🌍 环境	着火	当你燃烧时——还会建议你背包中可用于灭火的物品
💊 状态	受伤检测	受到伤害时（触发自动暂停/退出——但 AFK 分类默认关闭）
💊 状态	低生命值	生命值低于阈值时（红色 vignette 效果 + 可选的自动操作）
💊 状态	低饥饿值	饥饿值不足时，提供智能的食物推荐

保护动作

动作由检测触发。每个动作都可独立开关。

类型	动作	默认状态
🛡️ 主动/AFK	自动暂停 [2]	✅ 开 [1]
🛡️ 主动/AFK	自动退出 [2]	❌ 关 3
🛡️ 主动/其他	自动水桶落地（放置水/史莱姆方块）	❌ 关
💬 被动/HUD	快捷栏标题 警告文字	✅ 开
💬 被动/HUD	红色 Vignette（低生命值屏幕效果）	✅ 开
💬 被动/其他	实体轮廓 发光高亮	✅ 开
💬 被动/其他	方块高亮 透视方块	✅ 开
💬 被动/其他	声音警报	✅ 开

注意：

[1]: 但是，该功能会被默认关闭的 AFK 分类所限制。

[2]: 这两个动作在触发时会禁用 AFK 分类（以防止被重复触发）。

---

在服务器上游玩

Safeguard 专为 原版生存及其衍生玩法（PvE）设计，而非竞技 PvP。大多数功能完全在你的本地游戏客户端运行，不影响服务器游戏内容。然而，少数功能——特别是 自动水桶落地，它模拟玩家如放置水等动作——可能会被严格的反作弊系统标记。方块高亮功能（如熔岩检测）仅限于在挖掘时标记 紧邻玩家的危险方块；它不是泛用的透视工具，并且已经拯救了许多不知情的矿工免于突如其来的熔岩死亡。

许多生存服务器确实允许此类客户端辅助模组——这也是我们没有完全禁止在服务器上使用的原因。尽管如此，确保合规仍是你的责任：在使用该模组前询问服务器所有者或管理员，并始终自行承担使用风险。

---

截图

防苦力怕

熔岩检测

警告你 紧邻挖掘路径的熔岩——这些方块如果你挖进去可能会淹没你的隧道。只有在活跃挖掘时才会激活高亮，并且严格限制在玩家旁边的危险方块；它不是泛用的透视工具。对于那些曾被突然出现的熔岩搞得措手不及的矿工来说，这真是救星。

低饥饿值

根据你当前的饥饿值和饱和度智能推荐食物，防止浪费并提供最高效率。

---

配置

通过 Mod Menu 或 /safeguard screen 命令打开配置界面。

在树状结构中开关检测和动作——禁用某个分类（例如“战斗”）会同时禁用其下所有子项。配置保存至 .minecraft/config/safeguard.json。

---

命令

/safeguard screen                        打开配置界面
/safeguard detection <id> [state]        查看或切换某个检测
/safeguard action <id> [state]           查看或切换某个动作

这些命令完全是客户端的，绝不会发送至服务器。ID 格式为 命名空间:分类/.../名称。该命令提供 Tab 补全 功能。

---

依赖项

类型	名称	版本
必需	Fabric API	≥ 0.141.4
必需	YACL	≥ 3.8.2
推荐	Mod Menu	≥ 17.0.0

---

反馈与贡献

欢迎在 GitHub Issues 提交 Bug 报告和功能建议。

如需了解更多信息，请查看我们的 GitHub 仓库。