BL 家庭管理器

BL Home Manager

一个简洁、无需输入指令的服务器家管理图形界面——完全客户端侧，无需安装服务器插件。

---

🏠 这是什么？

厌倦了手动输入 /sethome basement_storage_room_3 并祈祷自己拼写正确？BL Home Manager 可以将服务器上原有的家命令封装到一个简洁的图形界面中。通过可搜索、可滚动的列表来设置、传送、重命名和整理家——无需记忆指令、无需担心拼写错误、也无需在聊天记录里翻找自己之前起过的家名。该模组不会改动你家的实际位置，它只是一个智能的客户端侧封装，适用于任何服务器上运行的家管理插件。

---

✨ 功能特性

• 一键传送 — 浏览家列表，一键点击即可传送，无需手动输入指令
• 可搜索的家列表 — 输入文字即可即时按名称筛选家
• 分类管理 — 将家归类到基地、农场、矿洞、村庄或你自定义的分类中
• 收藏夹 — 给最常用的家加上星标，方便快速查找
• 安全删除确认 — 两级确认提示，附带5秒倒计时和取消选项，防止误操作删除家
• 服务器同步 — 自动从服务器上的 /homes 类指令拉取你的家列表，并保持本地列表更新
• 可配置指令 — 兼容任意服务器的命令语法（/sethome、/home、/delhome 等）——只需在设置中一次性配置好
• 快捷键访问 — 按下一个键即可从任何位置打开家管理器（可在按键设置中自定义）
• 持久化本地数据库 — 家的元数据（收藏、分类）保存在本地，重启后不会丢失，也不会被服务器端重同步清空

---

🕹️ 使用方法

1. 加入任意安装了家管理插件（Essentials、CMI 等）的多人服务器
2. 按下已配置的键（默认未绑定——在按键设置中配置）打开 BL Home Manager
3. 首次启动时，输入你服务器的家命令（例如 /sethome、/home、/delhome、/homes）
4. 点击 + 设置家，输入名称并确认——模组会自动为你发送指令
5. 点击任意家旁边的 传送 即可瞬间抵达
6. 使用搜索栏或分类标签快速查找所需的长列表内容

注意： 该模组在同步时依赖解析服务器的聊天输出来检测家名。如果你的服务器使用了不常见的家列表格式，可能需要手动添加家。

---

⚙️ 技术细节

• 100% 客户端侧 — 无需服务器插件、模组或配置
• 兼容任意基于命令的家系统 — Essentials、CMI 或自定义插件均可，只要命令可配置
• 使用 Fabric 的 ClientReceiveMessageEvents API 在同步时读取聊天输出——无需注入服务器内部
• 家数据以 JSON 格式存储在 .minecraft/config/bl-home-manager-homes.json
• 同步会解析多行聊天回复，并自动过滤非家名称的标记