{"id":29023474,"url":"https://github.com/kynuxdev/aichat","last_synced_at":"2026-03-05T21:05:02.577Z","repository":{"id":286491609,"uuid":"961316941","full_name":"KynuxDev/AiChat","owner":"KynuxDev","description":"🤖 AiChat: Minecraft sunucunuzu KynuxCloud'un güçlü yapay zeka modelleriyle donatın! Oyuncularınız GPT-4, Claude ve daha fazlasıyla gerçek zamanlı sohbet edebilir. Kolay kurulum, yüksek performans, oyuncu başına özelleştirilebilir konuşma geçmişi.","archived":false,"fork":false,"pushed_at":"2025-06-19T09:38:53.000Z","size":137,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-27T11:02:05.396Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KynuxDev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-06T08:54:54.000Z","updated_at":"2025-06-19T09:38:56.000Z","dependencies_parsed_at":"2025-04-06T20:25:06.020Z","dependency_job_id":"a630e06b-345c-4da5-817c-dc5e09551598","html_url":"https://github.com/KynuxDev/AiChat","commit_stats":null,"previous_names":["kynuxdev/aichat"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/KynuxDev/AiChat","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KynuxDev%2FAiChat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KynuxDev%2FAiChat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KynuxDev%2FAiChat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KynuxDev%2FAiChat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KynuxDev","download_url":"https://codeload.github.com/KynuxDev/AiChat/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KynuxDev%2FAiChat/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30149951,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T16:58:46.102Z","status":"ssl_error","status_checked_at":"2026-03-05T16:58:45.706Z","response_time":93,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-26T03:30:29.154Z","updated_at":"2026-03-05T21:05:02.559Z","avatar_url":"https://github.com/KynuxDev.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🤖 Minecraft AI Chat Eklentisi | Lora Project Entegrasyonu\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Minecraft-1.16.5%2B-brightgreen\" alt=\"Minecraft 1.16.5+\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/API-KynuxCloud-blue\" alt=\"KynuxCloud API\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Versiyon-1.1-orange\" alt=\"Versiyon 1.1\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Güvenlik-Üst_Düzey-red\" alt=\"Güvenlik\" /\u003e\n  \u003cbr /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Grok--3--Mini-Desteklenir-blueviolet\" alt=\"Grok-3-mini\" /\u003e\n\u003c/div\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cb\u003eMinecraft sunucunuzda yapay zeka ile sohbeti bir üst seviyeye taşıyın!\u003c/b\u003e\n\u003c/p\u003e\n\n## 📋 İçindekiler\n\n- [🌟 Genel Bakış](#-genel-bakış)\n- [✨ Temel Özellikler](#-temel-özellikler)\n- [🔧 Kurulum](#-kurulum)\n- [⚙️ Yapılandırma](#️-yapılandırma)\n- [📢 Komutlar](#-komutlar)\n- [🛡️ İzinler](#️-izinler)\n- [🧩 Gelişmiş Özellikler](#-gelişmiş-özellikler)\n- [🚀 Performans Optimizasyonu](#-performans-optimizasyonu)\n- [🔐 Güvenlik Önlemleri](#-güvenlik-önlemleri)\n- [❓ Sık Sorulan Sorular](#-sık-sorulan-sorular)\n- [📘 API Entegrasyonu](#-api-entegrasyonu)\n- [🛠️ Geliştirici Bilgileri](#️-geliştirici-bilgileri)\n- [🔮 Gelecek Özellikler](#-gelecek-özellikler)\n- [📞 Destek ve İletişim](#-destek-ve-iletişim)\n\n## 🌟 Genel Bakış\n\nAiChat eklentisi, Minecraft sunucunuzda oyuncuların gelişmiş yapay zeka modelleriyle anlık olarak iletişim kurmasını sağlar. Lora Project'un güçlü yapay zeka API altyapısını kullanarak, en gelişmiş dil modellerine erişim sağlar ve oyuncularınıza benzersiz bir deneyim sunar.\n\n## ✨ Temel Özellikler\n\n### 💬 Sohbet Entegrasyonu\n- **Komut Tabanlı Erişim**: `/ai \u003cmesaj\u003e` komutu ile anında AI asistana ulaşma\n- **Sohbet Tetikleyicisi**: Normal sohbette `ai \u003cmesaj\u003e` yazarak AI ile konuşabilme\n- **Renkli Yanıtlar**: Özelleştirilebilir renk kodları ile AI yanıtlarında görsel zenginlik\n- **Oyuncu Bazlı Konuşma Geçmişi**: Her oyuncu için ayrı konuşma akışı\n\n### 🧠 Yapay Zeka Özellikleri\n- **Çoklu Model Desteği**: OpenAI, Anthropic, Google ve Cohere'in en güncel modellerini kullanabilme\n- **Kişiselleştirilebilir Sistem Mesajı**: AI'nın karakterini ve yanıt tarzını belirleyebilme\n- **Yaratıcılık Ayarı**: Temperature değerini değiştirerek AI yanıtlarının yaratıcılık seviyesini ayarlama\n- **Token Limiti**: Yanıt uzunluğunu kontrol edebilme\n\n### ⚙️ Yönetim Araçları\n- **Kolay Yapılandırma**: Basit config.yml dosyası ile tüm ayarları özelleştirme\n- **Yeniden Yükleme**: `/ai reload` komutu ile yapılandırma değişikliklerini anında uygulama\n- **Konuşma Geçmişi Yönetimi**: Bireysel veya toplu konuşma geçmişi temizleme\n- **Model Listesi**: Kullanılabilir güncel modelleri görüntüleme\n\n## ⚙️ Yapılandırma\n\nAiChat eklentisi, kapsamlı ve detaylı bir yapılandırma dosyası (`config.yml`) sunar:\n\n```yaml\n# API Yapılandırması\napi:\n  url: 'http://ai.kynux.cloud/api/v1/chat/completions'\n  key: 'YOUR_API_KEY'  # KynuxCloud API anahtarınız\n  model: 'grok-3-mini'      # Tercih ettiğiniz model\n  temperature: 0.7     # Yaratıcılık seviyesi (0.0-1.0)\n  max_tokens: 1000     # Maksimum yanıt uzunluğu\n\n# Sohbet Yapılandırması\nchat:\n  system_prompt: 'Sen yardımcı bir asistansın. Minecraft oyuncusuna kısa ve öz yanıtlar ver.'\n  prefix: '\u0026b[AI] \u0026r'  # AI yanıtlarının öneki (renk kodları desteklenir)\n  \n  # Sohbet Tetikleyici Özelliği\n  chat_trigger:\n    enabled: true      # Sohbette ai \u003cmesaj\u003e yazarak kullanabilme\n    keyword: 'ai'      # Tetikleyici kelime\n```\n\n### Yapılandırma Seçenekleri Açıklaması\n\n#### API Yapılandırması\n- **url**: Lora Project API endpoint'i (değiştirmeyin)\n- **key**: Lora Project API anahtarınız\n- **model**: Kullanılacak AI modeli (güncel liste için `/ai models` komutunu kullanın)\n- **temperature**: AI yanıtlarının yaratıcılık/rastgelelik seviyesi\n  - 0.0: Çok tutarlı, deterministik yanıtlar\n  - 0.7: Dengeli yaratıcılık (önerilen)\n  - 1.0: Maksimum yaratıcılık, daha az tutarlı\n- **max_tokens**: Yanıt için maksimum token sayısı (daha büyük değerler daha uzun yanıtlar üretir)\n\n#### Sohbet Yapılandırması\n- **system_prompt**: AI'nın karakterini ve davranışını belirleyen sistem mesajı\n- **prefix**: AI yanıtlarının başına eklenecek önek (renk kodları: \u00260-\u00269, \u0026a-\u0026f, \u0026k-\u0026o)\n- **chat_trigger**: Sohbet kutusundan tetikleme özelliği\n  - enabled: Özelliği açar/kapatır\n  - keyword: Tetikleyici kelime (örn: \"ai yardım et\" yazıldığında çalışır)\n\n## 📢 Komutlar\n\nAiChat eklentisi, kullanımı kolay bir komut seti sunar:\n\n| Komut | Açıklama | İzin |\n|-------|----------|------|\n| `/ai \u003cmesaj\u003e` | AI'ya mesaj gönderir ve yanıt alır | `aichat.ai` |\n| `/ai clear` | Kendi konuşma geçmişinizi temizler | `aichat.ai` |\n| `/ai clearall` | Tüm oyuncuların konuşma geçmişlerini temizler | `aichat.admin` |\n| `/ai reload` | Yapılandırma dosyasını yeniden yükler | `aichat.admin` |\n| `/ai models` | Kullanılabilir AI modellerini listeler | `aichat.admin` |\n\n### Otomatik Tamamlama\n\nTüm komutlar Tab tuşu ile otomatik tamamlama özelliğini destekler. Örneğin:\n- `/ai c` + TAB → `/ai clear`\n- `/ai re` + TAB → `/ai reload`\n\n## 🛡️ İzinler\n\nAiChat eklentisi, basit ve etkili bir izin sistemi kullanır:\n\n| İzin | Açıklama | Varsayılan |\n|------|----------|------------|\n| `aichat.ai` | `/ai` komutunu kullanabilme | Tüm oyuncular |\n| `aichat.admin` | Yönetici komutlarını kullanabilme | Operatörler |\n\nPermissions eklentinizde bu izinleri özelleştirebilirsiniz:\n\n```yaml\npermissions:\n  aichat.ai:\n    description: Yapay zeka ile sohbet etme izni\n    default: true\n  aichat.admin:\n    description: AiChat yönetici komutlarını kullanma izni\n    default: op\n```\n\n## 🧩 Gelişmiş Özellikler\n\n### 📜 Konuşma Geçmişi Yönetimi\nAiChat, her oyuncu için ayrı bir konuşma geçmişi tutar ve en son 10 mesajı hatırlar. Bu, AI'nın bağlam içinde kalmasını ve tutarlı yanıtlar vermesini sağlar. Oyuncular `/ai clear` komutu ile kendi geçmişlerini temizleyebilir.\n\n### 🎭 Kişiselleştirilmiş AI Karakteri\n`system_prompt` ayarını değiştirerek AI'nın davranışını ve kişiliğini tamamen özelleştirebilirsiniz. Örneğin:\n\n```yaml\nsystem_prompt: 'Sen Minecraft uzmanı bir asistansın. Oyunculara Minecraft hakkındaki sorularında kısa ve bilgilendirici yanıtlar ver. Esprili bir tarzın var ve cevaplarında Minecraft terimleri kullanmayı seviyorsun.'\n```\n\n### 🎨 Renk Kodları\nAI yanıtlarında Minecraft renk kodlarını kullanabilirsiniz:\n\n| Kod | Renk | Kod | Renk |\n|-----|------|-----|------|\n| \u00260 | Siyah | \u00268 | Koyu Gri |\n| \u00261 | Koyu Mavi | \u00269 | Mavi |\n| \u00262 | Koyu Yeşil | \u0026a | Yeşil |\n| \u00263 | Koyu Aqua | \u0026b | Aqua |\n| \u00264 | Koyu Kırmızı | \u0026c | Kırmızı |\n| \u00265 | Mor | \u0026d | Pembe |\n| \u00266 | Altın | \u0026e | Sarı |\n| \u00267 | Gri | \u0026f | Beyaz |\n\nBiçimlendirme kodları:  \n\u0026k (Sihirli), \u0026l (Kalın), \u0026m (Üstü çizili), \u0026n (Altı çizili), \u0026o (İtalik), \u0026r (Sıfırla)\n\n## 🚀 Performans Optimizasyonu\n\nAiChat eklentisi, sunucu performansını en üst düzeyde tutmak için tasarlanmıştır:\n\n- **Asenkron API İstekleri**: Tüm API çağrıları arka planda asenkron olarak işlenir, böylece ana sunucu thread'i engellenmez.\n- **Otomatik Konuşma Yönetimi**: Konuşma geçmişi otomatik olarak optimize edilir, çok uzun geçmişler kısaltılır.\n- **OkHttp3 ile Verimli Bağlantı**: Modern HTTP istemcisi ile hızlı ve güvenilir API iletişimi.\n- **Hafıza Optimizasyonu**: Yalnızca aktif oyuncuların konuşma geçmişleri bellekte tutulur.\n\n## 🔐 Güvenlik Önlemleri\n\n### API Anahtarı Güvenliği\n- API anahtarınızı **kesinlikle gizli tutun**\n- `config.yml` dosyasına sınırlı erişim sağlayın\n- API anahtarınızı düzenli olarak değiştirin\n\n### Veri Güvenliği\n- Oyuncu konuşmaları Lora Project'un güvenli altyapısında işlenir\n- Hassas bilgiler şifrelenir ve güvenli bir şekilde iletilir\n- Tüm veri aktarımları modern güvenlik protokolleri kullanılarak gerçekleştirilir\n\n## ❓ Sık Sorulan Sorular\n\n### Eklenti sunucu performansımı etkiler mi?\nHayır. AiChat, tüm API isteklerini asenkron olarak işler ve ana sunucu thread'ini engellemez. Oyuncular AI ile konuşurken bile sunucunuz tam performansla çalışmaya devam eder.\n\n### Konuşma geçmişi nerede saklanır?\nKonuşma geçmişi, bellekte (RAM) tutulur ve sunucu kapatıldığında silinir. Kalıcı depolama yapılmaz. Bu, hem performans hem de gizlilik açısından avantaj sağlar.\n\n### Bir mesajın maximum uzunluğu nedir?\nMinecraft sohbet mesajlarının sınırı 256 karakterdir. AiChat, uzun AI yanıtlarını otomatik olarak bölerek birden fazla mesaj halinde gönderir.\n\n### Promethium, Claude ve diğer modeller arasında ne fark var?\nHer model farklı özelliklere, uzmanlık alanlarına ve yanıt stillerine sahiptir. Örneğin, Claude modelleri daha yaratıcı ve akıcı yanıtlar verirken, GPT modelleri teknik konularda daha başarılıdır. `/ai models` komutu ile tüm modelleri görebilir ve ihtiyacınıza en uygun modeli seçebilirsiniz.\n\n## 🛠️ Geliştirici Bilgileri\n\nAiChat eklentisi aşağıdaki teknolojileri kullanır:\n\n- **Java 17+**: Modern Java özellikleri\n- **Spigot/Bukkit API**: Minecraft sunucu entegrasyonu\n- **OkHttp3**: Hızlı ve güvenilir HTTP istekleri\n- **Jackson**: JSON işleme ve serileştirme\n- **CompletableFuture**: Asenkron işlem yönetimi\n\n### Projeyi Geliştirme\n\n1. Git deposunu klonlayın:\n   ```bash\n   git clone https://github.com/kynuxcloud/aichat.git\n   ```\n\n2. Maven ile bağımlılıkları yükleyin:\n   ```bash\n   cd aichat\n   mvn install\n   ```\n\n3. Kod değişikliklerinizi yapın\n\n4. Projeyi derleyin:\n   ```bash\n   mvn clean package\n   ```\n\n5. `target/aichat-1.0.jar` dosyasını test sunucunuzda çalıştırın\n\n## 🔮 Gelecek Özellikler\n\nAiChat ekibi sürekli olarak yeni özellikler geliştirmektedir. Yakında gelmesi planlanan özellikler:\n\n- **Görsel Anlama**: Görselleri anlama ve açıklama yeteneği\n- **Çoklu Dil Desteği**: Otomatik dil algılama ve çeviri\n- **Sohbet Arayüzü**: Özel GUI ile daha gelişmiş sohbet deneyimi\n- **Webhook Entegrasyonu**: Discord ve diğer platformlarla entegrasyon\n- **Sohbet Kayıtları**: İsteğe bağlı olarak konuşmaları diske kaydetme\n- **NPC Entegrasyonu**: Citizens gibi eklentilerle AI destekli NPC'ler oluşturma\n\n## 📞 Destek ve İletişim\n\nAiChat eklentisi ve KynuxCloud hizmetleri hakkında destek almak için:\n\n- **Discord (LoraProject)**: [Lora Project](https://discord.gg/Cgz29e3Fu3) \n- **Discord (KynuxCloud)**: [KynuxCloud Discord Sunucusu](https://discord.gg/wCK5dVSY2n)\n- **Website**: [kynux.cloud](https://kynux.cloud)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Minecraft-1.16.5%2B-brightgreen\" alt=\"Minecraft 1.16.5+\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Lisans-MIT-blue\" alt=\"MIT License\" /\u003e\n  \u003cp\u003e© 2025 KynuxCloud - Tüm hakları saklıdır.\u003c/p\u003e\n  \u003cp\u003eAiChat, KynuxCloud'un resmi eklentisidir.\u003c/p\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkynuxdev%2Faichat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkynuxdev%2Faichat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkynuxdev%2Faichat/lists"}