InvSeparate

插件

· 作者 Himic

InvSeparate 是一款开源的 Minecraft 网络路由解决方案,支持在单个代理入口点背后托管多个整合包。

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

最新 SNAPSHOT-1.0.0 · 26.2 · Velocity

一键开服(送7天)

InvSeparate

InvSeparate 是一个用于 Minecraft 网络的开源路由解决方案,允许在单个代理入口点背后托管多个整合包。

它由两部分组成:

  • 一个 Velocity 插件,用于决定玩家应使用的登录服务器和后端目标
  • 一个客户端模组,在后端选择发生之前向 Minecraft 握手添加包标识符

这使得一个 Velocity 代理能够同时服务原版客户端、多个整合包客户端以及不同的登录流程。

功能

  • 基于标识符的初始路由
  • 从登录服务器到最终后端的两阶段路由
  • 针对没有安装该模组或使用未知标识符的客户端提供默认回退机制
  • 基于 Velocity 3.4.x 开发,兼容范围延伸至 Velocity 4.x
  • 采用单体仓库布局,共享协议代码、代理插件以及多种加载器实现

工作原理

  1. 客户端模组读取配置的 identifier(标识符)
  2. 模组将 <hostname>\0<identifier> 写入握手的 host 字段
  3. Velocity 插件从原始握手主机名中读取标识符
  4. 插件选择配置的登录服务器和登录后目标
  5. 如果不存在标识符,则使用正常的默认路由

重要提示:Velocity 的 getVirtualHost() 方法会丢弃空字节之后的任何数据。因此代理插件必须读取原始虚拟主机值以恢复标识符。

仓库结构

  • common: 共享协议常量和辅助工具
  • velocity: Velocity 插件实现
  • neoforged: NeoForge 客户端模组
  • fabric: Fabric 客户端模组
  • forge: 预留 Forge 模块
  • bungeecord: 预留 BungeeCord 模块

示例配置

Velocity 配置文件位于 plugins/invseparate/config.yml:

default-server: "login"
default-post-login-server: "lobby"
post-login-delay-seconds: 5

identifiers:
  endlessmc-hng:
    login-server: "hng_login"
    post-login-server: "hng"

客户端配置:

identifier = "endlessmc-hng"

构建说明

Common 和 Velocity

当前仓库默认使用 Gradle 9.x,因此这些模块可以直接构建:

./gradlew.bat :common:build :velocity:build

加载器模块

Loader 特定的模组,例如 neoforged、fabric 和 forge 位于同一仓库中,但在 settings.gradle.kts 中默认并非全部启用。

请按照构建文件中的内联注释切换所需的 Gradle 版本,并启用你想要构建的 Loader 模块。

分支策略

  • 1.21.1 是当前主分支
  • 其他 Minecraft 版本在需要时应维护在独立的分支中
  • 1.21.8 分支已不再使用

使用场景

  • 原版客户端加入默认的登录服务器
  • 不同的整合包客户端加入不同的登录服务器
  • 玩家经过身份验证后被转发至其目标后端服务器
  • 需要比简单的登录后转发插件更强大的代理端路由层的网络

许可证

当前的源码头部信息基于 MIT 许可证组织。

InvSeparate

InvSeparate 是一个面向多整合包 Minecraft 网络的开源路由方案。

它由两部分组成:

  • Velocity 插件:在代理层识别客户端标识,并决定玩家应进入哪个登录服、认证后再进入哪个目标服。
  • 客户端 Mod:在 Minecraft 握手阶段把整合包标识附加到握手主机名中,让代理在真正进入后端前就能完成分流。

这让同一个 Velocity 入口可以同时服务原版客户端、多个整合包客户端,以及各自不同的登录与落地流程。

特性

  • 支持基于客户端标识的初始路由
  • 支持“登录服 -> 目标服”的二段转发
  • 未安装 Mod 或标识未知时回退到默认服务器
  • 当前以 Velocity 3.4.x 为基线开发,目标兼容 Velocity 4.x
  • 仓库内按模块组织公共协议、代理插件和不同加载器实现

工作原理

  1. 客户端 Mod 在连接服务器时读取本地配置中的 identifier
  2. Mod 将 <hostname>\0<identifier> 写入握手地址
  3. Velocity 插件从原始握手主机名中提取标识
  4. 插件根据 config.yml 中的规则选择登录服与登录后目标服
  5. 若无标识或标识未知,则按默认规则处理

注意:Velocity 的 getVirtualHost() 会丢弃 null byte 之后的数据,因此服务端必须读取原始主机名而不是处理后的虚拟主机值。

仓库结构

  • common:公共协议常量与工具
  • velocity:Velocity 插件实现
  • neoforged:NeoForge 客户端 Mod
  • fabric:Fabric 客户端 Mod
  • forge:预留 Forge 模块
  • bungeecord:预留 BungeeCord 模块

配置示例

Velocity 配置文件位于 plugins/invseparate/config.yml:

default-server: "login"
default-post-login-server: "lobby"
post-login-delay-seconds: 5

identifiers:
  endlessmc-hng:
    login-server: "hng_login"
    post-login-server: "hng"

NeoForge/Fabric 客户端配置核心项:

identifier = "endlessmc-hng"

构建说明

公共模块与 Velocity

当前仓库默认使用 Gradle 9.x,可直接构建:

./gradlew.bat :common:build :velocity:build

Loader 模块

neoforged、fabric、forge 等加载器模块保留在同一仓库中,但当前 settings.gradle.kts 默认未启用全部模块。

按仓库内注释切换对应模块与 Gradle 版本后,可分别构建对应 Loader 产物。

分支策略

  • 当前主线版本为 1.21.1
  • 其他 Minecraft 版本建议使用独立分支维护
  • 1.21.8 分支已停止使用

适用场景

  • 原版客户端进入默认登录服
  • 不同整合包客户端进入各自的登录服
  • 登录认证完成后自动进入各自目标后端
  • 需要替代或补强现有“只负责转发、不负责识别客户端”的代理路由方案

许可证

本项目当前源码头部按 MIT 许可约定组织。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源