Minecraft eklentisi CommandPanels

🔌 CommandPanels Hakkında

CommandPanels, sunucular için YAML tabanlı bir GUI/menü sistemi sunan bir Minecraft eklentisidir. Envanter tabanlı panellere, diyalog (form) panellerine ve Bedrock oyuncuları için Floodgate uyumlu panellere odaklanır. Proje; komut çalıştıran, dinamik placeholder'lar gösteren ve mantık ile izinlere tepki veren etkileşimli, veri odaklı menüler oluşturmak için çevrimiçi bir düzenleyici ve yapılandırılmış bir format içerir.

🎯 Amaç

Bu eklenti, mağazalar, kitler, lobiler, moderasyon araçları veya özel iş akışları için esnek ve programlanabilir GUI'lere ihtiyaç duyan sunucu yöneticileri ve geliştiriciler için tasarlanmıştır. Panellerin komut çalıştırmasına, koşulları kontrol etmesine, eşyaları animasyonlu göstermesine ve diğer sistemlerde kullanılmak üzere oturum ya da kalıcı verileri sunmasına olanak verecek şekilde geliştirilmiştir.

⚙️ Özellikler

• Eşya etkileşimleri, slot düzenleri ve animasyon zincirleri içeren envanter panelleri.
• Oyunculardan yapılandırılmış formlar ve giriş almak için diyalog panelleri.
• Geyser/Floodgate kurulumları üzerinden Bedrock oyuncularına uyumlu paneller sunmak için Floodgate panel desteği.
• Görünürlüğü ve davranışı kontrol etmek için satır içi mantık ve koşullar (AND/OR/NOT tarzı operatörler).
• Komut/eylem sistemi: aç/kapat hook'ları, tıklama eylemleri, dışarı tıklama eylemleri ve koşullu komut çalıştırma.
• PlaceholderAPI desteği ve paneller içinde dinamik placeholder güncellemeleri.
• Paneller ve komutlar arasında erişilebilen oturum ve kalıcı panel verileri.
• İzinler değiştiğinde mantığın tamamen yeniden ayrıştırılmasını tetikleyebilen periyodik güncellemeler ve bir izin gözlemcisi.
• YAML canlı önizleme ve yapı kontrolleri olan çevrimiçi düzenleyici.

🧩 Kimler İçin

Modern Paper uyumlu sunucular çalıştıran ve esnek GUI menülerine ihtiyaç duyan yöneticiler ve eklenti geliştiricileri: survival/SMP sunucuları, mini oyun ağları, PvP hub'ları ve özel yönetim/moderasyon arayüzü gerektiren sunucular için.

🏗️ Kullanım Örnekleri

• Sunucu komutları çalıştıran ve belirli izinler ya da ekonomi bakiyesi gerektiren bir kit veya mağaza GUI'si oluşturmak.
• Oyuncu rütbesine göre animasyonlu eşyalar ve koşullu görünürlük içeren bir hub gezinme menüsü hazırlamak.
• Floodgate'e özgü panel sürümleriyle Bedrock uyumlu bir menü sunmak.

⌨️ Komutlar

(Komutlar ve izinleri resmi CommandPanels belgelerinden alınmıştır.)

🔐 İzinler

⚙️ Kurulum

📥 Kurulum

• Resmi CommandPanels .jar dosyasını indirin ve sunucunuzun plugins/ klasörüne yerleştirin.
• Eklenti verilerini oluşturmak için sunucuyu başlatın.
• İlk çalıştırmadan sonra plugins/CommandPanels içinde config.yml dosyasını ve panel tanım dosyalarını içeren panels/ klasörünü kontrol edin.

📦 Bağımlılıklar

• PlaceholderAPI — dinamik placeholder'lar için isteğe bağlı ama önerilir.
• Floodgate — Bedrock (Floodgate) panel desteği için isteğe bağlıdır.

🧾 Yapılandırma

• Paneller, panels/ dizinine yerleştirilen YAML dosyaları olarak tanımlanır. Düzen için alt klasörler desteklenir.
• panels/ dizini silinip eklenti yeniden başlatılırsa eklenti örnek paneller oluşturur.

🧠 Teknik Notlar

• Resmî belgeler ve sürümler, modern v4 sürümleri için desteklenen sunucu platformları olarak Paper ve Folia'yı (Paper fork'ları) belirtir.
• v4 sürüm hattı, son Minecraft sunucu sürümlerine odaklanır; panel tanımları, çalışma zamanında ayrıştırılan dinamik placeholder'ları ve koşullu mantığı destekler.
• Eklenti, panelleri açmak için izin düğümleri ve komut tabanlı bir API sunar; ayrıca panel YAML'si yüklenerek ve açma eylemleri çağrılarak diğer eklentilere bir kütüphane olarak da gömülebilir.

🤝 Bu Eklenti Ne Zaman İşe Yarar

Dinamik verileri, koşullu mantığı, Bedrock uyumluluğunu ve çevrimiçi bir düzenleyiciyi destekleyen yapılandırılmış, komutlanabilir bir GUI sistemine ihtiyacınız varsa, CommandPanels Paper tabanlı sunuculara ve ağlara uygun, doğrulanmış bir YAML-first yaklaşımı sunar.