- CraftBukkit / Spigot (or Spigot based fork like PaperSpigotPaper) / Sponge / BungeeCord
- File Manager access
- If you're using it on BungeeCord: If you use BungeeCord ensure it's the latest build.
If your setup uses BungeeCord you only need to install it on either BungeeCord or the servers behind the bungee (whether they are Spigot / Sponge etc).
If you choose to use BungeeCord, note that you will not be able to see yourself blocking.
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 Version||Clients can connect with|
|1.8.x||1.8.x, 1.9.x, 1.10.x, 1.11.x, 1.9/12.x, 1.913.x, 1.14.x|
|1.9.x||1.9.x, 1.10.x, 1.11.x, 1.12.x, 1.13.x, 1.14.x|
|1.9||10.2||x||1.9||10.x, 1.10||11.x, 1.12.x, 1.13.x, 1.14.x|
|1.11.x||1.9.411.x, 1.12.x, 1.13.x, 1.14.x|
|1.912.x||1.12.x, 1.1013.x, 1.1114.x|
Note: Future versions like 1.12 15 will work on all of the above due to how the plugin is built. (Excluding issues where noted)
Bukkit / Spigot Compatibility Issues
If you wish to use ProtocolSupport, please use an older build and note that it's only compatible on 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.
Some users have had issues with SkinRestorer, we're unable to provide a fix for this at this point in time. (Ensure you're updated)
There are some login issues with Citizens2 and items that don't exist, ensure you're not using things like MONSTER_EGG durability 0.
You can download the latest release from the top of https://www.spigotmc.org/resources/viaversion.19254/updates, download this to your plugin folder.
curl -o ViaVersion.jar http://myles.us/ViaVersion/latest.jar
For development builds you can find them on our build server, https://ci.viaversion.com/job/ViaVersion/
Check out our documentation on our config.yml here.
/viaversion - Displays the version and avaliable commands
/viaversion reload - Reloads the config (some options may require a reboot)
/viaversion probe - Probes servers for versions (BungeeCord only)
The permission for these commands is
Our aim is to provide compatibility and balanced gameplay. This is not a feature of ViaVersion nor is it planned.
BungeeCord isn't working?!
If you are using our plugin on BungeeCord itself, it may take a few minutes for ViaVersion to probe your protocols of your subservers, you can read here for more info.
Otherwise ensure your BungeeCord is updated.
If you use Title plugins on BungeeCord try without them, some may be outdated.
I'm getting weird packet errors?
If you're using 1.8, you might want to check your plugins, read our compatibility guide. Some plugins require chunks being sent in a server tick which ViaVersion modifies these outside of.
If you're on 1.9 there's a chance you're using a bad build (use the latest 1.9 build).
ViaVersion is causing TPS lag in timings?
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.
If you believe the issue is a bug, and not a configuration issue report it here on GitHub.