?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
NDPlayerStats

NDPlayerStats

✨ Track and display player stats – kills, deaths, killstreak, KD ratio, play time, and more features ✨

462downloads
1follower
462downloads
1follower

Compatibility

Minecraft: Java Edition

26.2
26.1.x
1.21.x
1.20.x
1.19.x
1.18.x
1.17.x
1.16.x
1.15.x
1.14.x
1.13.x

Platforms

Tags

Creators

Details

Licensed ARR
Published 7 months 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! High-performance servers, instant setup, and 24/7 support. Use code KUBASS7 for 7% off!

CraftNode Hosting

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

MCindex

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

Placeholder API

💾 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

📝 Notes

  • Database type changes require a server restart
  • All other settings can be reloaded with /ndps reload

👨‍💻 Author

Kubass1 – kubass.cz