ViaVersion

Allows the connection of higher client versions to lower server versions - it works on any platform you can think of.

The base ViaVersion jar runs on Paper and Velocity. We also have projects integrating ViaVersion to run on Fabric, Forge, Bungee, Sponge, or as a standalone proxy to join from basically any client version on any server version from the past decade. See HERE for an overview of the different Via* projects.

Note: While ViaVersion works reliably across all listed platforms, it has the highest performance and state accuracy on Paper servers and through ViaFabricPlus on clients, since both offer more extensive APIs and direct access to client/server state.

Supported Versions

If you're stuck, try this tool to work out what plugins you need.

User Docs: docs.viaversion.com

Snapshot Support

ViaVersion will only be released a few days after a Minecraft update unless the protocol changes of the update were trivial. If you want early-access, usually days or even weeks before the final release, you can subscribe to either:

• GitHub Sponsors ( preferred option. Use the /verify command on this Discord after), or alternatively
• Patreon (see the highest tier and make sure to link Patreon to your Discord account under Settings->Connections) This also includes access to a private repository with the code, which will be pushed to the public repository after the given delay on a Minecraft update.

Releases/Dev Builds

You can find official releases in the following places:

• Hangar (for our plugins): https://hangar.papermc.io/ViaVersion/ViaVersion
• Modrinth (for our mods): https://modrinth.com/mod/viaversion
• GitHub: https://github.com/ViaVersion/ViaVersion/releases

Dev builds for all of our projects are on our Jenkins server:

• Jenkins: https://ci.viaversion.com

ViaVersion as a Dependency

JavaDocs: https://jd.viaversion.com

Maven:

<repository>
    <id>viaversion-repo</id>
    <url>https://repo.viaversion.com</url>
</repository>

<dependency>
    <groupId>com.viaversion</groupId>
    <artifactId>viaversion-api</artifactId>
    <version>[5.0.0,6.0.0)</version>
    <scope>provided</scope>
</dependency>

Gradle:

repositories {
    maven("https://repo.viaversion.com")
}

dependencies {
    compileOnly("com.viaversion:viaversion-api:VERSION") // Replace the version
}

If you need access to the existing protocol or platform implementations, use the parent artifact viaversion. Please note the differences in licensing.

Note: If you want to make your own platform implementation of ViaVersion (and additional addons), take a look at the documentation.

Building

After cloning this repository, build the project with Gradle by running ./gradlew build and take the created jar out of the build/libs directory.

You need JDK 17 or newer to build ViaVersion.

Mapping Files

Mapping files are generated and managed in our Mappings repository. The generated mapping output is stored here.

Resources

• Via Mappings Generator
• Mojang mappings (Thank you, Mojang, very cool)
• Previously: Burger (see PAaaS) and wiki.vg

License

The entirety of the API directory is licensed under the MIT License; see licenses/MIT.md for details.

Everything else, unless explicitly stated otherwise, is licensed under the GNU General Public License v3, including the end-product as a whole; see licenses/GPL.md for details.

Special thanks to all our Contributors.