ViaBackwards 跨版本插件(兼容低版本)

ViaBackwards 向下兼容桥接插件
让低版本 Minecraft Java 版客户端顺利连接高版本服务器的协议转换插件，需与 ViaVersion 配合使用；支持 Paper/Folia/Velocity/BungeeCord/Sponge/Fabric 等多平台，GPL-3.0 开源。
基本信息

| 项目 | 信息 |
| --- | --- |
| 插件名称 | ViaBackwards |
| 开发者 | kennytv（Creator）、creeper123123321（Maintainer）、florianreuth（Developer）|
| 最新版本 | Modrinth 构建 5.12.0-SNAPSHOT+621（2026-08-06）；Hangar 正式版 5.10.0（2026-06-19）|
| 许可协议 | GPL-3.0-only |
| 兼容版本 | Minecraft Java 1.10 – 26.2（含 26.1.x、1.21.x、1.20.x … 1.10.x）|
| 运行平台 | Paper、Folia、Spigot 及其分支；Velocity、BungeeCord、Sponge；Fabric（需 ViaFabric/ViaFabricPlus）|
| 运行环境 | Java 17 或以上（Java 8 降级构建可从官方 CI 获取）|
| 项目地址 | https://modrinth.com/plugin/viabackwards |
| 官方文档 | https://viabackwards.com/ |
简介

ViaBackwards 是一款面向 Minecraft 服务端的协议翻译插件，解决"服务器版本高、玩家客户端版本低"的连接难题。例如服务端运行在 26.2，而玩家仍在使用 1.20.4，ViaBackwards 会自动把服务端发出的新版网络包翻译成旧客户端能理解的格式，使玩家无需升级客户端即可进入游戏、移动、战斗、交互。

它必须与 ViaVersion 一起工作：ViaVersion 负责"新版客户端进旧版服务器"的正向兼容，ViaBackwards 负责"旧版客户端进新版服务器"的反向兼容；二者组合后，服务器可以横跨多个大版本接纳玩家。如果需要支持到 1.7.10 等更老客户端，可额外叠加 ViaRewind。

插件自身只做网络层协议转换，不修改服务端核心逻辑、玩家数据或世界文件，对游戏机制零侵入、性能开销极小，安装后开箱即用，绝大多数场景无需改动配置。
核心特性
跨大版本向下兼容
服务端运行在 26.2、1.21.x、1.20.x 等新版本时，1.10 至 1.21.x 的各类旧客户端均可连接，大幅提升服务器的玩家可达性。
智能包翻译
自动将新版本服务端的网络包转换为旧客户端兼容格式；新加入的方块、物品、实体会被映射到旧客户端可识别的相近对象上，保证画面与交互基本可用。
与 ViaVersion 协同
ViaBackwards 专注"旧客户端进新服务器"，ViaVersion 专注"新客户端进旧服务器"，两者互补实现双向版本桥接。
ViaRewind 延伸支持
配合 ViaRewind 可将客户端下限延伸至 1.7.10，为怀旧服提供"祖传客户端"接入能力。
即插即用
将 jar 放入 plugins 目录重启即可工作，默认配置已针对大多数服务器优化；无需手动配置即可生效。
轻量高效
仅做协议层转换，不改动游戏机制，对服务端性能影响极小，可在生产环境、高并发网络、PvP 服中稳定运行。
多平台覆盖
同时支持 Paper、Folia、Spigot 分支、Velocity、BungeeCord、Sponge 等服务端；在 Fabric 端可通过 ViaFabric 或 ViaFabricPlus 载入（ViaFabric 放入 mods 目录，ViaFabricPlus 放入 ViaFabricPlus/jars 目录）。
环境要求

| 项目 | 要求 |
| --- | --- |
| 服务端 | Spigot/Paper/Folia/Purpur 等 Spigot 分支，或 Velocity/BungeeCord/Sponge 代理 |
| Java 版本 | Java 17 或以上（1.18+ 强烈建议 Java 17+；极端情况下可使用官方 CI 提供的 Java 8 降级构建）|
| 前置插件 | ViaVersion（必装，且三者需保持同一构建频道：同为 stable / beta / dev）|
| 可选插件 | ViaRewind（延伸至 1.7.10）、Geyser/Floodgate（叠加实现 Java+Bedrock 跨平台）|
安装方法
从 Hangar（插件）或 Modrinth（Mod）下载 ViaVersion 与 ViaBackwards 的 jar 文件，确保二者构建频道一致
将两个 jar 一同放入服务端 plugins/ 目录
重启服务器，在控制台日志中确认 ViaBackwards 加载成功
执行 /viaversion 验证状态，此时旧版客户端即可连接
如需调整，编辑 plugins/ViaBackwards/config.yml，并通过 /viaversion reload 热重载
升级提醒：建议始终使用最新的 beta 构建；alpha 构建仅用于快照版本兼容等前沿变更。ViaVersion、ViaBackwards、ViaRewind 三个项目务必使用相同的构建频道（stable/beta/dev），否则可能出现协议不匹配。
命令与权限

