Polymerium
指南

设置 Authlib Injector(外置登录)

使用 Yggdrasil 协议连接第三方认证服务器。

上次更新

什么是 Authlib Injector?

Authlib Injector 是一个 Java 代理,用于拦截 Minecraft 的认证调用并将其重定向到第三方 Yggdrasil 兼容服务器。中国 Minecraft 社区常使用它进行自定义认证(外置登录)。

Polymerium 内置支持此功能 —— 无需手动配置 Java 代理。

设置

步骤 1:添加 Authlib 账号

  1. 在侧边栏中进入 账号(Accounts)

  2. 点击 添加账号(Add Account)Authlib Injector

  3. 输入 Yggdrasil 认证服务器的 服务器 URL

    示例:https://auth.example.com/api/yggdrasil

  4. Polymerium 会获取服务器元数据并验证连接。

  5. 输入该服务器的凭据(用户名/邮箱 + 密码)。

  6. 账号已保存。

步骤 2:将账号绑定到您的实例

  1. 打开实例的属性。
  2. 账号覆盖(account override) 设置为您的 Authlib 账号。

或者,如果多数实例都使用此账号,也可以将其设置为默认账号。

步骤 3:部署并启动

  1. 点击 部署(Deploy)(或 启动(Launch) —— 会自动部署)。
  2. Polymerium 将 -javaagent 标志与预取的服务器元数据注入到启动命令中。
  3. 游戏将通过第三方服务器进行认证,而非 Mojang。

工作原理

使用 Authlib 账号启动实例时:

  1. Polymerium 会下载最新版的 Authlib Injector JAR(如果尚未缓存)。
  2. 获取并缓存服务器的 Yggdrasil 元数据。
  3. 向 JVM 参数添加 -javaagent:authlib-injector.jar={server_url}
  4. 游戏进程加载 Authlib Injector,在内存中修补认证流程。

服务器兼容性

Polymerium 兼容任何实现 Yggdrasil 协议的服务器,包括:

  • authlib-injector 兼容服务器
  • 大多数中国社区认证服务器(LittleSkin 等)
  • 自定义 Yggdrasil 实现

故障排除

问题解决方案
无法获取服务器元数据检查服务器 URL;确保其可访问
认证失败验证凭据;检查服务器是否要求特定格式
游戏可启动但无法加入服务器确保服务器 URL 与游戏服务器期望的一致
皮肤不显示这是服务器端功能;请咨询您的认证服务器管理员

目录