Minecraft ViaVersion Plugin
Last modified on Jun 9, 2022 in plugins
Overview
When owning a Minecraft Server, the wide range of versions available can be both a blessing and a curse. On one hand, you can easily adjust the version to fit whichever mods or plugins you need, but players may become frustrated when they need to constantly use differing versions for their servers. This issue is completely mitigated through the ViaVersion plugin, which can be used to allow newer-version players to join an older server. In addition, the matching add-on plugins can also be used for older players to connect to a server server at the same time. With all of them together, server players will be able to join while using any version from 1.8 and above without any extra work. With Apex Hosting, installing plugins is as simple as making use of our FTP File Access, so we have created this guide to ease you through the installation steps.
Summary
ViaVersion is a Minecraft plugin created by FormallyMyles on CurseForge. Available for any version over 1.8 and over 1.72 million downloads, this massively popular plugin is used in many servers. Using ViaVersion and its addons, players can join a server whether they are on a newer or older version.
Understanding ViaVersion Addons
While ViaVersion can be used by itself, it is also available for use with two other sub-plugins which have their own functionality.
ViaVersion – Allows players to connect while they are running a newer version.
ViaBackwards – Allows players to connect with an older Minecraft version later than 1.8.
ViaRewind – Similar to VB, but allows 1.7 and 1.8 players to connect to a newer server.
For example, if a server is running version 1.16 and you want a 1.18 player to join, ViaVersion is needed on the server. In the same example, if a 1.10 player wishes to join, ViaBackwards can be needed. A visual guide to this can be found in the above chart.
Downloading ViaVersion
- Navigate to the ViaVersion Spigot page.
- In the top-right, press the blue “Download” button.
- Save the file to a safe location for later.
- If needed, perform the same process with ViaBackwards or ViaRewind.
Once this is complete, you are ready to add the .jar files to your Minecraft server!
Server-Installation
- Navigate to the Apex Server Panel, then stop the server.
- Scroll down to the “Game File” section, then make note of the server version.
- Ensure the version is plugin-compatible, such as PaperMC or Spigot.
- Afterwards, enter the “FTP File Access” in the left-hand menu and log in.
- Locate or create the “plugins” folder, then enter it.
- Press “Upload” in the top-left menu, then drag + drop the .jar file(s).
- Once at 100%, return to the main panel page, then restart the server.
Usage
Once installed, a simple server restart will allow ViaVersion and its addons to be activated automatically. The plugin will work out of the box, so no configuration is required and can be tested immediately. If version 1.7 is used, the ProtocolSupport plugin may also need to be installed. Otherwise like before, everything will function automatically.
This can be extremely beneficial if running other plugins such as Geyser, as Bedrock and Java version updates can be inconsistent. ViaVersion completely removes this issue though, as long as the plugin is updated once in a while when new versions release.
Common Issues
I have issues trying to join with 1.7:
If you are using ViaRewind and are receiving issues while joining with the 1.7 server version, there could be a few potential issues. First, try to install the latest version of ProtocolSupport to your server. If issues still occur or you are receiving game crashes, try to lower the in-game render distance, as 1.7 can crash if the distance is too high.
Outdated Server! I’m still on X.X.X:
If you receive this error at any point, it can primarily be caused when a player is joining from the newest Minecraft version and the ViaVersion plugin has not been updated yet. To fix this, return to the ViaVersion Spigot page and redownload the latest version. Once complete, visit the FTP File Access and plugins folder like before while the server is turned off. Delete the old .jar file, then replace it with the newest one. The server can then be restarted to try again!
My blocks look weird:
This is a possible side-effect of the process the plugin uses to send data to older versions of the game. To fix it: go to the ViaVersion config file and change “serverside-blockconnections” to “true”. The config file can be found in the “Config Files” tab of the control panel, or in FTP File Access under the Plugins folder.
Helpful Links
How to Install Plugins
ViaVersion Spigot Page
ProtocolSupport Plugin Page
