✨ SimpleStatTrak ✨
CS:GO-style StatTrak™ item tracking for your Minecraft server

Bring the iconic StatTrak™ system from Counter-Strike: Global Offensive into Minecraft.

Track kills, damage dealt, blocks mined, arrows shot and 80+ other statistics — all stored directly inside the item.

No database. No dependencies. No performance impact.

⭐ What Does It Do?
SimpleStatTrak allows you to add a StatTrak™ counter to supported items.

Each individual item:

• Tracks its own stats
  
  
• Updates lore in real time
  
  
• Keeps data forever (stored in NBT)

If someone picks up your sword — the stats stay on the sword.

Features
✔ No database required (PersistentDataContainer)
✔ Real-time lore updates
✔ Per-item tracking (not per-player)
✔ 16 supported item categories
✔ 80+ unique trackable statistics
✔ Remove StatTrak without losing data
✔ 2-step reset confirmation system
✔ Fully configurable per item type
✔ Customizable lore format & colors
✔ Lightweight & optimized

Commands
/stattrak add – Add StatTrak to held item
/stattrak remove – Hide StatTrak (data preserved)
/stattrak reset – Reset stats (requires confirmation)
/stattrak info – Show stats in chat
/stattrak list – List enabled item types
/stattrak reload – Reload config (admin)
/stattrak help – Help menu

Aliases: /st, /statrak /stattrak

Permissions
stattrak.use – Basic usage (default: true)
stattrak.admin – Reload command (default: op)

Supported Items
Melee

• Swords
  
  
• Axes
  
  
• Mace
  
  
• Trident
  
  
• Spear

Ranged

• Bow
  
  
• Crossbow

Tools

• Pickaxe
  
  
• Shovel
  
  
• Shears
  
  
• Brush
  
  
• Flint & Steel

Armor

• Helmet
  
  
• Chestplate
  
  
• Leggings
  
  
• Boots
  
  
• Elytra

Example Lore
--------------------
⭐ StatTrak™
» Total Damage: 12,840
» Mobs Killed: 247
» Players Killed: 14
» Critical Hits: 89
» Times Used: 1,203
--------------------

⚙ Configuration Example
Everything is disabled by default.

settings:
track-in-creative: false
allow-player-reset: true

items:
sword:
enabled: false
stats:
# - damage_dealt_total
# - mobs_killed
# - players_killed
# - critical_hits
# - times_used

lore:
header: "&8&m--------------------"
title: "&6⭐ StatTrak™"
stat-format: "&7» {stat_display}: &e{stat_value}"
footer: "&8&m--------------------"

✅ Compatibility
Minecraft Versions

• 1.21.x

Server Software

• Spigot
  
  
• Paper
  
  
• Purpur
  
  
• Other Paper forks

Folia is not supported.

Requires Java 21+.

Technical Details

• Uses Bukkit PersistentDataContainer
  
  
• No database or file storage
  
  
• No async tasks
  
  
• Stats are bound to the item, not the player
  
  
• Creative tracking disabled by default