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 **(https://craftnode.eu)** / **(https://craftnode.org)**! High-performance servers, instant setup, and 24/7 support. Use code `KUBASS7` for 7% off! !(https://cdn.modrinth.com/data/cached_images/57cede3eff5fc275fc1f72a284c095db3270defc_0.webp) ### 📋 Need more players? Get your server listed on Minecraft server list – **(https://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! !(https://cdn.modrinth.com/data/cached_images/f603b6b61124ee1efd574f34bf8e9b874362537d.png) --- 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 ` | View player statistics in chat | `ndplayerstats.stats` | | `/statsgui ` | Open statistics GUI | `ndplayerstats.statsgui` | | `/leaderboard <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., ``) | | `%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 | !(https://cdn.modrinth.com/data/cached_images/9d10124edf8f41b9433fff2467f8b5fc6a21ea58.png) ### 💾 Database Support - **YAML** – Simple file-base