This page will guide you on installing ViaVersion, after installing you will have a protocol compatible server allowing more client versions to join.
Requirements
- CraftBukkit / Spigot / Paper (some forks are not officially supported due to the changes they make) / Sponge / BungeeCord / Velocity
- File Manager access
- If you're using it on BungeeCord: If you use BungeeCord ensure it's the latest build.
| Warning | ||
|---|---|---|
| ||
If your setup uses a proxy (e.g. BungeeCord/Velocity) you only need to install it on either the proxy or the servers behind the proxy (whether they are Spigot / Sponge etc). If you choose to use BungeeCord, note that you will not be able to see yourself blocking. |
Compatibility
You must use one of the following versions to allow certain versions, 1.8.x means any higher 1.8 version like 1.8.8. If you're stuck, try this tool to work out what plugins you need.
...
You may also use ViaBackwards for backwards 1.9-1.16 support on the above servers and ViaRewind will allow 1.8/1.7.
Bukkit / Spigot Compatibility Issues
If you wish to use ProtocolSupport, for 1.8.8 servers use build 388. Otherwise try the according build, late-bind may not function properly when using ProtocolSupport + ViaVersion. ViaRewind may also be a alternative solution to ProtocolSupport.
...
There are some login issues with Citizens2 and items that don't exist, ensure you're not using things like MONSTER_EGG durability 0.
Downloading ViaVersion
You can download the latest release from the top of https://www.spigotmc.org/resources/viaversion.19254/updates, download this to your plugin folder.
...
| Info | ||
|---|---|---|
| ||
For development builds you can find them on our build server, https://ci.viaversion.com/job/ViaVersion/ |
Installing ViaVersion
Once you have downloaded your ViaVersion.jar to the plugins folder, simply run your server.
...
| Info | ||
|---|---|---|
| ||
BungeeCord/Velocity works by detecting the protocol of the sub servers, to read more about configuring this to work better click here. |
Configuring ViaVersion
ViaVersion should work out of the box, in some cases, you might run into a few issues. We have a built-in packet limiter to avoid exploits which from time to time may be tripped, see our configuration page for notes on how to disable this if needed.
Check out our documentation on our config.yml here.
Commands
/viaversion - Displays the version and available commands
...
The permission for these commands is viaversion.admin.
Common Issues
My players in the tab list have no colour?
You may need to disable autoteam if you use a tag plugin like ColoredTags, use /viaver autoteam to disable. Alternatively, you can modify your config.yml.
I am being kicked for Outdated Server?
Ensure you have updated BungeeCord to the latest version if you use it, otherwise take a look at your startup log and ensure you're connecting to the right server and that ViaVersion is installed.
...
ViaVersion for versions 1.9 and above on 1.8 has to simulate player ticking for them to eat, draw bows etc. This means our plugin looks like it's causing lag but it's actually calling Minecraft server methods. You can turn of nms-player-ticking in the config to use an alternate method which won't touch timings but may cause issues with anti-cheat.
Other Issues
If you believe the issue is a bug, and not a configuration issue report it here on GitHub.
...