Skip to content

A Minecraft plugin that tracks every hit during combat. Each hit is counted and displayed, providing a simple hit counter system.

License

Notifications You must be signed in to change notification settings

amhunter1/Combat-Master

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

⚔️ Combat Master

Minecraft için gelişmiş combat tracking ve istatistik sistemi

Version bStats Java Minecraft License

📥 İndir📖 Wiki💬 Discord🐛 Issues


🌟 Öne Çıkan Özellikler

🎨 Modern GUI Sistemi

  • Tamamen özelleştirilebilir arayüzler
  • Akıcı menü geçişleri
  • Responsive tasarım
  • Çoklu sayfa desteği

🏆 Combo Sistemi

  • Gerçek zamanlı combo takibi
  • Seviye bazlı renk kodları
  • Ses efektleri ve animasyonlar
  • Otomatik reset sistemi

📊 İstatistik Analizi

  • Detaylı performans metrikleri
  • Sıralama sistemleri
  • İlerleme takibi
  • Karşılaştırmalı analizler

⚙️ Admin Araçları

  • Kapsamlı yönetim paneli
  • Toplu işlem desteği
  • Sistem monitörü
  • Otomatik backup

🚀 Hızlı Başlangıç

📋 Gereksinimler

  • Java: 17 veya üzeri
  • Sunucu: Spigot/Paper 1.20+
  • RAM: En az 512MB (önerilen: 1GB+)
  • PlaceholderAPI: İsteğe bağlı

Kurulum

  1. Plugin'i İndirin

    wget https://github.com/amhunter1/Combat-Master/releases/latest/Combat-Master-v2.0.0.jar
  2. Sunucuya Kurun

    mv Combat-Master-v2.0.0.jar plugins/
  3. Sunucuyu Başlatın

    # Otomatik konfigürasyon oluşturulacak
    java -jar spigot.jar
  4. Ayarları Yapın

    # plugins/Combat-Master/config.yml
    language: "tr"  # Türkçe için
    enabled-worlds: []  # Tüm dünyalar için boş bırakın

🎮 Ana Sistemler

🖥️ GUI Menü Sistemi

Combat Master'ın kalbi olan GUI sistemi, kullanıcıların tüm özelliklere kolay erişim sağlamasını mümkün kılar:

📱 Ana Menü Hub
  • Merkezi Kontrol: Tüm özelliklere tek noktadan erişim
  • Dinamik İçerik: Gerçek zamanlı veri güncellemeleri
  • Kullanıcı Dostu: Sezgisel navigasyon sistemi
  • Hızlı Erişim: Favorilerinizi kaydedin
/combatmaster        # Ana menüyü açar
/cm                  # Kısa versiyon
📈 İstatistik Paneli
  • Performans Metrikleri: Combo, hit, seviye analizi
  • Görsel Grafikler: İlerleme çubukları ve renk kodları
  • Karşılaştırma: Diğer oyuncularla performans kıyası
  • Geçmiş Veriler: Zaman bazlı istatistik görüntüleme

Özellikler:

  • ⚔️ En İyi Combo Skoru
  • 💎 Toplam Hit Sayısı
  • 📊 Seviye ve İlerleme
  • 🏅 Sıralama Pozisyonu
🏆 Liderlik Tablosu
  • Sayfalı Sistem: 21 oyuncu/sayfa
  • Real-time Updates: Canlı sıralama güncellemeleri
  • Filtreleme: Farklı kategorilerde sıralama
  • Ödül Sistemi: Top 3 için özel efektler

Kategoriler:

  • 🥇 En İyi Combo
  • 🎯 Toplam Hit
  • ⚡ Aktif Oyuncular

⚔️ Combat Sistemi

Gelişmiş combat tracking sistemi ile oyuncu performansını detaylı şekilde takip edin:

🎯 Combo Mekanikleri

Combo Hesaplama:

// Her başarılı hit combo'yu artırır
hit -> combo++

// Belirli süre sonra reset
timeout(10s) -> combo = 0

// Hasar alma durumunda reset
damage_taken -> combo = 0

Combo Seviyeleri:

  • 🟫 1-5: Başlangıç (Gri)
  • 6-10: Gelişen (Beyaz)
  • 🟡 11-20: İyi (Sarı)
  • 🟠 21-35: Harika (Turuncu)
  • 🔴 36-50: Mükemmel (Kırmızı)
  • 🟣 51-75: Efsanevi (Mor)
  • 🔵 76-100: Destansı (Mavi)
  • 🌟 100+: Tanrısal (Gökkuşağı)
🔊 Ses ve Efekt Sistemi

Dinamik Ses Efektleri:

  • Düşük Combo (1-10): ENTITY_PLAYER_ATTACK_STRONG
  • Orta Combo (11-25): ENTITY_EXPERIENCE_ORB_PICKUP
  • Yüksek Combo (26-50): ENTITY_PLAYER_LEVELUP
  • Epic Combo (51+): ENTITY_ENDER_DRAGON_GROWL

