ViaVersion 配方修复

服务端 Fabric 模组,用于防止 Fabric API 配方同步数据包导致通过 ViaVersion/ViaBackwards 以旧协议版本连接的客户端崩溃。

工具

ViaVersion 配方修复

一个服务端 Fabric 模组,用于防止 Fabric API 的配方同步数据包导致通过 ViaVersion/ViaBackwards 以非原生协议版本连接的客户端崩溃。

问题

自 Minecraft 1.21.2 起,原版不再向客户端同步所有配方。Fabric API 为需要客户端配方数据的模组(例如 JEI)添加了一个可选的配方同步 API(fabric-recipe-api-v1)。当服务器将此 API 与 ViaFabric 和 ViaBackwards 一起使用时,较旧 Minecraft 版本的客户端会崩溃并报错:

Failed to decode packet 'clientbound/minecraft:custom_payload'
Caused by: Tried to read NBT tag that was too big

ViaVersion 和 ViaBackwards 都不会转换 Fabric API 的自定义 RecipeSyncPayloadS2C 数据包,导致客户端错误解析数据。

解决方案

此模组在服务器层面拦截配方同步,并跳过向协议版本(通过 ViaVersion API 检测)与服务器原生协议不同的玩家发送该数据包。

原生版本的客户端会照常收到配方同步。

要求

  • Minecraft 1.21.10+
  • Fabric Loader >=0.18.0
  • Fabric API(含 fabric-recipe-api-v1)
  • ViaFabric(可选)——没有它模组不会执行任何操作,但也不会崩溃

构建

./gradlew build

输出的 jar 位于 build/libs/ 中。

许可证

MIT