Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
Licensed ARR
Published 7 months ago
Updated 2 weeks ago
๐ 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