📊 NDplayerStats
NDplayerStats is a powerful and lightweight Minecraft plugin that tracks player statistics including Kills, Deaths, KD Ratio, Killstreaks, Play Time, and detailed Death Tracking.
🚀 Need a Minecraft Server?
Looking for a reliable host to run NDplayerStats? Check out CraftNode / CraftNode.org! High-performance servers, instant setup, and 24/7 support. Use code KUBASS7 for 7% off!
📋 Need more players?
Get your server listed on Minecraft server list – MCindex.eu! Completely free, easy to set up, and a great way to attract new players to your server. Join the community and start growing today!
It's ideal for competitive, PvP, or survival servers that want to give players personal insights, leaderboard rankings, and visible rank prefixes.
✨ Features
📈 Statistics Tracking
- Kills – Total kills (PvP + PvE combined)
- PvP Kills – Kills against players
- PvE Kills – Kills against mobs/animals
- Deaths – Total deaths with detailed breakdown:
- PvP Deaths
- PvE Deaths (mobs/animals)
- Killstreak – Current and highest killstreak
- KD Ratio – Kill/Death ratio
- Play Time – Total play time tracked per player
- Player Rank – Global ranking based on kills
🎮 Commands
| Command | Description | Permission |
|---|---|---|
/stats [player] |
View player statistics in chat | ndplayerstats.stats |
/statsgui [player] |
Open statistics GUI | ndplayerstats.statsgui |
/leaderboard [kills|kd] <page> |
Show leaderboard with pagination | ndplayerstats.leaderboard |
/resetstats <player> |
Reset a player's statistics | ndplayerstats.reset |
/resetstatsall confirm |
Reset ALL players' statistics | ndplayerstats.resetall |
/ndps <help|info|reload|lookup|update> |
Admin commands | ndplayerstats.admin |
Permissions
| Permission | Default | Description |
|---|---|---|
ndplayerstats.stats |
Everyone (true) |
Use /stats command |
ndplayerstats.statsgui |
Operators (op) |
Use /statsgui command |
ndplayerstats.reset |
Operators (op) |
Use /resetstats command |
ndplayerstats.resetall |
Operators (op) |
Use /resetstatsall command |
ndplayerstats.leaderboard |
Everyone (true) |
Use /leaderboard command |
ndplayerstats.admin |
Operators (op) |
Use /ndps admin commands |
ndplayerstats.antiabuse.bypass |
Operators (op) |
Bypass anti-kill abuse protection |
🏆 Leaderboard
- Customizable size (default: 10 players)
- Custom rank colors for each position (#1 Gold, #2 Silver, #3 Bronze, etc.)
- Pagination support –
/leaderboard kills 2,/leaderboard kd 1 - Default mode – choose between
killsorkdin config - Auto-updating cache for performance
- Rank prefixes visible in chat, nametag, and tablist via PlaceholderAPI
🖥️ GUI
- Interactive statistics GUI
- Click the player head to refresh stats
- Fully customizable layout and items in
config.yml
🛡️ Anti-Kill Abuse
- Prevents kill farming against the same player
- Time-window mode with configurable limits
- Notifications for killer and victim
- Bypass permission:
ndplayerstats.antiabuse.bypass - World restrictions support
🔌 PlaceholderAPI Support
| Placeholder | Description |
|---|---|
%ndplayerstats_kills% |
PvP kills only |
%ndplayerstats_pvp_kills% |
PvP kills only |
%ndplayerstats_pve_kills% |
PvE kills only |
%ndplayerstats_all_kills% |
Total kills (PvP + PvE) |
%ndplayerstats_deaths% |
Total deaths |
%ndplayerstats_pvp_deaths% |
PvP deaths |
%ndplayerstats_pve_deaths% |
PvE deaths |
%ndplayerstats_all_deaths% |
Total deaths (PvP + PvE) |
%ndplayerstats_kd% |
KD Ratio (formatted to 2 decimals) |
%ndplayerstats_killstreak% |
Current killstreak |
%ndplayerstats_highestkillstreak% |
Highest killstreak |
%ndplayerstats_rank% |
Rank with prefix (e.g., [#1]) |
%ndplayerstats_rank_number% |
Rank number only |
%ndplayerstats_playtime% |
Formatted play time |
%ndplayerstats_kills_<number>% |
Player name at leaderboard position |
%ndplayerstats_deaths_<number>% |
Player name at leaderboard position |
%ndplayerstats_kd_<number>% |
Player name at leaderboard position |
%ndplayerstats_player_<name>_kills% |
Kills of a specific player |
%ndplayerstats_player_<name>_deaths% |
Deaths of a specific player |
%ndplayerstats_player_<name>_rank% |
Rank of a specific player |
💾 Database Support
- YAML – Simple file-based storage (default)
- SQLite – Lightweight embedded database
- MySQL – Centralized database for multi-server setups
⚙️ Configuration
- Fully configurable via
config.yml - Custom messages via
messages.yml - Performance settings (cache, async operations, save intervals)
- Death tracking settings (enable/disable specific death types, world restrictions)
- Rank system customization (unranked text, max display rank, minimum kills for rank)
🔧 Installation
- Download the latest
ndplayerstats-1.5.1.jar - Place it in your server's
plugins/folder - Restart your server
- Edit
config.ymlandmessages.ymlto your liking - Use
/ndps reloadto apply changes (except database type changes)
📁 File Structure
plugins/NDplayerStats/
├── config.yml # Main configuration file
├── messages.yml # All customizable messages
├── stats.yml # Player statistics (YAML database mode)
└── database.db # SQLite database file (SQLite mode)
text
🔴 Requirements
- Optional: PlaceholderAPI (for placeholders)
📝 Notes
- Database type changes require a server restart
- All other settings can be reloaded with
/ndps reload
👨💻 Author
Kubass1 – kubass.cz
