⚔️ 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

Ranking Placeholders

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

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