NDPlayerStats
1.5.3✨ Track and display player stats – kills, deaths, killstreak, KD ratio, play time, and more features ✨
📊 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.
Older Versions (SpigotMC): Older releases and historical builds are archived on SpigotMC Resource Page.
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|playtime] <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
kills,kdorplaytimein 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.3.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
Similar projects
Plugin →VeinMiner
Mine the whole vein on mining a single ore/block. Make the tedious mining experience to something satisfying and fun! FTB Ultimine alternative
99.3MSueta
Simple Voice Chat
A working voice chat in Minecraft!
76.8MSueta
Chunky
Pre-generates chunks, quickly and efficiently
18.4MSueta
VeinMiner Enchantment
Veinminer Addon - Adds vineminer enchantment to enchanting tables. Only tools with the enchantment can veinmine
18MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
14.7MSueta
WorldEdit
A Minecraft Map Editor... that runs in-game! With selections, schematics, copy and paste, brushes, and scripting. Use it in creative, or use it temporarily in survival.
11.6MSueta