LBKitPvP

Video : https://youtu.be/fgZayZ99dEo

## 📋 Özellikler

### ⚔️ Temel Sistem
- **Başlangıç Kiti**: Oyuncular demir kılıç, yay, 30 ok ve zincir zırh ile başlar
- **Seviye Sistemi**: Sonsuz seviye ilerlemesi (XP kazanarak)
- **ELO Sistemi**: Rekabetçi sıralama sistemi
- **Altın Ekonomisi**: Öldürme ile altın kazan, yükseltme ve market için harca
- **İstatistikler**: Öldürme, ölme, K/D oranı takibi

### 🎯 Yükseltme Sistemi

#### Tek Seferlik Yükseltmeler
- **Altın Kafa** (5.000 Altın): Adam öldürünce altın kafa kazan, güçlü iyileştirme efektleri
- **Balıkçı** (3.000 Altın): Olta ile başla, düşmanları çek

#### Otomatik Yükseltmeler
- **Güvenlik**: Spawn'da kask ile başla (Ücretsiz)
- **Sonsuz Okçu**: Ok ile öldürünce +3 ok kazan (Ücretsiz)

#### Seviye Bazlı Yükseltmeler (Max 5 Seviye)
- **XP Yükseltici**: Seviye başına +10 XP (1.000 → 16.000 Altın)
- **Altın Yükseltici**: Seviye başına +10 Altın (1.000 → 16.000 Altın)
- **Ekstra Yakın Hasar**: Seviye başına +2% hasar (2.000 → 32.000 Altın)
- **Ekstra Koruma**: Seviye başına -2% hasar alma (2.000 → 32.000 Altın)
- **Ekstra Ok Hasarı**: Seviye başına +3% ok hasarı (2.000 → 32.000 Altın)

### � Market Sistemi
- **Elmas Göğüslük** (10.000 Altın)
- **Elmas Bot** (8.000 Altın)
- **2 Ok** (500 Altın)
- **Elmas Kılıç** (15.000 Altın)

*Not: Market itemleri ölünce silinir*

### ⚡ Combat Tag Sistemi
- 10 saniye combat süresi
- Actionbar ile geri sayım
- Combat'tayken komut engelleme
- Çıkış yapınca otomatik ölüm
- Ok ve melee hasarı ile aktif olur

### 🎨 Seviye Renk Sistemi
- **0-20**: §7Gri
- **20-40**: §aYeşil
- **40-60**: §eSarı
- **60-80**: §cKırmızı
- **80-100**: §5Mor
- **100+**: §fBeyaz

### � Sıralama Sistemi
- En çok öldüren (Top 10)
- En yüksek ELO (Top 10)
- En yüksek K/D (Top 10)
- En yüksek seviye (Top 10)

### 💫 Özel Efektler
- **Seviye Atlama**: Title, ses efektleri, havai fişek
- **Yükseltme**: Actionbar mesajı, ses efektleri
- **Hasar Göstergesi**: Floating hologram ile hasar gösterimi
- **Altın Kafa**: Geğirme sesi ile kullanım

---

## 📦 Kurulum

1. Plugin JAR dosyasını `plugins` klasörüne atın
2. Sunucuyu başlatın
3. `/spawnayarla` komutu ile spawn noktasını ayarlayın
4. `config.yml` ve `messages.yml` dosyalarını özelleştirin

### Gereksinimler
- **Minecraft**: 1.20+
- **Spigot/Paper**: 1.20+

### Opsiyonel Bağımlılıklar
- **PlaceholderAPI**: Placeholder desteği için
- **FancyHolograms**: Sıralama hologramları için
- **FancyNpcs**: NPC entegrasyonu için

---

## 🎮 Komutlar

### Oyuncu Komutları
| Komut | Açıklama | İzin |
|-------|----------|------|
| `/upgrade` | Yükseltme menüsünü açar | `kitpvp.upgrade` |
| `/market` | Market menüsünü açar | `kitpvp.market` |
| `/spawn` | Spawn noktasına ışınlanır | `kitpvp.spawn` |

### Admin Komutları
| Komut | Açıklama | İzin |
|-------|----------|------|
| `/spawnayarla` | Spawn noktasını ayarlar | `kitpvp.setspawn` |
| `/altinekle <oyuncu> <miktar>` | Oyuncuya altın ekler | `kitpvp.addgold` |
| `/seviye-ekle <oyuncu> <miktar>` | Oyuncuya seviye ekler | `kitpvp.addlevel` |

