ViaFabric

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

★ 408 Open GitHub ↗

Client-side and server-side ViaVersion implementation for Fabric

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ViaFabric

[![ViaVersion Discord](https://img.shields.io/badge/chat-on%20discord-blue.svg)](https://viaversion.com/discord)
[![CurseForge Downloads](http://cf.way2muchnoise.eu/full_viafabric_downloads.svg)](https://www.curseforge.com/minecraft/mc-mods/viafabric)
[![Modrinth Downloads](https://img.shields.io/modrinth/dt/ViaFabric?label=Modrinth&logo=Modrinth&style=flat-square)](https://viaversion.com/fabric)
[![CurseForge Versions](http://cf.way2muchnoise.eu/versions/viafabric.svg)](https://www.curseforge.com/minecraft/mc-mods/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)

If you are using the latest Minecraft version and care about the gameplay being more enjoyable/functional, you may want
to
check [ViaFabricPlus](https://modrinth.com/mod/viafabricplus) out. See the [differences](#viafabricplus) between
ViaFabric and ViaFabricPlus.

This mod can be installed on:

- Minecraft 26.x+ versions
- 1.14.4 – 1.21.11
- 1.8.9 / 1.12.2 
  using the Fabric Loader.

For each year, there is a versioned branch named after that year (for example, `ver/26.x`). Each yearly branch contains all `26.x` releases published during that year.

Additional version branches
- `ver/1.14-1.21` supports 1.14.4, 1.15.2, 1.16.5, 1.17.1, 1.18.2, 1.19.4, 1.20.6, 1.21.11
- `ver/1.8-1.12` supports 1.8.9 and 1.12.2

## Anti cheat integration

ViaFabric supports sending a custom payload to transmit player protocol version data to the server. This allows servers
to retrieve a player's protocol version via plugin messages, which can be useful for anti-cheat checks and
version-dependent logic.
For more details on how to use this feature, see
the [Server and Player Details Protocol wiki](https://github.com/ViaVersion/ViaVersion/wiki/Server-and-Player-Details-Protocol).

## Dependencies

| Dependency                                    | Download                                     |
|-----------------------------------------------|----------------------------------------------|
| (Bundled) ViaVersion                          | https://viaversion.com/                      |
| (Bundled) Cotton Client Commands (MC 1.14-15) | https://jitpack.io/#TinfoilMC/ClientCommands |
| Fabric API                                    | https://modrinth.com/mod/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/ViaAprilFools?:

- Just drop them into mods folder. Make sure you are using versions compatible with the ViaVersion version you are
  using.

### What versions can ViaVersion, ViaBackwards, ViaRewind and ViaAprilFools translate?:

- **With [ViaVersion](https://viaversion.com)**:
  Your server can accept newer versions. Your client can connect to older versions.

- **Adding [ViaBackwards](https://viaversion.com/backwards) (and
  optionally [ViaRewind](https://viaversion.com/rewind))**:
  Your server can accept older versions. Your client can connect to newer versions.

- **Adding [ViaAprilFools](https://viaversion.com/aprilfools)**: Your server can accept April Fools versions.

Note: When using ViaFabric for versions older than 1.17, you need [Java 8 builds](https://ci.viaversion.com/)

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

- Client-side:

|                       | 1.8.x | 1.9.x | 1.10-1.20.x | 1.21.x |
|-----------------------|-------|-------|-------------|--------|
| 1.14.4-1.20.6 clients | ✓     | ✓     | ✓           | ⟲      | ⟲   ⟲ | ⟲ | ⟲ | ⟲ | ⟲ |
| 1.21.11 client        | ✓     | ✓     | ✓           | ✓      | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |

✓ = [ViaVersion](https://viaversion.com) ⟲ = [ViaBackwards](https://viaversion.com/backwards) ⏪
= [ViaRewind](https://viaversion.com/rewind)

*Note: 1.7.x is not supported in ViaFabric - 1.9.x, 1.10.x, 1.11.x, and 1.13.x may cause problems when visiting such
servers in client-side mode.*

### Can ViaVersion, ViaBackwards and ViaRewind support snapshots?:

- Check https://viaversion.com/donate for getting early access to snapshots. You can use the preview ViaVersion builds
  with ViaFabric by
  putting them in the mods' folder. During Minecraft updates there will be usual a branch on this repository with the
  updated ViaFabric.

## Alternatives

### Client-side:

- [ViaForge](https://modrinth.com/mod/viaforge): Clientside Implementation of ViaVersion for Forge.
- [ViaFabricPlus](https://modrinth.com/mod/viafabricplus): Fabric mod for the latest Minecraft version with QoL fixes
  and enhancements to the gameplay.
- [multiconnect](https://www.curseforge.com/minecraft/mc-mods/multiconnect): Discontinued Fabric mod for connecting to
  older
  versions: down to 1.11 (stable) and 1.8 (experimental).

### Server-side:

- [ViaVersion](https://viaversion.com): Plugin for Velocity and Paper/Bukkit (and optionally also Sponge/BungeeCord).
- [ProtocolSupport](https://github.com/ProtocolSupport/ProtocolSupport): Discontinued Bukkit plugin for older client
  versions (down to 1.4.7).

### Standalone proxy:

- [ViaProxy](https://github.com/ViaVersion/ViaProxy): Standalone ViaVersion proxy with ViaBackwards, ViaRewind and
  ViaLegacy,
  allowing you to connect to a wide range of versions (down to classic versions) with your modern client (1.7.2+).
  Supports online mode.
- [VIAaaS](https://github.com/ViaVersion/VIAaaS): Standalone ViaVersion proxy with ViaBackwards and ViaRewind, allowing
  you to connect without a mod installed on your client. Supports online mode.
- [DirtMultiversion](https://github.com/DirtPowered/DirtMultiversion): Discontinued Proxy allowing to connect down to
  Beta 1.3 with
  newer Minecraft client versions.

### Cool things to try:

- [Geyser](https://geysermc.org/): Plugins, Fabric mod and a standalone proxy for allowing Bedrock Edition on Java
  Edition servers.
- [PolyMc](https://github.com/TheEpicBlock/PolyMc): Fabric mods which translates modded items and blocks, allowing
  vanilla to connect using resource packs.

## Commands

### Commands:

- There are 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))

## 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, differently than using -1 version,
  which may detect the native server version.

### How can I set the version for specific servers?:

#### Suffix Style

- Append ``._v(VERSION).viafabric`` after the host, before any port.
    - All dots (``.``) in a given version must be replaced with underscores (``_``).
- Examples:
    - ``minigame.example.com._v1_8.viafabric``
    - ``native.example.com._v-1.viafabric``
    - ``auto.example.com._v-2.viafabric``

#### Prefix Style

- Add ``viafabric.v(VERSION);`` before the address.
- Examples:
    - ``viafabric.v1.8;minigame.example.com``
    - ``viafabric.v-1;native.example.com``
    - ``viafabric.v-2;auto.example.com``

## ViaFabricPlus

### Does it work with ViaFabric:

- No, ViaFabric cannot be used with ViaFabricPlus.

### Differences with ViaFabricPlus:

|                        | ViaFabric                                   | ViaFabricPlus                                                   |
|------------------------|---------------------------------------------|-----------------------------------------------------------------|
| Can be installed on    | Multiple client/server versions with fabric | Latest client-side version with fabric                          |
| Objectives             | Simply implement ViaVersion                 | Implements ViaVersion with client-side fixes to version changes |
| How does it work?      | Modifying packets at network code           | Modifying client code more deeply                               |
| Triggering anti-cheats | Very likely                                 | Mostly not                                                      |

## Disclaimer

It cannot be guaranteed that this mod is allowed on specific servers as it can possibly cause problems with anti-cheat
plugins.\
***(USE ONLY WITH CAUTION!)***

ViaFabric

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README