ViaVersion - 跨版本连接插件

ViaVersion 是一款允许高版本 Minecraft 客户端连接低版本服务器的插件。只需将其放入插件文件夹即可使用，若使用 BungeeCord 等代理，请参考下文说明。

💡核心功能与支持

ViaVersion 的核心目标是让使用新版客户端的玩家能够连接到旧版服务器。它本身仅支持更高版本的客户端连接。若需要让旧版客户端连接，请配合使用 ViaBackwards 和 ViaRewind。

支持的平台与版本

• 支持的服务端：Spigot、Paper、Velocity（本页下载）。
• 额外的适配器：ViaBungee、ViaSponge、ViaFabric 需要单独下载。
• 版本支持：支持所有比服务器版本新的客户端版本（包括子版本）。

重要须知

• 标有 -DEV 的构建版本来自我们的构建服务器。
• 所有使用的插件都应为当前 Bukkit 版本而设计。
• 不要使用 /reload 命令，它可能导致问题。如有需要，请重启服务器。
• 如需了解需要哪些 Via* 插件，请点击此处。

🎮安装与配置

基础安装

• 将 ViaVersion 插件文件放入服务器的 plugins 文件夹。
• 启动服务器，插件将自动生成配置文件。
• 建议首先阅读我们的安装文档，以确保一切设置正确。

代理服务器（BungeeCord / Velocity）设置

• 请确保你的 BungeeCord 或 Velocity 及其所有插件均为最新版本。
• 你可以将 ViaVersion 安装在后端服务器上，或直接安装在 Velocity 代理上。
• 最佳兼容性方案：将插件安装在后端服务器上。

常见配置调整

• 数据包限制：如果玩家因“发送过多数据包”被踢出，可以在配置文件中将 max-pps 等限制值设置为 -1 来禁用此功能，或尝试逐步提高该值。
• 方块连接问题：如果方块显示异常或连接不正确，请在配置中设置 serverside-blockconnections: true。
• 皮肤问题：如果遇到断开连接问题，并且使用了 SkinRestorer 插件，请尝试暂时移除它以进行排查。

🔧命令与权限

所有命令都需要 viaversion.admin 权限。

• /viaver list - 显示玩家所使用的客户端版本。
• /viaver autoteam - 切换碰撞自动分组。如果遇到 BungeeCord 团队问题，可能需要禁用它。
• /viaver dontbugme - 切换更新通知。
• /viaver pps - 显示转发玩家的每秒数据包数。
• /viaver debug - 用于数据包崩溃和问题报告，将在控制台显示所有数据包。除非被要求，否则不要使用。

❓常见问题解答

兼容性与功能

• 问：我能让 1.7 客户端连接吗？
• 答：我们不计划原生支持 1.7。建议在 1.8 服务器上使用 ProtocolSupport 配合 ViaVersion，或者更推荐使用 ViaRewind + ViaBackwards 组合。

• 问：你会更新支持 1.x 版本吗？
• 答：是的，我们计划随着 Minecraft 官方更新而持续更新。

• 问：我能使用新版本的物品、方块或特性吗？
• 答：ViaVersion 的目标是提供连接兼容性，并不添加新版中的新物品、方块或游戏功能。

故障排除

• 问：我遇到了奇怪的断开连接错误？
• 答：请尝试在无其他插件的情况下测试。如果问题依旧，请向我们报告。否则，可能是其他插件冲突，请逐一移除插件排查。

• 问：BKCommonLib / Orebfuscator 与 ProtocolLib 在 1.8 不兼容？
• 答：是的，对于 1.8，它们无法与 ProtocolLib 正常工作。你可以使用为此特殊修改的版本：

- [BKCommonLib 特殊版本](https://www.spigotmc.org/threads/bkcommonlib.178174/)

- [Orebfuscator 特殊版本](https://www.spigotmc.org/threads/orebfuscator.178175/)

其他

• 问：插件是开源的嗎？
• 答：是的，源代码位于 GitHub。

• 问：如何获取帮助？
• 答：请加入我们的 Discord 服务器 或使用本页的“讨论”选项卡。

• 问：配置选项是什么意思？
• 答：请查阅我们的文档。

• 问：如何报告 Bug？
• 答：如果你是开发者，欢迎在 GitHub 上帮助我们修复问题。否则，请点击此处提交问题报告。

✨支持与资源

我们非常感谢社区的支持！

• Discord（帮助与更新）：https://discord.gg/viaversion
• 文档：http://docs.viaversion.com
• 捐赠：https://viaversion.com/donate
• 构建服务器：http://ci.viaversion.com
• Javadocs (API)：http://jd.viaversion.com
• Maven 仓库：http://repo.viaversion.com

赞助者

特别感谢我们所有的赞助者！你也可以通过 GitHub Sponsors 支持 ViaVersion，赞助者甚至可以获得下一版本的早期访问权限。

<details>

<summary>查看历史赞助者名单</summary>

（此处保留原始赞助者名单列表，内容过长，在此折叠。）

</details>

合作伙伴

• 需要服务器托管？ 可以看看我们的合作伙伴 Shockbyte。