ArceniaKlan

• Özellikler
• Gereksinimler
• Kurulum
• Komutlar
• İzinler (Permissions)
• Yapılandırma (config.yml)
• Mesajlar (messages.yml)
• PlaceholderAPI Placeholders
• Geliştirici API'si
• Veritabanı Şeması
• Savaş Sistemi
• POV İzleyici Sistemi
• GUI Sistemi
• Mimari
• Derleme

1. KlanSistemi-1.0.0.jar dosyasını plugins/ klasörüne koyun
2. Sunucuyu başlatın — config.yml, messages.yml ve klanlar.db otomatik oluşacaktır
3. İsteğe bağlı: config.yml ayarlarını düzenleyin ve /reload confirm yapın
4. Arena kurmak için: /klanadmin arena oluştur <isim> komutunu kullanın

Oyuncu Komutları — /klan

Not: Klan oluşturma, davet, terfi, dağıtma gibi tüm işlemler GUI üzerinden yapılır.

Admin Komutları — /klanadmin

Arena Yönetimi — /klanadmin arena

Hologram Yönetimi — /klanadmin siralama

# Veritabanı
database:
  filename: "klanlar.db"

# Klan Ayarları
clan:
  name:
    min-length: 3          # Minimum klan ismi uzunluğu
    max-length: 16         # Maksimum klan ismi uzunluğu
    allowed-pattern: "^[a-zA-ZçÇğĞıİöÖşŞüÜ0-9 ]+$"  # İzin verilen karakterler (regex)
  starting-points: 0      # Başlangıç puanı
  profanity-filter:        # Yasaklı kelimeler
    - "küfür1"
    - "küfür2"

# Üye Limiti
member-limit:
  start: 5                 # Başlangıç üye limiti
  max: 20                  # Maksimum üye limiti
  base-cost: 1000          # Yükseltme taban maliyeti (puan)
  multiplier: 1.5          # Her seviye maliyet çarpanı

# Puan Sistemi
points:
  kill-reward: 10          # Oyuncu öldürme ödülü
  death-penalty: 0         # Ölüm cezası
  min-points: 0            # Minimum puan (negatif olmaz)

# Sohbet Formatları (MiniMessage)
chat:
  clan-format: "<dark_green>[Klan] <green>{role} {player}: <white>{message}"
  alliance-format: "<dark_purple>[İttifak] <light_purple>{clan} {player}: <white>{message}"
  spy-clan-format: "<gray>[SPY-Klan] [{clan}] {player}: {message}"
  spy-alliance-format: "<gray>[SPY-İttifak] [{clan}] {player}: {message}"

# Hologram Ayarları
hologram:
  title: "<gold><bold>⚔ En İyi Klanlar ⚔"
  line-format: "<yellow>#{rank} <white>{clan} <gray>- <green>{points} puan"
  top-count: 10            # Gösterilecek klan sayısı
  refresh-interval: 300    # Otomatik yenileme (saniye)

# Roller
roles:
  leader:
    display: "<red>Lider"
    prefix: "★"
  officer:
    display: "<gold>Subay"
    prefix: "◆"
  trusted:
    display: "<green>Güvenilir"
    prefix: "●"
  member:
    display: "<gray>Üye"
    prefix: "○"

# Savaş Sistemi
war:
  min-players: 1           # Takım başına minimum oyuncu
  max-players: 10          # Takım başına maksimum oyuncu
  accept-timeout: 30       # Davet kabul süresi (saniye)
  pvp-delay: 5             # Savaş başlamadan PvP koruması (saniye)
  reconnect-timeout: 30    # Bağlantı kopması toleransı (saniye)
  block-ender-pearl: true  # Ender pearl engelleme
  max-viewers: 20          # Maksimum izleyici sayısı
  war-points-reward: 100   # Savaş kazanma puan ödülü

Tüm mesajlar MiniMessage formatında yazılır ve messages.yml içinden düzenlenebilir.

Kullanılabilir Placeholder'lar

MiniMessage Formatı

<!-- Renkler -->
<red>Kırmızı metin
<green>Yeşil metin
<gold>Altın metin
<gray>Gri metin

