多登录兼容模组

一个适用于Minecraft 1.21.1(可能也支持其他版本)的Fabric服务端模组,与MC-MultiLogin-service项目集成。

管理

mc-multilogin-compat-mod

一个用于 Minecraft 1.21.1(Mojang 映射表)的 Fabric 服务端模组,用于与 MC-MultiLogin-service 集成。

一个用于 Minecraft 1.21.1(Mojang 映射表)的 Fabric 服务端模组,用于与 MC-MultiLogin-service 集成,可以实现多源登录方式。

建议配合 Authlib-Injector 使用。此模组仅修改登录方式和登录失败时的提示信息。

建议配合 Authlib-Injector 使用。此模组仅修改登录方式和登录失败时的提示信息。如果您使用 Authlib-Injector,请记得设定它的链接为 MC-MultiLogin-service 提供的 API 地址。

Velocity 插件版本

配置可以在 plugins\multilogin-auth-compat\multilogin-compat-config.json 找到。

配置可以在 plugins\multilogin-auth-compat\multilogin-compat-config.json 找到。

Fabric 模组版本

功能特性

  • 每次玩家登录时,模组会以 detail=true 调用配置的 MC-MultiLogin-service 端点,因此认证失败时会返回结构化的 JSON 错误,而不是笼统的“Failed to verify username!”提示。
  • 详细的错误原因(DUPLICATE_NAME、BANNED、NOT_FOUND 等)会直接转发到连接客户端的断开连接界面。
  • DUPLICATE_NAME 时自动重命名(可配置):当服务报告某个玩家名称已被另一个皮肤站账号占用时,模组会自动使用服务建议的 availableId(例如 Steve_2)重试登录,并将原始名称 → 新名称的映射记录在 config/mc-multilogin-renames.json 中。

安装设置

  1. 将模组 JAR 放入服务器的 mods/ 目录。
  2. 启动服务器一次——默认配置文件将生成在 config/mc-multilogin-compat.json,并且服务器会因错误而停止,要求你 填写 API URL。
  3. 编辑配置,将 apiUrl 设置为你的 MC-MultiLogin-service 方法入口的基础 URL (例如 http://127.0.0.1:25600/login/my)。
  4. 重启服务器。

配置(config/mc-multilogin-compat.json)

{
  "apiUrl": "http://127.0.0.1:25600/login/my",
  "autoRename": true
}
字段 类型 默认值 描述
apiUrl string "" 必填。 MC-MultiLogin-service 登录方法的基础 URL(例如 method[].url 下配置的路径)。模组会自动追加 /session/minecraft/hasJoined?…。
autoRename boolean true (目前尚未生效)当为 true 时,遇到 DUPLICATE_NAME 拒绝会使用服务返回的 availableId 触发自动重试。重命名会持久化到 config/mc-multilogin-renames.json。设为 false 可禁用并改为显示错误。

构建

# Requires Java 21 and internet access to maven.fabricmc.net
./gradlew build

输出的 JAR 将位于 build/libs/。