Action Bar Mesajları:

⚔️ Combo: 25 | 🎯 Hit: 1,337 | 🏅 Sıra: #3
🌍 Dünya Yönetimi

Esnek Aktivasyon:

enabled-worlds:
  - "world"      # Ana dünya
  - "pvp_arena"  # PvP arenası
  # Boş liste = tüm dünyalar aktif

Özel Ayarlar:

  • Mob vuruşları dahil/hariç
  • Kritik vuruş zorunluluğu
  • Yerden vuruş kontrolü
  • Oyuncu vs oyuncu sınırları

🛠️ Admin Yönetim Sistemi

Güçlü admin araçları ile sunucunuzu tam kontrol altında tutun:

👥 Oyuncu Yönetimi

Canlı Oyuncu Takibi:

  • 📊 Real-time istatistikler
  • ⚡ Aktif combo durumları
  • 🎮 Oyuncu profil analizi
  • 🔧 Tek tık combo reset

Toplu İşlemler:

# Tüm combo'ları sıfırla
/combatmaster reset all

# Belirli oyuncuyu sıfırla  
/combatmaster reset <oyuncu>

# Toplu istatistik görüntüleme
/combatmaster bulk-stats
⚡ Hızlı Komutlar

One-Click İşlemler:

  • 💥 Tüm Combo Reset: Sunucu geneli sıfırlama
  • 🚫 Menü Kapatma: Tüm açık menüleri kapat
  • 🔄 Plugin Reload: Hot-reload sistemi
  • 💾 Veri Kaydetme: Manuel backup
  • 🧹 Cache Temizleme: Bellek optimizasyonu
  • 🚨 Acil Durdurma: Güvenli plugin kapatma
📊 Sistem Monitörü

Performance Dashboard:

🖥️ Sistem Bilgileri:
├── Java: OpenJDK 17.0.2
├── Bellek: 2.1GB / 4.0GB (52%)
├── CPU: 8 cores @ 2.4GHz
└── Uptime: 3d 14h 22m

⚡ Plugin Metrikleri:  
├── Açık Menüler: 23/50
├── Aktif Combo'lar: 8
├── Database: SQLite (OK)
└── bStats: Enabled

🗄️ Database & Performans

💾 Veri Yönetimi

Database Seçenekleri

SQLite (Varsayılan):

database:
  type: "sqlite"
  sqlite:
    file: "combatmaster.db"
    backup-interval: 24h

MySQL (Gelişmiş):

database:
  type: "mysql"
  mysql:
    host: "localhost"
    port: 3306
    database: "combatmaster"
    username: "user"
    password: "pass"
    pool-size: 10
Performans Optimizasyonları

HikariCP Connection Pool:

  • ⚡ Ultra hızlı bağlantı yönetimi
  • 🔄 Otomatik bağlantı yenileme
  • 📊 Real-time pool monitoring
  • 🛡️ Connection leak detection

Memory Management:

  • 🧠 Akıllı cache sistemi
  • 🔥 Hot-data caching
  • 🗑️ Otomatik garbage collection
  • 📈 Memory usage monitoring

🌍 Çoklu Dil Desteği

🔤 Desteklenen Diller

🇹🇷
Türkçe
language: "tr"
🇬🇧
English
language: "en"

🔧 Dil Özelleştirme

Dil Dosyası Yapısı:

# plugins/Combat-Master/lang/tr.yml
gui:
  titles:
    main: "&6&l⚔ Combat Master Hub ⚔"
    stats: "&e⚡ {0} İstatistikleri"
    
  items:
    best_combo: "&6🏆 En İyi Combo"
    total_hits: "&b💎 Toplam Hit"
    
combo_descriptions:
  legendary: "Efsanevi seviye! İnanılmaz."
  godlike: "Tanrısal güç! Sınırları aştınız!"

Fallback Sistemi:

İngilizce mesaj bulunamadı → Türkçe'ye fallback → Varsayılan mesaj

🎯 Komutlar ve İzinler

💬 Oyuncu Komutları

Komut Açıklama İzin
/combatmaster Ana menüyü açar combatmaster.use
/combatmaster gui Ana menüyü açar combatmaster.use
/combatmaster stats İstatistik menüsü combatmaster.use
/combatmaster top Liderlik tablosu combatmaster.use
/cm Kısa komut combatmaster.use

⚙️ Admin Komutları

Komut Açıklama İzin
/combatmaster reload Plugin'i yeniden yükle combatmaster.admin
/combatmaster reset <oyuncu> Oyuncu combo'sunu sıfırla combatmaster.admin
/combatmaster reset all Tüm combo'ları sıfırla combatmaster.admin
/combatmaster info Plugin bilgilerini göster combatmaster.admin

