ViaFabric/README.md

ViaFabric

Client-side and server-side ViaVersion implementation for Fabric

Allows the connection to/from different Minecraft versions on your Minecraft client/server (LAN worlds too)

This mod can be installed on 1.8.9, 1.14.x, 1.15.x, 1.16.x and 1.17.x with Fabric Loader.

Dependencies

Dependency	Download
(Bundled) ViaVersion	https://viaversion.com/
(Optional) Cotton Client Commands (MC 1.14-15)	https://www.curseforge.com/minecraft/mc-mods/cotton-client-commands
Fabric API (MC 1.14+)	https://www.curseforge.com/minecraft/mc-mods/fabric-api
Legacy Fabric API (MC 1.8.9)	https://www.curseforge.com/minecraft/mc-mods/legacy-fabric-api

Note: ViaVersion is designed for Vanilla Minecraft servers. It probably will not work with modded registry entries or registry synchronization (fabric-registry-sync mod).

ViaVersion

How can I install ViaBackwards/ViaRewind?:

• Just drop them into mods folder. Make sure you are using versions compatible with the ViaVersion version you are using.
• CurseForge links: ViaBackwards ViaRewind

What versions can ViaVersion, ViaBackwards and ViaRewind translate?:

• With ViaVersion: Your server can accept newer versions. Your client can connect to older versions.

• Adding ViaBackwards (and optionally ViaRewind): Your server can accept older versions. Your client can connect to newer versions.

• Server-side: See https://viaversion.com/

• Client-side:

	1.8.x	1.9.x	1.10-1.14.4	1.15.x	1.16.x	1.17.x
1.8.9 client	✓	⏪	⟲	⟲	⟲	⟲
1.14.x client	✓	✓	✓	⟲	⟲	⟲
1.15.x client	✓	✓	✓	✓	⟲	⟲
1.16.x client	✓	✓	✓	✓	✓	⟲
1.17.x client	✓	✓	✓	✓	✓	✓

✓ = ViaVersion ⟲ = ViaBackwards ⏪ = ViaRewind

Can ViaVersion, ViaBackwards and ViaRewind support snapshots?:

• Check https://ci.viaversion.com/ for development builds with snapshot support

Alternatives

Client-side:

• ClientViaVersion: This discontinued client-side plugin for The 5zig Mod implemented ViaVersion, ViaBackwards and ViaRewind for 1.7.10, 1.8.9, 1.12 and 1.12.2 clients, allowing them to connect to 1.7-1.12.2 servers.
• multiconnect: This client-side Fabric mod does also accept older protocols and fixes some differences between versions, which ViaFabric doesn't. Currently, it goes down to 1.11 (stable) and 1.9 (experimental).
• Protocol4: This LiteLoader allows your 1.7.10 client connect to 1.7.x server.
• ViaForge: Fork of ViaFabric porting it to Forge.

Server-side

• ProtocolSupport: This Bukkit plugin allows clients to connect from older versions (down to 1.4.7).
• ViaVersion: ViaVersion can run as a plugin for BungeeCord, CraftBukkit, SpongeCommon and Velocity servers.

Standalone proxy:

• DirtMultiversion: Proxy allowing to connect down to Beta 1.3 with newer Minecraft client versions (currently).
• VIAaaS: Standalone ViaVersion proxy with ViaBackwards and ViaRewind, allowing you to connect without a mod installed on your client. Supports online mode.

Cool things to try:

• Geyser: Plugins, Fabric mod and a standalone proxy for allowing Bedrock Edition on Java Edition servers.
• PolyMc: Fabric mods which translates modded items and blocks, allowing vanilla to connect using resource packs.

Commands

Commands:

• There're 3 server-side alias /viaversion, /vvfabric and /viaver, and a client-side command /viafabricclient for Minecraft 1.14+ (OP permission level 3 is required for these commands, received by Entity Status Packet)

Configs

Configuration:

• ViaVersion configuration is available at .minecraft/config/viafabric/viaversion.yml
• ViaFabric configuration is at .minecraft/config/viafabric/viafabric.yml

How can I disable client-side ViaFabric?:

• You can disable it in the menu or by setting global protocol version to -1 (this will keep per-server translations still enabled)

How to use protocol detection?:

• For using globally, set the protocol to AUTO or -2. For using in a specific server: ddns.example.com._v-2.viafabric
• The protocol detector will try to ping with the client native protocol version. If you have ViaVersion or similar in the server it may use the translated version, differently than multiconnect which uses -1 version, which may get the native server version.
• It may hold your handshake for up to 10 seconds.
• The auto-detected version is cached for 30 seconds.

How can I set the version for specific servers?:

• Append ._v(VERSION).viafabric.
• Examples: minigame.example.com._v1_8.viafabric, native.example.com._v-1.viafabric, auto.example.com._v-2.viafabric

multiconnect

Does it work with multiconnect at same time on client?:**

• Yes, ViaFabric can be used with multiconnect. ViaFabric will send to their version auto detector their closest supported version. (multiconnect beta-supported versions (currently < 1.11) aren't used)
• Example of configurations:
• (1.8 server) <-> (disabled ViaFabric) <-> (auto-detected 1.8 server - multiconnect) = doesn't work because multiconnect doesn't support it
• (1.8 server) <-> (detected 1.8 - ViaFabric - suggests 1.11) <-> (detected 1.11 server - multiconnect) = works, ViaVersion is translating 1.8 -> 1.11 and multiconnect is accepting 1.11
• (1.8 server) <-> (forced 1.8 - ViaFabric - suggests 1.11) <-> (detected 1.11 server - multiconnect) = works, ViaVersion is translating 1.8 -> 1.11 and multiconnect is accepting 1.11
• (1.8 server) <-> (forced 1.8 - ViaFabric - detected 1.12.2 client) <-> (forced 1.12.2 server - multiconnect) = works, ViaVersion is translating 1.8 -> 1.12.2 and multiconnect is accepting 1.12.2

Differences with multiconnect:

	ViaVersion	multiconnect
Designed for	servers	clients
Can be installed on	multiple client/server versions	latest client version
Objectives	simply implement ViaVersion	version support with fixes to version changes
How does it work?	modifying packets at network code	modifying client code more deeply
Triggering anti-cheats	very likely	less likely

WARNING

I cannot guarantee that this mod is allowed on every (or even any) server. This mod may cause problems with anti cheat plugins. USE AT OWN RISK