ArBan

• Ceza Yönetimi — Ban, tempban, IP ban, mute, tempmute, IP mute, kick (süreli/kalıcı)
• Uyarı Sistemi — Süreli/kalıcı uyarı, otomatik eylem (belirli uyarı sayısında mute/ban), GUI ile görüntüleme
• Not Sistemi — Oyunculara yetkili notu ekleme, GUI ile görüntüleme ve silme
• Puan Sistemi — Ceza puanı ekleme/çıkarma, eşik aşımında otomatik ceza, decay (zaman aşımı)
• Alt Hesap Tespiti — IP geçmişi üzerinden otomatik alt hesap tespiti ve yetkili bildirimi
• Escalation Sistemi — Tekrarlayan ihlallerde otomatik artan ceza; mute, ban, IP ban ve kick action desteği
• Jail Sistemi — Oyuncuyu izole ortamda yetkiliyle karşı karşıya getirme, izole sohbet, sohbet loglama
• Freeze Mekaniği — Süreli veya kalıcı dondurma, BossBar geri sayım, veritabanı kalıcılığı (sunucu yeniden başlatmalarına dayanıklı)
• Zamanlanmış Ban — Belirli bir tarihte otomatik uygulanacak ban zamanlama, iptal etme ve listeleme
• Ceza Geri Alma (Rollback) — Bir yetkilinin belirli süre içindeki tüm cezalarını geri alma (dry-run desteği)
• Yetkili Koruma (Rate Limit) — Kısa sürede çok fazla ceza komutu kullanan yetkilileri sessiz bloke etme; kategori bazlı takip, ayrı Discord webhook kanalı
• GUI Arayüzleri — Oyuncu profili, ceza geçmişi (filtre/istatistik/sıralama/arama), alt hesap kontrolü, yetkili istatistikleri, uyarılar, notlar, puanlar, bildirim tercihleri, şablon yöneticisi
• Discord Webhook — Tüm moderasyon işlemlerini Discord'a detaylı embed olarak bildirme (rate limit bildirimleri ayrı kanala)
• PlaceholderAPI Entegrasyonu — Scoreboard, tab list ve chat pluginlerinde ArBan verilerini gösterme
• Ceza Şablonları — Önceden tanımlanmış ceza şablonları ile hızlı ceza uygulama
• Bitiş Bildirimleri — Yaklaşan ceza süre doluşlarını yetkililere önceden bildirme
• Veritabanı Desteği — SQLite ve MySQL desteği, otomatik yedekleme, import/export, MySQL deadlock koruması
• Çok Sunucu Desteği — Paylaşımlı MySQL ile ağ genelinde ceza yönetimi
• Folia Uyumluluğu — Folia uyumlu asenkron zamanlayıcı
• Harici Mesaj Dosyası — Tüm mesajlar messages.yml dosyasında; kolay düzenleme ve Türkçe karakter desteği
• Veri Beyaz Listesi — Belirli oyuncu ve IP'leri veri kaydından muaf tutma
• Kapsamlı Test Komutu — Tüm bileşenleri tek komutla 19 kategoride test etme (/arban test)
• Developer API — 44 metot (sorgulama + ceza uygulama/kaldırma) ve 4 olay (event) sınıfı ile diğer eklentiler için kapsamlı API

1. Projeyi derleyin veya hazır JAR dosyasını indirin (ArBan-3.8.jar)
2. JAR dosyasını sunucunuzun plugins/ klasörüne kopyalayın
3. Sunucuyu başlatın — plugins/ArBan/config.yml ve plugins/ArBan/messages.yml otomatik oluşturulur
4. config.yml dosyasını ihtiyacınıza göre düzenleyin
5. Mesajları özelleştirmek için messages.yml dosyasını düzenleyin
6. /arban reload komutuyla değişiklikleri uygulayın

Ceza Komutları

Uyarı Komutları

Not Komutları

Puan Komutları

Freeze & Jail Komutları

Bilgi & Araştırma Komutları

Alt Hesap Ceza Komutları

Zamanlanmış Ban Komutları

Tarih formatı: gg/AA/yyyy-SS:dd (örnek: 25/04/2026-15:30)

Rollback & Yetkili Koruma Komutları

Yönetim Komutları

Komut Takma Adları

Tab Tamamlama

Tüm komutlar akıllı tab tamamlama desteği sunar:

