Minecraft eklentisi EssentialsDiscord

🔌 EssentialsX Discord hakkında

EssentialsX Discord (EssentialsDiscord modülü olarak dağıtılır), bir Minecraft sunucusunu bir Discord sunucusuyla entegre eden resmi bir EssentialsX modülüdür. Çekirdek EssentialsX modülünün yanında bir eklenti JAR’ı olarak çalışır ve yapılandırılmış bir bot tokeniyle Discord’a bağlanarak sohbeti, etkinlikleri iletir ve küçük bir API destekli Discord tarafı etkileşimleri sunar.

🎯 Amaç

Modülün temel amacı iki yönlüdür: seçilen Minecraft sohbetlerini/etkinliklerini Discord kanallarına iletmek ve seçilen Discord mesajlarını/komutlarını Minecraft sunucusuna aktarmak. Discord ile EssentialsX tabanlı bir Minecraft sunucusu arasında doğrudan, yapılandırılabilir iletişim ve sınırlı uzaktan kontrol isteyen sunucu yöneticileri için tasarlanmıştır.

⚙️ Özellikler

• Farklı mesaj türleri için yapılandırılabilir kanal eşlemesi (sohbet, giriş/çıkış, staff vb.).
• Minecraft sohbetinin Discord’a aktarılması ve isteğe bağlı olarak Discord mesajlarının Minecraft sohbetine aktarılması.
• Konsol komutlarını çalıştırabilen, oyunculara mesaj gönderebilen ve oyuncu listelerini gösterebilen Discord tarafı slash komutları (yapılandırılabilir ve rollerle sınırlandırılabilir).
• İnce ayrıntılı mesaj türü sistemi ve tür bazlı biçimlendirme, eklenti yapılandırmasında tanımlanır.
• Sağlanan DiscordService API’si üzerinden özel mesaj türleri ve Discord etkileşim komutları kaydetmek için geliştirici API’si.

🧩 Kimler için

• Discord ↔ Minecraft sohbet senkronizasyonu isteyen EssentialsX kullanan sunucu sahipleri.
• Oyun içi staff ile bağlanacak özel staff kanalları isteyen ekipler.
• Discord’a basit etkileşimler veya özel mesaj kancaları sunmak isteyen eklenti geliştiricileri.

🏗️ Örnek kullanım alanları

• Global sohbeti özel bir Discord kanalına yönlendirirken staff’a özel Discord mesajlarını oyun içi staff’a göndermek.
• Doğrulanmış Discord rollerinin, herkese açık olmadan yapılandırılmış sunucu sorgularını veya komutlarını slash komutlarıyla çalıştırmasına izin vermek.
• Başka bir eklentinin EssentialsX Discord API’sine özel bir mesaj türü kaydederek yapılandırılmış bildirimleri Discord’a göndermesini sağlamak.

⌨️ Komutlar

EssentialsX Discord, tipik Minecraft sohbet komutları yerine yapılandırılabilir Discord tarafı slash komutları (Discord’a kayıtlı) sunar. Resmî dokümantasyonda örnekleri verilen bu komutlar Discord’dan çalıştırılır ve konsol komutlarını çalıştırabilir, oyunculara mesaj gönderebilir veya oyuncu listelerini gösterebilir. Komut kullanılabilirliği ve ayrıcalıklı özellikler, eklenti yapılandırmasındaki rol/ID ayarlarıyla kontrol edilir.

🔐 İzinler

⚙️ Kurulum

📥 Kurulum

• EssentialsX Discord modülünün JAR dosyasını indirin ve sunucunuzdaki plugins/ dizinine, temel EssentialsX JAR’ının yanına yerleştirin.
• Modülün yapılandırmasını oluşturmak için sunucuyu başlatın, ardından sunucuyu durdurun.
• plugins/EssentialsDiscord/config.yml dosyasında bot tokenini, kanal ID’lerini, mesaj türlerini ve komut rol ayarlarını dokümantasyonda belirtildiği gibi yapılandırın, ardından yeniden başlatın.

📦 Bağımlılıklar

• EssentialsX (core) — modül, EssentialsX eklenti paketine bir ek olarak çalışır.

🧠 Teknik notlar

• Modül, diğer eklentilerin özel mesaj türleri kaydetmesi ve yapılandırılmış Discord kanallarına mesaj göndermesi için bir hizmet API’si (DiscordService) sağlar.
• Discord tarafı komutlar, standart Minecraft izin düğümleri yerine eklenti yapılandırmasında ayarlanan roller/ID’ler ile kontrol edilir.
• Yönetici tarzı yapılandırma (bot tokeni, kanal ID’leri, mesaj biçimlendirme, komut rol ID’leri) ilk çalıştırmada oluşturulan modül yapılandırma dosyasında yapılır.

🤝 Bu eklenti ne zaman kullanışlıdır

Bir Discord topluluğu ile EssentialsX tabanlı bir Minecraft sunucusu arasında, rol kısıtlamalı Discord komutları ve geliştirici kancaları dahil olmak üzere yönetilen ve yapılandırılabilir iki yönlü iletişime ihtiyaç duyduğunuzda, EssentialsX Discord mesaj eşlemesini ve entegrasyonlar için küçük bir API’yi yöneten odaklanmış bir modül sunar.