Getting Started

Install the build that matches your Minecraft version and mod loader, then launch once to generate the configuration files.

Requirements

Minecraft	Loader	Java
1.20.1	Forge, Fabric	17
1.21.1	NeoForge, Fabric	21
26.1.x	NeoForge, Fabric	25
26.2	NeoForge, Fabric	25

Fabric builds also require Fabric API. Jade is optional.

Install the mod

Modrinth

1. Open Better Harvest Levels versions on Modrinth.
2. Select your exact Minecraft version and loader.
3. Download the matching jar and place it in your mods/ folder.
4. If you selected Fabric, install the matching Fabric API jar in mods/ too.

CurseForge

1. Open Better Harvest Levels on CurseForge and go to Files.
2. Select your exact Minecraft version and loader.
3. Download the matching jar and place it in your mods/ folder.
4. If you selected Fabric, install the matching Fabric API jar in mods/ too.

Choose where to install it

A server can enforce its harvest rules for players who do not have Better Harvest Levels installed. Each loader checks whether a client has the Better Harvest Levels network channel before sending the rules.

Install the mod on clients that need corrected harvest prediction or Jade’s modified harvest requirement display. In single-player, the integrated client and server both load the mod from the same jar.

Note

A client without the mod does not receive the server’s Better Harvest Levels rules. The server still decides whether block breaking produces drops. See Multiplayer sync for reload and client-display troubleshooting.

Generate the configuration

Start the game or server once. Better Harvest Levels creates this folder beside mods/:

config/betterharvestlevel/
├── tiers.json
├── blocks.json
├── tools.json
└── equivalences.json

The generated block override, tool override, and equivalence lists are empty. tiers.json contains the default tier ladder.

Add your first block rule

1. Open config/betterharvestlevel/blocks.json.

   Replace its contents with this rule:

   {
     "configVersion": 1,
     "overrides": [
       {
         "target": "minecraft:coal_ore",
         "type": "block",
         "requiredTier": "iron"
       }
     ]
   }

2. Save the file and reload the rules.

   Join the world as an operator and run:

   /bhl reload

3. Check the active requirement.

   Look at a coal ore block within eight blocks, then run:

   /bhl check

4. Verify the rule.

   An iron-tier or better pickaxe can receive drops from the coal ore. Weaker pickaxes cannot.

Continue

Configuration Reference the block, tool, tier, and equivalence file formats.

Commands Reload rules and inspect the active harvest requirement.