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! 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 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

🔌 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

1. Download the latest ndplayerstats-1.4.0.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