📊 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! High-performance servers, instant setup, and 24/7 support. Use code KUBASS7 for 7% off!
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
- Deaths – Total deaths with detailed breakdown:
- PvP Deaths
- PvE Deaths (mobs/animals)
- Environmental Deaths (fall, fire, lava, etc.)
- Void Deaths
- Suicide Deaths
- 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 |
🏆 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
🔌 PlaceholderAPI Support
| Placeholder | Description |
|---|---|
%ndplayerstats_kills% |
Total kills |
%ndplayerstats_deaths% |
Total deaths |
%ndplayerstats_kd% |
KD Ratio (formatted to 2 decimals) |
%ndplayerstats_killstreak% |
Current killstreak |
%ndplayerstats_highestkillstreak% |
Highest killstreak |
%ndplayerstats_pvpkills% |
PvP kills |
%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.4.0.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
