TanıtımDyDiscord — Türkçe Destekli Minecraft–Discord Entegrasyon Eklentisi [1.20.x - 26.x]

DyDiscord​

Türkçe destekli, yapılandırılabilir Minecraft–Discord entegrasyonu
Güncel Sürüm: v1.0.1-BETA

Merhaba MC-TR ailesi,

DyDiscord, Minecraft sunucunuz ile Discord topluluğunuzu birbirine bağlamak için geliştirdiğim bir eklentidir. Oyuncuların hesaplarını eşlemesini, iki platform arasında sohbet etmesini ve Minecraft rütbelerinin Discord rollerine aktarılmasını sağlar. Sunucu yöneticileri ayrıca oyuncu bildirimlerini, boost ödüllerini ve özel konsol kanalını yapılandırabilir.

Bot doğrudan Minecraft sunucusunda çalışır. Kendi Discord botunuzu kullanabilirsiniz; ayrı bir bot uygulaması veya harici veritabanı kurmanız gerekmez. Kullanmak istediğiniz özellikleri ayrı ayrı etkinleştirebilirsiniz.

Değerli ziyaretçimiz, içeriği görebilmek için şimdi giriş yapın veya kayıt olun.

---

Öne Çıkan Özellikler​

Hesap Eşleme Sistemi​

• Oyuncular oyun içinden aldıkları kısa süreli kodla Minecraft ve Discord hesaplarını eşleyebilir.
• Her Minecraft hesabı bir Discord hesabıyla eşlenebilir.
• Hesap bilgileri Discord’da özel yanıtlarla gösterilir.
• Mesajlarda ham hesap ID’leri yerine kullanıcı adları kullanılır.
• Oyuncular eşlemelerini onay vererek kaldırabilir.
• Eşlenen hesaplar sunucu yeniden başlatıldığında korunur.

Hesap Paneli ve Komutlar​

• Hesap Eşle, Eşlemeyi Kaldır ve Hesabım butonları tek panelde bulunur.
• Panel varsayılan olarak Discord sunucunuzun simgesini kullanır; farklı bir görsel belirlenebilir.
• Panel yenilendiğinde mevcut mesaj güncellenir.
• İstenirse panel kapatılıp hesap işlemleri Discord komutlarıyla yapılabilir.
• Panel tekrar açıldığında mevcut panel kaydı ve hesaplar korunur.

İki Yönlü Sohbet​

• Minecraft sohbeti Discord’a, Discord sohbeti Minecraft’a aktarılabilir.
• İki yön birbirinden bağımsız açılıp kapatılabilir.
• Sohbet için konsol ve hesap eşleme kanallarından ayrı bir kanal belirlenir.
• Mesaj biçimleri yapılandırılabilir.
• Minecraft tarafındaki rütbeler LuckPerms veya Vault Chat üzerinden gösterilebilir.
• Discord mesajlarında sunucudaki görünen ad ve uygun en yüksek rol kullanılır.
• Aktarılan Minecraft mesajları Discord’da kullanıcı, rol veya herkese yönelik bildirim oluşturmaz.

Özel veya moderasyon uygulanan sohbetlerin açığa çıkmasını önlemek için tanınmayan Minecraft sohbet eklentilerinde dışarıya aktarım durdurulur. Bu eklentilerle uyumluluk ayrıca değerlendirilmelidir.

Discord Rol Entegrasyonu​

• Hesabını eşleyen oyunculara bir veya birden fazla Discord rolü verilebilir.
• Eşlenen hesap rolü için LuckPerms zorunlu değildir.
• LuckPerms grupları Discord rol ID’leriyle eşleştirilebilir.
• Bir Minecraft grubuna birden fazla Discord rolü bağlanabilir.
• Doğrudan, miras alınan ve geçici grup üyelikleri değerlendirilir.
• Geçici rütbesi biten çevrimdışı oyuncuların Discord rolleri de kontrol edilir.
• Eşleme kaldırıldığında veya bir rol kuralı silindiğinde ilgili roller için temizleme işlemi yapılır.
• Yalnızca yapılandırılan roller yönetilir; kullanıcının diğer rollerine dokunulmaz.
• Rol değişiklikleri önizlenebilir ve bağlı hesaplar kademeli olarak eşitlenebilir.

Senkronizasyon Minecraft → Discord yönündedir. Discord rolü üzerinden Minecraft grubu, yetki veya OP verilmez.

