Minecraft-Plugin ViaVersion

🔌 Über ViaVersion

ViaVersion ist ein Minecraft-Plugin, das die Protokollübersetzung zwischen Client und Server ermöglicht, sodass Spieler mit unterschiedlichen Minecraft-Clientversionen einem einzigen Server beitreten können. Es bietet Kompatibilität über mehrere Versionen hinweg, indem es Netzwerkpakete zwischen den Protokollversionen von Client und Server übersetzt.

🎯 Zweck

ViaVersion löst das Problem der Fragmentierung von Client-Versionen: Wenn ein Server auf einer bestimmten Minecraft-Version läuft, können sich Spieler mit neueren oder älteren Clients normalerweise nicht verbinden. ViaVersion übersetzt die Protokolle, sodass Betreiber eine bestimmte Serverversion beibehalten können, während sich Clients in einem breiteren Versionsbereich verbinden können.

⚙️ Funktionen

• Läuft je nach Bedarf als Plattform-Plugin (Paper/Spigot/CraftBukkit) oder auf Proxy-Plattformen (Velocity).
• Übersetzt Netzwerkprotokolle, damit neuere Clients älteren Servern beitreten können und umgekehrt (die Kompatibilitätsbereiche hängen vom installierten ViaVersion-Build und optionalen Add-ons ab).
• Optionale Begleitprojekte/Add-ons erweitern die Unterstützung: ViaBackwards und ViaRewind für die Unterstützung älterer Clients.
• Konfigurationsoptionen und ein Packet-Limiter stehen zur Verfügung, um das Verhalten anzupassen und Exploit-Versuche abzumildern.
• Bietet Diagnosebefehle und einen Dump-Befehl, um Laufzeitinformationen zur Fehlerbehebung zu sammeln.

🧩 Für wen es gedacht ist

• Server-Betreiber, die mehrere Java Edition-Clientversionen unterstützen möchten, ohne den Server sofort zu aktualisieren.
• Netzwerkbetreiber, die Proxys (z. B. Velocity) verwenden und versionsübergreifende Verbindungen zwischen Backend-Servern benötigen.
• Plugin-Entwickler und Integratoren, die eine Protokollübersetzungsschicht oder Zugriff auf die ViaVersion-API brauchen.

🏗️ Beispielanwendungsfälle

• Ein Survival/PvP-Server bleibt auf einem stabilen Paper-Build, während sich Spieler mit neueren Clients verbinden können.
• Ein Proxy-Netzwerk nutzt ViaVersion auf dem Proxy oder auf den Backend-Servern, sodass Spieler mit unterschiedlichen Clientversionen dem Netzwerk beitreten können.
• Ein Entwickler nutzt das ViaVersion-API-Artefakt, um Protokollübersetzung in eine eigene Plattformimplementierung zu integrieren.

⌨️ Befehle

🔐 Berechtigungen

⚙️ Installation

📥 Einrichtung

• Laden Sie die offizielle ViaVersion-Plugin-JAR für Ihre Plattform herunter und legen Sie sie im plugins/-Verzeichnis des Servers oder Proxys ab.
• Starten Sie den Server; prüfen Sie die Serverkonsole, um zu bestätigen, dass das Plugin erfolgreich geladen wurde.
• Wenn Sie einen Proxy verwenden (z. B. Velocity), installieren Sie ViaVersion entweder auf dem Proxy oder auf den Backend-Servern (nicht unbedingt auf beiden), je nachdem, wo die Übersetzung stattfinden soll.

📦 Abhängigkeiten

• Für den Kernbetrieb sind keine obligatorischen externen Plugin-Abhängigkeiten erforderlich. Optionale Begleitprojekte (ViaBackwards, ViaRewind) erweitern die Versionsunterstützung und werden separat verteilt.

🧾 Konfiguration

• ViaVersion bietet Konfigurationsoptionen (in der offiziellen Dokumentation als config.yml bezeichnet), um Paketlimits, Debugging und andere Verhaltensweisen anzupassen.

🧠 Technische Hinweise

• Bestätigte Server-Plattformen: Paper (und mit CraftBukkit/Spigot kompatible Server) sowie Velocity; Integrationsprojekte gibt es für Fabric, Forge, Bungee und Sponge.
• Für offizielle Builds ist Java 17+ erforderlich.
• Die Kompatibilitätsbereiche variieren je nach Build; ViaBackwards und ViaRewind stehen zur Verfügung, um die Unterstützung für ältere Clientversionen zu erweitern.
• Das Projekt stellt für Entwickler ein API-Artefakt bereit und veröffentlicht Releases auf Hangar, Modrinth (für Mods) und GitHub.

🤝 Wann dieses Plugin nützlich ist

Wenn Sie Spielern mit unterschiedlichen Minecraft-Java-Clientversionen erlauben möchten, sich mit einem einzigen Server oder Netzwerk zu verbinden, ohne sofort ein Server-Upgrade erzwingen zu müssen, bietet ViaVersion eine gepflegte Protokollübersetzungsschicht und zugehörige Werkzeuge dafür sowie Diagnosen und Erweiterungspunkte für Entwickler.