<p align="center"> <img src="https://api.kynux.cloud/img/kynuxcloud-logo.png" alt="Turkish Profanity Detection Banner"> <br> <h1>🛡️ Turkish Profanity Detection 🛡️</h1> <strong>Minecraft Sunucunuz İçin Gelişmiş Türkçe Küfür ve Hakaret Tespit Sistemi</strong> <br> <a href="https://github.com/KynuxDev/turkish-profanity-detection-plugin/releases"><img src="https://img.shields.io/badge/version-1.0.1-blue.svg" alt="Version"></a> <a href="https://www.minecraft.net"><img src="https://img.shields.io/badge/Minecraft-1.8--1.20%2B-green.svg" alt="Minecraft Version"></a> <a href="https://discord.gg/wCK5dVSY2n"><img src="https://img.shields.io/discord/1279438641684283434?color=5865F2&label=discord&logo=discord&logoColor=white" alt="Discord"></a> </p> ## ✨ Genel Bakış Turkish Profanity Detection, Minecraft sunucularınız için **Kynux AI destekli**, Türkçe odaklı, gelişmiş bir küfür ve uygunsuz içerik tespit sistemidir. Bu eklenti, basit kelime filtrelerinin ötesine geçerek, yapay zeka algoritmalarıyla mesajların bağlamını anlar, gizlenmiş küfürleri, hakaretleri, nefret söylemini ve diğer istenmeyen içerikleri etkili bir şekilde tespit eder. Amacımız, sunucunuzda daha güvenli ve pozitif bir sohbet ortamı oluşturmanıza yardımcı olmaktır. ## 🌟 Son Güncelleme Vurguları (Sürüm X.Y.Z): Kynux AI Entegrasyonu! 🌟 * **Ana Analiz Motoru Artık Kynux AI:** Tüm içerik analizleri, daha isabetli ve esnek sonuçlar için Kynux AI ((https://api.kynux.cloud/api/v1/chat/completion)) üzerinden gerçekleştirilmektedir. * **Sadeleştirilmiş ve Güçlendirilmiş Yapılandırma:** `config.yml` dosyası, Kynux AI entegrasyonuna odaklanacak şekilde yeniden düzenlendi. API anahtarınızı ve model tercihinizi kolayca yönetebilirsiniz. * **Detaylı Analiz Kayıtları:** Kynux AI'dan gelen `analysisDetails` gibi önemli bilgiler artık istatistik kayıtlarınızda saklanıyor. * **Kod Optimizasyonu:** Eklentinin genel kod tabanında performans ve okunabilirlik iyileştirmeleri yapıldı. * **.gitignore Eklendi:** Proje yönetimi için standart bir `.gitignore` dosyası eklendi. ## 📱 Temel Özellikler * **🧠 Gelişmiş Yapay Zeka Analizi:** * Kynux AI (örn: O3-mini, GPT-4) entegrasyonu ile esnek ve güçlü içerik analizi. * Karakter değiştirme (a yerine @), argo ve fonetik benzerlikleri anlama yeteneği. * Yapılandırılabilir sistem mesajları ile AI davranışını yönlendirme imkanı. * **⚡ Akıllı Aksiyon Sistemi:** * Kynux AI tarafından önerilen otomatik aksiyonlar (uyarı, susturma, atma, yasaklama). * İçeriğin ciddiyetine göre yapılandırılabilir yaptırımlar. * Tekrarlayan ihlaller için kademeli ceza seçenekleri (`config.yml` üzerinden ayarlanabilir). * **📊 Detaylı İstatistikler ve Raporlama:** * Oyuncu bazlı küfür ve uygunsuz içerik kullanım istatistikleri. * Tespit edilen kelime, kategori, şiddet seviyesi ve AI analiz detayları. * MySQL veya SQLite veritabanı desteği ile kalıcı veri saklama. * Kullanışlı Admin GUI (`/tpd admin`) üzerinden istatistiklere erişim ve yönetim. * **🔌 Geniş Entegrasyon Seçenekleri:** * Discord webhook entegrasyonu ile anlık bildirimler. * PlaceholderAPI desteği ile eklenti verilerini diğer eklentilerle kullanma. * **🚀 Performans Odaklı Tasarım:** * Asenkron API çağrıları ve veritabanı işlemleri ile sunucu performansını etkilemez. * Akıllı mesaj önbellekleme sistemi ile gereksiz API isteklerini azaltır. * Optimize edilmiş veritabanı sorguları ve bağlantı havuzu (HikariCP). * **🔒 Güvenlik ve Kontrol:** * API anahtarı ile güvenli bağlantı. * Mesaj gönderme hızı sınırlaması (Rate Limiting). * Belirli oyuncular veya gruplar için bypass izni (`turkishprofanitydetection.bypass`). ## 🛠️ Kurulum 1. En son `.jar` dosyasını (https://github.com/KynuxDev/turkish-profanity-detection-plugin/releases) sayfamızdan indirin. 2. İndirdiğiniz dosyayı sunucunuzun `plugins` klasörüne yerleştirin. 3. Sunucunuzu yeniden başlatın. 4. `plugins/TurkishProfanityDetection/config.yml` dosyasını açın ve **mutlaka `kynux_api.key` alanına geçerli Kynux AI API anahtarınızı girin**. Diğer ayarları da isteğinize göre düzenleyebilirsiniz. 5. Gerekirse `/tpd reload` komutu ile eklentiyi yeniden yükleyin. Daha detaylı kurulum, yapılandırma, komutlar ve izinler hakkında bilgi için lütfen (https://github.com/KynuxDev/turkish-profanity-detection-plugin/blob/main/README.md) dosyamızı inceleyin. --- Bu platformda ayrı bir "Documentation" bölümü olmadığı için, temel kurulum adımlarını ve daha detaylı bilgi için GitHub README'ye yönlendirmeyi bu ana açıklama kısmına dahil ettim. Eğer platformun ayrı bir "Wiki" veya "Documentation" sekmesi varsa, `README.md` dosyasındaki "Yapılandırma", "Komutlar ve İzinler", "PlaceholderAPI Entegrasyonu", "Discord Webhook Entegrasyonu" ve "SSS" gibi bölümleri oraya taşıyabilirsiniz.