实用核心生活质量改善

💡 实用核心 QoL

Minecraft 的客户端生活质量改进。

概述

实用核心 QoL 为 Minecraft 提供客户端生活质量改进。所有功能均可通过 config/utility_core_qol-common.toml（或游戏内模组菜单）单独开关。

功能特性

配方选择器（Polymorph 系统）

• 当多个合成配方匹配相同的材料时，显示一个可点击的网格，供你选择想要的结果
• 适用于工作台（3×3）和玩家物品栏（2×2）合成网格
• 将选择同步到服务器以获得正确的产物物品
• 可配置最大显示配方数量（1-64，默认 16）
• 支持键盘/鼠标导航

生物群系与维度标题

• 进入新生物群系或维度时显示原版标题/副标题
• 移植自 YUNGNICKYOUNG 的 Traveler's Titles（LGPLv3）
• 复用原版标题 HUD（无自定义渲染器）
• 淡入淡出时间：10/70/20 刻

标题垂直偏移

• 可配置原版标题/副标题文本的垂直位移（-200 至 +200，默认 +75）
• 正值 = 向上，负值 = 向下

配置

通过 utility_core_qol-common.toml：

# 配方选择器
enableCraftingRecipeSelector = true
maxRecipesDisplayed = 16
logDetectedConflicts = false

# 生物群系/维度标题
enableBiomeDimensionTitles = true

# 标题垂直偏移
titleVerticalOffset = 75  # -200 至 200

配方选择器工作原理

1. 打开工作台或物品栏合成网格
2. 放置匹配多个配方的材料
3. 出现显示所有可能结果的网格
4. 点击所需结果 → 服务器同步选择
5. 输出槽中的结果更新

API（供其他模组使用）

// 获取玩家的配方选择数据
PolymorphApi.INSTANCE.getPlayerRecipeData(player)

// 查找所有匹配输入的配方
PolymorphApi.INSTANCE.getRecipesFor(recipeManager, recipeType, input, level)

// 清除玩家的配方选择数据
PolymorphApi.INSTANCE.clearPlayerRecipeData(player)

致谢

• 生物群系/维度标题：移植自 YUNGNICKYOUNG 的 Traveler's Titles（LGPLv3）

环境要求

端侧：客户端（主要）+ 服务器（同步数据包）

已知不兼容

Fast Workbench (fastbench)：与配方选择系统冲突。请移除它以使用此功能。

MIT 许可证。由 Stalking Dragons 开发。