<!-- Stiller -->
<bold>Kalın
<italic>İtalik
<underlined>Altı çizili

<!-- Gradyan -->
<gradient:red:blue>Gradyan metin</gradient>

<!-- Sıfırlama -->
<reset>Normal metin

Gereksinim: PlaceholderAPI eklentisi yüklü olmalıdır.

Kullanım Örneği (Scoreboard / TAB)

&6Klan: %klan_name%
&ePuan: %klan_points%
&7Rol: %klan_role%
&7Üyeler: %klan_members%/%klan_limit%

Diğer eklentiler, KlanAPIProvider sınıfı üzerinden klan sistemine erişebilir.

API'ye Erişim

import com.arcenia.klan.api.ClanAPI;
import com.arcenia.klan.api.KlanAPIProvider;

ClanAPI api = KlanAPIProvider.getAPI();
if (api != null) {
    // API kullanıma hazır
}

Mevcut API Metodları

Kullanım Örnekleri

ClanAPI api = KlanAPIProvider.getAPI();

// Oyuncunun klanını kontrol et
Clan clan = api.getClan(player.getUniqueId());
if (clan != null) {
    player.sendMessage("Klanın: " + clan.getName());
    player.sendMessage("Puanın: " + clan.getPoints());
}

// Puan ekle (asenkron)
api.addPoints(clan.getId(), 50, "Özel etkinlik ödülü").thenRun(() -> {
    player.sendMessage("50 puan eklendi!");
});

// İttifak kontrolü
boolean allied = api.arePlayersAllied(player1.getUniqueId(), player2.getUniqueId());

// Top 5 klan
List<Clan> top5 = api.getTopClans(5);
for (int i = 0; i < top5.size(); i++) {
    Clan c = top5.get(i);
    System.out.println("#" + (i + 1) + " " + c.getName() + " - " + c.getPoints() + " puan");
}

// Rol kontrolü
ClanRole role = api.getPlayerRole(player.getUniqueId());
if (role == ClanRole.LEADER) {
    // Lider özel işlemleri
}

Model Sınıfları

Clan

ClanMember

ClanRole (Enum)

Metotlar: isHigherThan(role), isAtLeast(role), getNextRole(), getPreviousRole()

plugin.yml Bağımlılık

Diğer eklentiler plugin.yml'de KlanSistemi'yi bağımlılık olarak eklemelidir:

depend:
  - KlanSistemi    # zorunlu bağımlılık
# veya
softdepend:
  - KlanSistemi    # isteğe bağlı

SQLite veritabanı (klanlar.db) aşağıdaki tabloları içerir:

clans

clan_members

alliances

holograms

war_history

Akış Diyagramı

Admin: /klanadmin savaş
    ↓
WarSetupMenu GUI açılır
    ↓
[1] Klan A seç → [2] Klan B seç → [3] Arena seç → [4] Mod seç
    ↓
WarPlayerSelectMenu GUI açılır
    ↓
Her klandan eşit sayıda oyuncu seç → Onayla
    ↓
Oyunculara davet gönderilir (/klan kabul — 30 saniye)
    ↓
Tüm oyuncular kabul edince → Arena'ya ışınlanma
    ↓
PvP koruması (5 saniye) + Geri sayım başlıkları
    ↓
⚔ SAVAŞ BAŞLADI! → Aktif PvP
    ↓
Ölüm → Eleme (Spectator moda geçiş)
    ↓
Raunt kazananı belirlenir → Sonraki raunt / Savaş sonu
    ↓
Kazanan belirlenir → Puan ödülü + DB kaydı + Hologram yenileme

Savaş Modları

Savaş Sırasında Kısıtlamalar

Kullanım

1. /klan izle → Savaş İzle GUI açılır
2. Hayatta olan bir savaşçıya tıkla → İzleme modu başlar
3. Kontroller:
   • Sol Tık → Önceki savaşçıya geç
   • Sağ Tık → Sonraki savaşçıya geç
   • Shift → İzleme modundan çık

İzleyici Kısıtlamaları

Tüm GUI'ler BaseGUI çerçevesi üzerine inşa edilmiştir.

GUI Listesi

