?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
Player stats

Player stats

Viper Player Stats is a high-performance, server-side stat tracking mod for. It monitors player activity with granular detail—blocks broken, mobs killed, items crafted, distance traveled, and 30+ more categories.🔌✨

12downloads
1follower
12downloads
1follower

Compatibility

Minecraft: Java Edition

26.2
26.1.x
1.21.x

Platforms

Supported environments

Server-side
Singleplayer

Links

Join Discord server
Donate on Ko-fi

Tags

Creators

Details

Licensed MIT
Published 22 hours ago

📊 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>.json with 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

  1. Install the mod on your server (client-side not required). 📥
  2. Start the server — stats begin tracking automatically. 🟢
  3. Query player stats using the /stats command. 🎮

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. 📊✨