⚡️ pref: newbee/...

docs/newbee/csl.md

@@ -24,9 +24,9 @@ LittleSkin 自 CustomSkinLoader 14.7 起被添加到了 CustomSkinLoader 的默
 
 <!--@include: ./mod-tips.template.md-->
 
-## 版本：14.7+ <Badge type="tip" text="✨ 当前版本" />
+## 版本：14.7+ <Badge type="tip" text="✨ 当前版本" /> {#14.7+}
 
-如果不存在与你同名的正版角色导致冲突的问题，一般无需修改 CustomSkinLoader 的配置文件。
+如果不存在与你同名的正版角色导致冲突的问题，<mark>一般无需修改 CustomSkinLoader 的配置文件</mark>。
 
 以下是同名冲突在游戏内的典型表现：
 
@@ -77,36 +77,33 @@ https://skin.prinzeugen.net/cape/*.png
 ## 手动修改配置文件 {#edit-csl-config}
 
 > [!NOTE] 什么情况下需要手动修改 CustomSkinLoader 配置文件？
-> 👉 **一般来说，你只需要简单地安装 CustomSkinLoader Mod 即可，无需进行任何额外的配置。**
+> 一般来说，你只需要简单地安装 CustomSkinLoader Mod 即可，无需进行任何额外的配置。
 >
