Home zh CN
QCloudy_Addition（QCA）是一个以英文为默认语言、提供中英文界面、仅在客户端运行的 Hypixel SkyBlock Fabric 模组。它用一个按“功能”分类的界面统一管理地图、HUD、被动视觉辅助、宠物信息、Attribute Shard 工具和部分客户端体验优化。
当前稳定版： Release 0.3.9
Minecraft： 26.1.2 与 26.2
必需： Java 25、Fabric Loader 0.19.3 或更高版本，以及与 Minecraft 对应的 Fabric API
可选： Mod Menu，以及经过适配审核的其他 SkyBlock 模组版本
说明： QCA 是独立的社区项目，与 Hypixel、Mojang、Microsoft、SkyHanni、Skyblocker、Firmament、BabyZombieAddons 和 Feesh 均无隶属或官方认可关系。
实验性集成警告：“统一设置编辑”和“统一 HUD 编辑”仍是概念测试，均默认关闭，目前并不稳定。第三方模组更新可能让已识别字段或 HUD 契约失效。请备份对应模组配置，并在原生编辑器中核对重要修改。
- 安装
- 自 Release 2.5.3 以来的变化
- 打开模组
- 设置、语言与 HUD 编辑
- 功能指南
- Attribute Shard 指南与规划器
- 兼容 SkyBlock 模组的统一控制
- 纯客户端与安全边界
- 命令与对外操作
- 本地保存的数据
- 兼容性与故障排查
- 报告 Bug
- 验证、许可证与致谢
Release 0.3.9 提供两个 Minecraft 目标。请安装与游戏版本完全对应的 JAR。
| Minecraft | 所需 Fabric API | 可运行文件 |
|---|---|---|
| 26.1.2 | 0.155.2+26.1.2 或更高的兼容版本 | QCloudy_Addition-0.3.9+26.1.2-Release.jar |
| 26.2 | 0.154.2+26.2 或更高的兼容版本 | QCloudy_Addition-0.3.9+26.2-Release.jar |
该目标要求 Fabric Loader 0.19.3 或更高版本以及 Java 25。
- 安装对应版本的 Minecraft、Fabric Loader、Fabric API 和 Java。
- 从 QCloudy 官方下载页下载可运行的 QCA JAR；实际文件仍由官方 GitHub Release 资产提供。
- 将可运行 JAR 放入该实例的
mods文件夹。 - 删除同一文件夹中的旧版 QCA，确保只加载一个 QCA 版本。
- 启动 Minecraft，按
O或输入本地设置命令打开 QCA。
不要把以 -sources.jar 结尾的文件当作模组安装。它是供开发者和 IDE 使用的源代码包。
QCA 独立运行不需要 SkyHanni、Skyblocker、Firmament、BabyZombieAddons、Feesh 或 Mod Menu。Mod Menu 只会额外提供一个进入 QCA 设置的入口。
Release 0.3.9 汇总了 2.5.3 之后 Alpha 与 Beta 阶段的工作。
- 新增完整离线 320 Shard 指南与规划器：配方、反向用途、获取方式/效果、多步 Fusion Tree、候选路线、Materials Only、Ironman/速度规划、Fusion Lines，以及从玩家实际打开的 Hunting Box 记录仓库。
- 新增 Century Cake 效果计时与到期提醒、Power Orb/Flare 消失提醒、Ciallo 钓鱼上钩提示、Hunting/Safari 辅助、改进的宠物/Dragon 等级显示、地图、HUD 与外观控制。
- 新增可选且默认关闭的统一设置/HUD 集成，可识别 SkyHanni、Skyblocker、Firmament、BabyZombieAddons 与 Feesh 的实时能力。此功能仍是不稳定的概念测试，请谨慎使用。
- 修复钓鱼重复播放和岩浆钓鱼识别、个人 Tree Gift 生物提醒、Power Orb/Flare 重复或旧计时、Century Cake Hunting Fortune 识别、空分类/空 HUD、钓鱼分组、Golden/Jade Dragon 等级、Shard 界面对齐/焦点/图标/颜色，以及 Dwarven X/Z 指针连续性。
- 删除
/aca、/ca、Slot Locking、Storage Overlay、菜单中键转换，以及对未知第三方结构的不安全猜测。
详细历史见中文更新日志。
可以通过以下方式打开设置：
- 默认按
O。可以在 控制 → 按键绑定 → QCloudy_Addition 中重新绑定。 - 输入
/qca或/qc。 - 安装 Mod Menu 后，从 Mod Menu 中打开 QCA。
以上两个斜杠命令都是本地客户端命令。只有在对应名称没有被其他客户端命令占用时才会注册；它们只打开本地界面，不会发送给 Hypixel。
输入 /qshard [英文搜索内容] 可以打开离线 Attribute Shard 指南，并预先填入搜索内容。
左侧栏只显示当前至少拥有一个可用功能的分类，并对显示出来的分类保持以下顺序：
- 通用
- 地图
- 物品与菜单
- 战斗
- 地牢
- Slayer
- 挖矿
- 耕种
- 砍树
- 钓鱼
- 狩猎
- Rift
- 活动
Safari 是狩猎下的可折叠分组，Garden 属于 Farming，Crimson Isle 与 Kuudra 属于战斗。钓鱼中的下级组命名为咬钩提示，不再出现“钓鱼 → 钓鱼”。同一个功能只归属于一个位置，不会在多个分类中重复出现。可折叠分组默认收起。
- 左键点击卡片：开启或关闭功能。
- 开启后，卡片左侧显示蓝色条。
- 右键点击卡片：打开属于该功能的全部二级设置。
- 二级菜单不重复显示一级菜单已经拥有的总开关。
- 大范围数值使用可拖动滑块。功能音量统一为 0–100%，除非另有说明，默认 64%。
- 可编辑颜色使用统一 RGB/HSV 选择器、预设颜色；所有背景颜色都可以选择完全透明。
- 热键可使用键盘、鼠标按键以及 Ctrl/Shift/Alt/Cmd-Super 组合。监听按键时按
Esc、Backspace 或 Delete 可以清空绑定。
模组默认显示英文，可在 QCA 设置中切换为简体中文。
语言选项只翻译 QCA 自己的界面。Hypixel 提供的物品、任务、地点、宠物、皮肤、宠物配件，以及玩家重命名的 HOTM 预设都会保留客户端收到的原始名称。这样可以避免错误翻译，也能保证搜索与游戏内名称一致。
点击设置界面左下角的 编辑 HUD。
- 只有“已开启、当前已加载、并且确实有可见内容”的 HUD 才能编辑。
- 拖动面板可以移动位置。
- 像桌面窗口一样拖动边框或角落可以缩放。
- 每个 HUD 单独保存 50–200% 的缩放。
- HUD 上的小齿轮会打开该 HUD 自己的设置。
- 松开鼠标时保存位置与缩放，重启后仍然保留。
- 每个 HUD 可以单独设置背景颜色/透明度、边框是否显示、边框宽度/颜色、标题颜色、粗体和文字阴影。
- 当 HUD 没有任何可见内容时，整个面板都不会渲染，不会留下空标题、空边框或空背景。
- 界面动画控制 QCA 本地菜单的过渡动画。
- 预警总静音可以统一关闭 QCA 的警告声音，而不强制关闭所有视觉提示。
- 手动重连在连接失败与断开连接界面添加一个正常大小的“重连”按钮。只有玩家点击后才会连接，没有倒计时、循环或自动重试。
- 聊天偷窥在按住自定义按键或组合键时临时展开已经收到的聊天记录。鼠标滚轮可以选择滚动聊天，或继续控制快捷栏。
- Dwarven Mines 地图使用给定的单层 12 区域概览图和实时红色箭头。一个连续变换只把玩家实时的 X/Z 两个坐标映射到背景；Y 坐标与计分板上的子区域名称被明确忽略。指针表达的是大致可视位置，而不是精确到方块的测绘坐标。因此位于 The Mist 上方的桥梁不会切换到另一个楼层或区域算法。
- Glacite Tunnels 地图根据玩家本地 Y 坐标选择低、中、高三张地图；所有层共用一个坐标系，地点标签会自动避让。
- Fairy Soul 路标是地图分类中的一个统一功能，包含内置的 Torrhus 与 Safari 坐标。该功能默认关闭；开启后两个坐标组会同时启用。粉色信标在收到与最近坐标匹配的“已找到/已经找到”确认后消失。
地图点位名称统一使用官方英文名称。
- 已装备宠物 HUD显示收到的宠物等级、按品质着色的名字、真实宠物/皮肤头、经验进度、距离满级经验、可选皮肤名和宠物配件。支持 200 级 Dragon 曲线以及 Ancient Golden Dragon 溢出等级。宠物满级时只隐藏多余的“距离满级”一行，不会隐藏配件。
- Attribute Shard 指南与规划器提供离线 320 Shard 浏览、直接配方、用途、多步规划、仓库和 Fusion Lines，详见下方独立章节。
- 物品时间戳显示客户端观察到的物品创建时间。
- 保存光标位置为支持的菜单恢复设定的鼠标位置。
- AOTE/AOTV 声音可以让 Instant Transmission 与 Etherwarp 保留原声或改用本地声音预设，音量为 0–100%，默认 64%。QCA 不改变传送距离、冷却、移动、数据包或物品使用逻辑。
槽位锁定、Storage 覆盖和菜单中键点击转换已经从 QCA 底层彻底删除，并不是仅从设置界面隐藏。
- Ender Dragon 高亮在玩家位于 The End 或 Dragon's Nest 时，把客户端收到的 Hypixel Ender Dragon 加入 Minecraft 原版轮廓渲染；颜色可自定义。
- Power Orb 与 SOS 消失提醒通过本人精确消失聊天识别 Radiant、Mana Flux、Overflux、Plasmaflux Power Orb。Warning、Alert、SOS Flare 不再使用错误的聊天假设，而是由精确道具使用建立候选、成功放置音效确认，再启动本地三分钟生命周期。放置失败、实体卸载、玩家距离和增益范围都不会触发提醒。Power Orb、Flare、中央大字、音效和 0–100% 音量可分别设置；音量默认 64%。
-
Crimson Isle 阵营任务读取收到的
Faction Quests:Tab 区块，显示未完成任务的原始名称和进度；已完成任务不会显示。 - 已安装外部模组中能被实时识别且具备安全读写能力的 Crimson Isle 与 Kuudra 功能，会作为战斗的下级分组出现；不再要求版本号完全匹配。
该分类用于显示已安装外部模组中功能定义匹配、且实时能力检测通过的地牢设置。没有发现可安全使用的能力时，QCA 不会虚构一个替代实现，并会隐藏整个空分类。
该分类用于显示已安装外部模组中功能定义匹配、且实时能力检测通过的 Slayer 设置。无法安全读取或写入的分支会被省略，但版本号本身不会直接阻止兼容。
- 挖矿任务与粉尘读取 Dwarven Mines、Crystal Hollows、Glacite Tunnels 和 Glacite Mineshafts 中客户端收到的 Tab 数据。
- Crystal Hollows 的
Jungle使用完整地点名匹配，因此 The Park 的Jungle Island不会触发该 HUD。 - Commission 名称完整显示，并使用单独测量宽度的进度条。
- 进度可以显示为保留一位小数的百分比，或 current/target 数值。
- Mithril、Gemstone 与 Glacite Powder 分开追踪。
- 可选的
HOTM: <预设名>一行会记住在相关菜单中观察到的 Heart of the Mountain 预设。
已安装外部模组中通过实时能力检测的 Garden 与 Farming 功能会显示在这里。QCA 只合并真正等价的功能；即使价格提示、利润统计和任务追踪都与 Farming 有关，它们也不会被错误合并成同一个开关。
- Torrhus Chapter 与资源在一个可换行 HUD 中组合显示当前 Helia Chapter、完整任务/进度、Forest Whispers、Desert Whispers、Forest Essence、Safari Essence、Sweep 和 Forest Fortune。
- Galatea 追踪使用独立设置显示 Hina Chapter 与 Agatha's Contest，并遵循相同的内容与空面板规则。
- Tree Critter 计时读取已加载 Tree Protection Order 名牌上服务器显示的准确倒计时，不自行猜测或启动一个本地计时器。
- Miria 与 Agatha Contest 信息可以显示下一档、距离下一档还差多少，以及预计 Safari Ticket；不会重复计分板已有的比赛计时。
- Benefactor 状态只从范围明确的 Tab、计分板、聊天和玩家实际打开的菜单内容组合获得。
- Tree Gift 提醒必须先确认属于本地玩家的奖励区块。配置的稀有物品和准确生物提示可以显示屏幕中央文字并播放本地声音；旁边其他玩家单独出现的公共提示不会触发。
- 钓鱼功能归入咬钩提示下级组，而不是再次使用“钓鱼”作为组名。
- 钓鱼上钩声音默认关闭。
- 它把附近收到的准确
!!!标记与本地玩家的水钓浮标，或范围受限的 Hypixel 岩浆钓鱼浮标表现进行关联。 - 每根鱼竿只播放一次内置 Ciallo 声音，音量 0–100%，默认 64%。
- 收杆不会再次播放，也不会重新触发本次提示。
- QCA 永远不会自动抛竿或收杆。
- Beeheemoth 辅助提供可自定义轮廓、临时黄色生成信标和独立 Beeheemoth 声音控制。玩家靠近、收到自己的抓捕确认或实体消失时，信标会被移除。
-
Lasso REEL 提示音在本地玩家收到的 Lasso 状态首次变为准确
REEL时播放一次。 - Critter Behavior Assistant根据已记录的 Critter 机制显示范围受限的屏幕中央提示。
- Safari Run Dashboard追踪本轮时间和 Ticket Tier。“本轮捕获 Shard 统计”是独立开关，默认关闭。
- Safari Run Critterdex按 Cavern、Forest、Haunted 和 Icy 分类显示本轮已捕获/缺失进度，名称不会被省略。
- Critter 高亮按照官方 Shard 品质给真实可见实体着色，不穿墙显示；抓捕用 Armor Stand 道具会被排除。
- Cold Safety提供可调整的第一/第二次预警（默认 80/90），以及可选的最近已加载篝火信标；Cold 开始下降后信标关闭。
- Doomspiral 就绪在玩家拥有至少 4 个 Soothing Incense 时提醒；Warden 就绪在本地可见抓捕冷却进入就绪状态时提醒。
- Sparkling、Floor Drop 与 Quest Item 辅助只使用收到的聊天、可见名称/实体、附近已经加载的方块和本地物品栏。
-
Wumpa HUD接受玩家本人和队友 Loot Share 的 8 个 Icy 前置捕获；全部完成后改为显示
Wumpa: Spawned。红色移动/碰撞预测为可选功能，默认关闭。 - Snoozle 墙覆盖只给附近符合条件且暴露在外的墙面着色，颜色可自定义。
- Safari Belt Tooltip显示客户端确认的四个 milestone 等级和属性加成，并按本地账号/Profile 保存已确认进度。
该分类预留给能够通过实时能力检测的兼容外部功能。没有发现可安全使用的实现时，QCA 会隐藏对应分组。
该分类预留给能够通过实时能力检测的兼容外部活动功能。即使多个提供者拥有同一个功能，QCA 仍然只显示一个功能入口。
Shard 系统完全是只读信息工具。QCA 不会点击 Fusion 菜单、选择产物、移动物品、发送 /hb 或执行任何 Fusion。
内置目录包含准确 320 种当前 Bazaar 中存在的 Attribute Shard，以及每个 ID 对应的离线图标。
- 可以按官方英文名、Shard ID、效果、品质、分类、家族、Skill、生物类型或获取方式搜索。
- Details 显示效果、语义分类、所有内置的自然获取方式，并明确标记只能通过 Fusion 获得的 Shard。
- Recipes 显示所有可以产出目标 Shard 的有序输入组合；Queen Bee 等同时拥有自然来源与 Fusion 配方的 Shard 也包含在内。
- Uses 显示当前 Shard 可以作为输入参与的所有配方。
- 配方卡保留左右输入顺序、所需数量、最多三个可选产物、ID/Chameleon/Special 产量和 Pure Reptile 翻倍说明。
- 可以点击的 Shard 名字在悬停时加深并加下划线；品质与语义信息使用对应的 SkyBlock/Minecraft 颜色。
- 如果客户端已经收到匹配的真实 ItemStack，则真实物品渲染优先；否则使用内置的对应 ID 图标。
运行中的模组不会访问 Wiki、Hypixel API、Bazaar API、SkyShards 或图标服务。版本化数据在发布前生成并审核，然后直接打包进 JAR。
- **Plan：**输入目标 Shard 与数量，生成有边界限制的多步 Fusion Tree。
- **Recipes：**分别设置输入和输出过滤条件，查看直接有序配方关系。
- **Shards：**查看效果、家族、Skill、生物类型、获取方式、默认每小时获取速度，以及自定义本地速度。
- **Fusion Lines：**查看 ID、Special 与 Chameleon 路线；节点可点击、可拖动，位置保存在本地。
- **Warehouse：**使用玩家实际打开的 Hunting Box 页面中观察到的 Shard 数量。
- **Settings：**设置路线模式、价格侧、操作时间假设、Kuudra/Kraken 参数、是否使用仓库等。
规划支持 Fastest/最快或 Cheapest/最便宜、Normal 或 Ironman、其他候选配方，以及只显示汇总材料的 Materials Only。Ironman 永远不使用 Bazaar。Kraken 计算可以纳入 Kuudra Tier、通关时间、coins/hour 机会成本、Key 成本和停顿时间。
QCA 不包含 Bazaar 下载器。只有当已安装的兼容 Skyblocker 通过审核的公开方法提供其本地缓存价格时，价格路线才可用。没有价格提供者时，Cheapest 会明确显示不可用，但离线指南、Ironman、获取速度、Fusion Lines 和仓库功能仍然正常。
仓库只读取当前打开的 Hunting Box 页面中可见的 Shard ID 和准确 Owned: N Shards lore。它不会输入 /hb、切换页面、点击槽位、读取隐藏物品栏或自动执行规划。
Release 0.3.9 为以下已安装模组提供可选的能力探测适配：
- SkyHanni
- Skyblocker
- Firmament
- BabyZombieAddons
- Feesh
这些模组都是可选项，不是 QCA 的编译或运行依赖。
**请谨慎使用：**两个统一编辑器都是实验性概念测试，并非稳定兼容承诺，且默认关闭。请保留配置备份，并在提供方原生编辑器中核对任何重要设置或 HUD 改动。
Feesh 适配会配对其实时公开委托属性 getter/setter，并通过 Feesh 自己的路径保存。只有已启用、条件成立且存在内容的 Overlay 才会进入“编辑 HUD”，QCA 会正确换算 LEFT/CENTER/RIGHT 锚点，并编辑缩放/对齐及调用 Feesh 原生持久化。含义不明确的设置或变化的 HUD 契约会被省略，只显示在“兼容性缺失报告”中。
“通用”中有两个相互独立的总开关。“统一设置编辑”控制第三方设置的探测与编辑；“统一 HUD 编辑”控制第三方 HUD 的探测、位置与缩放编辑。两者均默认关闭。每一次提供方扫描都必须经过第二次确认：首次开启但没有有效会话快照时，以及每一次 Refresh，都会先显示对应范围的确认窗口。取消首次确认会保持总开关关闭；取消 Refresh 会保留上一份有效快照；重启后恢复为开启的开关不会静默扫描。确认后才会打开可视化进度页。设置页只显示设置数量，HUD 页只显示 HUD 数量，不显示未安装模组。两个开关都关闭时会取消待处理工作并卸载会话快照，不会关闭 QCA 自身设置或 HUD。
当多个受支持模组实现完全相同的功能时，QCA 只显示一张功能卡片。二级菜单最上方是提供者选择。比如选择 SkyHanni 后，该卡片将控制 SkyHanni 对应实现；开启时只关闭其他模组中定义完全一致的功能。然后同一个二级菜单会显示该 SkyHanni 功能中可以安全编辑的原生设置。
QCA 直接修改已加载提供者的本地实时配置对象，并调用该模组自己的保存方式。它不会修改未加载模组的原始配置文件。已识别的布尔值、枚举、范围数值、HUD 位置和缩放可以在 QCA 中显示；不安全或复杂的颜色/热键对象仍保留在对应模组自己的编辑器中。
启用 HUD 总开关后，提供者拥有的 HUD 才会出现在 编辑 HUD 中，并标明来源模组；松开鼠标时才写入修改。
提供方版本号不再作为白名单。只有玩家明确确认首次扫描或 Refresh 后，QCA 才会探测已安装提供方中能够识别的配置与保存能力；普通打开设置菜单或编辑器不会扫描。分类先使用原生路径和已验证规则，只有剩余未分类元数据进入固定本地分类器；置信度不足就不分类。因此普通版本更新后，结构仍兼容的原有功能可继续编辑；无法安全理解的新结构会被省略。提供方未安装或必需根对象/保存契约缺失时会安全关闭对应适配器，不影响 QCA 自身功能。
通用 → 兼容模组 下的 兼容性缺失报告 是只读信息卡，不属于功能。它没有开关或启用条，鼠标左键或右键都能打开。报告读取最近一次完成的快照并按已安装模组分组，只显示 QCA 已经明确识别、但无法通过“设置”“HUD 编辑”“分类”或其组合统一管理的功能；能够正常管理的功能不会显示。检查不会改变提供方数值，也不会给完全未知的未来结构随意编造名称。
QCA 在 Fabric metadata 中声明为仅客户端模组。普通功能只读取客户端已经收到或已经能够看到的信息：本地位置、已加载实体/方块、计分板、Tab、聊天、当前可见菜单、物品 lore 和本地输入。
QCA 不包含 Hypixel Mod API 订阅、Hypixel 公共 API 客户端、HTTP 客户端、WebSocket、遥测、远程更新器、宏、自动移动、自动点击、自动抓捕、自动使用物品、隐藏物品栏读取或区块请求。
读取另一个本地模组已经缓存的数值，不会给 QCA 增加硬依赖，也不会让 QCA 自己发起额外网络请求。可选 Skyblocker 价格桥在审核方法不存在时会安全关闭。
“被动渲染”不等于“官方批准”。实体轮廓、信标、墙体覆盖和移动预测会让客户端已经收到的信息更容易观察，因此政策风险相对更高。所有 Minecraft 模组均由玩家自行承担使用风险。请阅读最新的 Hypixel Allowed Modifications 与 Hypixel SkyBlock Rules。
完整表格见客户端数据流与合规清单。
| 玩家操作 | 结果 | 发往服务器的内容 |
|---|---|---|
/qca、/qc
|
打开本地 QCA 设置 | 无 |
/qshard [英文搜索内容] |
打开本地离线 Shard 指南 | 无 |
/th |
玩家主动触发 Torrhus 快捷命令 | warp torrhus |
/helia |
玩家主动触发 Helia 快捷命令 | chapter torrhus |
| 点击 重连 | 对内存中记住的服务器目标发起一次正常连接 | Minecraft 正常连接 |
/th 等价于玩家手动输入 /warp torrhus；/helia 等价于玩家手动输入 /chapter torrhus。它们都不会自动触发。QCA 没有 sendChat、自动命令、自动重连循环或自动生成聊天内容。
QCA 只保存普通本地 JSON：
-
config/qcloudy_addition.json：语言、功能设置、HUD 外观/位置/缩放、记住的宠物信息、按 Profile 保存的已接收狩猎数据、Fairy Soul 状态，以及 Shard Planner 设置/速度/图位置。 -
config/qcloudy_addition_shard_warehouse.json：玩家实际打开 Hunting Box 页面后，按本地 Profile 保存的 Shard 数量和观察时间。
旧版 autumecloudyaddition.json 只读取一次用于迁移。保存时会先写临时文件，并在系统支持时进行原子替换。
QCA 不会保存密码、Access Token、Hypixel API Key、聊天记录、远程账户数据或服务器重连地址。
- 确认可运行 JAR 与 Minecraft 26.1.2 或 26.2 完全对应。
- 确认 Java 25、Fabric Loader 0.19.3+ 和对应 Fabric API。
- 删除重复或旧版 QCA JAR。
- 不要把
-sources.jar当作可运行模组放入mods。
这通常是正常逻辑。只有当功能开启、当前位置/状态已经加载并且确实存在可见行时，HUD 才会渲染并出现在编辑器中。标题或占位符不能让一个空面板继续存在。
Dwarven 地图是单层、近似的 X/Z 概览图，明确忽略 Y 和楼层/子区域名称。箭头应该实时、连续移动，但背景本身不是逐方块精确测绘地图。
QCA 不会下载 Bazaar 价格。可以使用离线/Ironman/获取速度模式，或者安装仍通过已识别公开方法提供现有客户端价格缓存的兼容 Skyblocker。提供方更新可能让价格桥不可用，其他 Shard 工具仍可继续使用。
QCA 不会只因版本号变化就拒绝整个提供者。重新打开设置后，它会再次探测实时配置与原生保存能力；仍兼容的已知字段会继续出现，不能安全理解的新结构会被省略。
如果 QCA 已经收到匹配的真实 ItemStack，会优先让 Minecraft 渲染真实物品，使服务器或材质包表现生效；从未观察过的目录条目使用内置的对应 ID 离线图标。
请创建 GitHub Issue，并提供：
- QCA 版本和完整文件名
- Minecraft、Fabric Loader、Fabric API 与 Java 版本
- 完整模组列表及版本
- 使用语言和 GUI Scale
- 出现问题的具体岛屿/地点以及复现步骤
- 预期结果与实际结果
- UI/渲染问题的截图或短视频
-
latest.log；如果崩溃，还需要 Crash Report - 只安装 Fabric API 与 QCA 时是否仍然发生
不要上传 Access Token、会话标识、私人聊天或其他敏感信息。
Release 0.3.9 使用 Java 25 为 Minecraft 26.1.2 与 26.2 构建。当前验证报告会记录两个构建准确的自动测试、压缩包、语言与兼容契约检查结果。
自动测试与压缩包检查不能代替真实 Hypixel 回归、所有 GUI Scale、所有材质包和未来每一种模组组合。准确测试边界请查看当前验证报告。
项目文档：
QCloudy_Addition 源代码采用 GNU Lesser General Public License v3.0 or later（LGPL-3.0-or-later）。经过审核的离线事实/资源及其许可证均记录在 THIRD_PARTY_NOTICES.md 中，其中包括 Hypixel SkyBlock Wiki 和 MIT 许可证的 SkyShards 图标数据。运行中的模组不会联系这些来源。