DN Advancely

🏆 DN-Advancely - 实时进度与配方追踪器 (Fabric)

DN-Advancely 是一款优质的 Fabric 模组，旨在帮助玩家实时追踪已完成的进度和配方解锁情况。它拥有可自定义、简洁的游戏内 HUD 叠加层以及进度图钉，让您无缝监控各项里程碑。

无论您是想达成 100% 游戏进度的完美主义者，还是优化路线的速通玩家，亦或只是想确切知道完成某个复杂进度还缺什么，DN-Advancely 都是您的理想伴侣。

---

✨ 特性

📊 1. 实时 HUD 统计信息

• 直观叠加层： 在屏幕上显示您已解锁的进度和配方总数（默认位于左下角，并动态调整以避免遮挡聊天栏）。
• 流畅同步： 每秒（20 游戏刻）从服务器向客户端更新数据，不会造成任何性能影响或网络开销（不会导致 TPS/FPS 下降）。
• 自动隐藏： 当您打开 F3 调试屏幕或关闭 GUI（F1）时，HUD 会自动隐藏，以保持界面整洁。

📌 2. 进度图钉

• 紧密追踪： 将单个或多个进度直接固定在 HUD 上，以便密切监控目标。
• 详细条件： 显示完成进度（例如 3/5）以及剩余条件列表（例如待击杀的特定生物、待探索的生物群系等）。
• 动态更新： 界面会自动截断过长的标题，完成任务后显示 已完成！ 状态，并在进度完全达成后自动取消固定。

💻 3. 命令系统与智能补全

• 智能 Tab 补全： 输入 /advancely pin 命令时，动态建议所有有效、可显示的进度 ID。
• 定向取消固定建议： 使用 /advancely unpin 时，仅建议您当前已固定的进度。
• 即时详细查询： 使用 /advancely info 在聊天栏中查看进度的描述、状态和确切剩余条件，无需打开繁琐的游戏内进度菜单。

---

🛠️ 命令

命令	描述
/advancely hud show	在屏幕上显示 HUD 追踪叠加层。
/advancely hud hide	从屏幕隐藏 HUD 追踪叠加层。
/advancely pin <advancement_id>	将一个进度固定到 HUD（支持自动补全所有可显示的进度）。
/advancely unpin <advancement_id>	从 HUD 取消固定一个进度（仅建议您当前已固定的进度）。
/advancely info <advancement_id>	查看某个进度的描述、完成状态和剩余条件列表。
/advancely list advancements	列出所有已完成的进度并显示您的总体进度（例如 15/120）。
/advancely list recipes	列出所有已解锁的配方 ID 并显示您的总体进度（例如 80/450）。

---

💾 配置与持久化

• 所有玩家偏好（固定的进度列表和 HUD 可见性状态）都会独立存储在服务器上的 config/dn-advancely-pins.json 文件中。
• 这些设置会在更改时（固定、取消固定或切换 HUD）自动保存，并在玩家重新连接服务器时加载。

---

⚙️ 要求与兼容性

• 模组加载器： Fabric Loader（版本 >=0.19.3 或更高）。
• 必要依赖： Fabric API（请确保下载兼容版本）。
• Minecraft 版本： 1.21.x / 1.21.1（使用 Yarn 映射表 1.21.11+build.6 和 Minecraft 版本 26.1.2 配置）。
• 多人游戏支持： 在单人游戏和多人游戏中均完全支持。模组必须同时安装在服务器和客户端上，以确保网络数据包（AdvancelySyncPayload）正确同步。

---

📝 许可证

本项目采用 BSD-2-Clause-FreeBSD 许可证 授权。您可以根据此许可证的条款自由使用、修改和重新分发源代码。