🔐 İzin Sistemi

permissions:
  combatmaster.use:
    description: "Temel Combat Master kullanımı"
    default: true
    
  combatmaster.admin:
    description: "Admin panel erişimi"
    default: op
    children:
      - combatmaster.use
      - combatmaster.reload
      - combatmaster.reset

🔧 Konfigürasyon

⚙️ Ana Ayarlar

config.yml - Tam Konfigürasyon
# ============================================
#           COMBAT MASTER v2.0.0
#     Gelişmiş Combat Tracking Plugin'i
# ============================================

# Dil Ayarları
language: "tr"  # Desteklenen: tr, en

# GUI Sistemi
gui:
  # Ses Efektleri
  sounds:
    enabled: true
    open-sound: "BLOCK_CHEST_OPEN"
    click-sound: "UI_BUTTON_CLICK"
    success-sound: "ENTITY_EXPERIENCE_ORB_PICKUP"
    error-sound: "ENTITY_VILLAGER_NO"
    
  # Performans Ayarları
  performance:
    auto-refresh-interval: 30  # Saniye
    max-open-menus: 50
    cache-duration: 300        # Saniye
    
  # Görünüm
  appearance:
    use-borders: true
    items-per-page: 21
    animated-items: true

# Combat Sistemi
combat:
  # Combo Ayarları
  combo:
    timeout-seconds: 10
    reset-on-damage: true
    
    # Renk Sistemi
    color-system:
      enabled: true
      colors:
        1-5: "&7"      # Gri
        6-10: "&f"     # Beyaz
        11-20: "&e"    # Sarı
        21-35: "&6"    # Turuncu
        36-50: "&c"    # Kırmızı
        51-75: "&d"    # Pembe
        76-100: "&5"   # Mor
        101+: "&b"     # Açık Mavi
    
    # Mesaj Sistemi
    messages:
      enabled: true
      interval: 5  # Her 5 combo'da bir mesaj
      
  # Action Bar
  actionbar:
    enabled: true
    format: "⚔️ Combo: {combo} | 🎯 Hit: {hits} | 🏅 Sıra: #{rank}"
    
  # Ses Efektleri
  sounds:
    enabled: true
    combo-sounds:
      low:    {sound: "ENTITY_PLAYER_ATTACK_STRONG", volume: 0.8, pitch: 1.0}
      medium: {sound: "ENTITY_EXPERIENCE_ORB_PICKUP", volume: 1.0, pitch: 1.2}
      high:   {sound: "ENTITY_PLAYER_LEVELUP", volume: 1.2, pitch: 1.5}
      epic:   {sound: "ENTITY_ENDER_DRAGON_GROWL", volume: 1.5, pitch: 2.0}
      
    reset-sound: {sound: "ENTITY_ITEM_BREAK", volume: 0.6, pitch: 0.8}

# Dünya Ayarları
worlds:
  enabled-worlds: []  # Boş = tüm dünyalar, örnek: ["world", "world_nether"]
  
# Hit Ayarları  
hits:
  count-mob-hits: true
  count-ground-hits: false
  critical-only: false
  
# Database
database:
  type: "sqlite"  # sqlite veya mysql
  
  sqlite:
    file: "combatmaster.db"
    backup:
      enabled: true
      interval-hours: 24
      keep-backups: 7
      
  mysql:
    host: "localhost"
    port: 3306
    database: "combatmaster"
    username: "root"
    password: ""
    pool-size: 10
    timeout: 5000
    
# Liderlik Tablosu
leaderboard:
  size: 100
  update-interval: 60  # Saniye
  
# bStats Analytics
metrics:
  enabled: true
  plugin-id: 28408

# Debug
debug:
  enabled: false
  log-combo-events: false
  log-database-queries: false

📈 PlaceholderAPI Entegrasyonu

🏷️ Mevcut Placeholders

Placeholder Açıklama Örnek
%combatmaster_combo% Mevcut combo 25
%combatmaster_best_combo% En iyi combo 87
%combatmaster_total_hits% Toplam hit 1,337
%combatmaster_rank% Sıralamadaki yer #3
%combatmaster_level% Combat seviyesi Efsanevi

📊 Kullanım Örneği

# TAB plugin ile kullanım
scoreboard:
  title: "&6Combat Stats"
  lines:
    - "&eCombo: &c%combatmaster_combo%"
    - "&eBest: &6%combatmaster_best_combo%"
    - "&eRank: &a%combatmaster_rank%"

🚨 Sorun Giderme

Sık Sorulan Sorular

Q: Menüler açılmıyor, ne yapmalıyım?

Çözüm Adımları:

  1. İzinleri kontrol edin: /lp user <oyuncu> permission check combatmaster.use
  2. Console'da hata mesajları var mı kontrol edin
  3. Plugin'in düzgün yüklendiğini doğrulayın: /plugins
  4. Config dosyasının syntax hatası var mı kontrol edin
