Better Harvest Levels

BetterHarvestLevel

Take full control of your modpack’s mining progression. BetterHarvestLevel lets you define custom tool tiers, override harvest levels for any block or tool, and unify cross-mod progression… all through simple JSON config files.

Features

Custom Tier Definitions

Define your own mining tiers beyond vanilla’s wood/stone/iron/diamond/netherite hierarchy. Each tier supports:

• Custom name, display name, and color
• Numeric level for ordering
• Configurable icon item (shown in Jade tooltips)
• Insertion point (after/before) for precise tier ordering

Block & Tool Overrides

Override which tier is required to mine any block, or what tier any tool belongs to. Target overrides by:

• Individual ID: minecraft:obsidian, create:brass_block
• Tag: #minecraft:needs_iron_tool
• Mod namespace: create:* (all blocks/items from a mod)
• Regex: pattern-match across the entire registry

Tier Equivalence Groups

Group tiers that should be treated as equivalent for mining purposes. Useful for mods that add parallel progression paths (e.g., making a modded alloy tier equivalent to iron).

Config Layering

Split your overrides across multiple files for organization. Use blocks.json, blocks_create.json, blocks_thermal.json, etc. BetterHarvestLevel merges them all automatically in alphabetical order. Keep per-mod configs clean and separate.

Jade/WAILA Integration

Blocks with BHL overrides display their required tier in the Jade tooltip, complete with:

• Tier name in its configured color
• A harvestability indicator (green checkmark or red X) based on your held tool
• The tier’s icon item

In-Game Commands

• /bhl check held Show the BHL tier of your held tool
• /bhl check looking Show the required tier of the block you’re looking at
• /bhl info List all registered tiers and override counts
• /bhl reload Hot-reload all config files without restarting

Mod Ignore List

Exclude entire mods from override resolution so their blocks and tools are left untouched.

Getting Started

1. Install the mod and launch the game once. Config files are generated in .minecraft/config/betterharvestlevel/.
2. Edit tiers.json to define your tier hierarchy.
3. Add block overrides in blocks.json (or create per-mod files like blocks_create.json).
4. Add tool overrides in tools.json (or per-mod files like tools_thermal.json).
5. Optionally define equivalence groups in equivalences.json.
6. Use /bhl reload in-game to apply changes instantly.

Example: Adding a custom tier and overriding a block

tiers.json: Add a “copper” tier between stone and iron:

{
  "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: Require the copper tier to mine lapis ore:

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

For Modpack Developers

BetterHarvestLevel is built specifically for modpack developers who need granular control over mining progression. Ship your tier and override configs with your modpack, no end-user configuration needed. The layered config system means you can organize overrides per-mod and easily add or remove mod-specific files as your modpack evolves.