我的世界 Java 版从 BungeeCord 迁移到 Velocity:转发方式、插件替换与切换步骤

代理迁移最容易出问题的不是安装 Velocity,而是后端转发方式、代理插件和玩家 UUID 是否保持一致。

先给结论

BungeeCord 与 Velocity 都是 Java 版多服网络常用的代理,但两者插件 API 不同,转发配置也不同。迁移时要先盘点代理插件与后端插件依赖,选择 Velocity 的转发方式并同步配置到所有后端,在测试网络中验证身份、权限、跳转和跨服插件,最后在低峰切换入口并保留回退路径。

一、先盘点现有网络

列出代理层插件:权限、跨服聊天、封禁、命令、统计和负载均衡等。

列出所有后端服务器名称、地址、端口和用途,例如大厅、生存、小游戏和测试服。

确认后端服务端核心与版本,以及它们当前使用的转发配置。

确认哪些插件依赖代理消息通道,例如跨服传送、全局聊天和玩家定位。

盘点结果是迁移清单,没有清单就无法判断迁移后少了什么。

二、插件不能直接通用

BungeeCord 插件与 Velocity 插件使用不同 API,通常不能直接放进 Velocity 运行。

每个代理插件都要寻找 Velocity 版本或功能相近的替代插件。

部分功能可以下沉到后端插件或改由外部服务实现。

找不到替代方案的插件要提前评估是否保留 BungeeCord,或调整功能设计。

替换插件后,配置格式和数据存储也可能不同,需要单独迁移。

三、选择转发方式

Velocity 支持多种转发方式,常见做法是使用现代转发,并在代理与后端使用相同密钥。

后端服务器需要启用与 Velocity 对应的转发设置,并关闭不再使用的旧转发方式。

转发密钥必须足够复杂,保存在私有配置中。

后端端口只允许代理访问,否则玩家可能绕过代理直接连接。

转发配置错误的典型表现是无法进服、UUID 异常或权限丢失。

四、测试网络验证

搭建与正式网络结构一致的测试网络,包括代理、大厅和至少一个主要后端。

验证正版玩家通过代理进入后,后端获得的 UUID 和用户名正确。

测试服务器之间跳转、断线重连、跨服聊天、封禁和权限继承。

测试直接连接后端端口会被拒绝。

记录测试问题与修复方案,形成正式切换清单。

五、数据与权限迁移

如果代理层权限或封禁数据存放在插件文件中,需要转换到新插件格式。

使用数据库存储的插件,要确认新插件能读取原有表结构,或者提供迁移工具。

迁移前备份所有代理配置、插件数据和数据库。

迁移后抽查管理员、普通玩家和被封禁玩家的状态。

不要在没有备份的情况下运行一次性数据转换脚本。

六、正式切换

选择低峰时段,提前公告维护时间与可能影响。

停止旧代理,启动 Velocity,并确认后端转发配置已经全部更新。

先由管理员进服验证核心流程,再开放给少量玩家。

观察日志、连接数、跳转失败和权限问题。

保留旧代理配置和旧插件数据,在稳定前不要删除。

七、常见问题

有人问为什么迁移后玩家进不去。检查后端转发设置、密钥和端口访问限制。

还有人问权限全没了。可能是 UUID 变化或代理权限插件数据未迁移。

也有人发现跨服聊天失效。代理插件通常需要更换为 Velocity 兼容版本。

最后一个常见问题是后端能被直连。立即限制后端端口只允许代理访问。

执行步骤

  1. 盘点代理插件、后端服务器和转发配置。
  2. 为每个 BungeeCord 插件寻找 Velocity 替代方案。
  3. 配置 Velocity 转发方式与私有密钥。
  4. 同步更新所有后端的转发设置。
  5. 限制后端端口只允许代理访问。
  6. 在测试网络验证身份、权限、跳转和跨服功能。
  7. 备份代理数据与数据库并迁移插件数据。
  8. 低峰切换正式入口并保留回退方案。

验收标准

  • 所有代理插件都有替代或处理方案。
  • 后端获得正确 UUID 与用户名。
  • 后端端口无法从公网直连。
  • 权限与封禁状态迁移正确。
  • 跨服跳转和聊天正常。
  • 旧代理配置与数据仍有备份。

常见误区

  • 把 BungeeCord 插件直接放进 Velocity。
  • 只改代理不改后端转发。
  • 转发密钥过于简单或公开。
  • 后端端口暴露公网。
  • 不备份就转换权限数据。
  • 切换后立即删除旧代理配置。

代理迁移的核心是身份与插件生态的平移。先盘点、再测试、同步转发、保护后端端口,Velocity 才能平稳接管整个网络。