Boost Ödülleri​

• Discord sunucusuna boost basan eşlenmiş oyuncular için ödül komutları çalıştırılabilir.
• Mevcut eklentilerinizin komutlarıyla geçici rütbe, oyun parası veya site kredisi verilebilir.
• Komutlarda oyuncu adı ve UUID kullanılabilir.
• Kesintisiz boost dönemi için ödül kaydı ve bekleme süresi uygulanır.
• Boost sona erdiğinde veya hesap eşlemesi kaldırıldığında isteğe bağlı kaldırma komutları çalıştırılabilir.

Para, rütbe veya site kredisi sağlayıcısı DyDiscord’a dahil değildir. Ödüller, sunucunuzda kullandığınız sağlayıcının komutlarıyla uygulanır.

Oyuncu ve Sunucu Bildirimleri​

• Oyuncu girişleri, çıkışları ve ölümleri Discord’a gönderilebilir.
• Her olay ayrı ayrı açılıp kapatılabilir.
• Bildirim metinleri ve renkleri düzenlenebilir.
• Normal sunucu kapanışında kısa bir “Sunucu kapanıyor.” bildirimi gönderilmeye çalışılır.
• Discord’daki sunucu komutuyla sunucu adı, görünen oyuncu sayısı ve Minecraft sürümü görüntülenebilir.

Özel Konsol Kanalı​

• Gerçek sunucu konsol çıktısı özel bir Discord kanalına aktarılabilir.
• Güvenilen Discord rollerine konsol komutu çalıştırma erişimi verilebilir.
• Log aktarımı ve komut çalıştırma ayrı ayrı açılıp kapatılabilir.
• Komutlara ek kabul veya ret mesajı gönderilmez; sunucunun gerçek çıktısı gösterilir.

Konsol erişimi Minecraft konsolunun yetkileriyle çalışır. Bu erişim yalnızca güvendiğiniz yöneticilere verilmelidir.

Dil Sistemi​

• Türkçe ve İngilizce desteği bulunur.
• Oyuncunun Minecraft dili otomatik algılanabilir.
• Oyuncular kendi dil tercihlerini kaydedebilir.
• Yöneticiler sunucu dilini sabitleyebilir.
• Minecraft ve Discord dili birbirinden bağımsız ayarlanabilir.
• Yardım ve TAB önerileri etkin dile ve kullanıcının yetkilerine göre gösterilir.
• Türkçe, İngilizce ve desteklenen Türkçe ASCII komut karşılıkları kullanılabilir.

---

Desteklenen Entegrasyonlar​

• LuckPerms: Sohbet rütbesi gösterimi ve gerçek grup üyeliğine dayalı Discord rol senkronizasyonu.
• Vault ve Chat sağlayıcısı: Sohbet rütbesi gösterimi için alternatif sağlayıcı.
• Komut sunan rütbe, ekonomi veya site kredisi eklentileri: Yapılandırılan boost ödüllerinin uygulanması.

LuckPerms ve Vault temel hesap eşleme sistemi için zorunlu değildir. Vault desteği grup senkronizasyonu anlamına gelmez.

---

Komutlar​

Oyuncu Komutları​

• /dydiscord — Discord davet bağlantısını gösterir.
• /dydiscord help — Kullanılabilir komutları gösterir.
• /dydiscord link — Hesap eşleme kodu oluşturur.
• /dydiscord status — Kendi hesap eşleme durumunu gösterir.
• /dydiscord unlink — Eşlemeyi kaldırmak için onay başlatır.
• /dydiscord confirm <kod> — Bekleyen işlemi onaylar.
• /dydiscord cancel — Bekleyen onayı iptal eder.
• /dydiscord language <auto|en|tr> — Kişisel dil tercihini belirler.

/discord aynı komutları kullanır. Türkçe karşılıklar da kabul edilir; etkin dildeki komutları TAB ile görebilirsiniz.

Admin Komutları​

Yönetim komutları /dydiscord admin altında bulunur.

