Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 13 Next »

This page will guide you on installing ViaVersion, after installing you will have a protocol compatible server allowing more client versions to join.


  • CraftBukkit / Spigot (or Spigot based fork like PaperSpigot)
  • File Manager access
  • If you use BungeeCord ensure it's the latest build (This plugin is only for Spigot servers, ensure you have the latest Bungee and it will work fine).


You must use one of the following versions to allow certain versions, 1.8.x means any 1.8 version like 1.8.8.

Server VersionClients can connect with
1.8.x1.8.x, 1.9.x, 1.10.x
1.9/, 1.10.x, 1.10.x (Note: 1.10.1/2 will not work properly it's suggested you upgrade.), 1.10.x

Note: Future versions like 1.11 will work on all of the above due to how the plugin is built. (Excluding issues where noted)

If you wish to use ProtocolSupport, please use an older build and note that it's only compatible on 1.8.8 servers.

If you are using BKCommonLib for 1.8.8, consider using this build.

Some users have had issues with SkinRestorer, we're unable to provide a fix for this at this point in time.

Downloading ViaVersion

You can download the latest release from the top of, download this to your plugin folder.

If you are using command line you can use the following for stable builds:


wget -O ViaVersion.jar


curl -o ViaVersion.jar



For development builds you can find them on our build server,

Installing ViaVersion

Once you have downloaded your ViaVersion.jar to the plugins folder, simply run your server.


ViaVersion will not work properly if you use a plugin manager and other plugins, please reboot your server. Additionally make sure to read your startup log in case there are any errors!

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.

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.

My players are being kicked with /reload?! And I'm having issues after /reload!?

We kick players when using ProtocolLib to stop the server crashing on reload, also you should probably use a PluginManager instead. If you're updating ViaVersion a reboot is much better than a reload as it means it will take full effect.

Other Issues

If you believe the issue is a bug, and not a configuration issue report it here on GitHub.

For support use the Discussion section on our Spigot page.

For live support, (EU times mostly) you can connect to our Spigot IRC channel #viaversion here.

  • No labels