ToolStats Fabric

A Fabric mod port of the ToolStats Paper plugin. Tracks statistics on tools, weapons, and armor directly on items via NBT data storage.

About

ToolStats monitors and displays equipment statistics directly on items. This Fabric version maintains full feature parity with the original Paper plugin while using Fabric's mixin system and Minecraft's built-in NBT storage instead of Bukkit's PersistentDataContainer. Stats are stored on the item itself, eliminating the need for external databases.

Features

The mod tracks an extensive range of metrics including:

• Block and crop harvesting with various tools
• Combat statistics (kills, damage dealt, critical strikes)
• Item ownership history (crafting, looting, trading, creative mode, fishing)
• Armor durability and damage taken
• Specialized activities like fishing catches, sheep shearing, and elytra flight time
• Wither and Ender Dragon kills

Choose between tracking all statistics by default or using a token system to add statistics to tools/armor. Display format for each statistic is customizable or can be disabled entirely.

Data Storage & Maintenance

Statistics are stored directly on items themselves via NBT data. If lore information becomes corrupted, use /toolstats reset command to restore accuracy for the held item.

Configuration

All settings are in config/toolstats/config.yml. See the ToolStats Wiki for detailed configuration options.

Building

./gradlew build

Output JAR: build/libs/

Technical Details

• Minecraft: 1.21.11
• Fabric Loader: 0.18.1+
• Fabric API: 0.141.3+
• Java: 21+
• Storage: NBT via DataComponents.CUSTOM_DATA (no custom registry entries)
• Hooks: Mixin-based bytecode injection (server-side only)

License

GNU General Public License v3

Credits

Original ToolStats plugin by hyperdefined. Fabric port developed with Claude (Anthropic).

Links

• Original Project: https://github.com/hyperdefined/ToolStats
• ToolStats Documentation: https://github.com/hyperdefined/ToolStats/wiki