Yggdrasil

VlssuSkin 提供 Yggdrasil 验证鉴权服务，你可以配合 authlib-injector 来实现 Minecraft 服务器外置登录，并在不安装皮肤 Mod 的情况下加载来自 VlssuSkin 的材质。

你可以在 https://authlib-injector.yushi.moe/~download/ 下载到最新版本的 authlib-injector。

Yggdrasil API 地址

VlssuSkin 的 Yggdrasil API 的地址是：

https://skin.vlssu.com/api/yggdrasil

API 文档

请参阅：Yggdrasil 服务端技术规范

你也可以在 wiki.vg 上找到更多信息。

在服务端使用

请先将服务器配置文件（一般为 server.propties）中 online-mode 一项的值设为 true，然后在你的服务端的启动指令的 -jar 参数前添加如下参数：

-javaagent:{path/to/authlib-injector.jar}=https://skin.vlssu.com/api/yggdrasil

其中 {path/to/authlib-injector.jar} 为指向 authlib-injector 的路径。

提示

如果你使用 BungeeCord，你需要在所有服务端（包括 BungeeCord 和所有子服）中加载 authlib-injector（方法见上），但只有 BungeeCord 打开 online-mode，其他服务端应该关闭 online-mode。

在客户端使用

在客户端中使用 VlssuSkin 的 Yggdrasil 需要启动器支持自定义 Yggdrasil 服务器。推荐使用 HMCL 3。

提示

如果你使用的启动器不支持自定义 Yggdrasil，并且你使用的启动器是使用 Java 编写的，你也可以手动添加 JVM 参数来加载 authlib-injector（就像在服务端使用 authlib-injector 一样），但是本文不介绍这种做法。

HMCL 启动器示例

以下以 HMCL 3.5 为例，演示在 Minecraft 客户端中使用 Yggdrasil。

1. 打开 HMCL 3.5 的「新建游戏账户」界面。

2. 点击左下角的「添加认证服务器」，输入 VlssuSkin 的 Yggdrasil API 地址，点击「下一步」，等待识别出 VlssuSkin 的 Yggdrasil 后点击「完成」。 如果你曾经添加过 VlssuSkin 的 Yggdrasil，你也可以在「添加账户」菜单中直接选择 VlssuSkin。

3. 在「添加账户」菜单中选择 VlssuSkin，填写你的邮箱和密码。「用户名」即为你在 VlssuSkin 的账号的邮箱。 如果你只添加了一个认证服务器，那么 HMCL 3.5 会默认选中那个唯一的认证服务器。

4. 设置完成啦！你可以启动游戏了。

PCL 启动器示例

以下以 PCL 2 为例，演示在 Minecraft 客户端中使用 Yggdrasil。

小小的建议

该启动器可能存在反人类设计或其他一些原因，在此我们不太推荐使用此启动器，建议使用其他启动器。如果您觉得此提示不当，请无视此提示。

1. 打开 PCL 2 的「版本设置」界面。如果这是你第一次打开 PCL 2，请先下载你想玩的版本(或服务器所需版本)。

2. 点击「设置」往下拉动会看见「服务器选项」，在「登陆方式」一栏选择「第三方登录：Authlib-lnjector」，下面会弹出「认证服务器」等一系列选项。输入 VlssuSkin 的 Yggdrasil API 地址等信息。

由于PCL2作者设计原因，每玩一个新版本都需要如此设置

登陆方式    第三方登录：Authlib-lnjector
认证服务器  https://skin.vlssu.com/api/yggdrasil
注册链接    https://skin.vlssu.com/auth/register
服务器名称  VlssuSkin

提示

在新版 PCL 这里左下角会有「设置为 Little Skin」，请不要点击，直接左上角点返回即可。

3. 设置好后主页不出意外已经自动变成VlssuSkin设置界面了，在下方填写你的邮箱和密码。「账户」即为你在 VlssuSkin 的账号的邮箱。 因PCL2作者设计原因，认证服务器只能设置一个，在不更改(没有输错)的情况下，那 VlssuSkin 就是启动器唯一的认证服务器

4. 设置完成啦！你可以直接点「启动游戏」了，账户会直接登录。

正版 启动器示例

以下以 Minecraft Launcher 为例，演示在 Minecraft 客户端中使用 Yggdrasil。

1. 首先你得是正版，然后再皮肤站绑定正版，如发现进不去，可以去皮肤站的个人资料右上角进行更新UUID

2. 需要先下载 authlib-injector.jar 并放在你的游戏文件的根目录也就是 .minecraft 文件夹里（实际随你放哪）

3. 然后打开正版启动器的JVM参数进行设置

设置参数

-javaagent:{绝对位置\authlib-injector.jar}=https://skin.vlssu.com/api/yggdrasil

这是我的参数

-javaagent:C:\Users\vlssu\AppData\Roaming\.minecraft\authlib-injector.jar=https://skin.vlssu.com/api/yggdrasil -Xmx8G -XX:+UnlockExperimentalVMOptions -XX:+UseG1GC -XX:G1NewSizePercent=20 -XX:G1ReservePercent=20 -XX:MaxGCPauseMillis=50 -XX:G1HeapRegionSize=32M

4. 设置完成啦！你可以启动游戏了。

参考链接

• 配合 authlib-injector 使用