• help — Erişilebilir yönetim komutlarını gösterir.
• reload — Ayarları ve mesajları yeniden yükler.
• language <auto|en|tr> — Minecraft sunucu dilini belirler.
• bot enable|disable|restart — Bot bağlantısını yönetir.
• panel enable|disable — Hesap panelini açar veya kapatır.
• panel send ve panel refresh — Paneli oluşturur veya günceller.
• roles ... — Rol kurallarını, önizlemeyi ve senkronizasyonu yönetir.
• console ... — Konsol kanalını ve erişim ayarlarını yönetir.
• status ve doctor — Bağlantı durumunu ve kurulum eksiklerini gösterir.

admin dalı her iki dilde aynı kalır.

---

Yetkiler​

Genel Yetki Grupları​

• dydiscord.player — Oyuncu komutlarını ve sohbet izinlerini kapsar. Varsayılan: Herkes.
• dydiscord.admin — Oyuncu grubunu ve yönetim izinlerini kapsar. Varsayılan: OP.

Oyuncu Yetkileri​

• dydiscord.invite — Davet bağlantısını görüntüleme.
• dydiscord.help — Yardım menüsünü görüntüleme.
• dydiscord.link — Eşleme kodu oluşturma.
• dydiscord.status — Kendi hesap durumunu görüntüleme.
• dydiscord.unlink — Kendi eşlemesini kaldırma.
• dydiscord.language — Kişisel dil tercihini değiştirme.
• dydiscord.chat.send — Minecraft sohbetini Discord’a aktarma.
• dydiscord.chat.receive — Discord sohbetini Minecraft’ta alma.

Yönetim işlemleri de ayrı alt izinlere sahiptir. Yardım, TAB, komut çalıştırma ve onay işlemleri ilgili izinleri kontrol eder. Bir alt izin açıkça reddedildiğinde OP olmak bu reddi aşmaz.

Ayrıntılı izin listesi bulunur.

---

Kurulum​

1. Sunucuyu kapatın.
2. DyDiscord-v1.0.1-BETA.jar dosyasını plugins klasörüne yerleştirin.
3. Sunucuyu başlatarak yapılandırma dosyalarını oluşturun.
4. Kendi Discord botunuzu oluşturup sunucunuza davet edin.
5. Token ve Discord sunucu ID’sini yerel bot.yml dosyasına girin.
6. /dydiscord admin reload ve /dydiscord admin bot enable komutlarını kullanın.
7. Kullanacağınız kanalları ve özellikleri yapılandırın.

Bot bağlantısı, sohbet köprüsü, olay bildirimleri, rol senkronizasyonu, boost ödülleri ve konsol özellikleri yeni kurulumda kapalıdır.

Bot tokenini paylaşmayın. Kurulum için botunuza Administrator yetkisi vermeniz gerekmez; kullandığınız özelliklerin gerekli izinlerini tanımlayın.

Eski Sürümden Geçiş​

Güncellemeden önce eski JAR dosyasını ve plugins/DyDiscord klasörünün tamamını sunucu kapalıyken yedekleyin.

Desteklenen yükseltmelerde hesaplar, kişisel dil tercihleri, panel kaydı, özel ayarlar ve çeviriler korunur. Oyuncuların hesaplarını yeniden eşlemesi gerekmez.

Veritabanı yedeğine dönmek, Discord’da değiştirilmiş rolleri veya daha önce uygulanmış ödülleri otomatik olarak geri almaz.

---

Uyumluluk ve Beta Durumu​

DyDiscord, Java 17 bytecode hedefi ve Spigot API 1.20.4 tabanı ile derlenir. Paper 26.3 / Java 25 üzerinde belirli senaryolar test edilmiştir; bu sonuçlar bütün Minecraft sürümleri ve eklenti kombinasyonları için uyumluluk garantisi değildir.

Eklenti şu anda Beta aşamasındadır. Hata bildirimlerinizi ve önerilerinizi GitHub üzerinden iletebilirsiniz.

---

Bağlantılar​

• Değerli ziyaretçimiz, içeriği görebilmek için şimdi giriş yapın veya kayıt olun.
• Değerli ziyaretçimiz, içeriği görebilmek için şimdi giriş yapın veya kayıt olun.
• Değerli ziyaretçimiz, içeriği görebilmek için şimdi giriş yapın veya kayıt olun.
• Değerli ziyaretçimiz, içeriği görebilmek için şimdi giriş yapın veya kayıt olun.
• Değerli ziyaretçimiz, içeriği görebilmek için şimdi giriş yapın veya kayıt olun.
• Değerli ziyaretçimiz, içeriği görebilmek için şimdi giriş yapın veya kayıt olun.