Combat Master

<div align="center"> # ⚔️ Combat Master **Advanced combat tracking and statistics system for Minecraft** (https://img.shields.io/badge/version-v2.0.0-blue.svg)](https://github.com/amhunter1/Combat-Master) (https://img.shields.io/badge/bStats-28408-brightgreen.svg)](https://bstats.org/plugin/bukkit/Combat-Master/28408) (https://img.shields.io/badge/Java-17%2B-orange.svg)](https://adoptium.net/) (https://img.shields.io/badge/Minecraft-1.20%2B-green.svg)](https://www.spigotmc.org/) (https://modrinth.com/plugin/combat-master) • (https://github.com/amhunter1/Combat-Master/wiki) • (https://discord.com/users/871721944268038175) </div> --- ## 🌟 Key Features - **🎨 Modern GUI System** - Fully customizable interfaces with smooth transitions - **🏆 Advanced Combo System** - Real-time tracking with level-based color codes and sound effects - **📊 Detailed Statistics** - Comprehensive performance metrics and leaderboards - **⚙️ Admin Tools** - Powerful management panel with bulk operations - **🌍 Multi-language Support** - Turkish and English with easy customization - **💾 Flexible Database** - SQLite (default) or MySQL with HikariCP connection pooling - **🔌 PlaceholderAPI Integration** - Full PAPI support for other plugins --- ## 🚀 Quick Start ### Requirements - **Java**: 17 or higher - **Server**: Spigot/Paper 1.20+ - **RAM**: Minimum 512MB (recommended: 1GB+) - **PlaceholderAPI**: Optional ### Installation 1. Download the latest version from (https://modrinth.com/plugin/combat-master) 2. Place `Combat-Master-v2.0.0.jar` in your `plugins/` folder 3. Start/restart your server 4. Configure settings in `plugins/Combat-Master/config.yml` --- ## 🎮 Main Systems ### Combat & Combo System **Combo Levels:** - 🟫 1-5: Beginner (Gray) - ⚪ 6-10: Developing (White) - 🟡 11-20: Good (Yellow) - 🟠 21-35: Great (Orange) - 🔴 36-50: Perfect (Red) - 🟣 51-75: Legendary (Purple) - 🔵 76-100: Epic (Blue) - 🌟 100+: Godlike (Rainbow) **Features:** - Automatic combo reset after 10 seconds - Dynamic sound effects based on combo level - Action bar display with real-time stats - Reset on damage taken ### GUI Menu System - **Main Hub**: Central control panel for all features - **Stats Panel**: Detailed performance metrics and analysis - **Leaderboards**: Paginated rankings (21 players per page) - **Admin Panel**: Complete management interface --- ## 💬 Commands | Command | Description | Permission | |---------|-------------|------------| | `/combatmaster` | Open main menu | `combatmaster.use` | | `/cm` | Short command | `combatmaster.use` | | `/cm stats` | View statistics | `combatmaster.use` | | `/cm top` | View leaderboards | `combatmaster.use` | | `/cm reload` | Reload plugin | `combatmaster.admin` | | `/cm reset <player>` | Reset player combo | `combatmaster.admin` | | `/cm reset all` | Reset all combos | `combatmaster.admin` | --- ## 📊 PlaceholderAPI | Placeholder | Description | Example | |-------------|-------------|---------| | `%combatmaster_combo%` | Current combo | `25` | | `%combatmaster_best_combo%` | Best combo | `87` | | `%combatmaster_total_hits%` | Total hits | `1,337` | | `%combatmaster_rank%` | Leaderboard rank | `#3` | | `%combatmaster_level%` | Combat level | `Legendary` | --- ## ⚙️ Configuration ```yaml # Language (en/tr) language: "en" # Combat settings combat: combo: timeout-seconds: 10 reset-on-damage: true actionbar: enabled: true # Database database: type: "sqlite" # or "mysql" # Worlds worlds: enabled-worlds: # Empty = all worlds ``` --- ## 🔄 Updates ### v2.0.0 - Major Update **New Features:** - ✨ Completely redesigned GUI system - 🎨 Modern menu designs - ⚡ Enhanced performance - 🔧 Advanced admin tools - 📊 Detailed system monitor **Fixes:** - 🐛 Placeholder rendering issues - 🎨 Color code display bugs - 💾 Database connection stability --- ## 📈 Statistics <div align="center"> (https://bstats.org/signatures/bukkit/Combat-Master.svg)](https://bstats.org/plugin/bukkit/Combat-Master/28408) (https://bstats.org/plugin/bukkit/Combat-Master/28408) </div> --- ## 💝 Support <div align="center"> ### 🤝 Support the Project ⭐ Star this repository • 🐛 Report bugs • 💡 Request features • 🤝 Contribute code ### 📞 Contact - **Discord**: (https://discord.com/users/871721944268038175) - **GitHub**: (https://github.com/amhunter1/Combat-Master) - **Download**: (https://modrinth.com/plugin/combat-master) </div> --- <div align="center"> **Made by (https://github.com/amhunter1)** *Thanks for using Combat Master! 🎮* </div>