Bind tracker items to pickaxes, weapons, rods, and more. Lifetime counters are stored on the item (PDC) and shown on lore with MiniMessage. Fully data-driven: add tracker profiles, stats, filters, and layouts in config. Paper and Folia 1.21 - 26.x
Support
Report bugs and get support here: https://discord.gg/VvM6k2eBDa
Features
• Folia support – stat updates are scheduled on the correct region; no main-thread spam from credits.
• Unlimited tracker definitions – each profile has its own binder item, applies-to rules (vanilla item tags + extra materials), and stat list.
• Lifetime stats on lore – placeholders
{stat_id} per counter; refresh when a stat changes.• Stat types – block_break, player_kill, mob_kill, fish_catch, damage_dealt, melee_hit, projectile_shot, projectile_hit.
• Per-stat filters – block tags / materials, entity groups (HOSTILE, PASSIVE, BOSS, NEUTRAL), entity types, damage-victim (players/mobs/any), require-custom-name for named mobs/bosses.
• Lore layouts – normal
tracked-lore, optional compact (single line) or grouped sections.• Binding UX – right-click binder + tool in hands (configurable cancel-interact); optional inventory click-to-bind; single-use binders when
consume-binder is true.• Combat & sources – kill-credit hand mode (MAIN / OFF / BOTH); configurable hand for block break, fishing, melee damage, and projectile damage.
• Toggles –
track-combat-damage and track-projectile-shots for servers that only want block/kill/fish stats.• Developer API –
PerfTrackersApi (read profile / lifetime counts, isTracked); cancellable TrackerStatIncrementEvent for integrations.• Messages – MiniMessage in
messages.yml; tab-complete on commands.Commands
/tracker – Receive one binder for the default tracker (perftrackers.use)
/tracker get (trackerId) – Receive a binder for that tracker id (perftrackers.use)
/tracker (trackerId) – Same as get (trackerId) (perftrackers.use)
/perftrackers reload – Reload config and messages (perftrackers.admin)
/perftrackers give (player) (trackerId) [amount] – Give binder stack to an online player, amount 1–64 (perftrackers.admin)
/perftrackers help – Show admin usage (perftrackers.admin)
/perftracker … – Alias for /perftrackers (same permissions)
