Better Item Stats

By
zClash

Customize item attributes like durability, mining speed, attack damage, attack speed, armor, and more through a simple JSON configuration.

Better Item Stats

Better Item Stats is a lightweight configuration-focused utility for Minecraft 1.20.1 Fabric that allows modpack authors to customize item statistics by registry ID without modifying the original content mod.

It works with both vanilla and modded items and is designed to complement progression and harvest-level systems by handling the numerical properties of items separately.

Features

- Durability Overrides — Set an exact maximum durability for damageable items.

- Mining Speed Overrides — Change an item's effective mining speed without changing which blocks the item can harvest.

- Attack Damage — Override the final player attack damage for an item.

- Attack Speed — Override the final player attack speed for an item.

- Armor Attributes — Configure armor, armor toughness, and knockback resistance.

- Vanilla & Modded Items — Target any item using its registry ID.

- Mining Tooltips — Display mining information for configured items, even when mining speed is not being overridden.

- Per-Entry Configuration — Enable or disable individual item entries and only change the attributes you specify.

- Lightweight Integration — Uses Fabric API for client-side tooltip integration without requiring content mods.

Only the attributes specified in an entry are modified. Other item attributes and modifiers remain unchanged.

Better Harvest Levels Integration

When Better Harvest Levels 2.0.1 or newer is installed, Better Item Stats can read the active harvest-level override for an item at runtime.

The integration can:

- Display the effective Better Harvest Levels harvest tier.

- Display the item's detected digging speed.

- Correct existing harvest-level tooltip lines from compatible tooltip providers.

- Add the effective harvest level for configured custom items when showMiningTooltip is enabled.

Example tooltip:

2 Harvest Level
5 Digging Speed

The integration is completely optional. Better Harvest Levels remains responsible for harvest tiers, tool requirements, and progression rules. Better Item Stats only reads the effective values for tooltip display and does not replace or modify those rules.

Configuration

The configuration file is located at:

config/betteritemstats/items.json

Example:

{
  "configVersion": 1,
  "enabled": true,
  "overrides": [
    {
      "target": "minecraft:iron_sword",
      "type": "item",
      "durability": 300,
      "attackDamage": 6.5,
      "attackSpeed": 1.6,
      "slot": "mainhand"
    }
  ]
}

Available Fields

Field	Description
`target`	Registry ID of the target item.
`type`	Item type. Currently supports `item`.
`enabled`	Enables or disables the individual entry. Defaults to `true`.
`durability`	Sets the item's maximum durability.
`miningSpeed`	Replaces the item's effective mining speed when the item is already effective against the block.
`showMiningTooltip`	Enables mining information in the tooltip.
`attackDamage`	Sets the final player attack damage while the item is equipped in the configured slot.
`attackSpeed`	Sets the final player attack speed while the item is equipped in the configured slot.
`armor`	Sets the armor value supplied by the item.
`armorToughness`	Sets the armor toughness value supplied by the item.
`knockbackResistance`	Sets the knockback resistance supplied by the item.
`slot`	Equipment slot used by the configured combat attributes. Supports `mainhand`, `offhand`, `head`, `chest`, `legs`, and `feet`.

Only the fields included in an entry are changed.

Mining Tooltip Without Changing Mining Speed

You can display an item's mining information without overriding its original mining speed:

{
  "target": "abstoneedition:bismuth_pickaxe",
  "type": "item",
  "showMiningTooltip": true
}

When Better Harvest Levels has an active tier override for the item, the effective harvest level is displayed alongside the detected digging speed.

If another tooltip mod already provides equivalent mining information for a specific item, showMiningTooltip can be disabled:

"showMiningTooltip": false

Harvest Progression Compatibility

Better Item Stats does not replace harvest levels, tool tiers, block requirements, or tool suitability.

For example, changing:

"miningSpeed": 5.0

does not make an item capable of harvesting blocks that it could not previously harvest.

This allows Better Item Stats to be used alongside Better Harvest Levels and similar progression systems while keeping item statistics and harvest rules separate.

Installation

Install Fabric Loader for Minecraft 1.20.1.
Install Fabric API.
Place the Better Item Stats JAR in the mods folder on both the client and server.
Start the game once to generate the configuration file.
Edit config/betteritemstats/items.json.
Restart the game or server after changing the configuration.

Better Harvest Levels is optional and is only required when you want its configured harvest levels to be displayed through the Better Item Stats tooltip integration.

Compatibility

- Minecraft: 1.20.1

- Mod Loader: Fabric

- Environment: Client & Server

- Required: Fabric API

- Optional: Better Harvest Levels 2.0.1+

- Java: 17+

Better Item Stats works with both vanilla and modded items and does not require the original content mod that adds the target item to be modified.

Credits

Created by zClashTM.

License

Better Item Stats is licensed under the MIT License.