NDPlayerStats

📊 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 kills or kd in 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

1. Download the latest ndplayerstats-1.5.1.jar
2. Place it in your server's plugins/ folder
3. Restart your server
4. Edit config.yml and messages.yml to your liking
5. Use /ndps reload to 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