From 7b487adcbd4b16f77d914412f0f33b67e38a493f Mon Sep 17 00:00:00 2001
From: LeiSureLyYrsc <162931251+LeiSureLyYrsc@users.noreply.github.com>
Date: Wed, 6 Nov 2024 01:24:40 +0800
Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E5=BC=80=E5=A7=8B=E5=BC=95?=
=?UTF-8?q?=E5=AF=BC=20=E6=B7=BB=E5=8A=A0=E9=9D=9E=E6=AD=A3=E7=89=88?=
=?UTF-8?q?=E7=8E=A9=E5=AE=B6=E5=BC=95=E5=AF=BC=20=E5=A4=96=E7=BD=AE?=
=?UTF-8?q?=E7=99=BB=E5=BD=95=E6=8F=8F=E8=BF=B0=20=E5=AE=A2=E6=88=B7?=
=?UTF-8?q?=E7=AB=AF=E4=BD=BF=E7=94=A8=E5=A4=96=E7=BD=AE=E7=99=BB=E5=BD=95?=
=?UTF-8?q?=E5=B8=AE=E5=8A=A9=20=E7=9A=84=E9=A1=B5=E9=9D=A2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/docs/authlib-client.md | 48 +++++++++++++++++++++++++++++
docs/docs/offline-users.md | 13 ++++++++
docs/docs/yggdrasil.md | 60 +++++++++++++++++++++++++++++++++++++
3 files changed, 121 insertions(+)
create mode 100644 docs/docs/authlib-client.md
create mode 100644 docs/docs/offline-users.md
create mode 100644 docs/docs/yggdrasil.md
diff --git a/docs/docs/authlib-client.md b/docs/docs/authlib-client.md
new file mode 100644
index 0000000..730bc0d
--- /dev/null
+++ b/docs/docs/authlib-client.md
@@ -0,0 +1,48 @@
+---
+title: 你的客户端应用外置登录
+createTime: 2024/11/05 23:46:01
+permalink: /docs/authlib-client/
+---
+::: tip 小提示
+RainCraft皮肤站并不局限于RainCraft服务器，它同样也可以应用到其他使用了**Raincraft鉴权**的服务器，具体情况请点击下列**使用我们的皮肤站 - 服务器**卡片
+
+注意：RainCraft账号无法让你进入正版服务器，因为此账号**不是正版账号**
+:::
+
+
+
+
+
+---
+
+~~后面再补图文教程(bushi)~~
+
+# 通用启动器解决方案 (例如HMCL PCL)
+
+[*此处为官方教程*](https://blessing.netlify.app/yggdrasil-api/authlib-injector.html#%E9%85%8D%E7%BD%AE%E5%90%AF%E5%8A%A8%E5%99%A8)
+
+1.打开你的启动器，同时也登录 [**皮肤站**](https://skin.ineko.cc/) 账号
+
+2.将 **快速配置启动器** 栏目下的 **将此按钮拖动至启动器** 长按 鼠标左键 拖入到启动器松开，随后在弹出的窗口点击 [完成/确定]
+
+
+## PCL 的后续操作
+
+1.在新的页面填写你的邮箱账号和密码，然后点击 [启动游戏]
+
+2.完成登录 Enjoy it~~~
+
+## HMCL 的后续操作
+
+1.点击左上角的 [角色] 进入角色管理界面，在左侧栏点击 **RainCraft**，输入你的邮箱账号和密码，然后点击 [登录]
+
+2.完成登录 Let's go!!!
+
+---
+:::tip 提醒
+
+邮箱账号可填写成你的游戏ID，这不会影响游戏最终登录的账号(除非你登错号鸟)
+
+:::
+
+
diff --git a/docs/docs/offline-users.md b/docs/docs/offline-users.md
new file mode 100644
index 0000000..af1313b
--- /dev/null
+++ b/docs/docs/offline-users.md
@@ -0,0 +1,13 @@
+---
+title: 使用外置登录服务
+createTime: 2024/11/05 22:59:49
+permalink: /docs/offline-users/
+---
+
+
+
+
+
+为了玩家账户安全，照顾非正版玩家体验，RainCraft采用了 [**自建皮肤站**](https://skin.ineko.cc/) 供非正版玩家们提供了可以进入服务器的另一种登录方式
+
+如果你没有正版账号(或是离线玩家)，请你点击[**为你的客户端应用外置登录**](/docs/authlib-client/)进行操作。
\ No newline at end of file
diff --git a/docs/docs/yggdrasil.md b/docs/docs/yggdrasil.md
new file mode 100644
index 0000000..96bd394
--- /dev/null
+++ b/docs/docs/yggdrasil.md
@@ -0,0 +1,60 @@
+---
+title: Yggdrasil 外置登录
+createTime: 2024/11/05 23:25:53
+permalink: /docs/yggdrasil/
+---
+# Yggdrasil 外置登录
+
+RainCraft 提供 Yggdrasil 验证鉴权服务。
+
+外置登录需要配合其他技术一起实现。外置登录可以为玩家提供统一的非 Mojang 游戏外登录体验，并在不安装皮肤 Mod 的情况下加载来自 RainCraft 的材质。
+
+---
+
+## Yggdrasil API 地址
+
+RainCraft 的 Yggdrasil API 的地址是：
+
+``` http
+https://skin.ineko.cc/api/yggdrasil
+```
+---
+
+::: warning 有点高级
+以下部分是面向开发者和多人游戏服务器管理员的，普通用户可能无法理解。
+
+如果你看不懂下面在说些什么，直接忽略这部分内容即可，这并不会影响你正常使用 RainCraft 的基础功能。
+:::
+
+## 什么是外置登录？
+
+没有正版 Minecraft 账户的玩家通常都会使用 **离线登录** 来启动游戏，Minecraft 服务端提供了启用离线模式的选项。
+
+- 🏴☠️ 玩家只需要用户名即可进入服务端，服务端并不会验证进服玩家身份的合法性;
+- 😕 玩家在游戏中的样貌只能是 Steve 或 Alex 之类的默认皮肤，而不能是自定义的材质。
+
+为了让玩家在游戏中能欣赏到各自的皮肤，CustomSkinLoader 和 SkinsRestorer 等 Mod 或插件被广泛使用。
+
+但离线登录的鉴权机制给予了恶意玩家们极大的发挥空间。他们会冒充其他玩家进入服务器行偷鸡摸狗之事，零成本的批量账号更是轰炸小型服务器的绝妙武器。
+
+因此而头疼的服务器管理员们会为服务器安装诸如 AuthMe 之类的登录插件，以尽可能杜绝上述事项。然而，对服务器管理员来说，登录插件的配置过程称不上简单；对于玩家来说，改名、忘记密码等操作更是繁琐。
+
+---
+
+上述现象都是离线登录机制导致的。如果使用正版登录，基本不用为之操劳。
+
+而 **外置登录**，如同正版登录一样，可以避开上述问题。
+
+> 其实，在游戏内部，外置登录的工作方式几乎如正版登录一模一样。
+
+如果将正版登录理解为游戏中官方的纯正的「内置登录」的话，那么「外置登录」的意思就很好理解了：
+
+**将 Minecraft 官方的登录鉴权服务器地址，通过一些手段，替换为第三方的登录鉴权服务器地址。**
+
+- 🔐 可控的鉴权
+- 👔 自定义皮肤 / 披风
+- 👍️ 极强的兼容性
+
+只有玩家和服务器两端都正确配置后，外置登录才能正常工作。因此外置登录并不能用来登录至采用正版登录的服务器。
+
+如果仅仅是单人游戏，无需借助 Mod 即可在游戏内欣赏到自定义的皮肤也是一个不小的亮点。
\ No newline at end of file