KAYNAKLAR:
VirüsTotal:
SpigotMc:
Source Code:
Modrinth:
GENİŞLETİLMİŞ SİSTEM ÖZELLİKLERİ:
Otomatik Bilgilendirme Sistemi:
Eklenti, Minecraft sunucusunda gerçekleşen belirli olayları otomatik olarak Discord sunucusuna bildirir. Bu sistem sayesinde oyuncu aktiviteleri, eşleşme durumu ve özel bildirimler Discord üzerinden ilgili kanallara gönderilir. Bildirimler, config.yml dosyası aracılığıyla özelleştirilebilir ve kanal bazlı yönlendirme desteklenir.
Dahili Gömülü Discord Botu:
Eklenti, harici bir bot kurulumuna gerek kalmadan kendi içerisinde çalışan bir
entegre Discord botu barındırır.
Bu sayede sistem, herhangi bir 3. parti uygulamaya ihtiyaç duymadan bağımsız olarak çalışabilir.
Bot, Discord API üzerinden:
- Mesaj gönderme
- Rol atama
- Kullanıcı adı güncelleme
- Onay sistemi yönetimi
gibi işlemleri doğrudan gerçekleştirebilir.
Onaylı Kullanıcı Eşleştirme Sistemi:
Kullanıcıların Minecraft hesaplarını Discord hesaplarıyla bağlamadan önce bir onay sürecinden geçmeleri gerekmektedir. Bu sistem, sunucuda yetkisiz kullanıcı eşleşmelerinin önüne geçmek ve güvenliği artırmak için geliştirilmiştir.
Gelişmiş Yapılandırma Desteği:
Tüm sistem, kullanıcı dostu bir
config.yml yapılandırma dosyası ile kontrol edilir.
Bu yapılandırma dosyası sayesinde:
- Botun durum mesajları (örnek: /playing, /watching)
- Otomatik mesaj içerikleri
- Mesajların gönderileceği kanal ID’leri
Kullanıcı Adı Güncelleme Sistemi:
Başarılı eşleştirme sonrasında, kullanıcının Discord üzerindeki görünen adı otomatik olarak Minecraft kullanıcı adı ile güncellenir.
Bu özellik:
- Sunucu içi düzeni artırır
- Oyuncuların kimlik takibini kolaylaştırır
- Anonim kullanıcı adlarının önüne geçer
Yapılandırma dosyası üzerinden bu özellik aktif/pasif hale getirilebilir.
Rol Atama ve Yetkilendirme Sistemi:
Eklenti, oyuncu eşleşmesini tamamladıktan sonra kullanıcının sahip olduğu özel üyelik durumuna göre
Discord üzerindeki belirli rolleri otomatik olarak atar.
Rol tanımlamaları
config.yml üzerinden yapılır ve şu kurallar desteklenir:
- VIP, Premium, Elit gibi özel üyelik sistemleri
- Çoklu rol desteği (birden fazla rol aynı anda atanabilir)
Ekstra Özellikler & Planlanan Geliştirmeler:
Web Panel Entegrasyonu (Planlanıyor)
Sunucu sahiplerinin ve yöneticilerin tüm eşleştirme ve yapılandırma işlemlerini görsel bir arayüz üzerinden kolaylıkla yapabileceği bir
Web Panel sistemi planlanmaktadır.
Panel özellikleri:
- Gerçek zamanlı kullanıcı eşleştirme takibi
- Discord rol atama geçmişi görüntüleme
- Log kayıtlarına erişim
- Bot yapılandırma ayarlarını web üzerinden düzenleme
- Yedekleme ve dışa aktarma desteği
Detaylı Loglama ve Geriye Dönük Kayıt Sistemi
Her türlü eşleştirme, rol atama, onay süreci ve yapılandırma değişiklikleri, sistem tarafından
log dosyalarına yazılır.
Log sistemi:
- /logs/match_logs.yml → Oyuncu eşleştirme geçmişi
- /logs/role_assignments.log → Otomatik/manuel rol atamaları
- /logs/error.log → Olası hata ve sistem uyarıları
- /logs/admin_actions.log → Yetkili işlemleri ve komut kullanımları
Geliştirici API Desteği (Geliştirilebilir)
Sistem, harici uygulama ve panellere bağlanmak isteyen geliştiriciler için basit bir
REST API sunabilir.
API ile:
- Kullanıcı eşleşme verisi çekilebilir
- Discord rol ve durum sorgusu yapılabilir
- Sunucu içi olaylara özel tetikleyiciler (webhook-style)
Kurulum Talimatları
- config.yml dosyasındaki token kısmına Discord bot tokeninizi girin.
- bilgilendirme-kanal-id alanına mesaj gönderilecek Discord kanalının ID'sini yazın.
- oduller bölümünü kendi sunucunuza göre düzenleyin.
- Oyuncular, Minecraft üzerinde /hesapeşle eşle komutunu kullanarak, Discord botuna /eşle [Kod] komutunu girmelidir.
Komutlar
- /hesapeşle eşle
➤ Discord botuna gönderilecek olan eşleştirme kodunu görüntüler.
- /hesapeşle kaldır
➤ Mevcut eşleştirme bağlantısını kaldırır.
- /hesapeşle yenile
➤ messages.yml dosyasını yeniden yükler.
- /hesapeşle kodiptal
➤ Onay sürecindeki kodunuzu iptal eder.
- /hesapeşle liste
➤ Hesabını eşleyen oyuncuların listesini gösterir.
- /hesapeşle sıfırla <OyuncuAdı>
➤ Belirtilen oyuncunun eşleşme bağlantısını sıfırlar.
Yetkiler
- agnesesle.admin: Tüm Komutlara Erişim Sağlar.
