ArYetkili

ArYetkili, staff ekibinizi tek bir yerden yönetmenizi sağlar. Yetki verme/alma, aktiflik takibi, performans puanlama, başarım rozeti, rapor sistemi, staff modu ve toplu işlemler gibi özellikleri kapsamlı bir GUI sistemiyle sunar. Tüm komutlar tek bir /yetkili komutu üzerinden çalışır.

• Yetki Yönetimi -- LuckPerms üzerinden doğrudan rank verme/alma, hiyerarşi kontrolü, onay mekanizması
• Aktiflik Takibi -- Oturum bazlı süre ölçümü, haftalık/aylık dönemler, rank bazlı eşik değerleri
• AFK Tespiti -- Hareket, blok etkileşimi, chat ve komut bazlı AFK algılama
• Staff Modu -- Fly, god mode, vanish; envanter otomatik kaydetme/geri yükleme
• Rapor Sistemi -- Oyuncuların staff üyelerini raporlaması, cooldown, durum takibi (Açık/Çözüldü/Reddedildi)
• Görev Durumu -- Görevde / Meşgul / İzinli durumları, staff listesinde görünür
• Başarım Rozetleri -- 9 farklı başarım (ceza sayısı, aktiflik saati, seri, kıdem), otomatik kazanım
• Performans Puanlama -- 0-100 arası ağırlıklı skor (aktiflik, ceza, tutarlılık, başarım)
• Toplu İşlemler -- Birden fazla staff üzerinde aynı anda rank değişikliği
• GUI Paneli -- 19 ekranlı envanter tabanlı yönetim arayüzü
• Log Geçmişi -- Tüm yetki işlemlerinin kayıt altına alınması
• Discord Webhook -- Yetki değişikliklerinde Discord kanalına bildirim
• ArBan Entegrasyonu -- Ceza istatistiklerini performans skoruna dahil etme (opsiyonel)
• Çift Veritabanı -- SQLite (varsayılan) veya MySQL (HikariCP bağlantı havuzu)
• MiniMessage -- Tüm mesajlar MiniMessage formatında, tamamen özelleştirilebilir

1. ArYetkili-1.0.0.jar dosyasını sunucunuzun plugins/ klasörüne koyun.
2. Sunucuyu başlatın. Plugin plugins/ArYetkili/config.yml dosyasını oluşturacaktır.
3. config.yml dosyasını ihtiyacınıza göre düzenleyin.
4. /yetkili reload ile ayarları yeniden yükleyin.

Kaynaktan Derleme

# JDK 21 gereklidir (hedef Java 17)
cd ArYetkili
mvn clean package
# Çıktı: target/ArYetkili-1.0.0.jar

Tüm komutlar /yetkili ana komutu üzerinden çalışır. Aliaslar: /staff, /y

plugins/ArYetkili/config.yml dosyasından tüm ayarlar yönetilir.

Temel Ayarlar

general:
  staff-permission: "aryetkili.staff"   # Staff olarak kabul edilecek permission
  default-group: "default"              # Yetki alındığında atanacak grup
  allow-self-remove: false              # Kendi yetkisini kaldırabilir mi
  confirmation-enabled: true            # İki adımlı onay mekanizması
  confirmation-timeout: 15              # Onay süresi (saniye)

Veritabanı

database:
  type: "sqlite"            # "sqlite" veya "mysql"
  sqlite-file: "aryetkili.db"
  mysql:
    host: "localhost"
    port: 3306
    database: "aryetkili"
    username: "root"
    password: ""
    pool:
      maximum-pool-size: 10
      minimum-idle: 2

Aktiflik Sistemi

activity:
  afk-detection: true
  afk-timeout: 300                    # Saniye
  period-type: "weekly"               # "weekly" veya "monthly"
  threshold-mode: "per-rank"          # "global" veya "per-rank"
  global-threshold: 5                 # Saat
  rank-thresholds:
    helper: 3
    moderator: 7
    admin: 10

Discord Webhook

discord:
  enabled: true
  webhook-url: "https://discord.com/api/webhooks/..."
  events:
    staff-promote: true
    staff-demote: true
    luckperms-change: true
    config-change: false

Diğer Modüller

Her modül enabled: true/false ile açılıp kapatılabilir:

Plugin 19 farklı GUI ekranı sunar:

Plugin ile ilgili bir sorun yaşıyorsanız öncelikle Java 17+ ve Paper 1.21.x sürümünde olduğunuzdan emin olun. LuckPerms (5.4+) eklentisinin yüklü ve çalışır durumda olduğunu kontrol edin. Veritabanı bağlantı hataları için config.yml dosyasındaki SQLite veya MySQL ayarlarını gözden geçirin; MySQL kullanıyorsanız bağlantı bilgilerinin doğruluğunu teyit edin. Komutlar çalışmıyorsa /yetkili komutu için gerekli yetkilere sahip olduğunuzdan emin olun. Hatalı davranışlar veya performans sorunları için plugins/ArYetkili/logs dizinindeki kayıtları inceleyebilir, sorun devam ederse konsol çıktısını hata raporu olarak iletebilirsiniz.

ArYetkili, geliştiricilerin eklenti verilerine erişebilmesi ve entegrasyon sağlayabilmesi için kapsamlı bir API sunar. Eklentiyi projenize dahil etmek için pom.xml dosyanıza bağımlılık olarak eklemeniz yeterlidir. API üzerinden; staff üyelerinin aktiflik sürelerini sorgulayabilir, performans puanlarına erişebilir, mevcut görev durumlarını (Görevde/Meşgul/İzinli) kontrol edebilir ve başarım rozeti verilerini çekebilirsiniz. Ayrıca, LuckPerms entegrasyonu sayesinde yetki değişikliklerini dinleyebilir ve rapor sistemi verilerine programatik olarak müdahale edebilirsiniz. Tüm işlemler ArYetkiliAPI sınıfı üzerinden yönetilmekte olup, veritabanı işlemlerinde HikariCP bağlantı havuzu ile yüksek performanslı veri alışverişi desteklenmektedir.