VelocityVersionBouncer

插件

· 作者 Hallo5000

这是为 Velocity 代理服务器(版本 3.4.0)设计的插件,可在客户端连接时自动重定向,将用户路由至与其游戏版本相匹配的服务器。

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

最新 2.1.0-release · 26.3 · Velocity

一键开服(送7天)

VelocityVersionBouncer

一种简单且全自动的方法,根据玩家的游戏版本将其连接到正确的服务器。

VelocityVersionBouncer 是 Velocity proxy 的一个插件,它会根据玩家的协议版本(Minecraft 游戏版本)自动选择最兼容的后端服务器。


? 工作原理

  • 每当客户端连接到代理时,插件都会检查所有已注册的服务器并比较它们的协议版本(游戏版本)。
  • 默认情况下,将选择第一个匹配的服务器(您可以在配置文件中更改此设置)。
  • 配置文件位于插件文件夹中(plugins/velocityversionbouncer/config.toml)。
  • 客户端可以自动路由,也可以基于配置文件中设置的显式路由进行路由。
  • 可选功能包括:回退功能以及用于服务器列表 ping 的版本比较。
  • 您还可以更改插件的语言(目前支持 en_US、zh_CN 和 de_DE)。

❓ 您可能有的问题:

  • 通过 /server 切换服务器时也会触发吗? 不会,版本检查仅在初始连接(从多人服务器列表)或使用回退功能时触发。
  • 如果找不到兼容的服务器会发生什么? 客户端将被断开连接,并显示相应的提示/原因。
  • 这适用于模组版 Minecraft 服务器吗? 如果您使用像 Ambassador+ProxyCompatibleForge (更多信息) 这样的设置,该插件将根据其协议版本(游戏版本)路由客户端,并检查后端服务器是否接受已安装的模组。

? 安装与 ?️ 要求

  1. 下载最新稳定版的 .jar 文件(此处),或者自行构建(包含 Gradle 文件)。
  2. 将文件放入服务器的 plugins/ 文件夹中(仅限代理!),然后重启一次服务器以在 plugins/velocityversionbouncer/config.toml 生成配置文件。
  3. 完成配置文件编辑后,再次重启代理,一切应该就能正常工作了。 注意:如果您未运行 Java 25(或更高版本)和 Velocity 4.2.1(或更高版本),此插件可能无法正常工作。
  4. 如果遇到任何问题:请确保您没有使用快照版本(因为这些版本预期不稳定,而且此 README 始终解释的是最新发行版),如果仍有问题,欢迎在该插件的 GitHub 仓库中提交 issue。

兼容性

  • VelocityVersionBouncer 专为 Velocity proxy 构建(其他代理或分支可能也能工作,但未获得官方支持)。
  • 在 v2.X.X 之前,VelocityVersionBouncer 是针对 Java 21 和 Velocity 3.4.0 编译的,因此要支持 Java 21 或 Velocity 3.4.0 - 4.2.1,您可能需要将 VelocityVersionBouncer 降级到 1.6.0-release 或 1.6.1-SNAPSHOT。
  • 当然,您也可以分叉项目并针对其他版本进行编译。大部分内容应该完全相同。

示例配置:

# 此配置用于确定每当客户端尝试连接到后端服务器(以及可选地丢失连接)时,如何以及在多大程度上对服务器进行协议版本检查

# en_US zh_CN de_DE
language = "en_US"

# 'whitelist' 是一个字符串数组,列出了当客户端尝试连接时要检查其协议版本的服务器名称。
# 留空等同于放入所有已注册的服务器
# 示例:["server1", "server2"]
# 注意:字符串外的空格将被忽略。
whitelist = ["lobby1", "lobby2", "fun-minigame", "devServer", "best-modpack"]

# 'blacklist' 是一个字符串数组,用于在版本比较期间从临时服务器列表中排除某些服务器。
# 首先添加白名单,然后从该临时列表中移除黑名单中包含的所有服务器。
blacklist = ["devServer"]

# 'modded-servers' 是白名单中的一组服务器,它们会在无模组服务器之前被尝试,以确保
# 模组客户端不会进入原版服务器。
modded-servers = ["best-modpack"]

# 如果启用此选项,可确保加入的玩家均匀分布到所有服务器上
# 选项:(不区分大小写)
#   "FIRST-MATCH" - 玩家将发送到第一个匹配的服务器
#   "BALANCED" - 玩家将均匀分布到所有匹配的服务器上
distribution = "FIRST-MATCH"

# 如果将此选项设置为 'true',您可以通过使用配置中的 try-list ('ping-passthrough')
# 来覆盖 velocity 确定服务器列表 ping 响应的方式
# 相反,当客户端发送服务器 ping 时,它将使用与加入/回退过程中相同的算法来确定匹配的服务器
# 如果在显式路由中也使用 clientbrands,请小心,因为这些不能用于匹配服务器 ping
server-list-ping = false
# 此选项确定在未找到匹配的服务器 ping 响应时是否使用 velocities ping-passthrough
# 如果设置为 true,描述等内容可能会显示,但客户端会显示版本不匹配,
# 否则客户端将显示“无法连接到服务器”
# 如果 'server-list-ping' 设置为 false,此选项也将被忽略
default-to-ping-passthrough = true

# 这定义了多久对所有后端服务器进行一次 ping 以刷新插件 ping 缓存中的信息
# 单位为秒
ping-intervall = 300

如果启用此选项,则每当客户端从服务器被踢出时(无论是在登录期间、通过 /kick 命令,还是其他原因),

它们将被自动重定向(弹回)到另一台服务器,而不是断开连接。如果客户端通过主动离开服务器显式断开连接,则不会进行重定向。

客户端被踢出的服务器将暂时从备用选项中排除。

这可以防止客户端在备用跳转过程中被发送回该服务器,从而避免可能的无限循环。

enable-fallback-bouncing = true

当 'explicit-fallback-server' 中存在有效的服务器名称时,插件将不再搜索新服务器,而是仅尝试指定的服务器。

如果您希望禁用此选项,请留空(当 enable-fallback-bouncing 设置为 false 时,此项也会禁用)。

警告:这将不检查版本是否匹配

explicit-fallback-server = "lobby"

------ 显式路由 ------

语法

vX_X_X - 游戏版本

p000 - 协议版本(每个发布/快照的协议版本号可在以下链接查看:)

cXYZ - 客户端品牌(例如:vanilla、forge、fabric、Geyser(通过 GeyserMC 加入的玩家)、badlion 等)

必须定义游戏版本 (v) 或协议版本 (p),但客户端品牌 (c) 完全是可选的

当未定义客户端品牌时,路由将接受所有使用定义的游戏/协议版本连接的客户端

[explicit-routing]

示例:v1_21_8cFORGE = "lobby-1"

示例:p123 = "lobby-2"

示例:cGeyser = "GeyserMC-server"

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源