⚡️ perf: add pay-for-minecraft tips

SerinaNya · SerinaNya · commit 5c2196469d56 · 2025-01-25T17:14:48.000+08:00
diff --git a/docs/feature/oauth-for-yggdrasil.md b/docs/feature/oauth-for-yggdrasil.md
@@ -1,6 +1,25 @@
-# 通过 OAuth 访问 Yggdrasil API
+# Yggdrasil Connect / 通过 OAuth 访问 Yggdrasil API
 
-<!--@include: ../advanced/for-experts.template.md-->
+<!-- @include: @/advanced/for-experts.template.md -->
+<!-- @include: @/pay-for-minecraft.template.md -->
+
+
+---
+
+> [!IMPORTANT] 🔎 草案正在审阅中
+> 此功能是 [Yggdrasil Connect 草案](https://github.com/yushijinhun/authlib-injector/issues/268) 的一部分，处于公开审阅阶段。
+>
+> 我们深知，这份草案绝非简单的几句话就能定夺，它的实现依赖于社区的共同努力.
+>
+> 我们充分尊重且欢迎社区提出的每一条具有建设性的意见。
+
+> [!IMPORTANT] ♻️ 现有的传统 Yggdrasil API 短时间内不会终止服务
+> Yggdrasil Connect 和现有的传统 Yggdrasil API 会同时提供服务，以确保用户始终能够轻松、稳定地使用 LittleSkin 的服务。
+
+> [!WARNING] 🐞 最终的方案可能有所不同
+> 在 Yggdrasil Connect 草案的最终实现方案中，可能会与当前版本有所不同。
+
+---
 
 authlib-injector 外置登录利用了 Minecraft 自带的 Yggdrasil 鉴权认证系统，已经成为了多人游戏中用户身份认证的主流手段之一。
 
diff --git a/docs/pay-for-minecraft.template.md b/docs/pay-for-minecraft.template.md
@@ -0,0 +1,4 @@
+> [!DANGER] ⚠️ 这并不能代替正版
+> 请始终考虑购买正版的 Minecraft。
+>
+> 使用正版的 Minecraft 可以为你提供更省心的游玩体验。
diff --git a/docs/yggdrasil/authlib-injector.md b/docs/yggdrasil/authlib-injector.md
@@ -25,6 +25,8 @@ fetch('https://authlib-injector.yushi.moe/artifact/latest.json').then(r => r.jso
 > [!WARNING] 这不是插件，也不是 Mod
 > authlib-injector 使用方式较为特殊，将其 JAR 文件放入服务端的 `plugins/` 或 `mods/` 目录下不会有任何作用。
 
+<!-- @include: @/pay-for-minecraft.template.md -->
+
 ## 获取 JAR 文件
 
 <GetAuthlibInjector :latest="latest" :updated="updated" :download="download" />
diff --git a/docs/yggdrasil/client.md b/docs/yggdrasil/client.md
@@ -1,35 +1,37 @@
-# 在客户端配置 Yggdrasil 外置登录
-
-> [!TIP] 在多人游戏中的提示
-> 为客户端配置 Yggdrasil 外置登录确实能起到「在多人游戏中加载皮肤」的作用，但是这是建立在服务端已经正确配置了外置登录的基础上的。
->
-> 仅仅在客户端使用 LittleSkin 的外置登录服务并不能达到任何效果。
->
-> 此外，LittleSkin 的外置登录并不能代替正版验证，也<mark>不能帮助你进入仅支持正版的服务器</mark>。
-
-<NCard title="🤔 什么是外置登录？" link="/yggdrasil/#什么是外置登录" >
-与离线登录的区别 / 基本原理 / 优缺点 / ...
-</NCard>
-
-## HMCL 3
-
-![HMCL 3 操作流程](./assets/hmcl-3-5-5.webp)
-
-> [!TIP] 无需再手动添加认证服务器
-> HMCL 3 已将 LittleSkin 添加为默认选项之一，直接点击相关界面中的 LittleSkin 选项即可。
-
-1. 进入账户列表，在左侧菜单中选择 LittleSkin，填写你的邮箱和密码。
-
-   「用户名」即为你在 LittleSkin 的账号的邮箱，也可以是任意一个你拥有的角色名。
-
-2. 选择你的游戏角色。
-
-    如果你只有一个角色，那么 HMCL 3 会默认选择那个唯一的角色。
-
-    如果你希望添加多个角色，你可以再次添加你的账号来添加其他角色。
-
-:tada: 设置完成啦！你已经可以启动游戏了。
-
-## BakaXL
-
-TODO...
+# 在客户端配置 Yggdrasil 外置登录
+
+<!-- @include: @/pay-for-minecraft.template.md -->
+
+> [!TIP] 在多人游戏中的提示
+> 为客户端配置 Yggdrasil 外置登录确实能起到「在多人游戏中加载皮肤」的作用，但是这是建立在服务端已经正确配置了外置登录的基础上的。
+>
+> 仅仅在客户端使用 LittleSkin 的外置登录服务并不能达到任何效果。
+>
+> 此外，LittleSkin 的外置登录并不能代替正版验证，也<mark>不能帮助你进入仅支持正版的服务器</mark>。
+
+<NCard title="🤔 什么是外置登录？" link="/yggdrasil/#什么是外置登录" >
+与离线登录的区别 / 基本原理 / 优缺点 / ...
+</NCard>
+
+## HMCL 3
+
+![HMCL 3 操作流程](./assets/hmcl-3-5-5.webp)
+
+> [!TIP] 无需再手动添加认证服务器
+> HMCL 3 已将 LittleSkin 添加为默认选项之一，直接点击相关界面中的 LittleSkin 选项即可。
+
+1. 进入账户列表，在左侧菜单中选择 LittleSkin，填写你的邮箱和密码。
+
+   「用户名」即为你在 LittleSkin 的账号的邮箱，也可以是任意一个你拥有的角色名。
+
+2. 选择你的游戏角色。
+
+    如果你只有一个角色，那么 HMCL 3 会默认选择那个唯一的角色。
+
+    如果你希望添加多个角色，你可以再次添加你的账号来添加其他角色。
+
+:tada: 设置完成啦！你已经可以启动游戏了。
+
+## BakaXL
+
+TODO...
diff --git a/docs/yggdrasil/index.md b/docs/yggdrasil/index.md
@@ -7,6 +7,8 @@ LittleSkin 提供 Yggdrasil 验证鉴权服务，也被简单地称为外置登
 > [!WARNING] 外置登录不是联机服务
 > LittleSkin 可以在联机时提供皮肤和鉴权服务，但不提供联机服务本身。
 
+<!-- @include: @/pay-for-minecraft.template.md -->
+
 ## Yggdrasil API 地址
 
 LittleSkin 的 Yggdrasil API 的地址是：
@@ -36,12 +38,13 @@ https://littleskin.cn/api/yggdrasil
 >
 > 如果你看不懂下面在说些什么，直接忽略这部分内容即可，这并不会影响你正常使用 LittleSkin 的基础功能。
 
-
 ## 什么是外置登录？
 
-没有正版 Minecraft 账户的玩家通常都会使用 **离线登录** 来启动游戏，Minecraft 服务端提供了启用离线模式的选项。
+<!-- @include: @/pay-for-minecraft.template.md -->
+
+暂未购入正版 Minecraft 账户的玩家通常都会使用 **离线登录** 来启动游戏，Minecraft 服务端提供了启用离线模式的选项。
 
-- 🏴‍☠️ 玩家只需要用户名即可进入服务端，服务端并不会验证进服玩家身份的合法性;  
+- 🏴‍☠️ 玩家只需要用户名即可进入服务端，服务端并不会验证进服玩家身份的有效性;  
 - 😕 玩家在游戏中的样貌只能是 Steve 或 Alex 之类的默认皮肤，而不能是自定义的材质。
 
 为了让玩家在游戏中能欣赏到各自的皮肤，CustomSkinLoader 和 SkinsRestorer 等 Mod 或插件被广泛使用。
@@ -54,13 +57,13 @@ https://littleskin.cn/api/yggdrasil
 
 上述现象都是离线登录机制导致的。如果使用正版登录，基本不用为之操劳。
 
-而 **外置登录**，如同正版登录一样，可以避开上述问题。
+而 **外置登录**，也可以避开上述问题。
 
 > 其实，在游戏内部，外置登录的工作方式几乎如正版登录一模一样。
 
 如果将正版登录理解为游戏中官方的纯正的「内置登录」的话，那么「外置登录」的意思就很好理解了：
 
-**<mark>将 Minecraft 官方的登录鉴权服务器地址，通过一些手段，替换为第三方的登录鉴权服务器地址。</mark>**
+**<mark>将 Minecraft 官方的登录鉴权服务器地址，替换为第三方的登录鉴权服务器地址。</mark>**
 
 - 🔐 可控的鉴权
 - 👔 自定义皮肤 / 披风
diff --git a/docs/yggdrasil/multilogin.md b/docs/yggdrasil/multilogin.md
@@ -1,73 +1,75 @@
----
-outline: [2, 3]
----
-
-# MultiLogin
-
-> MultiLogin 是一款服务端插件， 功能是让您的服务器支持正版与多种外置登录共存， 用来连接两个或多个外置验证服务器下的玩家，让他们能在一起玩。
-
-外置登录给服务器提供了类似正版的管理和登录方式，但对于一个拥有 Minecraft 正版账号的玩家来说，正版登录是更加简单方便的选择。如果你是一名服务器管理员，可以考虑选用下面的插件实现这种效果。
-
-此插件专为服务端设计。服务器管理员可参考此文档：[GitHub / MultiLogin / wiki](https://github.com/CaaMoe/MultiLogin/wiki)
-
-## 单服务端
-
-我们建议直接参考 MultiLogin 的 [GitHub Wiki](https://github.com/CaaMoe/MultiLogin/wiki#%E7%AE%80%E5%8D%95%E9%85%8D%E7%BD%AE)。
-
-若只需要使用 Mojang 和 LittleSkin，仅限创建以下两个文件。
-
-::: code-group
-
-``` yaml:line-numbers [multilogin/services/offical.yml]
-# Below, only the most basic configuration is provided.
-# You can refer to the template file to complete all configurations.
-
-# Please edit before use.
-id: 0
-
-name: 'Official'
-# Don't change it unless you really want to.
-serviceType: OFFICIAL
-```
-
-``` yaml:line-numbers [multilogin/services/littleskin.yml]
-# Below, only the most basic configuration is provided.
-# You can refer to the template file to complete all configurations.
-
-# Please edit before use.
-id: 1
-
-name: 'LittleSkin'
-# Don't change it unless you really want to.
-serviceType: BLESSING_SKIN
-yggdrasilAuth:
-  blessingSkin:
-    apiRoot: 'https://littleskin.cn/api/yggdrasil'
-```
-
-:::
-
-## Velocity <Badge type="tip" text="Minecraft 1.13 +" />
-
-### 1. 配置 Velocity 转发
-
-Modern forwarding 是 Velocity 支持的一种独创格式。它以高效的二进制格式转发所有玩家信息。但是，它仅适用于 Minecraft 1.13 或更高版本。
-
-> [!TIP] 提示
-> 本文仅会对「为 Velocity modern forwarding 配置 LittleSkin 外置登录」做出说明。
->
-> 本案例使用 Velocity + Paper + MultiLogin 作为示例。
->
-> 具体的 Velocity 配置请结合参考 [Velocity 文档](https://docs.papermc.io/velocity/player-information-forwarding#configuring-modern-forwarding)。
-
-<!--@include: ./velocity.template.md-->
-
-### 2. 配置 MultiLogin
-
-- 对于 Velocity
-  
-  安装 MultiLogin 插件，并按照 [MultiLogin 的官方文档](https://github.com/CaaMoe/MultiLogin/wiki)正确配置插件配置文件。
-
-- 对于子服务器
-
-  仅需在 Velocity 正确配置 MultiLogin 插件即可，无需对子服进行修改。
+---
+outline: [2, 3]
+---
+
+# MultiLogin
+
+> MultiLogin 是一款服务端插件， 功能是让您的服务器支持正版与多种外置登录共存， 用来连接两个或多个外置验证服务器下的玩家，让他们能在一起玩。
+
+外置登录给服务器提供了类似正版的管理和登录方式，但对于一个拥有 Minecraft 正版账号的玩家来说，正版登录是更加简单方便的选择。如果你是一名服务器管理员，可以考虑选用下面的插件实现这种效果。
+
+此插件专为服务端设计。服务器管理员可参考此文档：[GitHub / MultiLogin / wiki](https://github.com/CaaMoe/MultiLogin/wiki)
+
+<!-- @include: @/pay-for-minecraft.template.md -->
+
+## 单服务端
+
+我们建议直接参考 MultiLogin 的 [GitHub Wiki](https://github.com/CaaMoe/MultiLogin/wiki#%E7%AE%80%E5%8D%95%E9%85%8D%E7%BD%AE)。
+
+若只需要使用 Mojang 和 LittleSkin，仅限创建以下两个文件。
+
+::: code-group
+
+``` yaml:line-numbers [multilogin/services/offical.yml]
+# Below, only the most basic configuration is provided.
+# You can refer to the template file to complete all configurations.
+
+# Please edit before use.
+id: 0
+
+name: 'Official'
+# Don't change it unless you really want to.
+serviceType: OFFICIAL
+```
+
+``` yaml:line-numbers [multilogin/services/littleskin.yml]
+# Below, only the most basic configuration is provided.
+# You can refer to the template file to complete all configurations.
+
+# Please edit before use.
+id: 1
+
+name: 'LittleSkin'
+# Don't change it unless you really want to.
+serviceType: BLESSING_SKIN
+yggdrasilAuth:
+  blessingSkin:
+    apiRoot: 'https://littleskin.cn/api/yggdrasil'
+```
+
+:::
+
+## Velocity <Badge type="tip" text="Minecraft 1.13 +" />
+
+### 1. 配置 Velocity 转发
+
+Modern forwarding 是 Velocity 支持的一种独创格式。它以高效的二进制格式转发所有玩家信息。但是，它仅适用于 Minecraft 1.13 或更高版本。
+
+> [!TIP] 提示
+> 本文仅会对「为 Velocity modern forwarding 配置 LittleSkin 外置登录」做出说明。
+>
+> 本案例使用 Velocity + Paper + MultiLogin 作为示例。
+>
+> 具体的 Velocity 配置请结合参考 [Velocity 文档](https://docs.papermc.io/velocity/player-information-forwarding#configuring-modern-forwarding)。
+
+<!--@include: ./velocity.template.md-->
+
+### 2. 配置 MultiLogin
+
+- 对于 Velocity
+  
+  安装 MultiLogin 插件，并按照 [MultiLogin 的官方文档](https://github.com/CaaMoe/MultiLogin/wiki)正确配置插件配置文件。
+
+- 对于子服务器
+
+  仅需在 Velocity 正确配置 MultiLogin 插件即可，无需对子服进行修改。
diff --git a/docs/yggdrasil/server.md b/docs/yggdrasil/server.md
@@ -8,6 +8,8 @@ import { faUsers, faPlus } from '@fortawesome/free-solid-svg-icons'
 
 # 在服务端配置 Yggdrasil 外置登录
 
+<!-- @include: @/pay-for-minecraft.template.md -->
+
 在 Minecraft 服务端侧，存在多种配置外置登录的方式。
 
 ---
