====== 在 Minecraft 服务端使用 authlib injector ======
\\
===== 目录 =====
获取 authlib-injector\\
原版服务端、Spigot 等\\
BungeeCord\\
调用 Mojang 皮肤\\
通过代理访问 Mojang\\
兼容性\\
\\

本文主要介绍如何在 Minecraft 服务端使用 authlib-injector。\\
\\
**获取 authlib-injector**\\
首先你需要从[[https://authlib-injector.yushi.moe/|此处]]下载最新版本的 authlib-injector。\\
\\
**粗体**原版服务端、Spigot 等\\
请将服务端的 online-mode 设置为 true，然后在其启动命令中添加以下 JVM 参数：\\

-javaagent:{path/to/authlib-injector.jar}={https://meown.top/skin/api/yggdrasil}
{path/to/authlib-injector.jar} 表示你在上一步中下载的 JAR 文件所在的位置（相对路径、绝对路径皆可）。\\
{https://meown.top/skin/api/yggdrasil} 表示验证服务器的 URL。
例如，这是原先的启动命令：\\

java -jar minecraft_server.1.12.2.jar nogui
假设：\\

你下载到的 authlib-injector JAR 文件名为 authlib-injector.jar。\\
你将其放到了与服务端 JAR minecraft_server.1.12.2.jar 相同的目录下。\\
验证服务器的 URL 为 https://meown.top/skin/api/yggdrasil。
那么添加参数后的命令行应该如下：\\

java -javaagent:authlib-injector.jar=https://meown.top/skin/api/yggdrasil -jar minecraft_server.1.12.2.jar nogui\\
\\
**粗体**BungeeCord\\
如果使用 BungeeCord，那么在所有服务端上都需要加载 authlib-injector（方法见上），但应只有 BungeeCord 打开 online-mode，后端 MC 服务端应关闭 online-mode。\\
\\
**粗体**调用 Mojang 皮肤\\
加载 authlib-injector 后，所有皮肤默认都是从指定的验证服务器处获取的。例如：\\

/give @p minecraft:skull 1 3 {SkullOwner:"notch"}
命令获取的都是自定义的验证服务器上名为 notch 的角色的皮肤。\\

如果要使用 Mojang 的皮肤，则可以在角色名称后加上 @mojang，如：\\

/give @p minecraft:skull 1 3 {SkullOwner:"notch@mojang"}\\
\\

**粗体**通过代理访问 Mojang\\
调用 Mojang 皮肤的功能需要 MC 服务端能够访问 Mojang API。如果你的服务端要通过代理才能访问 Mojang，那么你可以在启动时添加以下 JVM 参数来指定代理：\\

-Dauthlibinjector.mojangProxy=socks://<host>:<port>\\
注意：\\

只有向 Mojang 查询角色信息时才会使用此代理，材质图像下载不走代理（即使是来自 Mojang 的材质）。\\
目前仅支持 SOCKS5。\\
\\
**粗体**兼容性\\
一般而言，authlib-injector 兼容绝大多数插件和 Mod。下表列出的是（曾经）存在兼容性问题的插件 / Mod / 服务端：\\

受影响的插件 / Mod / 服务端	受影响的 authlib-injector 版本	备注
Citizens2	<=1.1.23	#27 #28
LaunchWrapper	=1.1.24	#33
ModLauncher	1.1.24, 1.1.25	#38
Arclight	<=1.1.30	#80
Geyser (plugin)	<=1.1.31	#83
BungeeCord	<=1.1.36	#108