Minecraft sunucunuzda yapay zeka ile sohbeti bir üst seviyeye taşıyın!
- 🌟 Genel Bakış
- ✨ Temel Özellikler
- 🔧 Kurulum
- ⚙️ Yapılandırma
- 📢 Komutlar
- 🛡️ İzinler
- 🧩 Gelişmiş Özellikler
- 🚀 Performans Optimizasyonu
- 🔐 Güvenlik Önlemleri
- ❓ Sık Sorulan Sorular
- 📘 API Entegrasyonu
- 🛠️ Geliştirici Bilgileri
- 🔮 Gelecek Özellikler
- 📞 Destek ve İletişim
AiChat 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.
- Komut Tabanlı Erişim:
/ai <mesaj>komutu ile anında AI asistana ulaşma - Sohbet Tetikleyicisi: Normal sohbette
ai <mesaj>yazarak AI ile konuşabilme - Renkli Yanıtlar: Özelleştirilebilir renk kodları ile AI yanıtlarında görsel zenginlik
- Oyuncu Bazlı Konuşma Geçmişi: Her oyuncu için ayrı konuşma akışı
- Çoklu Model Desteği: OpenAI, Anthropic, Google ve Cohere'in en güncel modellerini kullanabilme
- Kişiselleştirilebilir Sistem Mesajı: AI'nın karakterini ve yanıt tarzını belirleyebilme
- Yaratıcılık Ayarı: Temperature değerini değiştirerek AI yanıtlarının yaratıcılık seviyesini ayarlama
- Token Limiti: Yanıt uzunluğunu kontrol edebilme
- Kolay Yapılandırma: Basit config.yml dosyası ile tüm ayarları özelleştirme
- Yeniden Yükleme:
/ai reloadkomutu ile yapılandırma değişikliklerini anında uygulama - Konuşma Geçmişi Yönetimi: Bireysel veya toplu konuşma geçmişi temizleme
- Model Listesi: Kullanılabilir güncel modelleri görüntüleme
AiChat eklentisi, kapsamlı ve detaylı bir yapılandırma dosyası (config.yml) sunar:
# API Yapılandırması
api:
url: 'http://ai.kynux.cloud/api/v1/chat/completions'
key: 'YOUR_API_KEY' # KynuxCloud API anahtarınız
model: 'grok-3-mini' # Tercih ettiğiniz model
temperature: 0.7 # Yaratıcılık seviyesi (0.0-1.0)
max_tokens: 1000 # Maksimum yanıt uzunluğu
# Sohbet Yapılandırması
chat:
system_prompt: 'Sen yardımcı bir asistansın. Minecraft oyuncusuna kısa ve öz yanıtlar ver.'
prefix: '&b[AI] &r' # AI yanıtlarının öneki (renk kodları desteklenir)
# Sohbet Tetikleyici Özelliği
chat_trigger:
enabled: true # Sohbette ai <mesaj> yazarak kullanabilme
keyword: 'ai' # Tetikleyici kelime- url: Lora Project API endpoint'i (değiştirmeyin)
- key: Lora Project API anahtarınız
- model: Kullanılacak AI modeli (güncel liste için
/ai modelskomutunu kullanın) - temperature: AI yanıtlarının yaratıcılık/rastgelelik seviyesi
- 0.0: Çok tutarlı, deterministik yanıtlar
- 0.7: Dengeli yaratıcılık (önerilen)
- 1.0: Maksimum yaratıcılık, daha az tutarlı
- max_tokens: Yanıt için maksimum token sayısı (daha büyük değerler daha uzun yanıtlar üretir)
- system_prompt: AI'nın karakterini ve davranışını belirleyen sistem mesajı
- prefix: AI yanıtlarının başına eklenecek önek (renk kodları: &0-&9, &a-&f, &k-&o)
- chat_trigger: Sohbet kutusundan tetikleme özelliği
- enabled: Özelliği açar/kapatır
- keyword: Tetikleyici kelime (örn: "ai yardım et" yazıldığında çalışır)
AiChat eklentisi, kullanımı kolay bir komut seti sunar:
| Komut | Açıklama | İzin |
|---|---|---|
/ai <mesaj> |
AI'ya mesaj gönderir ve yanıt alır | aichat.ai |
/ai clear |
Kendi konuşma geçmişinizi temizler | aichat.ai |
/ai clearall |
Tüm oyuncuların konuşma geçmişlerini temizler | aichat.admin |
/ai reload |
Yapılandırma dosyasını yeniden yükler | aichat.admin |
/ai models |
Kullanılabilir AI modellerini listeler | aichat.admin |
Tüm komutlar Tab tuşu ile otomatik tamamlama özelliğini destekler. Örneğin:
/ai c+ TAB →/ai clear/ai re+ TAB →/ai reload
AiChat eklentisi, basit ve etkili bir izin sistemi kullanır:
| İzin | Açıklama | Varsayılan |
|---|---|---|
aichat.ai |
/ai komutunu kullanabilme |
Tüm oyuncular |
aichat.admin |
Yönetici komutlarını kullanabilme | Operatörler |
Permissions eklentinizde bu izinleri özelleştirebilirsiniz:
permissions:
aichat.ai:
description: Yapay zeka ile sohbet etme izni
default: true
aichat.admin:
description: AiChat yönetici komutlarını kullanma izni
default: opAiChat, 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.
system_prompt ayarını değiştirerek AI'nın davranışını ve kişiliğini tamamen özelleştirebilirsiniz. Örneğin:
system_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.'AI yanıtlarında Minecraft renk kodlarını kullanabilirsiniz:
| Kod | Renk | Kod | Renk |
|---|---|---|---|
| &0 | Siyah | &8 | Koyu Gri |
| &1 | Koyu Mavi | &9 | Mavi |
| &2 | Koyu Yeşil | &a | Yeşil |
| &3 | Koyu Aqua | &b | Aqua |
| &4 | Koyu Kırmızı | &c | Kırmızı |
| &5 | Mor | &d | Pembe |
| &6 | Altın | &e | Sarı |
| &7 | Gri | &f | Beyaz |
Biçimlendirme kodları:
&k (Sihirli), &l (Kalın), &m (Üstü çizili), &n (Altı çizili), &o (İtalik), &r (Sıfırla)
AiChat eklentisi, sunucu performansını en üst düzeyde tutmak için tasarlanmıştır:
- Asenkron API İstekleri: Tüm API çağrıları arka planda asenkron olarak işlenir, böylece ana sunucu thread'i engellenmez.
- Otomatik Konuşma Yönetimi: Konuşma geçmişi otomatik olarak optimize edilir, çok uzun geçmişler kısaltılır.
- OkHttp3 ile Verimli Bağlantı: Modern HTTP istemcisi ile hızlı ve güvenilir API iletişimi.
- Hafıza Optimizasyonu: Yalnızca aktif oyuncuların konuşma geçmişleri bellekte tutulur.
- API anahtarınızı kesinlikle gizli tutun
config.ymldosyasına sınırlı erişim sağlayın- API anahtarınızı düzenli olarak değiştirin
- Oyuncu konuşmaları Lora Project'un güvenli altyapısında işlenir
- Hassas bilgiler şifrelenir ve güvenli bir şekilde iletilir
- Tüm veri aktarımları modern güvenlik protokolleri kullanılarak gerçekleştirilir
Hayı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.
Konuş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.
Minecraft 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.
Her 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.
AiChat eklentisi aşağıdaki teknolojileri kullanır:
- Java 17+: Modern Java özellikleri
- Spigot/Bukkit API: Minecraft sunucu entegrasyonu
- OkHttp3: Hızlı ve güvenilir HTTP istekleri
- Jackson: JSON işleme ve serileştirme
- CompletableFuture: Asenkron işlem yönetimi
-
Git deposunu klonlayın:
git clone https://github.com/kynuxcloud/aichat.git
-
Maven ile bağımlılıkları yükleyin:
cd aichat mvn install -
Kod değişikliklerinizi yapın
-
Projeyi derleyin:
mvn clean package
-
target/aichat-1.0.jardosyasını test sunucunuzda çalıştırın
AiChat ekibi sürekli olarak yeni özellikler geliştirmektedir. Yakında gelmesi planlanan özellikler:
- Görsel Anlama: Görselleri anlama ve açıklama yeteneği
- Çoklu Dil Desteği: Otomatik dil algılama ve çeviri
- Sohbet Arayüzü: Özel GUI ile daha gelişmiş sohbet deneyimi
- Webhook Entegrasyonu: Discord ve diğer platformlarla entegrasyon
- Sohbet Kayıtları: İsteğe bağlı olarak konuşmaları diske kaydetme
- NPC Entegrasyonu: Citizens gibi eklentilerle AI destekli NPC'ler oluşturma
AiChat eklentisi ve KynuxCloud hizmetleri hakkında destek almak için:
- Discord (LoraProject): Lora Project
- Discord (KynuxCloud): KynuxCloud Discord Sunucusu
- Website: kynux.cloud
© 2025 KynuxCloud - Tüm hakları saklıdır.
AiChat, KynuxCloud'un resmi eklentisidir.