ApolloPlayerTransfer

插件

· 作者 Baba0bab

在 Velocity 代理关闭期间,迁移旧版 Lunar Client 玩家。这是一个 Velocity 插件,使用 Apollo API 将旧版(<1.20.5)Lunar Client 玩家在关闭时转移到备用代理。

0 本站下载 0 关注 更新于 4 个月前

最新 1.0.1 · 26.2 · Velocity

一键开服(送7天)

ApolloPlayerTransfer

别再让代理重启时流失你的 Lunar Client 玩家。

在现代 Velocity 网络中,当代理关闭(重启、维护或扩容)时,玩家会被自动转移到其他代理而毫无察觉……但仅适用于较新的客户端。

Velocity 的原生传输依赖于 Minecraft 1.20.5 引入的一个数据包。所有运行旧版本(包括大量 Lunar Client 用户)的玩家无法识别该数据包,因此会被直接断开连接,而不是被转移。

ApolloPlayerTransfer 填补了这一空白。 它不是“又一个传输插件”:它是为 Apollo 兼容的旧版玩家 带来传输功能的扩展,这样代理重启就不再导致他们掉线。


具体问题所在

想象一个拥有多个 Velocity 代理的网络。其中一个需要重启或替换:

玩家类型 无此插件 有此插件
1.20.5+ 客户端(任何客户端) ✅ 原生传输,无中断 ✅ 原生传输(不变)
旧版客户端 + Lunar Client (Apollo) ❌ 断开连接 ✅ 通过 Apollo 传输,无需重新连接
不支持传输的旧版客户端 ❌ 断开连接 ❌ 断开连接(无法传输)

简而言之:近期玩家继续像往常一样被移动,而你旧版本的 Lunar Client 玩家现在也可以了,不会再从服务器掉线。


真实场景

你运营着一个由单个域名背后的 3 个 Velocity 代理组成的网络。某天晚上你推送更新,代理 #2 需要重启:

  1. Velocity 立即将每个 1.20.5+ 玩家移动到代理 1 和 3。
  2. ApolloPlayerTransfer 接管你的 旧版 Lunar Client 玩家,并将他们发送到与所有人相同的备用代理。
  3. 你的玩家继续游戏。没有人需要重新连接,没有排队,也没有“你已断开连接”的提示。

这正是以前社区的一部分会在每次重启时掉线的情况。这个插件让他们保持在线。


兼容性“我的设置能用吗?”

在代理上安装任何东西之前,这里有一些关键点:

  • ✅ 代理: 需要 Velocity-CTD(正是 CTD 决定了要使用的备用代理)。 不支持纯 Velocity,因为备用选择依赖于 CTD 的 [proxy-addresses] 机制。ApolloPlayerTransfer 没有重新发明任何东西:它复用了你配置中已有的代理选择逻辑。
  • ✅ 客户端: 需要在代理和本地都安装带有 Apollo 的 Lunar Client,并启用传输模块。只有 Apollo 玩家才能被传输。
  • ✅ Minecraft 版本: 专为 低于 1.20.5 的玩家设计(1.20.5+ 已经由原生处理,插件不干预他们)。
  • ✅ 多代理网络: 专为拥有多个代理的网络构建(通常使用 Redis,用于 MOST_EMPTY / LEAST_EMPTY 备用过滤器)。这才是传输真正有意义的地方。
  • ✅ Java 21+,就像现代 Velocity 代理一样运行。
  • ✅ 零配置维护: 插件不添加配置文件。它读取你现有的 velocity.toml。不需要进行任何新调整即可发挥作用。

如果你的网络符合这种情况,那么这个插件就是为你量身定制的。


安装

  1. 将两个插件放入代理的 plugins/ 文件夹:
    • Apollo-Velocity : 下载
    • ApolloPlayerTransfer (本页的 .jar 文件)
  2. 确保 Apollo 配置中的 传输模块 已启用。
  3. 重启代理。搞定,插件会使用你已有的 Velocity-CTD 配置。

对于完全透明的传输(可选但推荐)

这些设置不是传输工作的必要条件,但它们使传输对玩家完全透明:

  • 跳过 Lunar Client 确认弹窗:在你的域名上添加一个 mc_transfer_accept_from TXT DNS 记录,以自动接受你自己服务器之间的传输。
  • 避免“已连接到远程代理!”消息:在 velocity.toml 中启用会话接管 (kick-existing-players / kick-existing-players-check-ip)。

这两项设置的详细信息以及插件的内部机制记录在 项目的 GitHub 页面。


插件不能做什么

为了避免任何意外,让我们明确一下:

  • 它不会神奇地让每个旧客户端都兼容。既没有原生传输 (< 1.20.5) 也没有 Apollo/Lunar Client 的玩家无法被传输,他们会像今天一样断开连接。这是协议限制,而非插件问题。
  • 它仅在优雅代理关闭时生效。如果是硬崩溃或断电,没有任何代码运行:在这种情况下无人能被传输,无论插件如何。
  • 它不替代 Velocity 的原生传输:它补充了那些原本会被遗留的玩家类别。

简而言之

如果你运行一个多代理 Velocity 网络,并且部分 Lunar Client 玩家在每次代理重启时掉线,而其他玩家则被干净地移动:这正是本插件解决的问题。


基于 GNU GPL v3.0 许可证的开源插件。源代码、技术文档和发布跟踪见 GitHub。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源