⚙️ Yapılandırma (`config.yml`) Eklentinin tüm davranışları `plugins/TurkishProfanityDetection/config.yml` dosyası üzerinden kontrol edilir. Ana yapılandırma bloğu `kynux_api`'dir:
Code (YAML):
# Kynux AI API Ayarları (Ana Yapay Zeka Entegrasyonu) kynux_api: # Kynux AI Chat Completion API endpoint'i url: "https://api.kynux.cloud/api/v1/chat/completion" # Kynux AI API anahtarınız. Bu alanı DOLDURMANIZ GEREKİR. key: "YOUR_KYNUX_API_KEY_HERE" # Kullanılacak yapay zeka modeli. Örn: "gpt-3.5-turbo", "gpt-4", vb. model: "gpt-3.5-turbo" # API istekleri için zaman aşımı süresi (milisaniye cinsinden) timeout: 30000
# 30 saniye
Diğer önemli yapılandırma bölümleri şunlardır:
actions: Mesaj iptali, loglama (konsol/dosya), Discord bildirimleri gibi genel eylemler.
action-recommendations: Kynux AI'nın önerdiği aksiyonlara (warn, mute, kick, ban) karşılık gelen Minecraft komutları.
Code (YAML):
action-recommendations:
warn: "warn %player% Uygunsuz içerik tespit edildi. Lütfen dikkat ediniz." mute: "mute %player% %time% Uygunsuz içerik" mute-time: "5m"# mute komutu için varsayılan süre kick: "kick %player% Uygunsuz içerik nedeniyle sunucudan atıldınız." ban: "tempban %player% %time% Uygunsuz içerik nedeniyle geçici olarak yasaklandınız." ban-time: "1d"# ban komutu için varsayılan süre
severity-actions: Kynux AI'nın belirlediği şiddet seviyesine göre (1-5) uygulanacak özel komutlar. AI'dan spesifik bir aksiyon önerisi gelmezse bu bölüm devreye girer.
statistics: Veritabanı türü (MySQL/SQLite), bağlantı bilgileri ve veri saklama süresi ayarları.
permissions: Eklenti komutları ve özellikleri için gerekli izinler.
messages: Eklentinin oyunculara gösterdiği mesajları özelleştirme.
Detaylı yapılandırma seçenekleri için lütfen eklentiyle birlikte gelen `config.yml` dosyasını inceleyiniz.
Komutlar ve İzinler
Ana Komut: `/tpd` (veya `/turkishprofanity`)
Alt Komutlar:
`/tpd help`: Tüm komutları ve açıklamalarını gösterir.
`/tpd reload`: Eklentiyi ve ayarları yeniden yükler. (turkishprofanitydetection.admin)
`/tpd version`: Eklenti sürümünü ve geliştirici bilgilerini gösterir.
`/tpd stats <oyuncu>`: Belirtilen oyuncunun küfür istatistiklerini gösterir. (turkishprofanitydetection.statistics veya turkishprofanitydetection.admin)
`/tpd clear <oyuncu|all>`: Belirtilen oyuncunun veya tüm oyuncuların küfür istatistiklerini temizler. (turkishprofanitydetection.admin)
`/tpd kynuxai <mesaj>`: Belirtilen mesajı Kynux AI ile analiz eder ve sonucu gösterir. (Admin yetkisi gerektirir - turkishprofanitydetection.admin)
İzinler:
`turkishprofanitydetection.bypass`: Bu izne sahip oyuncuların mesajları kontrol edilmez ve ceza almazlar.
`turkishprofanitydetection.admin`: Yönetici komutlarına (`/tpd admin`, `/tpd reload`, `/tpd clear`, `/tpd kynuxai`) ve yönetici bildirimlerine erişim sağlar.
`turkishprofanitydetection.commands`: Genel `/tpd` komutlarına erişim sağlar (help, version).
`turkishprofanitydetection.statistics`: `/tpd stats` komutuna erişim sağlar.
PlaceholderAPI Entegrasyonu Eğer sunucunuzda PlaceholderAPI yüklüyse, aşağıdaki placeholder'ları kullanabilirsiniz:
`%tpd_count%`: Oyuncunun tespit edilen toplam küfür/uygunsuz mesaj sayısı.
`%tpd_total%`: Sunucudaki tüm oyuncuların toplam tespit edilen küfür/uygunsuz mesaj sayısı.
`%tpd_status%`: Kynux AI API bağlantı durumu (Bu placeholder gelecekte eklenebilir, şu an için "Aktif" döner).
(Gelecekte daha fazla placeholder eklenebilir: ortalama şiddet, son tespit vb.)
Discord Webhook Entegrasyonu Tespit edilen uygunsuz içerikleri anında Discord sunucunuza bildirmek için webhook entegrasyonunu kullanabilirsiniz. `config.yml` dosyasındaki `actions.discord` bölümünü yapılandırmanız yeterlidir:
Code (YAML):
actions:
discord:
enabled: true
# false ise devre dışı webhook-url: "YOUR_DISCORD_WEBHOOK_URL_HERE" username: "Küfür Koruması"# Webhook'un Discord'da görünecek adı avatar-url: ""# Webhook avatar URL'si (isteğe bağlı) embed-color: "#FF0000"# Embed mesajının kenar rengi (HEX kodu) notify-severity-level: 3
# Sadece bu şiddet seviyesi ve üzerindeki tespitler bildirilir (1-5)
❓ Sıkça Sorulan Sorular (SSS)
Bu hata genellikle sunucunuzun Kynux AI API'sine erişemediğini gösterir. Şunları kontrol edin:
Sunucunuzun internet bağlantısının aktif olduğundan emin olun.
Sunucu güvenlik duvarınızın (firewall) veya ağ yapılandırmanızın giden HTTPS (genellikle port 443) bağlantılarına izin verdiğinden emin olun.
`config.yml` dosyasındaki `kynux_api.url` adresinin doğru ve erişilebilir olduğunu kontrol edin.
`config.yml` dosyasındaki `kynux_api.key` alanına geçerli bir Kynux AI API anahtarı girdiğinizden emin olun. API anahtarı olmadan istekler başarısız olacaktır.
`kynux_api.timeout` değerini, özellikle yavaş bağlantılarda veya yoğun API kullanımında, gerekirse artırmayı deneyin.
Bu sorun genellikle aşağıdaki nedenlerden kaynaklanır:
PlaceholderAPI eklentisinin sunucunuzda kurulu ve güncel olduğundan emin olun.
Sunucunuzu yeniden başlatmayı deneyin. Bazen eklenti yükleme sıralaması sorunlara yol açabilir.
PlaceholderAPI yüklendikten sonra Turkish Profanity Detection eklentisinin yüklendiğinden emin olun.
Konsolda `/papi reload` komutunu kullanarak PlaceholderAPI'yi yeniden yüklemeyi deneyin.
Evet, Kynux AI (özellikle GPT tabanlı modeller) birçok dili anlayabilir ve analiz edebilir. Eklenti şu anda özel olarak bir dil yapılandırması sunmasa da, Kynux AI'a gönderilen sistem mesajı (system prompt) AI'nın genel dil yeteneklerini kullanmasını sağlar. Eğer belirli dillerde daha iyi sonuçlar almak veya AI'nın davranışını o dillere göre özelleştirmek isterseniz, `KynuxAIService.java` içindeki `systemPrompt` değişkenini buna göre düzenleyebilirsiniz.