Simple StatTrak

<div align="center">

✨SimpleStatTrak✨

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

Paper 1.21+

Java 21+

[]()

</div>

---

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

- Lightweight — All stats stored in item NBT data via PersistentDataContainer - Lightweight — Stats update instantly in item lore every time something is tracked - Lightweight — Each individual item has its own stat history - Lightweight — Swords, axes, bows, crossbows, pickaxes, shovels, armor, elytra, mace, trident, spear, and more - Lightweight — From kills and damage to ores mined, sheep sheared, and fires ignited - Lightweight — Hide StatTrak™ lore and re-add it later to restore all stats - Lightweight — Two-step reset process to prevent accidental wipes - Lightweight — Enable/disable per item type, choose exactly which stats to show - Lightweight — 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:

```yaml 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

--- <div align="center">

Made with ❤️ for the Minecraft community