📊 Viper Player Stats 🚀
Viper Player Stats is a high-performance, server-side stat tracking mod for Minecraft 1.21.x, 26.1.x, and 26.2.x. It monitors player activity with granular detail—blocks broken, mobs killed, items crafted, distance traveled, and 30+ more categories—persisted to JSON with zero client-side dependencies. 🔌✨
Supported Versions
| Version | Java | Status |
|---|---|---|
| 1.21.x | 21 | ✅ Full support |
| 26.1.x | 25 | ✅ Full support |
| 26.2.x | 25 | ✅ Full support |
🛠️ Purpose & Function
The core mission of this project is to give server admins comprehensive insight into player activity through a lightweight, tick-efficient polling system. 📡
- Delta-Based Tracking: Polls the vanilla stat map on a configurable interval and calculates deltas, minimizing overhead. ⏱️
- 30+ Stat Categories: Tracks everything from blocks broken per type to fishing catches, potions brewed, books written, and dimension time. 📋
- Configurable Toggles: Every tracker can be individually enabled/disabled via
config/viper_player_stats.json. ⚙️ - Persistent JSON Storage: Player stats are saved to
stats/player_data/<uuid>.jsonwith automatic save intervals. 💾 - Admin Commands: Powerful in-game commands for querying, comparing, and resetting player stats. 🎮
✨ Key Features
| Feature | Description |
|---|---|
| 📡 Delta Polling | Only records stat changes since last poll — near-zero overhead |
| 🧱 Block Tracking | Per-block break counts + ore mining stats with tag-aware detection |
| ⚔️ Combat Stats | Mob kills, deaths (by cause), damage dealt/taken, projectiles fired/hit |
| 🍖 Food Tracking | Every food item consumed, tracked individually |
| 🛠️ Crafting & Items | Items crafted, dropped, picked up — per-item granularity |
| 🧪 Special Stats | Potions brewed, books written, items enchanted, trades made, beds slept |
| 🎣 Fishing Stats | Fish caught vs. junk caught |
| 🗺️ Dimension Time | Time spent in each dimension (overworld, nether, end, etc.) |
| 🛡️ Armor Durability | Tracks durability loss per armor slot |
| 🧹 Config UI | JSON config at config/viper_player_stats.json — edit and reload |
| 🌐 Server-Only | No client-side installation required — pure server-side |
| 🪶 Lightweight | ~30KB JAR, no external dependencies beyond Fabric API |
🎮 How to Use
- Install the mod on your server (client-side not required). 📥
- Start the server — stats begin tracking automatically. 🟢
- Query player stats using the
/statscommand. 🎮
Commands (require OP level 2):
/stats list — List all tracked stat categories
/stats <player> <stat_type> [timeframe] — View a player's stat
/stats top <stat_type> <limit> — Leaderboard for a stat
/stats reset <player> <stat_type> — Reset a player's stat (or "all")
Stat Types: blocks_broken, ores_mined, items_crafted, items_dropped, items_picked_up, mob_kills, mob_deaths, food_eaten, deaths, damage_dealt, damage_taken, distance_walked, distance_flown, distance_swum, beds_slept, trades_made, items_enchanted, books_written, potions_brewed, armor_durability_lost, teleports_used, buckets_emptied_filled, jukebox_plays, crops_harvested, doors_gates_opened, explosions_caused, projectiles_fired, projectiles_hit, fishing, dimension_time, jumps, time_played, time_since_death
Configuration:
Edit config/viper_player_stats.json to enable/disable any tracker category, adjust polling interval, or change save frequency.
Built for server admins who want deep player insight without sacrificing performance. One mod, 30+ trackers, zero client overhead — pure server-side intelligence. 📊✨
