---

What is SimpleStatTrak?

SimpleStatTrak brings the iconic CS:GO StatTrak™ experience to Minecraft. Track kills, damage, blocks mined, arrows shot, and dozens of other statistics — all displayed directly in the item's lore. No database required. Stats live on the item itself, forever.

Pick up any weapon, tool, or armor piece, run /stattrak add, and watch the numbers climb.

---

Features

• Zero database required — All stats stored in item NBT data via PersistentDataContainer
• Real-time lore updates — Stats update instantly in item lore every time something is tracked
• Per-item tracking — Each individual item has its own stat history
• 16 item types — Swords, axes, bows, crossbows, pickaxes, shovels, armor, elytra, mace, trident, spear, and more
• 80+ unique stats — From kills and damage to ores mined, sheep sheared, and fires ignited
• Remove without losing data — Hide StatTrak™ lore and re-add it later to restore all stats
• Reset with confirmation — Two-step reset process to prevent accidental wipes
• Fully configurable — Enable/disable per item type, choose exactly which stats to show
• Custom lore styling — Customize colors, format, header and footer with color codes
• Lightweight — No external dependencies, no async database calls, minimal overhead

---

How To Use

1. Hold any supported item in your main hand
2. Run /stattrak add
3. The item now tracks stats based on plugin config
4. Use the item normally — stats update automatically

To stop tracking: /stattrak remove (stats are preserved, just hidden)

To see stats in chat: /stattrak info

To reset stats: /stattrak reset (run twice within 30 seconds to confirm)

---

Commands

Command	Description
/stattrak add	Add StatTrak™ to the held item
/stattrak remove	Hide StatTrak™ (stats preserved)
/stattrak reset	Reset all stats on held item (requires confirmation)
/stattrak info	Show current stats for held item
/stattrak list	List all enabled item types and their stats
/stattrak reload	Reload config (admin only)
/stattrak help	Show help menu

Aliases: /st, /statrak

---

Permissions

Permission	Description	Default
stattrak.use	Use basic StatTrak commands	Everyone
stattrak.admin	Use /stattrak reload	Ops only

---

Tracked Item Types

Category	Items
Melee	Swords, Axes, Mace, Trident, Spear
Ranged	Bow, Crossbow
Tools	Pickaxe, Shovel, Shears, Brush, Flint & Steel
Armor	Helmet, Chestplate, Leggings, Boots, Elytra

---

Example Stat Lore

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

---

Configuration Preview

Everything is disabled by default. Enable what you need:

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

items:
  sword:
    enabled: false          # Set to true to enable
    stats:
      # - creation_date     # Uncomment to track
      # - 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 Version	Status
1.21	Supported
1.21.1	Supported
1.21.2	Supported
1.21.3	Supported
1.21.4	Supported
1.21.5+	Supported

Server Software	Status
Paper	Fully Supported
Spigot	Supported
Purpur	Supported
other Paper forks	Supported
Folia	Not Supported

Requires Java 21 or newer.

---

Technical Notes

• Stats are stored using Bukkit's PersistentDataContainer — they survive restarts, drops, and inventory transfers
• No database, no async I/O, no file writes — completely zero-overhead storage
• Stats are tracked per-item, not per-player — if someone picks up your sword, their kills count on your sword
• Creative mode tracking is disabled by default (toggle in config)
• The SPEAR item type is gracefully handled — if the item doesn't exist in your server version, it is silently skipped

---

Support

• contact me on discord nickname: we_rt, only with important bug related things

---

🌟 License

The source code is not publicly available, but if you want to edit something in the plugin for your own needs, update the plugin to a new version or anything else, contact me on discord nickname: we_rt and we will definitely come to an agreement

---