指南
设置 Authlib Injector(外置登录)
使用 Yggdrasil 协议连接第三方认证服务器。
上次更新
什么是 Authlib Injector?
Authlib Injector 是一个 Java 代理,用于拦截 Minecraft 的认证调用并将其重定向到第三方 Yggdrasil 兼容服务器。中国 Minecraft 社区常使用它进行自定义认证(外置登录)。
Polymerium 内置支持此功能 —— 无需手动配置 Java 代理。
设置
步骤 1:添加 Authlib 账号
-
在侧边栏中进入 账号(Accounts)。
-
点击 添加账号(Add Account) → Authlib Injector。
-
输入 Yggdrasil 认证服务器的 服务器 URL。
示例:
https://auth.example.com/api/yggdrasil -
Polymerium 会获取服务器元数据并验证连接。
-
输入该服务器的凭据(用户名/邮箱 + 密码)。
-
账号已保存。
步骤 2:将账号绑定到您的实例
- 打开实例的属性。
- 将 账号覆盖(account override) 设置为您的 Authlib 账号。
或者,如果多数实例都使用此账号,也可以将其设置为默认账号。
步骤 3:部署并启动
- 点击 部署(Deploy)(或 启动(Launch) —— 会自动部署)。
- Polymerium 将
-javaagent标志与预取的服务器元数据注入到启动命令中。 - 游戏将通过第三方服务器进行认证,而非 Mojang。
工作原理
使用 Authlib 账号启动实例时:
- Polymerium 会下载最新版的 Authlib Injector JAR(如果尚未缓存)。
- 获取并缓存服务器的 Yggdrasil 元数据。
- 向 JVM 参数添加
-javaagent:authlib-injector.jar={server_url}。 - 游戏进程加载 Authlib Injector,在内存中修补认证流程。
服务器兼容性
Polymerium 兼容任何实现 Yggdrasil 协议的服务器,包括:
- authlib-injector 兼容服务器
- 大多数中国社区认证服务器(LittleSkin 等)
- 自定义 Yggdrasil 实现
故障排除
| 问题 | 解决方案 |
|---|---|
| 无法获取服务器元数据 | 检查服务器 URL;确保其可访问 |
| 认证失败 | 验证凭据;检查服务器是否要求特定格式 |
| 游戏可启动但无法加入服务器 | 确保服务器 URL 与游戏服务器期望的一致 |
| 皮肤不显示 | 这是服务器端功能;请咨询您的认证服务器管理员 |