• Oyuncu adı önerileri
• Süre önerileri: 10m, 30m, 1h, 6h, 12h, 1d, 3d, 7d, 14d, 30d, perma
• Mute sebep önerileri (config'den)
• Ban sebep önerileri (config'den)
• Zamanlanmış ban: tarih (yarın / gelecek hafta) ve süre önerileri

Tüm plugin bileşenlerinin sağlığını tek komutla 19 kategoride kontrol eder. Her test ✓ (başarılı), ✗ (başarısız) veya ⚠ (uyarı) olarak raporlanır. Hata detayları sunucu konsoluna loglanır.

Örnek Çıktı

════════════════════════════════════
▸ VERİTABANI
  ✓ DatabaseManager yüklendi
  ✓ Bağlantı başarılı (MySQL)
  ✓ 11/11 tablo mevcut
  ✓ Yazma/okuma testi başarılı
▸ DEVELOPER API
  ✓ ArBanApi instance
  ✓ ArBanApiProvider.get() çalışıyor
  ✓ getActiveBan(null) = null
  ...
▸ GÜVENLİK
  ✓ DurationParser overflow koruması: 999999999y = -2
  ✓ storage.custom-path path traversal yok
...
════════════════════════════════════
  TEST SONUCU
  ✓ Başarılı: 142
  ✗ Başarısız: 0
  ⚠ Uyarı: 1
════════════════════════════════════

Ceza İzinleri

Uyarı / Not / Puan İzinleri

Alt Hesap İzinleri

Bilgi & Yönetim İzinleri

Zamanlanmış Ban & Koruma İzinleri

Bildirim İzinleri

Plugin ilk çalıştığında iki yapılandırma dosyası otomatik oluşturulur:

config.yml

Genel Ayarlar

# Chat prefix (hex renk desteği: &#RRGGBB)
prefix: "&#6B00D6&lSunucu &7» "

# Veritabanı türü: "sqlite" veya "mysql"
storage:
  type: sqlite
  sqlite:
    file: "arban.db"
  mysql:
    host: "localhost"
    port: 3306
    database: "arban"
    username: "root"
    password: "sifre"
    pool-size: 10

settings:
  default-reason: "Sebep yok."
  server-name: "Sunucu"
  protect-ops: true                    # OP'lara ceza verilmesini engeller
  max-active-bans-per-player: 0        # 0 = limitsiz
  max-active-mutes-per-player: 1
  log-chat-on-mute: true               # Mute atıldığında son mesajları loglar
  broadcast: false                     # Ceza bildirimlerini tüm yetkililere gönder
  block-commands: true                 # Mute'lu oyuncuların engellenecek komutları
  blocked-commands:
    - "/msg"
    - "/tell"
    - "/r"
    - "/reply"
    - "/w"
    - "/whisper"

Uyarı Sistemi

warn:
  # /warn ile verilen uyarıların varsayılan süresi (0 = kalıcı)
  # Örnek: "1h" = 1 saat, "30m" = 30 dakika, "1d" = 1 gün
  default-duration: "1h"
  show-title: true
  auto-actions:
    enabled: false
    rules:
      - count: 3
        action: "tempmute"
        duration: "1h"
        reason: "3 uyarı - otomatik susturma"
      - count: 5
        action: "tempban"
        duration: "1d"
        reason: "5 uyarı - otomatik ban"

Güvenlik: Auto-action'larda yalnızca şu komutlar çalıştırılabilir: ban, tempban, ipban, mute, tempmute, ipmute, kick, freeze, jail, warn, tempwarn

Puan Sistemi

points-system:
  enabled: false
  decay-window: "7d"           # Bu süreden eski puanlar sayılmaz (0 = kapalı)
  points-per-type:
    BAN: 5
    MUTE: 2
    KICK: 1
    WARN: 1
  auto-actions:
    enabled: false
    rules:
      - threshold: 10
        action: "tempban"
        duration: "1d"
        reason: "Puan eşiği aşıldı"

Ceza Geçmişi GUI

history:
  max-results: 500              # GUI'de gösterilen maksimum ceza sayısı
  default-date-filter: 0        # 0=tümü, 1=1gün, 2=7gün, 3=30gün

Bitiş Bildirimleri

expiry-notifications:
  enabled: false
  check-interval: "5m"          # Kontrol aralığı
  warn-before: "30m"            # Bitişten ne kadar önce bildir
  notify-types:
    - BAN
    - MUTE

Alt Hesap Tespiti

alt-detection:
  enabled: true
  exempt-ips:
    - "192.168.1.1"     # Muaf IP'ler (VPN, okul, kafe vb.)

Yedekleme

backup:
  enabled: true
  interval: "24h"        # Otomatik yedekleme aralığı
  max-backups: 7         # Eski yedekler otomatik silinir
  on-shutdown: true      # Sunucu kapanışında yedekle

Yetkili Koruma (Rate Limit)

rate-limit:
  enabled: true
  window-seconds: 60      # Bu süre içinde max-commands kadar komut kullanılabilir
  max-commands: 6          # Pencere içinde max komut sayısı (aşılınca bloke)
  block-duration: "1h"     # Bloke süresi

Escalation (Otomatik Artan Ceza)

escalation:
  enabled: true
  decay-minutes: 1440    # 24 saat sonra ihlal sayacı sıfırlanır (0 = kapalı)
  rules:
    hakaret:
      - count: 1
        action: "tempmute"
        duration: "1h"
      - count: 2
        action: "tempmute"
        duration: "3h"
      - count: 3
        action: "tempban"
        duration: "1d"
      - count: 4
        action: "ban"
        duration: "perma"

Desteklenen action türleri: mute, tempmute, ban, tempban, ipban, kick

Discord Webhook

webhook:
  enabled: true
  url: "https://discord.com/api/webhooks/WEBHOOK_ID/WEBHOOK_TOKEN"
  username: "ArBan"
  avatar-url: ""
  send-ban: true
  send-mute: true
  send-unban: true
  send-unmute: true
  send-kick: true
  send-update: true
  send-expire: true
  send-jail: true
  send-unjail: true
  send-freeze: true
  send-unfreeze: true
  send-alt-detect: true
  send-points-threshold: true
  send-rollback: true
  send-expiry-warn: true
  chat-history-lines: 5

  ratelimit:
    enabled: true
    url: "https://discord.com/api/webhooks/RATELIMIT_WEBHOOK_ID/TOKEN"

BossBar & Ses

bossbar:
  enabled: true
  show-reason: true

sounds:
  enabled: true
  volume: 1.0
  pitch: 1.0

messages.yml

Tüm oyuncu ve yetkili mesajları messages.yml dosyasında saklanır. Türkçe karakter desteği sunar ve config.yml'den bağımsız olarak düzenlenebilir.

Not: messages.yml dosyasında tek bir gui: bloğu bulunmalıdır. Birden fazla gui: bloğu olursa YAML standartlarına göre sonuncusu öncekini ezer ve alt bölümler kaybolur.

/arban reload komutu hem config.yml hem messages.yml dosyasını yeniden yükler.

Oyuncu Profili (/check <oyuncu>)

• Oyuncu durumu (çevrimiçi/çevrimdışı, son görülen)
• IP adresi ve konum bilgisi
• Ceza istatistikleri (ban, mute, kick, uyarı, puan)
• Aktif cezalar
• Yakın geçmiş ceza kayıtları

Ceza Geçmişi (/history)

• Sayfalandırılmış ceza kayıtları
• Tip filtresi — BAN, MUTE, KICK, IPBAN, IPMUTE, WARN arasında geçiş
• Durum filtresi — Tümü / Aktif / Pasif
• Tarih aralığı — Tümü / Son 1 Gün / Son 7 Gün / Son 30 Gün
• Sıralama — Yeni→Eski / Eski→Yeni
• İstatistik paneli — Toplam, aktif/pasif dağılımı, tip başına sayılar
• Arama — Sohbetten oyuncu adı yazarak hızlı arama
• Detay sayfası — Ceza olayları, kaldırma bilgisi (kim kaldırdı, ne zaman, nasıl)

Uyarılar (/warnings <oyuncu>)

• Aktif/süresi dolmuş/kaldırılmış uyarılar
• Tıklayarak uyarı kaldırma
• Toplam/aktif sayı özeti

Notlar (/notes <oyuncu>)

• Yetkili notları listesi
• Tıklayarak not silme

Puanlar (/points <oyuncu>)

• Puan geçmişi (pozitif/negatif)
• Toplam puan özeti

Alt Hesap Kontrolü (/alts <oyuncu>)

• Alt hesap listesi ve ban durumları
• IP adresi gösterimi (izin tabanlı maskeleme)

Yetkili İstatistikleri (/staffstats)

• Yetkili sıralama tablosu
• Yetkili başına ceza sayıları

Bildirim Tercihleri (/notifysettings)

• Bildirim kanallarını aç/kapat
• Kategori bazlı kontrol

Şablon Yöneticisi (/templates)

• Şablon oluşturma, düzenleme, silme
• Süre, sebep, görünen ad tanımlama

PlaceholderAPI yüklüyse ArBan otomatik olarak aşağıdaki placeholder'ları kaydeder:

Diğer eklentiler ArBan ile etkileşebilir. API, sorgulama ve (v3.9) ceza uygulama/kaldırma için 44 metot ve 4 olay sınıfı sunar.

API'ye Erişim

// Yöntem 1: Static provider
ArBanApi api = ArBanApiProvider.get();

// Yöntem 2: Plugin instance
ArBanPlugin plugin = (ArBanPlugin) Bukkit.getPluginManager().getPlugin("ArBan");
ArBanApi api = plugin.getApi();

API Metotları

public interface ArBanApi {

    // Aktif ceza sorgulama
    Punishment getActivePunishment(UUID uuid, PunishmentType type);
    Punishment getActiveBan(UUID uuid);
    Punishment getActiveMute(UUID uuid);
    Punishment getActiveIpBan(String ip);
    Punishment getActiveIpMute(String ip);

    // Durum kontrolleri
    boolean isPlayerBanned(UUID uuid);
    boolean isPlayerMuted(UUID uuid);
    boolean isPlayerFrozen(UUID uuid);
    boolean isPlayerJailed(UUID uuid);

    // Oyuncu bilgileri
    String getLastKnownIp(UUID uuid);
    String getLastKnownName(UUID uuid);

    // Ceza geçmişi
    List<Punishment> getPunishmentHistory(UUID uuid, int limit);
    List<Punishment> getPunishmentHistory(UUID uuid, PunishmentType type, int limit);
    Punishment getPunishmentById(long id);
    List<Punishment> getStaffPunishments(String staffName, int limit);
    List<Punishment> getRecentPunishments(int limit);

    // Uyarı sistemi
    int getActiveWarnCount(UUID uuid);
    List<Punishment> getActiveWarns(UUID uuid);
    List<Punishment> getAllWarns(UUID uuid);

    // Puan sistemi
    int getPlayerPoints(UUID uuid);

    // İstatistikler
    int getTotalPunishmentCount(UUID uuid);
    int getActivePunishmentCount(UUID uuid);
    int getStaffPunishmentCount(String staffName);

    // === v3.9: Ceza uygulama (yazma) ===
    // staffName cezayı veren gerçek yetkili olarak kaydedilir; duration "7d"/"perma"/null.
    CompletableFuture<PunishmentResult> ban(UUID target, String staffName, String duration, String reason);
    CompletableFuture<PunishmentResult> ipBan(UUID target, String staffName, String duration, String reason);
    CompletableFuture<PunishmentResult> mute(UUID target, String staffName, String duration, String reason);
    CompletableFuture<PunishmentResult> ipMute(UUID target, String staffName, String duration, String reason);
    CompletableFuture<PunishmentResult> kick(UUID target, String staffName, String reason);
    CompletableFuture<PunishmentResult> warn(UUID target, String staffName, String duration, String reason);
    CompletableFuture<PunishmentResult> freeze(UUID target, String staffName, String duration, String reason);
    CompletableFuture<PunishmentResult> jail(UUID target, String staffName, String reason);
    CompletableFuture<PunishmentResult> punishWithTemplate(UUID target, String staffName, String templateId);

    // === v3.9: Ceza kaldırma (yazma) ===
    CompletableFuture<PunishmentResult> unban(UUID target, String staffName);
    CompletableFuture<PunishmentResult> unmute(UUID target, String staffName);
    CompletableFuture<PunishmentResult> unIpMute(UUID target, String staffName);
    CompletableFuture<PunishmentResult> unfreeze(UUID target, String staffName);
    CompletableFuture<PunishmentResult> unjail(UUID target, String staffName);
    CompletableFuture<PunishmentResult> removeWarn(UUID target, long warnId, String staffName);
    CompletableFuture<PunishmentResult> removePunishmentById(long id, String staffName, RemovalCause cause);

    // === v3.9: Alt hesap & IP geçmişi (okuma) ===
    CompletableFuture<List<UUID>> getKnownAlts(UUID uuid);
    CompletableFuture<List<UUID>> getAltsByCurrentIp(UUID uuid);
    CompletableFuture<List<String>> getIpHistory(UUID uuid);

    // === v3.9: Şablon erişimi (okuma) ===
    List<PunishmentTemplate> getTemplates();
    PunishmentTemplate getTemplate(String id);

    // === v3.9: Yetkili istatistik dökümü (okuma) ===
    CompletableFuture<Map<PunishmentType, Integer>> getStaffPunishmentBreakdown(String staffName, long sinceEpochMillis);
}

Okuma metotları null-safe'dir; null parametrede null/false/0/boş liste döner.

v3.9 — Yazma API'si: Ceza uygulama/kaldırma metotları CompletableFuture<PunishmentResult> döndürür (Discord/JDA thread'lerinden async çağrı için uygundur); iş ArBan'ın Folia-uyumlu zamanlayıcısında yapılır, ana thread bloklanmaz. staffName cezayı veren gerçek yetkili olarak kaydedilir (CONSOLE değil). Yazma metotları komutlarla aynı servis katmanından geçer: mevcut event'ler, Discord webhook'u, escalation/puan sistemi ve korumalar (protect-ops, whitelist) otomatik işler — ayrı bir kod yolu yoktur.

PunishmentResult:

Notlar: freeze/jail online oyuncu gerektirir (offline hedef → INVALID_TARGET). Aynı türde aktif ceza varsa ArBan günceller ve sonuç SUCCESS döner. getPunishmentById(id), kaldırılmış cezalar için artık getRemovedBy() / getRemovedAt() / getRemovalCause() alanlarını da doldurur.

Olaylar (Events)

// RemovalCause enum değerleri
enum RemovalCause {
    UNBAN, UNMUTE, EXPIRE, DEACTIVATE, OTHER
}

Örnek Kullanım

// Event dinleme (mevcut)
@EventHandler
public void onPunishment(ArBanPunishmentAppliedEvent event) {
    String oyuncu = event.getTargetName();
    PunishmentType tur = event.getType();
    String sebep = event.getReason();
    // ...
}

// v3.9 — Ceza uygulama (örn. Discord botundan, gerçek yetkili adıyla)
api.ban(targetUuid, "ModAdi", "7d", "Hile kullanımı").thenAccept(result -> {
    if (result.isSuccess()) {
        long cezaId = result.getPunishment().getId();
        // Discord'a başarı bildirimi gönder
    } else {
        switch (result.getStatus()) {
            case TARGET_EXEMPT:     /* OP/bypass korumalı */ break;
            case INVALID_DURATION:  /* süre hatalı */ break;
            default:                /* result.getErrorMessage() */ break;
        }
    }
});

ArBan aşağıdaki güvenlik önlemlerini içerir:

Tüm süre parametrelerinde kullanılabilecek birimler:

Desteklenen Motorlar

Her iki motor da HikariCP bağlantı havuzu kullanır. MySQL deadlock durumları otomatik olarak yönetilir (3 deneme, üstel geri çekilme).

Tablolar

/arban export <oyuncu>     # Tek oyuncunun verilerini JSON olarak aktar
/arban export all          # Tüm verileri JSON olarak aktar
/arban import json         # JSON dosyasından içe aktarma
/arban import sqlite       # SQLite'dan MySQL'e aktarım

Desteklenen kaynaklar: JSON dosyaları, SQLite veritabanı, EssentialsX ban verileri

messages.yml dosyasındaki mesajlarda kullanılabilecek değişkenler:

Renk Desteği: &c (kırmızı), &a (yeşil), &#RRGGBB (hex)

Eklentiyle ilgili sorun yaşıyorsanız öncelikle sunucunuzun Java 17+ ve Paper/Folia 1.21+ sürümlerinde çalıştığından emin olun. Komutların çalışmaması durumunda yetkili izinlerini kontrol edin; "Yetkili Koruma (Rate Limit)" mekanizması, kısa sürede çok fazla işlem yapan yetkilileri otomatik olarak kısıtlayabilir. Discord bildirimleri gelmiyorsa webhook ayarlarınızı ve URL doğruluğunu gözden geçirin. Veritabanı veya ceza kalıcılığı sorunlarında, sunucu yeniden başlatmalarında verilerin korunup korunmadığını kontrol edin. Hatalı bir işlem yaptıysanız, "Ceza Geri Alma (Rollback)" özelliğini kullanarak belirli bir zaman dilimindeki işlemleri topluca iptal edebilirsiniz. Sorun devam ederse, konsol çıktılarını inceleyerek hata kayıtlarını kontrol edin.

ArBan, tüm moderasyon işlemlerini plugins/ArBan/logs dizininde detaylı metin dosyaları halinde saklar. Hatalı komut kullanımları, yetkili rate-limit tetiklenmeleri ve sistem çakışmaları konsol üzerinden [ArBan] etiketiyle raporlanır. Discord Webhook entegrasyonu aktif edildiğinde, tüm ceza işlemleri ve sistem uyarıları yapılandırılan kanallara anlık olarak iletilir. "Yetkili Koruma" mekanizması devreye girdiğinde, ilgili yetkilinin işlemleri geçici olarak askıya alınır ve bu durum loglarda "Rate Limit Exceeded" uyarısı ile belirtilir. Veritabanı veya GUI kaynaklı sorunlarda, /arban debug komutunu kullanarak sistemin mevcut durumunu ve son hata kayıtlarını konsola dökebilirsiniz.