1.1.18. 版本兼容插件
我们的服务器运行一个版本,但玩家客户端可能版本各异。为提升兼容性,推荐安装 ViaVersion + ViaBackwards 组合,让 1.18 及以上的玩家都能顺利进入服务器。
1.1.18.1. 插件简介
ViaVersion:允许高版本客户端进入低版本服务端
ViaBackwards:允许低版本客户端进入高版本服务端
ViaRewind:支持更低版本(如1.8-1.12),如有需求可选装
1.1.18.2. 关键链接
1.1.18.3. 安装步骤
下载 ViaVersion 和 ViaBackwards 的 jar 包
推荐仅安装到所有 Paper 分区的 plugins 目录(代理端不建议安装)
重启所有服务端
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 分区安装,代理端不建议部署版本兼容插件。
备注
这个插件要定期更新的, 避免出现最新版本的客户端无法连接你的服务器的问题。