天空之书

SkyBook - 简介

SkyBook 是一个 Fabric 客户端 Minecraft 模组，适用于 1.21.11（Java 21），让你无需离开容器界面即可在游戏中查看 Hypixel SkyBlock 维基百科。

功能说明

在任意 SkyBlock 物品上（箱子中、你的背包里、REI/JEI 条目列表中，任何地方）使用鼠标中键，一个游戏内叠加面板就会滑动到当前屏幕上，显示该物品在 Hypixel SkyBlock Fandom 维基百科中的对应页面。底层容器保持开启且完全可交互。

功能亮点

• 智能物品解析：读取 ExtraAttributes NBT 以提取 SkyBlock ID，然后通过 NEU 物品仓库查找规范的维基百科标题（支持宠物、附魔书、药水、符文、重铸属性）。
• 丰富的维基渲染：信息框、表格、标题、图片和标签组（例如凋灵盔甲变体）——从实时的 Fandom API 响应中解析，并在 Minecraft 的 GUI 中渲染。
• 链接导航 + 历史记录：可点击的维基链接，鼠标侧键（鼠标4/5）前进/后退，/skybook <查询> 命令。
• 缓存：磁盘缓存，24小时有效期限 + 轻量级 revid 重新验证；绝不会频繁请求维基百科。
• REI + JEI 集成：拦截两个配方查看器中悬停的条目。
• Hypixel 安全：鼠标中键仅被消耗，不会合成；玻璃板点击完全穿透；符合 Hypixel 的客户端模组规则。

技术栈

Fabric Loader 0.18.5 | Fabric API 0.140.0 | jsoup（捆绑） | NEU 物品仓库（ZIP 挂载，无需解压） | Fandom action=parse API | Mojang 映射

当前状态

v0.1.0 已构建并打包（skybook-0.1.0+1.21.11.jar，602 KB）。所有 12 个单元测试通过。已在开发客户端中通过冒烟测试（启动干净，REI/JEI 已注册，仓库 ETag 缓存正常工作）。等待首次游戏内交互测试。