Q: Combo değerleri gösterilmiyor?

Olası Nedenler:

  • Database bağlantı sorunu
  • Dünya ayarlarında bu dünya aktif değil
  • Hit detection ayarları yanlış

Çözüm:

/combatmaster reload  # Plugin'i yeniden yükle
Q: Dil değişiklikleri uygulanmıyor?

Adımlar:

  1. config.yml'de language: "tr" veya "en" olarak ayarlayın
  2. /combatmaster reload komutunu çalıştırın
  3. Hala çalışmıyorsa sunucuyu restart edin
Q: Performans sorunları yaşıyorum?

Optimizasyon:

# config.yml
gui:
  performance:
    max-open-menus: 25      # Düşürün
    cache-duration: 600     # Artırın
    
leaderboard:
  update-interval: 120      # Artırın
  
database:
  mysql:
    pool-size: 5            # Düşürün

🔄 Güncelleme Geçmişi

🆕 v2.0.0 - Major Update

🎉 Yeni Özellikler:

  • ✨ Tamamen yenilenmiş GUI sistemi
  • 🎨 Modern menü tasarımları
  • ⚡ Geliştirilmiş performans
  • 🔧 Advanced admin araçları
  • 📊 Detaylı sistem monitörü

🛠️ Düzeltmeler:

  • 🐛 Placeholder rendering sorunları
  • 🎨 Renk kodu görüntüleme hataları
  • 📱 Menü pozisyonlama sorunları
  • 💾 Database bağlantı istikrarı

⚠️ Breaking Changes:

  • Config formatı güncellendi
  • Bazı komutlar değişti
  • Database schema güncellemesi gerekli

👨‍💻 Geliştirici Bilgileri

📁 Proje Yapısı

Combat-Master/
├── 📂 src/main/java/com/melut/combatmaster/
│   ├── 📂 gui/                    # GUI Framework
│   │   ├── 📄 BaseGUI.java       # Base menü sınıfı
│   │   ├── 📄 MenuManager.java   # Menü yöneticisi
│   │   ├── 📄 MenuListener.java  # Click handler
│   │   ├── 📂 utils/             # GUI yardımcıları
│   │   └── 📂 menus/             # Menü implementasyonları
│   │       ├── 📄 MainMenu.java
│   │       ├── 📄 StatsMenu.java
│   │       ├── 📄 LeaderboardMenu.java
│   │       └── 📄 AdminMenu.java
│   ├── 📂 managers/              # Core yöneticiler
│   │   ├── 📄 CombatManager.java # Combat logic
│   │   ├── 📄 ConfigManager.java # Config handler
│   │   └── 📄 LangManager.java   # Dil sistemi
│   ├── 📂 database/              # Database katmanı
│   │   └── 📄 DatabaseManager.java
│   ├── 📂 listeners/             # Event listeners
│   │   └── 📄 CombatListener.java
│   ├── 📂 commands/              # Komut handlers
│   │   └── 📄 CombatMasterCommand.java
│   └── 📄 CombatMaster.java      # Ana plugin sınıfı
│
├── 📂 src/main/resources/
│   ├── 📄 config.yml            # Ana konfigürasyon
│   ├── 📄 plugin.yml           # Plugin metadata
│   └── 📂 lang/               # Dil dosyaları
│       ├── 📄 tr.yml         # Türkçe
│       └── 📄 en.yml         # İngilizce
│
└── 📄 pom.xml                  # Maven konfigürasyonu

🛠️ Build ve Geliştirme

# Projeyi klonla
git clone https://github.com/amhunter1/Combat-Master.git
cd Combat-Master

# Maven ile build
mvn clean compile package

# Test sunucusunda çalıştır
java -jar target/Combat-Master-v2.0.0.jar

Gereksinimler:

  • Java 17+ SDK
  • Maven 3.8+
  • Git

📊 İstatistikler ve Analytics


💝 Destek ve Katkı

🤝 Projeye Destek Olun


Star
Repo'yu yıldızlayın
🐛
Issues
Bug raporlayın
💡
Feature Request
Özellik önerin
🤝
Contribute
Kod katkısı yapın

📞 İletişim Kanalları

🔗 Links


📄 Lisans

Bu proje kapalı kaynak kodludur. Tüm hakları geliştiriciye aittir. Dağıtım ve kullanım koşulları için lütfen lisans dosyasını kontrol ediniz.


⚔️ Combat Master v2.0.0

Gelişmiş Combat Tracking Sistemi

Made with ❤️ by Melut


En iyi combat deneyimi için teşekkürler! 🎮

About

A Minecraft plugin that tracks every hit during combat. Each hit is counted and displayed, providing a simple hit counter system.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages