Minecraft eklentisi MyCommand

🔌 MyCommand hakkında

MyCommand, Java yazmadan özel komutlar, takma adlar ve komut odaklı etkileşimli arayüzler oluşturmak için kullanılan bir Minecraft eklentisidir. Başka komutları çalıştıran, biçimlendirilmiş metin gönderen, GUI açan, scriptleri tetikleyen ve olaylarla etkileşime giren komutları tanımlamak için YAML tabanlı bir sistem sunar.

🎯 Amaç

MyCommand, esnek özel komutlara, kısayollara ve yönetici/kullanıcı arayüzlerine ihtiyaç duyan sunucu yöneticileri için tasarlanmıştır. Tam bir eklenti geliştirmeden, komutlara özel davranışlar ekleme sorununu çözer (gecikmeler, warmup, cooldown, tab tamamlama, placeholderlar) ve hafif GUI etkileşimleri sağlar.

⚙️ Özellikler

• Yeni komutlar ve takma adlar oluşturun, isteğe bağlı olarak tab tamamlama için kaydedin.
• Tek bir özel komuttan birden fazla komut çalıştırın (konsol veya oyuncu tarafından).
• Komutlar için gecikme, warmup ve cooldown.
• Diğer komutların üzerine yazın veya kısayollar/takma adlar sağlayın.
• Eşya, blok, tabela, kitap, NPC ve item frame üzerinden komut tetikleme.
• GUI öğeleri: sandık tabanlı IconMenu, ActionBar, BossBar, Title, Scoreboard, Anvil GUI ve Sign GUI.
• Dinamik davranış için placeholder desteği ve script benzeri koşullar.
• Ekonomi entegrasyonu (Vault üzerinden isteğe bağlı) ve bazı bağımsız ekonomi özellikleri.
• Oyuncu olayları desteği (giriş/çıkış/ölüm) ve zamanlanmış görevler.
• İsteğe bağlı SQL destekli özel oyuncu veritabanı ve sınırsız komut için çoklu dosya desteği.
• BungeeCord ile ilgili özellikler ve proxy tarafı komutlar için ayrı bir Bungee sürümü.
• HTTP istekleri (GET/POST) ve desteklenen ortamlarda MiniMessage biçimlendirme desteği.
• Metrik raporlaması için bStats kullanır.

🧩 Kimler için

• Kodlama yapmadan özel komutlar ve menüler isteyen Survival ve SMP sunucuları.
• Özel mağaza/komut akışlarına ihtiyaç duyan yönetim odaklı veya ekonomi sunucuları.
• Komut davranışının merkezileştirilmesini veya proxy tarafında çalışmasını gerektiren proxy ağları.
• Dinamik çıktılar için script tabanlı koşullara ve placeholderlara ihtiyaç duyan sunucu işletmecileri.

🏗️ Örnek kullanım alanları

• Bir mağaza açmak, eşya vermek ve satın alımı kaydetmek için bir dizi konsol komutu çalıştıran tek bir komut tanımlamak.
• Sandık GUI girdileri ve anvil/sign istemleri kullanarak ceza/ışınlanma menüleri oluşturmak.
• Tab tamamlama ile birlikte daha uzun BungeeCord sunucu değiştirme komutlarına eşlenen kısa takma adlar sağlamak.

⌨️ Komutlar

Resmî dokümantasyon, eklentiyi yönetmek için yönetim komutlarını listeler. Proje tarafından belgelenen örnekler şunlardır:

(Tam liste ve kesin sözdizimi için eklentinin resmî komut dokümantasyonuna bakın.)

🔐 İzinler

Proje, yönetim işlemleri için izin düğümlerini belgeler. Resmî izin listesinden örnekler şunlardır:

| Permission | Description | Default | |---|---|---|---| | mycommand.reload | MyCommand yapılandırmasını yeniden yükleme izni. | belirtilmemiş | | mycommand.book.make | Özel komutlardan kitap oluşturma izni. | belirtilmemiş |

(Tam izin haritası için eklentinin izin dokümantasyonuna bakın.)

⚙️ Kurulum

📥 Kurulum

• Resmî .jar eklentisini indirin ve sunucunuzun plugins/ klasörüne koyun.
• Sunucuyu başlatın veya yeniden başlatın ve eklentinin yüklendiğini doğrulamak için konsol günlüklerini kontrol edin.
• Eklenti yüklenmezse, gerekli/isteğe bağlı destek eklentilerinin (bkz. Bağımlılıklar) mevcut veya güncel olduğunu doğrulayın.

📦 Bağımlılıklar

• ProtocolLib — eklenti yüklenmiyorsa veya bazı özellikler için önemli olduğu belirtilir.
• Vault — isteğe bağlı, ekonomi entegrasyonları için gereklidir.
• PlaceholderAPI — isteğe bağlı, genişletilmiş placeholder desteği için.

Yalnızca istediğiniz özellikler için doğrulanmış bağımlılıkları kurun; birçok entegrasyon isteğe bağlıdır.

🧠 Teknik notlar

• Eklenti YAML dosyalarıyla yapılandırılır ve komut sınırlarını aşmak için birden fazla komut dosyasını destekler.
• Özel oyuncu veritabanı için SQL depolama mevcuttur (isteğe bağlı) ve çoklu dosya kurulumları desteklenir.
• Proxy tarafı komut işleme için ayrı bir BungeeCord bileşeni vardır.
• Proje metrikleri bStats üzerinden raporlar.
• Desteklenen ortamlarda MiniMessage biçimlendirme ve tab tamamlama desteği kullanılabilir.

🤝 Bu eklenti ne zaman faydalıdır

Java yazmadan esnek, dosya tabanlı özel komutlara, koşullu scriptlere ve GUI tabanlı komut akışlarına ihtiyacınız varsa, MyCommand bu ihtiyaçlar için yapılandırılabilir bir platform sunar ve gerektiğinde proxy ile ekonomi entegrasyonları ekler.