TomDeathLeaderboard

A lightweight, robust, and lag-free Minecraft plugin for Paper/Spigot that tracks player deaths and displays them on a beautifully formatted server leaderboard.

✨ Features

• Automatic Tracking: Permanently saves player death counts using secure UUID data storage (deathdata.yml).
• In-Game Leaderboard: Custom chat display showing the Top 10 players with the most deaths.
• Dynamic Scoreboard: An elegant, built-in sidebar leaderboard that can be fully toggled or customized.
• PlaceholderAPI Support: Use %tomdeathleaderboard_deaths% to show death stats in any other plugin (Chat, Tablist, or Custom Scoreboards).
• Smart Tab-Completion: Full auto-complete for all player and admin subcommands.
• Performance Optimized: Uses asynchronous tasks and efficient stream API sorting to prevent any server lag or TPS drops.
• bStats Integrated: Includes safe built-in anonymous metrics.

📜 Commands & Permissions

👥 Player Commands

• /topdeaths - View the Top 10 player deaths leaderboard in chat.
  • Permission: tomdeathleaderboard.view (Default: everyone)
• /deaths - Check your own total death count.
  • Permission: tomdeathleaderboard.view
• /deaths <player> - Check another player's total deaths.
  • Permission: tomdeathleaderboard.view
• /deaths toggle - Turn the sidebar scoreboard leaderboard on or off for yourself.
  • Permission: tomdeathleaderboard.view

🛠️ Admin Commands

• /deathadmin set <player> <amount> - Hand-modify a player's death count.
  • Permission: tomdeathleaderboard.admin (Default: OP)
• /deathadmin reset <player> - Reset a specific player's deaths to 0.
  • Permission: tomdeathleaderboard.admin
• /deathadmin reload - Reload the config.yml settings instantly without restarting the server.
  • Permission: tomdeathleaderboard.admin

⚙️ Configuration (config.yml)

# TomDeathLeaderboard Configuration

scoreboard-leaderboard:
  # If true, the top death leaderboard will be displayed on the right side of the screen (sidebar)
  enabled: true
  # The title of the Scoreboard (Supports classic color codes with &)
  title: "&6&lServer Leaderboard"
  # The maximum number of players to show on the scoreboard (max 15)
  slots: 10

Made with 🩵 by Thomas