Commands

Better Harvest Levels registers the /bhl command tree for inspecting the active server rules and reloading configuration.

Command	Result
/bhl info	Lists loaded tiers and levels.
/bhl check	Checks the held item against the block targeted within eight blocks.
/bhl check hand	Reports the held item or hand ID and resolved tier.
/bhl check block	Reports the targeted block ID and resolved requirement.
/bhl reload	Reloads config, re-resolves selectors, syncs connected Better Harvest Levels clients, and reports loaded tier, block, and tool counts.

Inspect active rules

/bhl info

Lists every loaded tier in numeric order. Each line includes the tier’s display name and numeric level, which lets you confirm that custom tiers loaded.

/bhl check

Look at a block within eight blocks, hold the item you want to test, and run /bhl check. The result identifies the targeted block and held item, shows the resolved requirement and held tier, and reports whether the block will produce drops.

If no block is targeted within eight blocks, the command reports Look at a block instead.

/bhl check hand

Reports the held item’s name, item ID, and resolved tier. With an empty hand, it reports Bare Hand and the hand tier. A tool resolved through tools*.json is marked as an override.

/bhl check block

Look at a block within eight blocks and run /bhl check block. The result reports the block’s name, block ID, and resolved requirement. A requirement resolved through blocks*.json is marked as an override.

If no block is targeted within eight blocks, the command reports Look at a block instead.

Reload configuration

Caution

/bhl reload requires permission level 2. The info, check, check hand, and check block subcommands have no explicit permission gate in the mod.

Use this workflow after changing configuration:

1. Edit the JSON files under config/betterharvestlevel/.
2. Run /bhl reload in game.
3. Inspect the summary for the loaded tier, block rule, and tool rule counts.
4. Hold the intended tool, target the affected block within eight blocks, and run /bhl check.

Reloading reads the configuration again, validates tiers, re-resolves block and item selectors, rebuilds the active server rules, and syncs connected Better Harvest Levels clients. A successful reload reports the loaded tier, block rule, and tool rule counts.