CombatStats

# ⚔️ CombatStats ### **The ultimate PvP statistics, leaderboards and milestone system for modern Minecraft servers.** CombatStats is a modern, high-performance Minecraft plugin that tracks player combat activity, playtime, and economy progression. Featuring interactive GUI leaderboards, automated milestone rewards, PlaceholderAPI support, and database synchronization, CombatStats gives server owners everything they need to create a competitive and rewarding player experience. Whether you're running a **Survival**, **Lifesteal**, **SMP**, **Factions**, **Practice**, or **PvP** server, CombatStats helps keep players engaged through rankings, achievements, and progression systems. --- # 🌟 Features ## 📊 Comprehensive Statistics Tracking CombatStats automatically tracks: * Kills * Deaths * Kill/Death Ratio (KD) * Current Killstreak * Best Killstreak * Playtime * Economy Balance (via ExcellentEconomy) All statistics are stored efficiently and can be displayed through commands, placeholders, GUIs, scoreboards, holograms, and more. --- ## 🏆 Interactive Leaderboards Display your server's top players through beautiful inventory GUIs. ### Supported Rankings * Top Kills * Top Deaths * Top KD Ratio * Top Killstreak * Top Best Killstreak * Top Playtime * Top Balance ### Features ✔ Clickable player heads ✔ Real-time updates ✔ Dynamic sorting directly inside the GUI ✔ Offline player support ✔ Pagination support ✔ Fast database queries --- ## 💰 Economy Integration CombatStats integrates seamlessly with ExcellentEconomy. ### Features * Supports ExcellentEconomy * Wealth leaderboards via `/baltop` * Balance-based milestones * Economy placeholders No manual PlaceholderAPI expansion downloads are required. --- ## 🎯 Automated Milestone Rewards Reward your players automatically when they reach important milestones. ### Supported Milestone Types * Kills * Balance * Playtime ### Actions * Execute console commands * Execute player commands * Broadcast achievements * Grant ranks * Give rewards * Trigger custom server events ### Example ```yaml milestones: veteran_killer: type: kills value: 500 commands: - "console: broadcast &6%player% &ehas reached &c500 kills&e!" - "console: give %player% netherite_ingot 1" ``` --- ## 🗄 Database Support CombatStats supports multiple storage options. ### SQLite (Default) Perfect for: * Small servers * SMP servers * Single-instance setups ### MySQL Perfect for: * Networks * BungeeCord setups * Velocity setups * Shared statistics across multiple servers ### Benefits * Fast synchronization * Reliable storage * Multi-server compatibility --- ## 🔌 PlaceholderAPI Support CombatStats includes a powerful PlaceholderAPI expansion. ### Player Statistics | Placeholder | Description | | -------------------------------------- | ------------------- | | `%combatstats_player_kills%` | Total kills | | `%combatstats_player_deaths%` | Total deaths | | `%combatstats_player_kd%` | Kill/Death ratio | | `%combatstats_player_playtime%` | Playtime in seconds | | `%combatstats_player_killstreak%` | Current killstreak | | `%combatstats_player_best_killstreak%` | Best killstreak | | `%combatstats_player_balance%` | Current balance | ### Ranking Placeholders | Placeholder | Description | | ----------------------------------- | --------------- | | `%combatstats_player_rank_kills%` | Kill ranking | | `%combatstats_player_rank_kd%` | KD ranking | | `%combatstats_player_rank_balance%` | Balance ranking | ### Top Leaderboard Placeholders **Pattern** ```text %combatstats_player_<type>_<rank>_alltime_<name/value>% ``` **Examples** ```text %combatstats_player_kills_1_alltime_name% %combatstats_player_kills_1_alltime_value% %combatstats_player_kd_1_alltime_name% %combatstats_player_kd_1_alltime_value% %combatstats_player_balance_1_alltime_name% %combatstats_player_balance_1_alltime_value% ``` ### Supported Types * kills * deaths * kd * killstreak * best_killstreak * playtime * balance Perfect for: * Scoreboards * Holograms * Chat formatting * TAB lists * Custom GUIs --- ## 🛠 Administration Tools Manage player statistics directly in-game. ### Features * Set player statistics * Reset player statistics * Reload configuration * Placeholder debugging * Full tab completion * Offline player support --- ## 🔄 Update Checker CombatStats can notify administrators when a new version becomes available. ### Benefits * Stay up to date * Security improvements * New features * Bug fixes --- # 💻 Commands & Permissions | Command | Alias | Description | Permission | | --------------------------------- | ----------- | ------------------------------- | -------------------- | | `/stats` | `/cs` | Open