📖About NDPlayerStats

ABOUT

NDplayerStats is a powerful and lightweight Minecraft plugin that tracks player statistics such as: Kills • Deaths • KD Ratio • Killstreaks

It's ideal for competitive or PvP-focused servers that want to give players personal insights and leaderboard rankings.

FEATURES

Saves all statistics to stats.yml
Text-based /stats and GUI-based /statsgui
Kill leaderboard with customizable size, colors, and rank prefixes (e.g., #1, #2, …)
PlaceholderAPI support for easy integration with other plugins
Fully configurable via config.yml
Visible rank in nametag and tablist for top players (the rank is also visible in chat)
stats.yml - stores all current player statistics
config.yml – Controls leaderboard display options:

leaderboard:
  enabled: true
  size: 10
  display-prefix: true       # Shows rank number (#1, #2, ...) before player names
  colors:
    first: "&6"              # Gold for 1st place
    second: "&7"             # Silver for 2nd place
    third: "&8"              # Bronze for 3rd place
    others: "&f"             # White for all other positions

COMMANDS & PERMISSIONS

/stats - Displays the selected player's full stats.
permission: ndplayerstats.stats

/resetstats - Resets all stats of the selected player.
permission: ndplayerstats.resetstats

/statsgui - Shows a detailed GUI of the player's stats.
permission: ndplayerstats.statsgui

/leaderboard - Displays the top players leaderboard with their visible prefix

PLACEHOLDER API

%ndplayerstats_kills% - Displays the number of kills a player has.
%ndplayerstats_deaths% - Displays the number of player deaths.
%ndplayerstats_kd% - Displays the player's KD ratio
%ndplayerstats_killstreak% - Displays the player's current killstreak.
%ndplayerstats_top_% - Replace with a leaderboard position to display the player in that slot