外置登录

部分 Minecraft 启动器提供 Yggdrasil 外置登录功能，在外置登录下玩家可在非正版的情况下加载皮肤，并享受更安全的多人服务器鉴权。本文将介绍如何在常见启动器与服务端中配置 authlib-injector 外置登录。

HMCL 3

  1. 在 HMCL 启动器中选择 账户，点击 添加认证服务器
  2. 在认证服务器地址中输入：
https://skin.oak-ms.top/api/yggdrasil

地址简写

https://skin.oak-ms.top 和 skin.oak-ms.top 这些地址也可以填入，但 HMCL 在使用这些地址时搜索速度较慢，推荐直接使用完整 API 地址。

  1. 当服务器名称显示为 OakSkin，点击 完成
  2. 此时左侧会出现一个 OakSkin 外置登录方式

HMCL 3 外置登录

  1. 点击 OakSkin，填写皮肤站中注册账号的邮箱和密码，点击 登录
  2. 账户列表中出现角色名，代表成功登录

PCL 2

  1. 选择一个 Minecraft 版本，点击 版本设置
  2. 左侧列表中选择 设置，下滑找到 服务器
  3. 登录方式切换为 第三方登录：Authlib-Injector 或 LittleSkin
  4. 填入以下信息：
认证服务器：https://skin.oak-ms.top/api/yggdrasil
注册链接：https://skin.oak-ms.top/auth/register
服务器名称：OakSkin

填写麻烦？

部分设备可将皮肤站仪表盘中的 将此按钮拖动至启动器 按钮拖入 PCL2 窗口，即可快速填写配置信息。

  1. 填完后回到启动页，样式如下图所示：

PCL2 启动页

  1. 此时填写皮肤站账号的邮箱和密码，启动游戏会自动使用皮肤站账号登录

BakaXL

BakaXL 的外置登录配置过程与上述启动器类似，区别在于入口菜单位置不同。

视频教程

可参考 B 站教程：BV1W741197Bv

只需把视频中使用的认证服务器地址改为： https://skin.oak-ms.top/api/yggdrasil

后续会更新该启动器的详细图文配置教程。

服务端 authlib-injector

当离线服务器希望不使用模组和插件即可实现玩家皮肤加载，并确保玩家账号安全性时，authlib-injector 是一个好选择。

下载 authlib-injector

从 GitHub Releases 下载最新版本

配置 authlib-injector

  1. 将下载好的 authlib-injector-x.x.x.jar 放入 服务端启动脚本 或 服务端核心 jar 所在的文件夹中

单服务端（非群组服）常用配置

  1. 修改服务器配置文件 server.properties，将 online-mode 设为 true：
online-mode=true

必须开启 online-mode

如果 online-mode=false，玩家可以使用任意身份绕过鉴权直接进入服务器，外置登录将完全失效。

  1. 在你的服务端启动指令中，在 -jar 参数 之前 添加如下参数：
-javaagent:authlib-injector-x.x.x.jar=https://skin.oak-ms.top/api/yggdrasil

完整的启动命令示例：

java -Xmx4G -Xms2G -javaagent:authlib-injector-1.2.5.jar=https://skin.oak-ms.top/api/yggdrasil -jar server.jar nogui

群组服（Velocity / BungeeCord）

群组服需要在代理端（Velocity/BungeeCord）添加 -javaagent 参数，后端子服设置为 online-mode=false 并将连接信任交给代理。 更详细的配置请参考 authlib-injector 官方文档或联系 OakSkin 管理员。

  1. 启动服务器即可。玩家需使用启动器中配置好的 OakSkin 外置登录账号进入服务器。