Minecraft eklentisi ViaVersion

🔌 ViaVersion hakkında

ViaVersion, farklı Minecraft istemci sürümlerini kullanan oyuncuların tek bir sunucuya bağlanabilmesini sağlayan istemci/sunucu protokol çevirisini etkinleştiren bir Minecraft eklentisidir. İstemci ve sunucu protokol sürümleri arasındaki ağ paketlerini çevirerek çoklu sürüm uyumluluğu sağlar.

🎯 Amaç

ViaVersion, istemci sürümü parçalanması sorununu çözer: Bir sunucu belirli bir Minecraft sürümünde çalıştığında, daha yeni veya daha eski istemcileri kullanan oyuncular genellikle bağlanamaz. ViaVersion, protokolleri çevirerek yöneticilerin seçtikleri bir sunucu sürümünü korurken daha geniş bir istemci sürümü aralığının bağlanmasına izin vermesini sağlar.

⚙️ Özellikler

• İhtiyaca göre bir platform eklentisi (Paper/Spigot/CraftBukkit) olarak veya proxy platformlarında (Velocity) çalışır.
• Ağ protokollerini çevirerek daha yeni istemcilerin daha eski sunuculara bağlanmasına ve bunun tersine izin verir (uyumluluk aralıkları yüklü ViaVersion sürümüne ve isteğe bağlı eklentilere bağlıdır).
• Daha eski istemci desteğini genişletmek için isteğe bağlı yardımcı projeler/eklentiler vardır: ViaBackwards ve ViaRewind.
• Davranışı ayarlamak ve kötüye kullanım girişimlerini azaltmak için yapılandırma seçenekleri ve bir paket sınırlayıcı mevcuttur.
• Sorun gidermeye yardımcı olmak için çalışma zamanı bilgisi toplamak üzere tanılama komutları ve bir dump komutu sağlar.

🧩 Kimler için

• Sunucuyu hemen yükseltmeden birden fazla Java Edition istemci sürümünü desteklemek isteyen sunucu sahipleri.
• Proxy kullanan (ör. Velocity) ve arka uç sunucuları arasında sürümler arası bağlantıya ihtiyaç duyan ağ operatörleri.
• Bir protokol çeviri katmanına veya ViaVersion API erişimine ihtiyaç duyan eklenti geliştiricileri ve entegratörler.

🏗️ Örnek kullanım senaryoları

• Bir Survival/PvP sunucusu kararlı bir Paper build'inde kalırken daha yeni istemcileri kullanan oyuncuların bağlanmasına izin verir.
• Bir proxy ağı, proxy'de veya arka uç sunucularında ViaVersion kullanarak farklı istemci sürümlerindeki oyuncuların ağa katılmasını sağlar.
• Bir geliştirici, özel bir platform uygulamasına protokol çevirisini entegre etmek için ViaVersion API artifact'ini kullanır.

⌨️ Komutlar

🔐 İzinler

⚙️ Kurulum

📥 Kurulum

• Platformunuz için resmi ViaVersion eklenti jar dosyasını indirin ve sunucunun veya proxy'nin plugins/ dizinine yerleştirin.
• Sunucuyu başlatın; eklentinin başarıyla yüklendiğini doğrulamak için sunucu konsolunu kontrol edin.
• Bir proxy (ör. Velocity) kullanıyorsanız, istediğiniz çeviri noktasına bağlı olarak ViaVersion'u proxy'ye veya arka uç sunucularına kurun (ikisine birden kurmanız gerekmez).

📦 Bağımlılıklar

• Temel çalışma için zorunlu harici bir eklenti bağımlılığı gerekmez. İsteğe bağlı yardımcı projeler (ViaBackwards, ViaRewind) sürüm desteğini genişletir ve ayrı olarak dağıtılır.

🧾 Yapılandırma

• ViaVersion, paket limitlerini, hata ayıklamayı ve diğer davranışları ayarlamak için yapılandırma seçenekleri sunar (resmi belgelerde config.yml olarak geçer).

🧠 Teknik notlar

• Onaylanmış sunucu platformları: Paper (ve CraftBukkit/Spigot uyumlu sunucular) ile Velocity; Fabric, Forge, Bungee ve Sponge için entegrasyon projeleri mevcuttur.
• Resmi build'ler için Java 17+ gerekir.
• Uyumluluk aralıkları build'e göre değişir; daha eski istemci sürümleri desteğini genişletmek için ViaBackwards ve ViaRewind kullanılabilir.
• Proje, geliştiriciler için bir API artifact'i sunar ve Hangar, Modrinth (modlar için) ve GitHub üzerinde sürümler yayınlar.

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

Farklı Minecraft Java istemci sürümlerini kullanan oyuncuların sunucuyu hemen yükseltmeden tek bir sunucuya veya ağa bağlanmasına izin vermeniz gerekiyorsa, ViaVersion bunu sağlamak için bakım yapılan bir protokol çeviri katmanı ve ilgili araçları sunar; ayrıca geliştiriciler için tanılama ve genişletme noktaları da sağlar.