com.arcenia.klan
├── KlanSistemi.java          # Ana plugin sınıfı
├── api/
│   ├── ClanAPI.java          # Public API arayüzü
│   ├── ClanAPIImpl.java      # API implementasyonu
│   └── KlanAPIProvider.java  # Statik API erişim noktası
├── command/
│   ├── KlanCommand.java      # /klan komutu
│   └── KlanAdminCommand.java # /klanadmin komutu
├── database/
│   ├── DatabaseManager.java  # HikariCP bağlantı yönetimi
│   ├── ClanRepository.java   # Klan CRUD işlemleri
│   ├── AllianceRepository.java  # İttifak CRUD
│   ├── HologramRepository.java  # Hologram CRUD
│   └── WarRepository.java    # Savaş geçmişi CRUD
├── gui/
│   ├── BaseGUI.java          # Temel GUI çerçevesi
│   ├── PaginatedGUI.java     # Sayfalı GUI
│   ├── GUIButton.java        # Tıklanabilir buton
│   ├── GUIListener.java      # Inventory click handler
│   └── menu/
│       ├── MainMenu.java
│       ├── AdminMenu.java
│       ├── ClanMembersMenu.java
│       ├── AdminClanListMenu.java
│       ├── AdminPointsMenu.java
│       ├── HologramListMenu.java
│       ├── WarSetupMenu.java
│       ├── WarPlayerSelectMenu.java
│       └── WarSpectateMenu.java
├── hook/
│   └── KlanPlaceholderExpansion.java  # PAPI hook
├── listener/
│   ├── ChatListener.java     # Klan/ittifak sohbeti
│   ├── CombatListener.java   # PvP koruması (ittifak)
│   ├── PlayerListener.java   # Giriş/çıkış olayları
│   └── WarListener.java      # Savaş + POV event handler
├── manager/
│   ├── ClanManager.java      # Klan iş mantığı
│   ├── AllianceManager.java  # İttifak iş mantığı
│   ├── ChatManager.java      # Sohbet + spy yönetimi
│   ├── HologramManager.java  # FancyHolograms entegrasyonu
│   ├── PointsManager.java    # Puan yönetimi
│   ├── ArenaManager.java     # Arena CRUD (arenas.yml)
│   ├── WarManager.java       # Savaş yaşam döngüsü
│   └── POVManager.java       # İzleme oturumu yönetimi
├── model/
│   ├── Clan.java             # Klan veri modeli
│   ├── ClanMember.java       # Üye veri modeli
│   ├── ClanRole.java         # Rol enum (hiyerarşi)
│   ├── HologramData.java     # Hologram veri modeli
│   ├── Arena.java            # Arena veri modeli
│   └── WarRecord.java        # Savaş geçmişi kaydı
├── util/
│   ├── MessageUtil.java      # MiniMessage mesaj yönetimi
│   ├── ItemBuilder.java      # ItemStack builder
│   ├── ProfanityFilter.java  # Küfür filtresi
│   └── SignInputHandler.java # Tabela girişi handler
└── war/
    ├── WarSession.java       # Savaş durum makinesi
    ├── WarTeam.java          # Takım durumu
    └── ViewerSession.java    # İzleyici oturumu

Katmanlı Mimari

┌─────────────────────────────────┐
│         Commands & GUI          │  ← Kullanıcı etkileşim katmanı
├─────────────────────────────────┤
│           Managers              │  ← İş mantığı katmanı
├─────────────────────────────────┤
│         Repositories            │  ← Veri erişim katmanı
├─────────────────────────────────┤
│     DatabaseManager (HikariCP)  │  ← Bağlantı yönetimi
└─────────────────────────────────┘

# Gereksinimler: JDK 21+, Maven 3.9+
mvn clean package

# Çıktı: target/KlanSistemi-1.0.0.jar

Bağımlılıklar (shade ile paketlenir)

Not: SQLite JDBC ve HikariCP, shade eklentisi ile JAR'a dahil edilir ve relocation ile çakışma önlenir.

Bu proje Arcenia tarafından geliştirilmiştir.

Minecraft Paper 1.21+ için tasarlanmıştır. BoxPvP sunucuları için optimize edilmiştir.