跳到主要内容

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 的「新建游戏账户」界面。

image.png

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

image.png image.png

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

image.png

  1. 设置完成啦!你可以启动游戏了。

PCL 启动器示例

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

小小的建议

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

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

版本设置

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

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

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

提示

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

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

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

正版 启动器示例

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

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

An image

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

An image

  1. 然后打开正版启动器的JVM参数进行设置
-javaagent:{绝对位置\authlib-injector.jar}=https://skin.vlssu.com/api/yggdrasil

An image

  1. 设置完成啦!你可以启动游戏了。

参考链接