From 22a186b554d36bc1f35f25e1970d66d10b494fca Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Mon, 27 Apr 2026 16:07:16 +0000 Subject: [PATCH 1/5] docs: supplement MC multiplayer skin station login sections Agent-Logs-Url: https://github.com/Seele-Vollerei32/natfrp-wiki/sessions/f8c4279a-3c0b-4f4f-9212-f935036e7ac4 Co-authored-by: Seele-Vollerei32 <83913312+Seele-Vollerei32@users.noreply.github.com> --- app/mc.md | 8 ++++++++ offtopic/mc-java-server.md | 36 ++++++++++++++++++++++++++++++++++++ 2 files changed, 44 insertions(+) diff --git a/app/mc.md b/app/mc.md index 946fc11..c9de4a9 100644 --- a/app/mc.md +++ b/app/mc.md @@ -41,6 +41,14 @@ Minecraft 局域网联机穿透通常需要安装 Mod 辅助， 否则，请参考 [安装辅助 Mod 的步骤](#java-mod) ::: +::: tip 关于皮肤站账号 +**皮肤站** 是一种提供自定义皮肤托管和第三方身份验证的服务，如 [LittleSkin](https://littleskin.cn)。使用皮肤站账号联机时，请注意以下要求： + +- 所有参与联机的玩家（包括开启局域网的主机）必须使用 **同一个** 皮肤站的账号登录游戏 +- 需要使用支持第三方登录 (authlib-injector) 的启动器，如 [HMCL](https://hmcl.huangyuhui.net/)、[PCL2](https://afdian.net/a/LTCat) 等 +- 在启动器中按皮肤站提供的 **快速配置启动器** 教程添加第三方账号后登录，启动器内您的账号类型通常会显示为皮肤站名称（例如「LittleSkin」），而非「正版」或「离线」 +::: + 进入要联机的世界，按下键盘上的 **ESC** 键，在出现的界面里找到 `对局域网开放` 之类的按钮并且点击进入，对 **其他玩家** 进行设置，然后点击 `创造一个局域网世界`。 在聊天框里会提示 `本地游戏已在端口 xxxxx 上开启` ，表示游戏内置服务端已经启动在这个端口上，这就是我们的本地端口。 diff --git a/offtopic/mc-java-server.md b/offtopic/mc-java-server.md index ee6c9f2..0193794 100644 --- a/offtopic/mc-java-server.md +++ b/offtopic/mc-java-server.md @@ -530,6 +530,42 @@ java -Xmx4G -Xms4G -jar paper-1.21-119.jar ## 补充内容 {#other-content} +### 使用皮肤站验证 {#yggdrasil-auth} + +如果您希望让登录了皮肤站账号的玩家通过正版验证 (`online-mode=true`) 加入服务器，需要使用 [authlib-injector](https://github.com/yushijinhun/authlib-injector) 工具，将服务端的身份验证请求重定向到皮肤站的 Yggdrasil API。 + +::: warning +使用此功能要求所有联机玩家都已在启动器中配置了 **同一个** 皮肤站账号登录。 +::: + +1. 从 [authlib-injector 发布页面](https://github.com/yushijinhun/authlib-injector/releases) 下载最新版本的 `authlib-injector-*.jar` 文件，将其放置到服务器目录下 +2. 在皮肤站找到 **Yggdrasil API** 地址，通常在皮肤站的「快速配置启动器」或帮助页面中可以找到，形如 `https://your-skin-site.com/api/yggdrasil` +3. 修改您的启动脚本，在 `java` 命令后紧接着加入 `-javaagent` 参数： + + ```bat + java -javaagent:authlib-injector-*.jar=皮肤站API地址 -Xmx4G -Xms4G -jar 服务器核心文件名.jar + @pause + ``` + + 例如，使用 [LittleSkin](https://littleskin.cn) 且服务端核心为 `paper-1.21-119.jar`： + + ```bat + java -javaagent:authlib-injector-1.2.5.jar=https://littleskin.cn/api/yggdrasil -Xmx4G -Xms4G -jar paper-1.21-119.jar + @pause + ``` + + ::: tip + 对于 MinecraftForge / NeoForge 核心，请将 authlib-injector 参数加入 `user_jvm_args.txt` 文件中： + + ``` + -javaagent:authlib-injector-*.jar=皮肤站API地址 + -Xmx4G -Xms4G + ``` + ::: + +4. 确认 `server.properties` 中 `online-mode=true`（服务器初次启动时默认即为 `true`，如果之前已修改请改回来） +5. 重新启动服务器，此后只有成功通过皮肤站验证的玩家才能加入服务器 + ### Simple Voice Chat 简单语音聊天 {#simple-voice-chat} 如果您使用 Simple Voice Chat 模组/插件来进行语音聊天，您需要为它单独开一条隧道并进行配置。 From acde5a6a3e4bd4d075969246e47f225cb203435c Mon Sep 17 00:00:00 2001 From: Kevin Liu Date: Mon, 15 Jun 2026 09:52:34 +0800 Subject: [PATCH 2/5] app/mc: Update skin site --- app/mc.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/app/mc.md b/app/mc.md index c9de4a9..e4864be 100644 --- a/app/mc.md +++ b/app/mc.md @@ -45,8 +45,8 @@ Minecraft 局域网联机穿透通常需要安装 Mod 辅助， **皮肤站** 是一种提供自定义皮肤托管和第三方身份验证的服务，如 [LittleSkin](https://littleskin.cn)。使用皮肤站账号联机时，请注意以下要求： - 所有参与联机的玩家（包括开启局域网的主机）必须使用 **同一个** 皮肤站的账号登录游戏 -- 需要使用支持第三方登录 (authlib-injector) 的启动器，如 [HMCL](https://hmcl.huangyuhui.net/)、[PCL2](https://afdian.net/a/LTCat) 等 -- 在启动器中按皮肤站提供的 **快速配置启动器** 教程添加第三方账号后登录，启动器内您的账号类型通常会显示为皮肤站名称（例如「LittleSkin」），而非「正版」或「离线」 +- 需要使用支持第三方登录 (authlib-injector) 的启动器，如 [HMCL](https://hmcl.huangyuhui.net/)、[PCL2](https://afdian.com/a/LTCat) 等 +- 在启动器中按皮肤站提供的 **Yggdrasil 外置登录** 教程添加第三方账号后登录，启动器内您的账号类型通常会显示为皮肤站名称（例如「LittleSkin」），而非「正版」或「离线」 ::: 进入要联机的世界，按下键盘上的 **ESC** 键，在出现的界面里找到 `对局域网开放` 之类的按钮并且点击进入，对 **其他玩家** 进行设置，然后点击 `创造一个局域网世界`。 From 2dc90deca2d7049b2b23b2b19916a23d54e2c61e Mon Sep 17 00:00:00 2001 From: Kevin Liu Date: Mon, 15 Jun 2026 09:57:02 +0800 Subject: [PATCH 3/5] offtopic/mc-server: Update skin site --- offtopic/mc-java-server.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/offtopic/mc-java-server.md b/offtopic/mc-java-server.md index 0193794..3a5fd8b 100644 --- a/offtopic/mc-java-server.md +++ b/offtopic/mc-java-server.md @@ -539,7 +539,7 @@ java -Xmx4G -Xms4G -jar paper-1.21-119.jar ::: 1. 从 [authlib-injector 发布页面](https://github.com/yushijinhun/authlib-injector/releases) 下载最新版本的 `authlib-injector-*.jar` 文件，将其放置到服务器目录下 -2. 在皮肤站找到 **Yggdrasil API** 地址，通常在皮肤站的「快速配置启动器」或帮助页面中可以找到，形如 `https://your-skin-site.com/api/yggdrasil` +2. 在皮肤站找到 **Yggdrasil API** 地址，通常在皮肤站的「Yggdrasil 外置登录」或帮助页面中可以找到，形如 `https://skinsite.example.com/api/yggdrasil` 3. 修改您的启动脚本，在 `java` 命令后紧接着加入 `-javaagent` 参数： ```bat From 5c3591515dfdb6abff4de47ba9d8f7b0d6240837 Mon Sep 17 00:00:00 2001 From: Kevin Liu Date: Mon, 15 Jun 2026 10:27:16 +0800 Subject: [PATCH 4/5] offtopic/mc-server: disambiguation, --- app/mc.md | 4 ++-- offtopic/mc-java-server.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/app/mc.md b/app/mc.md index e4864be..6701ab5 100644 --- a/app/mc.md +++ b/app/mc.md @@ -30,7 +30,7 @@ Minecraft 局域网联机穿透通常需要安装 Mod 辅助， - 有玩家使用离线登录 (直接在启动器内设置用户名) ，则需辅助 Mod - 有玩家登录不同皮肤站的账号，则需辅助 Mod - 所有人都是正版账号，不需辅助 Mod -- 所有人都登录皮肤站的账号，不需辅助 Mod +- 所有人都登录同一个皮肤站的账号，不需辅助 Mod，具体操作参见 [此处](/offtopic/mc-java-server.md#yggdrasil-auth) 在需要辅助 Mod 时不使用，会出现 `登录失败: 无效会话 (请尝试重启游戏及启动器)` 问题。 @@ -44,7 +44,7 @@ Minecraft 局域网联机穿透通常需要安装 Mod 辅助， ::: tip 关于皮肤站账号 **皮肤站** 是一种提供自定义皮肤托管和第三方身份验证的服务，如 [LittleSkin](https://littleskin.cn)。使用皮肤站账号联机时，请注意以下要求： -- 所有参与联机的玩家（包括开启局域网的主机）必须使用 **同一个** 皮肤站的账号登录游戏 +- 所有参与联机的玩家（包括开启局域网的主机）必须使用 **同一个** 皮肤站的账号登录游戏 (账号需自行注册) - 需要使用支持第三方登录 (authlib-injector) 的启动器，如 [HMCL](https://hmcl.huangyuhui.net/)、[PCL2](https://afdian.com/a/LTCat) 等 - 在启动器中按皮肤站提供的 **Yggdrasil 外置登录** 教程添加第三方账号后登录，启动器内您的账号类型通常会显示为皮肤站名称（例如「LittleSkin」），而非「正版」或「离线」 ::: diff --git a/offtopic/mc-java-server.md b/offtopic/mc-java-server.md index 3a5fd8b..1044543 100644 --- a/offtopic/mc-java-server.md +++ b/offtopic/mc-java-server.md @@ -535,11 +535,11 @@ java -Xmx4G -Xms4G -jar paper-1.21-119.jar 如果您希望让登录了皮肤站账号的玩家通过正版验证 (`online-mode=true`) 加入服务器，需要使用 [authlib-injector](https://github.com/yushijinhun/authlib-injector) 工具，将服务端的身份验证请求重定向到皮肤站的 Yggdrasil API。 ::: warning -使用此功能要求所有联机玩家都已在启动器中配置了 **同一个** 皮肤站账号登录。 +使用此功能要求所有联机玩家都已在启动器中配置了 **同一个** 皮肤站的账号登录 (账号需自行注册)。 ::: 1. 从 [authlib-injector 发布页面](https://github.com/yushijinhun/authlib-injector/releases) 下载最新版本的 `authlib-injector-*.jar` 文件，将其放置到服务器目录下 -2. 在皮肤站找到 **Yggdrasil API** 地址，通常在皮肤站的「Yggdrasil 外置登录」或帮助页面中可以找到，形如 `https://skinsite.example.com/api/yggdrasil` +2. 在皮肤站找到 **Yggdrasil API** 地址，通常在皮肤站的「Yggdrasil 外置登录」或帮助页面中可以找到，形如 `https://skin.example.com/api/yggdrasil` 3. 修改您的启动脚本，在 `java` 命令后紧接着加入 `-javaagent` 参数： ```bat From 175d43c4082ed62869b7b294657dad0413edb4a7 Mon Sep 17 00:00:00 2001 From: Kevin Liu Date: Mon, 15 Jun 2026 10:58:24 +0800 Subject: [PATCH 5/5] app/mc; offtopic/mc-server: Update skin site references and remove problem Yggdrasil authentication instructions --- app/mc.md | 4 ++-- offtopic/mc-java-server.md | 36 ------------------------------------ 2 files changed, 2 insertions(+), 38 deletions(-) diff --git a/app/mc.md b/app/mc.md index 6701ab5..1905f46 100644 --- a/app/mc.md +++ b/app/mc.md @@ -30,7 +30,7 @@ Minecraft 局域网联机穿透通常需要安装 Mod 辅助， - 有玩家使用离线登录 (直接在启动器内设置用户名) ，则需辅助 Mod - 有玩家登录不同皮肤站的账号，则需辅助 Mod - 所有人都是正版账号，不需辅助 Mod -- 所有人都登录同一个皮肤站的账号，不需辅助 Mod，具体操作参见 [此处](/offtopic/mc-java-server.md#yggdrasil-auth) +- 所有人都登录同一个皮肤站的账号，不需辅助 Mod，具体操作参见 [此处](https://manual.littlesk.in/yggdrasil) 在需要辅助 Mod 时不使用，会出现 `登录失败: 无效会话 (请尝试重启游戏及启动器)` 问题。 @@ -41,7 +41,7 @@ Minecraft 局域网联机穿透通常需要安装 Mod 辅助， 否则，请参考 [安装辅助 Mod 的步骤](#java-mod) ::: -::: tip 关于皮肤站账号 +::: tip **皮肤站** 是一种提供自定义皮肤托管和第三方身份验证的服务，如 [LittleSkin](https://littleskin.cn)。使用皮肤站账号联机时，请注意以下要求： - 所有参与联机的玩家（包括开启局域网的主机）必须使用 **同一个** 皮肤站的账号登录游戏 (账号需自行注册) diff --git a/offtopic/mc-java-server.md b/offtopic/mc-java-server.md index 1044543..ee6c9f2 100644 --- a/offtopic/mc-java-server.md +++ b/offtopic/mc-java-server.md @@ -530,42 +530,6 @@ java -Xmx4G -Xms4G -jar paper-1.21-119.jar ## 补充内容 {#other-content} -### 使用皮肤站验证 {#yggdrasil-auth} - -如果您希望让登录了皮肤站账号的玩家通过正版验证 (`online-mode=true`) 加入服务器，需要使用 [authlib-injector](https://github.com/yushijinhun/authlib-injector) 工具，将服务端的身份验证请求重定向到皮肤站的 Yggdrasil API。 - -::: warning -使用此功能要求所有联机玩家都已在启动器中配置了 **同一个** 皮肤站的账号登录 (账号需自行注册)。 -::: - -1. 从 [authlib-injector 发布页面](https://github.com/yushijinhun/authlib-injector/releases) 下载最新版本的 `authlib-injector-*.jar` 文件，将其放置到服务器目录下 -2. 在皮肤站找到 **Yggdrasil API** 地址，通常在皮肤站的「Yggdrasil 外置登录」或帮助页面中可以找到，形如 `https://skin.example.com/api/yggdrasil` -3. 修改您的启动脚本，在 `java` 命令后紧接着加入 `-javaagent` 参数： - - ```bat - java -javaagent:authlib-injector-*.jar=皮肤站API地址 -Xmx4G -Xms4G -jar 服务器核心文件名.jar - @pause - ``` - - 例如，使用 [LittleSkin](https://littleskin.cn) 且服务端核心为 `paper-1.21-119.jar`： - - ```bat - java -javaagent:authlib-injector-1.2.5.jar=https://littleskin.cn/api/yggdrasil -Xmx4G -Xms4G -jar paper-1.21-119.jar - @pause - ``` - - ::: tip - 对于 MinecraftForge / NeoForge 核心，请将 authlib-injector 参数加入 `user_jvm_args.txt` 文件中： - - ``` - -javaagent:authlib-injector-*.jar=皮肤站API地址 - -Xmx4G -Xms4G - ``` - ::: - -4. 确认 `server.properties` 中 `online-mode=true`（服务器初次启动时默认即为 `true`，如果之前已修改请改回来） -5. 重新启动服务器，此后只有成功通过皮肤站验证的玩家才能加入服务器 - ### Simple Voice Chat 简单语音聊天 {#simple-voice-chat} 如果您使用 Simple Voice Chat 模组/插件来进行语音聊天，您需要为它单独开一条隧道并进行配置。