Minecraft eklentisi InteractionVisualizer

🔌 InteractionVisualizer hakkında

InteractionVisualizer, işlevsel bloklar ve ilgili varlıklar için istemci tarafında görsel gösterimler ve animasyonlar oluşturan bir Minecraft eklentisidir (örnek: crafting tables, furnaces, enchantment tables). Görseller oyunculara packet'ler aracılığıyla gönderilir ve sunucu tarafında blok veya varlık oluşturmaz — bunlar tamamen istemci tarafı gösterimlerdir ve dünya durumunu etkilemez.

🎯 Amaç

Eklenti, oyuncuların GUI'leri kullanırken öğeleri, ilerlemeyi, hologramları ve animasyonları göstererek yaygın kullanılan işlevsel bloklarla etkileşimlerini yakındaki oyuncular için görünür hale getirir. Oyuncuların dünya içi arayüzlerle etkileşime girdiğinde daha zengin ve daha bilgilendirici görsel geri bildirim isteyen sunucu sahipleri için tasarlanmıştır.

⚙️ Özellikler

• Birçok işlevsel bloğu ve bunlara karşılık gelen öğe/varlıkları animasyonlarla görselleştirir (crafting table, furnace, enchantment table ve diğerleri).
• Yalnızca istemci tarafı gösterimler: görseller kalıcı veya etkileşimli sunucu varlıkları oluşturmaz.
• Blok başına gösterim açma/kapatma ve genel modül açma/kapatma.
• Oyuncu geçiş durumu bir veritabanına kaydedilir (varsayılan olarak SQLite; MySQL desteklenir).
• Oyuncu geçiş durumu için PlaceholderAPI placeholder'ları kullanılabilir.
• Eklentiler için bir geliştirici API'si / wiki sağlar.
• Davranışı devre dışı bırakmak veya ayarlamak için yaygın eklentilerle entegrasyonları dikkate alır (vanish eklentileri, OpenInv vb.).

🧩 Kimler için

• Blok etkileşimleri için daha sürükleyici görsel geri bildirim isteyen Survival ve SMP sunucuları.
• Sunucu dünya verisini değiştirmeden istemci tarafında görsel cilayı tercih eden dekoratif/roleplay sunucuları.
• Görsel efektler üzerinde isteğe bağlı oyuncu bazlı kontrol isteyen sunucu yöneticileri.

🏗️ Örnek kullanım alanları

• Bir oyuncu tarif yuvalarını doldururken crafting table üzerinde öğelerin belirmesini göstererek yakındaki oyuncuların ilerlemeyi görebilmesini sağlamak.
• Bir oyuncu furnace arayüzüyle etkileşime girerken furnace ilerleme hologramı ve ortaya çıkan öğe görsellerini göstermek.
• Oyuncuların hangi gösterim modüllerini göreceğini açıp kapatmasına izin vermek (itemstands, dropped items, holograms).

⌨️ Komutlar

🔐 İzinler

⚙️ Kurulum

📥 Kurulum

• Resmi eklenti JAR dosyasını ve gerekli tüm bağımlılık JAR dosyalarını indirin.
• JAR dosyalarını sunucunuzun plugins/ klasörüne yerleştirin.
• Sunucuyu başlatın ve eklentinin yüklendiğini doğrulamak için konsolu kontrol edin.
• Gerekirse yapılandırmayı düzenleyin ve değişikliklerin uygulanması için sunucuyu yeniden başlatın.

📦 Bağımlılıklar

• ProtocolLib (belirtilen eski sunucu sürümleri / packet işleme için gereklidir).
• LightAPI Fork (kullanıldığı eski sürümler için gereklidir).

Proje tarafından belirtilen yumuşak/isteğe bağlı entegrasyonlar (davranışı ayarlamak için kullanılır): EssentialsX, OpenInv, PlaceholderAPI, SuperVanish, PremiumVanish, CMI.

🧾 Yapılandırma

• Eklenti varsayılan olarak oyuncu bazlı geçişleri SQLite içinde kaydeder ve sunucular arasında kalıcı depolama için MySQL'i destekler.
• Her blok gösterimi ve modül, eklenti yapılandırmasından devre dışı bırakılabilir.

🧠 Teknik Notlar

• Spigot API'si temel alınarak geliştirilmiştir; ayrıca Paper ve birkaç modern sunucu yapısıyla uyumluluk bildirir.
• Gösterimler yalnızca istemci tarafındadır ve öldürülebilir ya da kalıcı sunucu varlıkları oluşturmaz.
• Eklenti, üçüncü taraf eklentiler için bir geliştirici API'si sunar ve çeviriler topluluk tarafından korunur.
• Projede belirtilen bir sınırlama vardır: Minecraft 1.10.2 veya altında çalışmayabilir.

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

Sunucu tarafı durumu değiştirmeden, oyuncu etkileşimleri için müdahaleci olmayan dekoratif görsel geri bildirim istiyorsanız, InteractionVisualizer packet tabanlı animasyonlar ve oyuncu bazlı kontroller sunarak dünyayı değiştirmeden sürükleyiciliği artırır.