⚔️ 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. ⚔️🏆📊