ViaFabric/README.md

102 lines
7.2 KiB
Markdown
Raw Permalink Normal View History

# ViaFabric
2019-12-12 14:23:43 +01:00
[![Travis Build Status](https://travis-ci.com/ViaVersion/ViaFabric.svg?branch=master)](https://travis-ci.com/ViaVersion/ViaFabric)
2020-03-24 14:44:08 +01:00
[![ViaVersion Discord](https://img.shields.io/badge/chat-on%20discord-blue.svg)](https://viaversion.com/discord)
2020-08-04 14:09:59 +02:00
[![CurseForge Downloads](http://cf.way2muchnoise.eu/full_391298_downloads.svg)](https://viaversion.com/fabric)
[![CurseForge Versions](http://cf.way2muchnoise.eu/versions/391298.svg)](https://viaversion.com/fabric)
2020-06-29 21:38:20 +02:00
<!-- ^ GitHub seems to not support Let's Encrypt certificates -->
2019-12-12 14:38:08 +01:00
2020-02-24 17:53:32 +01:00
**Client-side and server-side ViaVersion implementation for Fabric**
2020-02-24 17:54:20 +01:00
2020-02-24 17:58:32 +01:00
Allows the connection to/from different Minecraft versions on your Minecraft client/server (LAN worlds too)
2020-02-24 17:53:32 +01:00
2020-07-12 21:39:13 +02:00
This mod supports 1.8.9 (in `mc-1.8` branch), 1.14.4/1.15.2 (in `mc-1.14-1.15` branch) and 1.16.x/snapshots (in `mc-1.16` branch) with Fabric Loader. Check the Minecraft version in file name when downloading from CurseForge/GitHub Releases.
2020-03-14 11:08:34 +01:00
Note: ViaVersion is designed for Vanilla Minecraft servers. It probably will not work with modded registry entries or registry synchronization (fabric-registry-sync mod).
2020-03-14 11:07:45 +01:00
2020-03-14 11:08:34 +01:00
2020-07-12 21:39:13 +02:00
**1.14+ Dependencies:**
2020-07-21 18:49:05 +02:00
2020-08-11 18:57:06 +02:00
| Dependency | Download |
| ----------------------------------------- | ------------------------------------------------------------------------------------------ |
| (Bundled 3.1.0 release) ViaVersion 3.0.2+ | https://ci.viaversion.com/job/ViaVersion/ or https://ci.viaversion.com/job/ViaVersion-DEV/ |
| (Bundled) Cotton Client Commands | https://www.curseforge.com/minecraft/mc-mods/cotton-client-commands |
| Fabric Command API v1 | https://www.curseforge.com/minecraft/mc-mods/fabric-api |
| Fabric Resource Loader v0 | https://www.curseforge.com/minecraft/mc-mods/fabric-api |
| Fabric Textures v0 | https://www.curseforge.com/minecraft/mc-mods/fabric-api |
| (Bundled) ProgrammerArtInjector | https://www.curseforge.com/minecraft/mc-mods/programmerartinjector |
2020-07-12 21:39:13 +02:00
**1.8.9 Dependencies:**
2020-07-21 18:49:05 +02:00
2020-08-11 18:57:06 +02:00
| Dependency | Download |
| ----------------------------------------- | ------------------------------------------------------------------------------------------ |
| (Bundled 3.1.0 release) ViaVersion 3.0.2+ | https://ci.viaversion.com/job/ViaVersion/ or https://ci.viaversion.com/job/ViaVersion-DEV/ |
| Fabric Commands v0 | https://www.curseforge.com/minecraft/mc-mods/legacy-fabric-api |
| Fabric Resource Loader v0 | https://www.curseforge.com/minecraft/mc-mods/legacy-fabric-api |
2020-03-14 11:08:34 +01:00
2020-08-05 12:51:08 +02:00
With [ViaVersion](https://viaversion.com):
2020-02-24 17:53:32 +01:00
- your server can accept newer versions
- your client can connect to older versions
2020-02-24 17:54:20 +01:00
Adding [ViaBackwards](https://viaversion.com/backwards) (and optionally [ViaRewind](https://viaversion.com/rewind)):
2020-02-24 17:53:32 +01:00
- your server can accept older versions
- your client can connect to newer versions
2020-02-24 17:58:32 +01:00
**How can I install ViaBackwards/ViaRewind?:**
- Just drop it into mods folder. Make sure you are using versions compatible with the ViaVersion version you are using. ViaVersion-DEV/ViaBackwards-DEV/ViaRewind-DEV and ViaVersion/ViaBackwards/ViaRewind CI builds are only compatible to each other if they have the same label (``-DEV`` or empty).
**What versions can ViaVersion, ViaBackwards and ViaRewind translate?:**
2020-07-26 18:29:20 +02:00
- Server-side:
[![Graph with ViaVersion supported versions](https://i.imgur.com/0u20Y2u.png)](https://viaversion.com)
2020-08-07 14:00:04 +02:00
2020-07-26 18:29:20 +02:00
- Client-side:
| Your Client | 1.8.x | 1.9.x | 1.10-1.14.4 | 1.15.x | 1.16.x |
2020-08-07 14:00:04 +02:00
| ----------- | ----- | ----- | ----------- | ------ | ------ |
| 1.8.9 | ✓ | ⏪ | ⟲ | ⟲ | ⟲ |
| 1.14.4 | ✓ | ✓ | ✓ | ⟲ | ⟲ |
| 1.15.2 | ✓ | ✓ | ✓ | ✓ | ⟲ |
2020-08-04 14:34:36 +02:00
| 1.16.2 | ✓ | ✓ | ✓ | ✓ | ✓ |
2020-08-05 12:51:08 +02:00
✓ = [ViaVersion](https://viaversion.com) ⟲ = [ViaBackwards](https://viaversion.com/backwards) ⏪ = [ViaRewind](https://viaversion.com/rewind)
2020-08-05 12:51:08 +02:00
**Can ViaVersion, ViaBackwards and ViaRewind support snapshots?:**
- Check https://ci.viaversion.com/job/ViaVersion-DEV/, https://ci.viaversion.com/job/ViaBackwards-DEV/ and https://ci.viaversion.com/job/ViaRewind-DEV/ for development builds with snapshot support
2020-07-09 21:04:54 +02:00
**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](https://wiki.vg/Entity_statuses#Player))
**Configuration**:
- ViaVersion configuration is available at ``.minecraft/config/viafabric/viaversion.yml``
- ViaFabric configuration is at ``.minecraft/config/viafabric/viafabric.yml``
**Alternatives to this mod:**
- [ClientViaVersion](https://github.com/Gerrygames/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. It also had a protocol translation for 1.7 servers, which there's an updated version at https://github.com/KennyTV/ViaVersion/tree/hack (unsupported).
- [multiconnect](https://www.curseforge.com/minecraft/mc-mods/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.10. (2020-06-23)
- [Protocol4](https://www.minecraftforum.net/forums/mapping-and-modding-java-edition/minecraft-mods/2299203-protocol4-1-0-2-allows-1-7-10-clients-to-connect): This LiteLoader client-side mod allows your 1.7.10 client to connect to 1.7.x servers.
- [ProtocolSupport](https://protocol.support/): This Bukkit plugin allows clients to connect from older versions (down to 1.4.7).
- [ViaVersion](https://viaversion.com): ViaVersion can run as a plugin for BungeeCord, CraftBukkit, SpongeCommon and Velocity servers.
**How can I disable client-side ViaFabric?:**
2020-07-06 17:12:09 +02:00
- You can disable it by resetting the anti-cheat warning in config file or by setting protocol version to -1
**Does it work with multiconnect at same time on client?:**
2020-08-11 18:57:06 +02:00
- 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.10) aren't used)
- Example of setups:
- (1.8 server) <-> (disabled ViaFabric) <-> (auto detected 1.8 server - multiconnect) = doesn't work because multiconnect doesn't support it
2020-08-11 18:57:06 +02:00
- (1.8 server) <-> (forced 1.8 - ViaFabric - suggests 1.11) <-> (detected 1.11 server - multiconnect) = works, ViaVersion translating 1.8 -> 1.11 and multiconnect accepting 1.11
- (1.8 server) <-> (forced 1.8 - ViaFabric - detected 1.12.2 client) <-> (forced 1.12.2 server - multiconnect) = works, ViaVersion translating 1.8 -> 1.12.2 and multiconnect accepting 1.12.2
2020-02-24 17:58:32 +01:00
## 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**