Better Harvest Levels

BetterHarvestLevel

全面掌控整合包的挖掘进度。BetterHarvestLevel 可让你定义自定义工具等级、覆盖任意方块或工具的挖掘等级，并统一跨模组的进度体系……所有设置都只需通过简单的 JSON 配置文件完成。

功能

自定义等级定义

定义超越原版木/石/铁/钻石/下界合金等级体系的自定义挖掘等级。每个等级支持：

• 自定义名称、显示名称和颜色
• 用于排序的数字等级
• 可配置的图标物品（显示在 Jade 提示框中）
• 插入位置（after/before），以精确排列等级顺序

方块和工具覆盖

覆盖挖掘任意方块所需的等级，或指定任意工具所属的等级。可通过以下方式指定覆盖目标：

• 单独的 ID：minecraft:obsidian、create:brass_block
• 标签：#minecraft:needs_iron_tool
• 模组命名空间：create:*（来自某个模组的所有方块/物品）
• 正则表达式：在整个注册表中进行模式匹配

等级等效组

将挖掘时应视为等效的等级分组。适用于添加平行进度路线的模组（例如，将某个模组添加的合金等级设为与铁等效）。

配置分层

将覆盖项拆分到多个文件中，方便整理。可以使用 blocks.json、blocks_create.json、blocks_thermal.json 等文件。BetterHarvestLevel 会按字母顺序自动合并所有文件。让每个模组的配置保持整洁、彼此独立。

Jade/WAILA 集成

应用了 BHL 覆盖设置的方块会在 Jade 提示框中显示所需等级，并包含：

• 以配置颜色显示的等级名称
• 根据你手持的工具显示可挖掘指示（绿色勾号或红色 X）
• 该等级对应的图标物品

游戏内命令

• /bhl check held 显示你手持工具的 BHL 等级
• /bhl check looking 显示你正在注视的方块所需的等级
• /bhl info 列出所有已注册的等级和覆盖项数量
• /bhl reload 热重载所有配置文件，无需重启

忽略模组列表

将整个模组排除在覆盖项解析之外，使其方块和工具不受影响。

入门指南

1. 安装模组并启动一次游戏。配置文件会生成在 .minecraft/config/betterharvestlevel/ 中。
2. 编辑 tiers.json 以定义等级体系。
3. 在 blocks.json 中添加方块覆盖项（或创建类似 blocks_create.json 的模组专属文件）。
4. 在 tools.json 中添加工具覆盖项（或创建类似 tools_thermal.json 的模组专属文件）。
5. 可选：在 equivalences.json 中定义等效组。
6. 在游戏内使用 /bhl reload，立即应用更改。

示例：添加自定义等级并覆盖方块

tiers.json：添加一个位于石头和铁之间的“铜”等级：

{
  "tiers": [
    { "name": "wood", "level": 0, "displayName": "Wood", "color": "#A0522D", "builtIn": true },
    { "name": "stone", "level": 1, "displayName": "Stone", "color": "#AAAAAA", "builtIn": true },
    { "name": "copper", "level": 2, "displayName": "Copper", "color": "#E8851C", "builtIn": false, "iconItem": "minecraft:copper_ingot" },
    { "name": "iron", "level": 3, "displayName": "Iron", "color": "#FFFFFF", "builtIn": true },
    { "name": "diamond", "level": 4, "displayName": "Diamond", "color": "#55FFFF", "builtIn": true },
    { "name": "netherite", "level": 5, "displayName": "Netherite", "color": "#555555", "builtIn": true }
  ]
}

blocks.json：需要铜级工具才能开采青金石矿石：

{
  "overrides": [
    { "target": "minecraft:lapis_ore", "type": "block", "requiredTier": "copper" },
    { "target": "minecraft:deepslate_lapis_ore", "type": "block", "requiredTier": "copper" }
  ]
}

面向整合包开发者

BetterHarvestLevel 专为需要精细控制采矿进度的整合包开发者打造。将你的等级配置和覆盖配置随整合包一同发布，无需终端用户进行配置。分层配置系统让你能够按模组整理覆盖配置，并随着整合包的迭代轻松添加或移除特定模组的文件。