ViaBackwards 没有独立的命令前缀，所有管理操作都复用 ViaVersion 的 /viaversion 指令：

| 命令 | 作用 |
| --- | --- |
| /viaversion reload | 重新加载 config.yml，无需重启（部分变更仍需全量重启才能生效）|
| /viaversion list | 查看当前在线玩家及其客户端版本 |
| /viaversion dump | 生成调试报告与粘贴链接，用于 GitHub Issue 反馈 |

权限节点沿用 ViaVersion 体系，通常由 viaversion. 等相关权限控制，OP 默认持有。
配置示意

配置文件位于 plugins/ViaBackwards/config.yml，常用字段如下（含默认值）：
是否始终显示被映射实体的原始名称（而非仅鼠标悬停时）
always-show-original-mob-name: true
将自定义附魔名称与等级写入物品 lore；如附魔插件已写入，请改为 false 避免重复
add-custom-enchants-into-lore: true
为 1.13+ 服务器上的 1.12 客户端，在计分板队伍前缀后追加队伍颜色
add-teamcolor-to-prefix: true
修复 1.13 客户端及以下在物品栏标题中看不到颜色/格式的问题
fix-formatted-inventory-titles: true
将 ping 包替换为物品栏确认包，提升反作弊兼容性（仅对 short 范围 id 生效）
handle-pings-as-inv-acknowledgements: false
为 1.17 以下客户端在 y=0 处发送假基岩（可能引发奇怪交互）
bedrock-at-y-0: false
将 1.19+ 服务器上的幽匿尖啸体映射为哭叫的黑曜石，修复碰撞与挖掘问题
sculk-shriekers-to-crying-obsidian: true
将 1.19+ 的黑暗效果映射为致盲，供 1.18.2 客户端识别
map-darkness-effect: true
抑制不支持特性的模拟警告（如 1.17+ 世界高度）
suppress-emulation-warnings: false
1.21.6+ 服务器向 1.21.5 客户端通过箱子界面模拟对话框
dialogs-via-chests: true
1.21.9+ 服务器向 1.21.7 客户端将行为准则以对话框形式呈现
code-of-conduct-as-dialog: true
已知限制
1.17+ 服务端若使用了非 0/256 的 min_y 与 height 世界高度，不会被支持；1.17 以下客户端无法看到或与 y=0 以下、y=255 以上的方块交互
1.17 以下客户端在 1.17+ 服务端上，特定物品栏点击操作可能出现物品栏同步异常
音效映射不完整
1.19.4 以下客户端在 1.20+ 服务端上无法使用锻炉（smithing table），可安装 AxSmithing 修复
新版本中加入、旧客户端不存在的内容，会被替代显示或不显示；依赖新机制的服务端插件对旧客户端可能表现异常
近期更新
5.12.0-SNAPSHOT+621（2026-08-06）：更新 ViaVersion 用法
5.11.1-SNAPSHOT（2026-07-29）：修复 1.13→1.12 手持方块重写、移除打开切石机时的警告、翻转 respawn_anchor_works 默认值
5.11.0（2026-07-13）：新物品与实体名称改为可翻译组件（可通过资源包 vb.entity. / vb.item. 覆盖）；新物品自定义模型数据迁移至映射文件 custom_model_data；1.21.5+ 服务端跳过 1.20.4→1.21.5 的重型物品转换；修复 26.2→26.1 床不可见、1.21.6→1.21.5 幼年快乐恶魂缩放、1.20.1 连接 26.2 断开等诸多问题
5.10.0（2026-06-19）：26.2 服务端支持；完善 26.1→1.21.11 映射；修复 1.21.6→1.21.5 对话框标签追踪
5.9.0（2026-04-19）：新增 pass-original-item-name-to-resource-packs 配置项；修复 26.1→1.21.11 旁观模式交互、1.21.5→1.21.4 皮革盔甲颜色渲染等问题
相关链接
Hangar（插件下载）：https://hangar.papermc.io/ViaVersion/ViaBackwards
Modrinth（Mod 下载）：https://modrinth.com/mod/viabackwards
GitHub 仓库：https://github.com/ViaVersion/ViaBackwards
官方 CI 开发构建：https://ci.viaversion.com/view/ViaBackwards/
配置文档：https://viaversion.atlassian.net/wiki/spaces/VIAVERSION/pages/1418133529/ViaBackwards+Configuration
Discord：https://viaversion.com/discord
许可

本项目基于 GPL-3.0-only 许可发布。