1.1.18. 版本兼容插件

我们的服务器运行一个版本,但玩家客户端可能版本各异。为提升兼容性,推荐安装 ViaVersion + ViaBackwards 组合,让 1.18 及以上的玩家都能顺利进入服务器。

1.1.18.1. 插件简介

  • ViaVersion:允许高版本客户端进入低版本服务端

  • ViaBackwards:允许低版本客户端进入高版本服务端

  • ViaRewind:支持更低版本(如1.8-1.12),如有需求可选装

https://proxy.spigotmc.org/4d591f2da290cc9ab7621d006cb1dd7cd7754dca/68747470733a2f2f692e696d6775722e636f6d2f7a7251546366302e706e67

1.1.18.2. 关键链接

1.1.18.3. 安装步骤

  1. 下载 ViaVersion 和 ViaBackwards 的 jar 包

  2. 推荐仅安装到所有 Paper 分区的 plugins 目录(代理端不建议安装)

  3. 重启所有服务端

wget https://hangarcdn.papermc.io/plugins/ViaVersion/ViaVersion/versions/5.4.2/PAPER/ViaVersion-5.4.2.jar
wget https://hangarcdn.papermc.io/plugins/ViaVersion/ViaBackwards/versions/5.4.2/PAPER/ViaBackwards-5.4.2.jar
cp ViaVersion-5.4.2.jar /home/mc/instances/dl1/plugins/
cp ViaBackwards-5.4.2.jar /home/mc/instances/dl1/plugins/
# 其他分区同理

1.1.18.4. 安装方式建议

  • 仅 Paper 所有分区安装(强烈推荐)

  • 仅代理端安装(不推荐,易出兼容性问题)

  • 代理端+Paper都安装(强烈不推荐)

1.1.18.5. 配置文件说明

ViaVersion 配置文件 config.yml 主要参数:

  • max-pps:最大发包速率,防止刷包攻击

  • send-supported-versions:是否在 ping 时发送支持的版本信息

  • block-versions:阻止的客户端版本,如 ["<1.18.0"] 表示禁止1.18以下版本

  • block-disconnect-msg:被阻止时的提示信息

root@mc:/home/mc/instances/dl1/plugins/ViaVersion# diff config.yml config.yml.default
18c18
< block-versions: ["<1.18.0"]
---
> block-versions: []
23c23
< block-disconnect-msg: 你使用了不支持的版本,请使用1.18+版本,建议使用1.21.6版本。
---
> block-disconnect-msg: You are using an unsupported Minecraft version!
43,44c43,44
< max-pps: 2000
< max-pps-kick-msg: 你发送了太多的包,请控制,避免对服务造成压力,或者联系管理员。
---
> max-pps: 800
> max-pps-kick-msg: You are sending too many packets!

1.1.18.6. 权限设置

通过 LuckPerms 授权 viaversion相关权限,这个没啥权限的, 不做配置。

1.1.18.7. 常见问题 QA

Q1:

玩家提示 "You are sending too many packets" 被踢出?

A1:

一般是 ViaVersion 配置文件中 max-pps 设置过小,建议根据实际服务器负载调整数值。

Q2:

某些版本无法进入服务器?

A2:

检查 block-versions 配置,确认未误禁需要支持的版本,建议motd里面给出支持的版本范围。

Q3:

代理端安装后出现兼容性问题?

A3:

推荐仅在 Paper 分区安装,代理端不建议部署版本兼容插件。

备注

这个插件要定期更新的, 避免出现最新版本的客户端无法连接你的服务器的问题。