-> 然而有时事与愿违，游戏中你的皮肤可能并不是你所期望的那个。
->
-> 当你在这个手册上或者是其他地方得知，「你需要手动修改配置文件」时，那就是时候照着下面的步骤来做了。
-
----
-
-你可以使用记事本或者任意编辑器将其打开，将配置文件原有的所有内容替换成以下内容。
-
-修改完成后别忘了先保存再退出。
-
-再次启动 Minecraft 之后，你应该就能在游戏里看到你在 LittleSkin 中设置的材质了。
+> 然而有时事与愿违，如果你在使用过程中遇到了如 [同名冲突](#14.7+) 这样的情况，那就是时候照着下面的步骤来做了。
 
 ---
 
 配置文件: `CustomSkinLoader.json` [<BSButton style="background-color: var(--vp-c-success-3)"><FA :icon="faFileArrowDown" /> 下载此文件 </BSButton>](/CustomSkinLoader.json)
 
 > [!IMPORTANT] ✅ 建议直接下载 CustomSkinLoader 配置文件
-> 你可以下载到为 LittleSkin 量身定制的配置文件，此文件的内容与下面的内容一致。
+> 你可以下载到为 LittleSkin 量身定制的配置文件，此文件的内容与下方代码块的内容一致。
 >
-> 你只需将下载到的文件覆盖掉原有的文件即可，而无需对原文件进行编辑。
+> 👉 你只需将下载到的文件<mark>覆盖（替换）掉原有的文件</mark>即可，而无需对原文件进行编辑。
 
-> [!TIP] 配置文件的位置
+> [!TIP] 📍 配置文件的位置
 > 配置文件默认存放于 `.minecraft/CustomSkinLoader/` 目录中，仅有一个配置文件，文件名为 `CustomSkinLoader.json`。
+>
+> 在大多数情况下，安装皮肤 Mod 后需要启动一次游戏并进入存档，配置文件才会被自动生成。
 
-> [!NOTE] 需要重启游戏
+> [!TIP] 🔁 需要重启游戏
 > 完成配置文件的修改后，你需要重启游戏才能使其生效。
 
-::: details 🤔 找不到配置文件的具体位置？
+> [!NOTE] 🥰 有关版本隔离
+> 如果你在启动器中启用了版本隔离，配置文件的路径还可能与上述有少许不同。
+>
+> 善用启动器的 <BSSection>打开模组文件夹</BSSection> 等类似功能，结合下方图示，再给予自己一些信心，你能够找到它的。
+
+::: details 🤔 找不到配置文件的具体位置？来看看图示
 ![CustomSkinLoader 文件夹所处位置](./assets/mods/csl-folder.webp)
 
 ![CustomSkinLoader 的配置文件和日志文件](./assets/mods/csl-files.webp)
@@ -164,7 +161,7 @@ CustomSkinLoader 有一个加载列表，里面存放和定义着如何加载你
 
 名称意为 _CustomSkinLoader 兼容层_。
 
-借助此 Mod，你可以在 Minecraft 1.7.10 中使用新版本的 CustomSkinLoader（仅限 _ForgeActive_ 通道）。
+借助此 Mod，你可以<mark>在 Minecraft 1.7.10 中使用新版本的 CustomSkinLoader</mark>（仅限 _ForgeActive_ 通道）。
 
 你可以在以下网站获取到关于 CompatibilityLayerForCustomSkinLoader 的更多信息。
 

docs/newbee/mod-tips.template.md

@@ -13,4 +13,4 @@
 > 1. CompatibilityLayerForCustomSkinLoader 需要与 CustomSkinLoader 一起安装
 
 > [!TIP] 其他加载材质的方式
-> 你也可以选择 [Yggdrasil 外置登录](/yggdrasil/index.md) 加载材质。但是，除 SkinPort 外，请不要同时使用 Yggdrasil 外置登录和皮肤 Mod，否则可能无法正常加载材质。
+> 你也可以选择 [Yggdrasil 外置登录](/yggdrasil/index.md) 加载材质。但是，除 SkinPort 外，请不要同时使用 Yggdrasil 外置登录和皮肤 Mod，否则可能无法正常加载材质。

docs/newbee/mod.md

@@ -8,8 +8,15 @@ outline: [2, 3]
 
 [[toc]]
 
+---
+
 <!--@include: ./mod-tips.template.md-->
 
+<NCard title="🗝️ 在寻找 CustomSkinLoader 嘛？" link="./csl" >
+<p><mark>CustomSkinLoader 是我们最推荐的皮肤 Mod</mark>，也被称为 <strong>CSL</strong> 或 <strong>万用皮肤补丁</strong>。</p>
+它现如今被单独放在一篇文章中说明，前去查看具体信息 👉
+</NCard>
+
 ## SkinPort
 
 如果你想要在 Minecraft 1.7.10 中加载 Alex 模型的皮肤，你需要使用 SkinPort。
@@ -48,7 +55,7 @@ client {
 
 保存退出，再次打开 Minecraft 之后，你应该就能看到你在 LittleSkin 中设置的材质了。
 
-## 传统加载 <Badge type="danger" text="👎 不再推荐" />
+## 传统加载 API
 
 ``` http
 # 皮肤查询 API
@@ -61,4 +68,28 @@ https://littleskin.cn/cape/{playername}.png
 
 请将以上两个查询 API 填入你的皮肤 Mod 的配置文件的对应位置。其中 `{playername}` 为角色名，请将其替换为对应的占位符。
 
-你也可以分享出你的皮肤 Mod 的配置方法，非常欢迎你帮助我们完善这个页面。
+你也可以分享出你的皮肤 Mod 或相关服务器插件的配置方法，非常欢迎你帮助我们完善这个页面。
+
+### Citizens 2 <Badge type="info" text="服务器插件" />
+
+> Citizens 是用于在 Minecraft 服务器中创建栩栩如生的 NPC 的一个插件。
+
+Citizens 2 为提供了一个 [`/npc skin`](https://wiki.citizensnpcs.co/Skins) 指令来为你的 NPC 设置皮肤。
+
+示例：将某 NPC 的皮肤设置为 LittleSkin 角色 `aabbccdd` 的皮肤：
+
+```plain
+/npc skin --url https://littleskin.cn/skin/aabbccdd.png
+```
+
+### SkinsRestorer <Badge type="info" text="服务器插件" />
+
+> SkinsRestorer 是一个插件，可以恢复离线模式服务器和网络的皮肤，让玩家能够通过指令来更改他们的皮肤。
+
+SkinsRestorer 提供了一个 [`/skin url`](https://skinsrestorer.net/docs/configuration/commands-permissions#player-commands:~:text=command.set.other-,/skin%20url%20%3Curl%3E,-Changes%20your%20skin) 指令来为游戏中的玩家设置皮肤。
+
+示例：将自己的皮肤设置为 LittleSkin 角色 `aabbccdd` 的皮肤：
+
+```plain
+/skin url https://littleskin.cn/skin/aabbccdd.png
+```

docs/newbee/textures.md

@@ -1,5 +1,5 @@
 ---
-outline: [1, 3]
+outline: [2, 3]
 ---
 
 <script setup>
@@ -24,23 +24,28 @@ LittleSkin 支持上传以下材质
 
 所有材质文件都应该是 PNG 格式的图片。
 
-::: tip 关于 PNG 格式
-作为一种带有透明度通道的格式，PNG 指的不仅仅是文件名后缀为 `.png`，更为重要的是 PNG 格式的规范。
-
-若将其他格式的图片通过简单地重命名，将会导致无法正常使用。
-:::
-
-::: tip 关于积分
-上传材质需要花费积分，而花费的积分数量按照材质文件的体积来计算。公开材质被他人收藏后，你可以获得奖励积分。
-
-对于公开材质，每 KB 存储空间需要花费 1 积分；而对于私密材质，每 KB 存储空间需要花费 20 积分。删除材质时会返还积分。
-
-公开材质被收藏一次可以获得 10 积分。如果有一个衣柜收藏被删除，则会扣除 10 积分。
-:::
-
-::: warning 注意
-材质上传页面显示的预估积分消耗仅供参考，实际积分消耗将按材质文件的实际大小计算。
-:::
+> [!IMPORTANT] 关于 PNG 格式
+> 作为一种带有透明度通道的格式，PNG 指的不仅仅是文件名后缀为 `.png`，更为重要的是 PNG 格式的规范。
+>
+> <mark>若只是把其他格式的图片简单地重命名，将会出现异常现象。</mark>
+
+> [!NOTE] 关于积分
+>
+> 下述内容可在 [积分系统](../score) 章节中找到。
+>
+> 上传材质需要花费积分，而花费的积分数量按照材质文件的体积来计算。
+>
+> - 对于公开材质，每 KB 存储空间需要花费 1 积分
+> - 对于私密材质，每 KB 存储空间需要花费 20 积分
+> - 删除材质时会返还积分
+>
+> 公开材质被他人收藏后，你可以获得奖励积分。
+>
+> - 公开材质被收藏一次可以获得 10 积分
+> - 如果有一个衣柜收藏被删除，会扣除 10 积分
+
+> [!NOTE] 注意
+> 材质上传页面显示的预估积分消耗仅供参考，实际积分消耗将按材质文件的实际大小计算。
 
 ![open-page](./assets/textures/1-open-page.webp)
 
@@ -50,15 +55,14 @@ LittleSkin 支持上传以下材质
     你可以在右侧查看你的材质的预览。
     材质信息设置完成后，点击<BSButton style="background-color: #28a745;">确认上传</BSButton>按钮。
 
-    ::: danger 谨记
-    LittleSkin 不允许上传包括但不限于如下内容的敏感材质（包括含有争议性的材质）：
-
-    - **高清的** 色情敏感的材质
-    - 政治敏感的材质
-    - 违反中国大陆地区、香港特别行政区和美国相关法律的材质
-
-    对于敏感材质，你需要在上传时将其设为私密材质，否则一经发现，相关材质将被删除，且你将被 LittleSkin 永久封禁。
-    :::
+    > [!CAUTION] 谨记
+    > LittleSkin 不允许上传包括但不限于如下内容的敏感材质（包括含有争议性的材质）：
+    >
+    > - **高清的** 色情敏感的材质
+    > - 政治敏感的材质
+    > - 违反中国大陆地区、香港特别行政区和美国相关法律的材质
+    >
+    > 对于敏感材质，你需要在上传时将其设为私密材质，否则一经发现，相关材质将被删除，且你将被 LittleSkin **永久封禁**。
 
 :sparkles: 你的材质就上传完成啦~
 
@@ -70,7 +74,7 @@ LittleSkin 支持上传以下材质
 
 如果你想要使用的材质已经在皮肤库中，你可以直接将其收藏到衣柜中使用。
 
-::: tip 提示
+> [!IMPORTANT] 提示
 每收藏一件材质至衣柜需要花费 10 积分。在衣柜中删除材质时会返还积分。
 ::::
 
@@ -102,7 +106,7 @@ LittleSkin 支持上传以下材质
 
 如果你以后还想要更换材质，或者想为其他角色设置材质，也可以按照这份文档中所述的方法来操作。
 
-### Tip：更换头像
+## 更换头像
 
 你可以将衣柜中的皮肤的面部设置为你在 LittleSkin 的头像。