在服务端配置 Yggdrasil 外置登录

本文介绍如何为各类 Minecraft 服务端配置 Yggdrasil 外置登录。

什么是 Yggdrasil 外置登录？

如果你还不了解 Yggdrasil 外置登录的概念，请先阅读 Yggdrasil 外置登录 页面。

为什么要配置服务端外置登录？

在多人游戏中，只有在服务端正确配置了 Yggdrasil 外置登录后，玩家才能正常地在多人游戏中显示他们在 OakSkin 上设置的材质。

此外，外置登录还提供了身份验证功能，可以有效防止玩家冒充他人进入服务器。

配置步骤

1. 下载 authlib-injector

authlib-injector 是一个用于实现 Yggdrasil 外置登录的工具。

你可以从 GitHub Releases 下载最新版本。

2. 配置服务端启动参数

在启动服务端时，添加以下 JVM 参数：

-javaagent:authlib-injector.jar=https://skin.oak-ms.top/api/yggdrasil

完整的启动命令示例：

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

3. 配置 server.properties

确保 server.properties 文件中的 online-mode 设置为 true：

online-mode=true

4. 重启服务端

完成配置后，重启服务端使配置生效。

常见问题

玩家无法进入服务器

请检查：

1. authlib-injector 是否正确加载
2. Yggdrasil API 地址是否正确
3. 服务端日志中是否有相关错误信息

玩家皮肤不显示

请检查：

1. 玩家是否使用外置登录启动游戏
2. 玩家的角色名是否与 OakSkin 上的角色名一致
3. 玩家是否已在 OakSkin 上设置了材质

调试模式

如果需要调试外置登录问题，可以在 JVM 参数中添加 -Dauthlib-injector.debug：

-javaagent:authlib-injector.jar=https://skin.oak-ms.top/api/yggdrasil -Dauthlib-injector.debug

这将输出更详细的调试日志，帮助你定位问题。

相关资源

• 在客户端配置 Yggdrasil 外置登录
• 遇到问题了？