anvilauth-injector/docs/在-Minecraft-服务端使用-authlib-injector.md

目录

• 获取 authlib-injector
• 原版服务端、Spigot 等
• BungeeCord
• 调用 Mojang 皮肤
  • 通过代理访问 Mojang
• 兼容性

本文主要介绍如何在 Minecraft 服务端使用 authlib-injector。

获取 authlib-injector

首先你需要从此处下载最新版本的 authlib-injector。

原版服务端、Spigot 等

请将服务端的 online-mode 设置为 true，然后在其启动命令中添加以下 JVM 参数：

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

• {path/to/authlib-injector.jar} 表示你在上一步中下载的 JAR 文件所在的位置（相对路径、绝对路径皆可）。
• {https://your-yggdrasil-api-root.com} 表示验证服务器的 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://example.yggdrasil.yushi.moe。

那么添加参数后的命令行应该如下：

java -javaagent:authlib-injector.jar=https://example.yggdrasil.yushi.moe -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"}
• （Citizens2 插件）/npc skin notch

这些命令获取的都是自定义的验证服务器上名为 notch 的角色的皮肤。

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

• /give @p minecraft:skull 1 3 {SkullOwner:"notch@mojang"}
• /npc skin notch@mojang

详细说明见 README § 参数 中的 -Dauthlibinjector.mojangNamespace 选项。

通过代理访问 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