更好的收获等级

更好的收获等级

适用于整合包开发者的配置驱动工具进度模组

矿石与资源

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 提示框中显示其所需等级，包括：

  • 以配置颜色显示的等级名称
  • 基于你当前手持工具的采掘能力指示器（绿色勾选或红色叉号）
  • 该等级的图标物品

游戏内命令

  • /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 专为需要精细控制挖矿进度的整合包开发者打造。你可以将等级和覆盖规则配置文件随整合包一同发布，无需最终用户进行任何配置。分层配置系统意味着你可以按模组组织覆盖规则，并在整合包演变过程中轻松添加或删除特定模组的文件。