⚔️ 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
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
%combatstats_player_<type>_<rank>_alltime_<name/value>%
Examples
%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 the statistics GUI | combatstats.use |
/stats <player> |
- | View detailed player statistics | combatstats.others |
/baltop |
/moneytop |
Open the balance leaderboard | combatstats.baltop |
/cs placeholder |
- | Show available placeholders | combatstats.use |
/cs reload |
- | Reload the plugin | combatstats.admin |
/cs set <player> <stat> <value> |
- | Set a player statistic | combatstats.admin |
/cs reset <player> |
- | Reset all player statistics | combatstats.admin |
⚙ Example Configuration
milestones:
veteran_killer:
type: kills
value: 500
commands:
- "console: broadcast &6%player% &ehas reached &c500 kills&e!"
- "console: give %player% netherite_ingot 1"
millionaire:
type: balance
value: 1000000
commands:
- "console: lp user %player% parent add rich_rank"
- "player: msg %player% &aYou are now a millionaire!"
⚖ Legal & API Usage
CombatStats integrates with ExcellentEconomy through its official public API.
Important
- No source code has been copied from ExcellentEconomy.
- CombatStats uses legal API hooks only.
- CombatStats is an independent project.
- CombatStats is not affiliated with, endorsed by, or associated with NightExpress.
📦 Requirements
Required
- Minecraft 1.21.11+
- Java 21+
- PlaceholderAPI
Optional
- ExcellentEconomy (for economy leaderboards and balance milestones)
🚀 Installation
1. Install Dependencies
Place the following plugins into your server's plugins folder:
- CombatStats
- PlaceholderAPI
- ExcellentEconomy (optional)
2. Start Your Server
CombatStats will automatically generate all required configuration files.
3. Configure Storage
Choose between:
- SQLite (default)
- MySQL
4. Restart or Reload
After configuration, restart the server or reload CombatStats.
5. Enjoy
Your statistics system, leaderboards, placeholders, and milestone rewards are now fully operational.
💬 Support & Community
Need help, found a bug, or want to suggest a feature?
Join the official Discord server:
❤️ Developed by FelixFGF
Create competition. Reward progression. Keep players engaged. CombatStats does it all. ⚔️🏆📊