---

## 📊 PlaceholderAPI

### Oyuncu İstatistikleri
```
%kitpvp_level% - Seviye numarası
%kitpvp_level_colored% - Renkli seviye
%kitpvp_level_prefix% - Köşeli parantezli prefix [25]
%kitpvp_exp% - Mevcut XP
%kitpvp_exp_required% - Gereken XP
%kitpvp_exp_progress% - XP ilerlemesi (150/200)
%kitpvp_elo% - ELO puanı
%kitpvp_gold% - Altın miktarı
%kitpvp_kills% - Öldürme sayısı
%kitpvp_deaths% - Ölme sayısı
%kitpvp_kd% - K/D oranı
```

### Sıralama (Top 1-10)
```
%kitpvp_top_kills_1% - En çok öldüren 1.
%kitpvp_top_elo_1% - En yüksek ELO 1.
%kitpvp_top_kd_1% - En yüksek K/D 1.
%kitpvp_top_level_1% - En yüksek seviye 1.
```

### Chat Örneği
```yaml
format: '%kitpvp_level_prefix% &f%player_name%&7: &f%message%'
# Sonuç: §a[25] CanBye§7: Merhaba!
```

---

## ⚙️ Yapılandırma

### config.yml
Tüm teknik ayarlar burada:
- Başlangıç kiti itemleri ve slotları
- Yükseltme fiyatları ve bonusları
- Market itemleri ve fiyatları
- ELO sistemi değerleri
- Combat tag süresi ve ayarları
- Scoreboard satırları ve formatı
- Seviye renkleri

### messages.yml
Tüm mesajlar ve metinler burada:
- Yükseltme mesajları
- Market mesajları
- Combat tag mesajları
- Seviye atlama mesajları
- Sıralama formatları

---

## 🎯 Özelleştirme Örnekleri

### Scoreboard Özelleştirme
```yaml
scoreboard:
  enabled: true
  title: "§c§lMY SERVER"
  lines:
    - "§7━━━━━━━━━━━━━━"
    - "§6Level: §e{level}"
    - "§6Gold: §e{gold}"
    - "§6Kills: §e{kills}"
    - "§7━━━━━━━━━━━━━━"
```

### Yükseltme Fiyatları
```yaml
upgrades:
  golden-head:
    cost: 10000  # Fiyatı değiştir
  xp-booster:
    cost-per-level: [2000, 4000, 8000, 16000, 32000]  # Her seviye için
```

### Combat Tag Süresi
```yaml
combat-tag:
  duration: 15  # 15 saniye yap
  blocked-commands:
    - "spawn"
    - "home"
    - "warp"
```

---

## 🎨 Hologram Kurulumu

### Seviye Renkleri Hologramı
```
§6§l⚔ SEVİYE SİSTEMİ ⚔

§7Seviye §70-20 §8→ §7Gri
§aSeviye §a20-40 §8→ §aYeşil
§eSeviye §e40-60 §8→ §eSarı
§cSeviye §c60-80 §8→ §cKırmızı
§5Seviye §580-100 §8→ §5Mor
§fSeviye §f100+ §8→ §fBeyaz

§7Adam öldürerek §eXP §7kazan!
```

### Sıralama Hologramı (Örnek)
```
§6§l⭐ EN ÇOK ÖLDÜREN ⭐

%kitpvp_top_kills_1%
%kitpvp_top_kills_2%
%kitpvp_top_kills_3%
%kitpvp_top_kills_4%
%kitpvp_top_kills_5%
```

---

## 🐛 Sorun Giderme

### Plugin yüklenmiyor
- Minecraft versiyonunu kontrol edin (1.20+)
- Spigot/Paper kullandığınızdan emin olun
- Console'da hata mesajlarını kontrol edin

### Placeholderlar çalışmıyor
- PlaceholderAPI yüklü olduğundan emin olun
- `/papi reload` komutu ile yeniden yükleyin
- `/papi ecloud download KitPvP` gerekli değil (built-in)

### Scoreboard görünmüyor
- `config.yml` içinde `scoreboard.enabled: true` olduğundan emin olun
- Başka bir scoreboard eklentisi ile çakışma olabilir

## 💖 Teşekkürler

Bu plugini kullandığınız için teşekkür ederiz! Sunucunuzda keyifli oyunlar dileriz.

**LBDev Team** 🚀