-
-
Notifications
You must be signed in to change notification settings - Fork 12
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
🐛 fix(newbee/csl): set GetCSL component to client-only
- Loading branch information
Showing
1 changed file
with
192 additions
and
190 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,190 +1,192 @@ | ||
| <script setup> | ||
| import GetCSL from '../../components/GetCSL.vue' | ||
| import { faFileArrowDown } from '@fortawesome/free-solid-svg-icons' | ||
| </script> | ||
|
|
||
| # CustomSkinLoader | ||
|
|
||
| CustomSkinLoader 是我们最推荐的皮肤 Mod，也被称为 **CSL** 或 **万用皮肤补丁**。 | ||
|
|
||
| LittleSkin 自 CustomSkinLoader 14.7 起被添加到了 CustomSkinLoader 的默认加载列表中，加载顺序仅次于正版皮肤。 | ||
|
|
||
| 本文提供了修改 CustomSkinLoader 配置文件的方法，以令其优先从 LittleSkin 加载材质。 | ||
|
|
||
| ## 下载此 Mod {#download} | ||
|
|
||
| 你可以在以下网站获取到关于 CustomSkinLoader 的更多信息 | ||
|
|
||
| - [MC百科 (mcmod.cn)](https://www.mcmod.cn/class/883.html) | ||
| - [CurseForge](https://www.curseforge.com/minecraft/mc-mods/customskinloader) | ||
|
|
||
| <GetCSL /> | ||
|
|
||
| --- | ||
|
|
||
| <!--@include: ./mod-tips.template.md--> | ||
|
|
||
| ## 版本：14.7+ <Badge type="tip" text="✨ 当前版本" /> {#14.7+} | ||
|
|
||
| 如果不存在与你同名的正版角色导致冲突的问题，<mark>一般无需修改 CustomSkinLoader 的配置文件</mark>。 | ||
|
|
||
| 以下是同名冲突在游戏内的典型表现： | ||
|
|
||
| - 显示的是你从**未使用过的陌生皮肤** | ||
| - 只加载了皮肤而没有加载披风 <Badge type="info" text="仅旧版" /> | ||
|
|
||
| 如果出现了上述情况，请参考本文中的 [手动修改配置文件](#edit-csl-config) 部分进行操作，以使其优先从 LittleSkin 加载材质。 | ||
|
|
||
| ## 版本：早期 <Badge type="danger" text="👎 不再推荐" /> | ||
|
|
||
| > [!WARNING] 注意 | ||
| > 我们不再推荐使用以下远古版本的 CustomSkinLoader，即低于 14.7 的版本。 | ||
| > | ||
| > - 对于 Minecraft 1.7.10，你可以同时安装 [CustomSkinLoader](#customskinloader) 和 [CompatibilityLayerForCustomSkinLoader](#clfcsl) 。 | ||
| > | ||
| > - 对于更低版本，目前并没有很好的解决方案。 | ||
| ::: details 使用 ExtraList：13.1 ~ 14.6a | ||
|
|
||
| CustomSkinLoader 14.4 起支持通过 ExtraList 的方式添加皮肤站，这也是我们推荐的方法之一。你可以在用户中心的「皮肤 Mod」页面下载到 LittleSkin 的 ExtraList 文件，将其放入 `.minecraft/CustomSkinLoader/ExtraList/` 目录下即可。 | ||
|
|
||
| 在安装完成后的第一次启动游戏并成功载入 CustomSkinLoader 时 ExtraList 文件会被自动删除，这是正常现象。如果不出意外的话，此时 LittleSkin 已被添加至 CustomSkinLoader 加载列表列表顶部。 | ||
|
|
||
| ::: | ||
|
|
||
| ::: details 修改配置文件：12.9- | ||
|
|
||
| 配置文件存放于 `.minecraft/CustomSkinLoader/` 目录中，共有两个配置文件，文件名分别为 `skinurls.txt` 和 `capeurls.txt`。 | ||
|
|
||
| 首先请使用记事本或者任意代码编辑器打开 `skinurls.txt`，将原有的所有内容替换为以下内容： | ||
|
|
||
| ```http | ||
| https://littleskin.cn/skin/*.png | ||
| https://skin.prinzeugen.net/skin/*.png | ||
| ``` | ||
|
|
||
| 保存退出后再使用记事本或任意代码编辑器打开 `capeurls.txt`，将原有的所有内容替换为以下内容： | ||
|
|
||
| ```http | ||
| https://littleskin.cn/cape/*.png | ||
| https://skin.prinzeugen.net/cape/*.png | ||
| ``` | ||
|
|
||
| 保存退出，再次打开 Minecraft 之后，你应该就能看到你在 LittleSkin 中设置的材质了。 | ||
|
|
||
| ::: | ||
|
|
||
| ## 手动修改配置文件 {#edit-csl-config} | ||
|
|
||
| <!-- markdownlint-disable MD051 --> | ||
|
|
||
| > [!NOTE] 什么情况下需要手动修改 CustomSkinLoader 配置文件？ | ||
| > 一般来说，你只需要简单地安装 CustomSkinLoader Mod 即可，无需进行任何额外的配置。 | ||
| > | ||
| > 然而有时事与愿违，如果你在使用过程中遇到了如 [同名冲突](#14.7+) 这样的情况，那就是时候照着下面的步骤来做了。 | ||
| <!-- markdownlint-restore --> | ||
|
|
||
| --- | ||
|
|
||
| 配置文件: `CustomSkinLoader.json` [<BSButton style="background-color: var(--vp-c-success-3)"><FA :icon="faFileArrowDown" /> 下载此文件 </BSButton>](/CustomSkinLoader.json) | ||
|
|
||
| > [!IMPORTANT] ✅ 建议直接下载 CustomSkinLoader 配置文件 | ||
| > 你可以下载到为 LittleSkin 量身定制的配置文件，此文件的内容与下方代码块的内容一致。 | ||
| > | ||
| > 👉 你只需将下载到的文件<mark>覆盖（替换）掉原有的文件</mark>即可，而无需对原文件进行编辑。 | ||
| > [!TIP] 📍 配置文件的位置 | ||
| > 配置文件默认存放于 `.minecraft/CustomSkinLoader/` 目录中，仅有一个配置文件，文件名为 `CustomSkinLoader.json`。 | ||
| > | ||
| > 在大多数情况下，安装皮肤 Mod 后需要启动一次游戏并进入存档，配置文件才会被自动生成。 | ||
| > [!TIP] 🔁 需要重启游戏 | ||
| > 完成配置文件的修改后，你需要重启游戏才能使其生效。 | ||
| > [!NOTE] 🥰 有关版本隔离 | ||
| > 如果你在启动器中启用了版本隔离，配置文件的路径还可能与上述有少许不同。 | ||
| > | ||
| > 善用启动器的 <BSSection>打开模组文件夹</BSSection> 等类似功能，结合下方图示，再给予自己一些信心，你能够找到它的。 | ||
| ::: details 🤔 找不到配置文件的具体位置？来看看图示 | ||
|  | ||
|
|
||
|  | ||
| ::: | ||
|
|
||
| <<< @/public/CustomSkinLoader.json{4-9 json:line-numbers} | ||
|
|
||
| ## 功能特性 | ||
|
|
||
| ### 仅在客户端有效 | ||
| 是一个客户端 Mod，在服务端上安装它不会起到任何作用 | ||
|
|
||
| ### 多个皮肤来源 / 加载列表 | ||
| 会尝试从众多来源（皮肤站）逐个加载皮肤，直到皮肤和披风都加载完毕 | ||
|
|
||
| ### 高清材质支持 | ||
| 提供了对大于 64*64 的皮肤和披风的高清材质的支持，在没有 Optifine 和 Sodium 等改善渲染的 Mod 的情况下也能正确显示高清材质 | ||
|
|
||
| ### 低版本双层皮肤支持 | ||
| 在 1.7.10 以下的版本中正确显示原先不支持显示的双层皮肤 | ||
|
|
||
| ### 透明皮肤支持 | ||
| 在部分低版本中可正确显示透明皮肤 | ||
|
|
||
| ## 工作原理 {#how-it-works} | ||
|
|
||
| CustomSkinLoader 会使用游戏内的玩家名查询不同的服务器，以此加载皮肤。 | ||
|
|
||
| CustomSkinLoader 有一个加载列表，里面存放和定义着如何加载你的材质： | ||
|
|
||
| - **从哪个服务器加载？** | ||
| - **加载的先后顺序？** | ||
| - 其他高级加载策略 | ||
|
|
||
| 目前的情况下，若不对 CustomSkinLoader 的配置文件进行修改，默认的加载顺序如下： | ||
|
|
||
| 1. Mojang 官方 | ||
| 2. **LittleSkin** ✨ | ||
| 3. Blessing Skin | ||
| 4. ... | ||
|
|
||
| 有一些流程示意图可帮助你理解加载列表这个机制： | ||
|
|
||
| ::: details 1. 默认配置 & Mojang 上不存在同名角色 | ||
|  | ||
| ::: | ||
|
|
||
| ::: details 2. 默认配置 & Mojang 上有同名角色 | ||
| 此时若要优先从 LittleSkin 中加载皮肤，可参照本文中的 [手动修改配置文件](#edit-csl-config) 部分进行操作，以达到 **3.** 的效果。 | ||
|
|
||
|  | ||
| ::: | ||
|
|
||
| ::: details 3. 手动修改配置文件，将 LittleSkin 设置为最高优先级 | ||
| 若参照本文中的 [手动修改配置文件](#edit-csl-config) 部分进行操作，即可达到以下效果。 | ||
|
|
||
|  | ||
| ::: | ||
|
|
||
| ::: details 4. 默认配置 & Mojang 上有同名角色 & 尝试加载全部材质 | ||
| 若 Mojang 中的同名角色设置了皮肤但未设置披风，CustomSkinLoader 会尝试从后续的服务器加载披风。 | ||
|
|
||
|  | ||
| ::: | ||
|
|
||
| ## CompatibilityLayerForCustomSkinLoader {#clfcsl} | ||
|
|
||
| > [!NOTE] 介绍 | ||
| > CustomSkinLoader 从 14.7 以来就已经放弃对 Minecraft 1.7.10 的支持，但是相较后续的 Minecraft 版本而言，从网络获取皮肤的过程并没有发生太大的变化。 | ||
| > | ||
| > 此 Mod 可以使 CustomSkinLoader 在 1.7.10 中正常运行。 | ||
| 名称意为 _CustomSkinLoader 兼容层_。 | ||
|
|
||
| 借助此 Mod，你可以<mark>在 Minecraft 1.7.10 中使用新版本的 CustomSkinLoader</mark>（仅限 _ForgeActive_ 通道）。 | ||
|
|
||
| 你可以在以下网站获取到关于 CompatibilityLayerForCustomSkinLoader 的更多信息。 | ||
|
|
||
| - [MC百科 (mcmod.cn)](https://www.mcmod.cn/class/4160.html) | ||
| - [CurseForge](https://www.curseforge.com/minecraft/mc-mods/compatibilitylayerforcustomskinloader) | ||
| <script setup> | ||
| import GetCSL from '../../components/GetCSL.vue' | ||
| import { faFileArrowDown } from '@fortawesome/free-solid-svg-icons' | ||
| </script> | ||
|
|
||
| # CustomSkinLoader | ||
|
|
||
| CustomSkinLoader 是我们最推荐的皮肤 Mod，也被称为 **CSL** 或 **万用皮肤补丁**。 | ||
|
|
||
| LittleSkin 自 CustomSkinLoader 14.7 起被添加到了 CustomSkinLoader 的默认加载列表中，加载顺序仅次于正版皮肤。 | ||
|
|
||
| 本文提供了修改 CustomSkinLoader 配置文件的方法，以令其优先从 LittleSkin 加载材质。 | ||
|
|
||
| ## 下载此 Mod {#download} | ||
|
|
||
| 你可以在以下网站获取到关于 CustomSkinLoader 的更多信息 | ||
|
|
||
| - [MC百科 (mcmod.cn)](https://www.mcmod.cn/class/883.html) | ||
| - [CurseForge](https://www.curseforge.com/minecraft/mc-mods/customskinloader) | ||
|
|
||
| <ClientOnly> | ||
| <GetCSL /> | ||
| </ClientOnly> | ||
|
|
||
| --- | ||
|
|
||
| <!--@include: ./mod-tips.template.md--> | ||
|
|
||
| ## 版本：14.7+ <Badge type="tip" text="✨ 当前版本" /> {#14.7+} | ||
|
|
||
| 如果不存在与你同名的正版角色导致冲突的问题，<mark>一般无需修改 CustomSkinLoader 的配置文件</mark>。 | ||
|
|
||
| 以下是同名冲突在游戏内的典型表现： | ||
|
|
||
| - 显示的是你从**未使用过的陌生皮肤** | ||
| - 只加载了皮肤而没有加载披风 <Badge type="info" text="仅旧版" /> | ||
|
|
||
| 如果出现了上述情况，请参考本文中的 [手动修改配置文件](#edit-csl-config) 部分进行操作，以使其优先从 LittleSkin 加载材质。 | ||
|
|
||
| ## 版本：早期 <Badge type="danger" text="👎 不再推荐" /> | ||
|
|
||
| > [!WARNING] 注意 | ||
| > 我们不再推荐使用以下远古版本的 CustomSkinLoader，即低于 14.7 的版本。 | ||
| > | ||
| > - 对于 Minecraft 1.7.10，你可以同时安装 [CustomSkinLoader](#customskinloader) 和 [CompatibilityLayerForCustomSkinLoader](#clfcsl) 。 | ||
| > | ||
| > - 对于更低版本，目前并没有很好的解决方案。 | ||
| ::: details 使用 ExtraList：13.1 ~ 14.6a | ||
|
|
||
| CustomSkinLoader 14.4 起支持通过 ExtraList 的方式添加皮肤站，这也是我们推荐的方法之一。你可以在用户中心的「皮肤 Mod」页面下载到 LittleSkin 的 ExtraList 文件，将其放入 `.minecraft/CustomSkinLoader/ExtraList/` 目录下即可。 | ||
|
|
||
| 在安装完成后的第一次启动游戏并成功载入 CustomSkinLoader 时 ExtraList 文件会被自动删除，这是正常现象。如果不出意外的话，此时 LittleSkin 已被添加至 CustomSkinLoader 加载列表列表顶部。 | ||
|
|
||
| ::: | ||
|
|
||
| ::: details 修改配置文件：12.9- | ||
|
|
||
| 配置文件存放于 `.minecraft/CustomSkinLoader/` 目录中，共有两个配置文件，文件名分别为 `skinurls.txt` 和 `capeurls.txt`。 | ||
|
|
||
| 首先请使用记事本或者任意代码编辑器打开 `skinurls.txt`，将原有的所有内容替换为以下内容： | ||
|
|
||
| ```http | ||
| https://littleskin.cn/skin/*.png | ||
| https://skin.prinzeugen.net/skin/*.png | ||
| ``` | ||
|
|
||
| 保存退出后再使用记事本或任意代码编辑器打开 `capeurls.txt`，将原有的所有内容替换为以下内容： | ||
|
|
||
| ```http | ||
| https://littleskin.cn/cape/*.png | ||
| https://skin.prinzeugen.net/cape/*.png | ||
| ``` | ||
|
|
||
| 保存退出，再次打开 Minecraft 之后，你应该就能看到你在 LittleSkin 中设置的材质了。 | ||
|
|
||
| ::: | ||
|
|
||
| ## 手动修改配置文件 {#edit-csl-config} | ||
|
|
||
| <!-- markdownlint-disable MD051 --> | ||
|
|
||
| > [!NOTE] 什么情况下需要手动修改 CustomSkinLoader 配置文件？ | ||
| > 一般来说，你只需要简单地安装 CustomSkinLoader Mod 即可，无需进行任何额外的配置。 | ||
| > | ||
| > 然而有时事与愿违，如果你在使用过程中遇到了如 [同名冲突](#14.7+) 这样的情况，那就是时候照着下面的步骤来做了。 | ||
| <!-- markdownlint-restore --> | ||
|
|
||
| --- | ||
|
|
||
| 配置文件: `CustomSkinLoader.json` [<BSButton style="background-color: var(--vp-c-success-3)"><FA :icon="faFileArrowDown" /> 下载此文件 </BSButton>](/CustomSkinLoader.json) | ||
|
|
||
| > [!IMPORTANT] ✅ 建议直接下载 CustomSkinLoader 配置文件 | ||
| > 你可以下载到为 LittleSkin 量身定制的配置文件，此文件的内容与下方代码块的内容一致。 | ||
| > | ||
| > 👉 你只需将下载到的文件<mark>覆盖（替换）掉原有的文件</mark>即可，而无需对原文件进行编辑。 | ||
| > [!TIP] 📍 配置文件的位置 | ||
| > 配置文件默认存放于 `.minecraft/CustomSkinLoader/` 目录中，仅有一个配置文件，文件名为 `CustomSkinLoader.json`。 | ||
| > | ||
| > 在大多数情况下，安装皮肤 Mod 后需要启动一次游戏并进入存档，配置文件才会被自动生成。 | ||
| > [!TIP] 🔁 需要重启游戏 | ||
| > 完成配置文件的修改后，你需要重启游戏才能使其生效。 | ||
| > [!NOTE] 🥰 有关版本隔离 | ||
| > 如果你在启动器中启用了版本隔离，配置文件的路径还可能与上述有少许不同。 | ||
| > | ||
| > 善用启动器的 <BSSection>打开模组文件夹</BSSection> 等类似功能，结合下方图示，再给予自己一些信心，你能够找到它的。 | ||
| ::: details 🤔 找不到配置文件的具体位置？来看看图示 | ||
|  | ||
|
|
||
|  | ||
| ::: | ||
|
|
||
| <<< @/public/CustomSkinLoader.json{4-9 json:line-numbers} | ||
|
|
||
| ## 功能特性 | ||
|
|
||
| ### 仅在客户端有效 | ||
| 是一个客户端 Mod，在服务端上安装它不会起到任何作用 | ||
|
|
||
| ### 多个皮肤来源 / 加载列表 | ||
| 会尝试从众多来源（皮肤站）逐个加载皮肤，直到皮肤和披风都加载完毕 | ||
|
|
||
| ### 高清材质支持 | ||
| 提供了对大于 64*64 的皮肤和披风的高清材质的支持，在没有 Optifine 和 Sodium 等改善渲染的 Mod 的情况下也能正确显示高清材质 | ||
|
|
||
| ### 低版本双层皮肤支持 | ||
| 在 1.7.10 以下的版本中正确显示原先不支持显示的双层皮肤 | ||
|
|
||
| ### 透明皮肤支持 | ||
| 在部分低版本中可正确显示透明皮肤 | ||
|
|
||
| ## 工作原理 {#how-it-works} | ||
|
|
||
| CustomSkinLoader 会使用游戏内的玩家名查询不同的服务器，以此加载皮肤。 | ||
|
|
||
| CustomSkinLoader 有一个加载列表，里面存放和定义着如何加载你的材质： | ||
|
|
||
| - **从哪个服务器加载？** | ||
| - **加载的先后顺序？** | ||
| - 其他高级加载策略 | ||
|
|
||
| 目前的情况下，若不对 CustomSkinLoader 的配置文件进行修改，默认的加载顺序如下： | ||
|
|
||
| 1. Mojang 官方 | ||
| 2. **LittleSkin** ✨ | ||
| 3. Blessing Skin | ||
| 4. ... | ||
|
|
||
| 有一些流程示意图可帮助你理解加载列表这个机制： | ||
|
|
||
| ::: details 1. 默认配置 & Mojang 上不存在同名角色 | ||
|  | ||
| ::: | ||
|
|
||
| ::: details 2. 默认配置 & Mojang 上有同名角色 | ||
| 此时若要优先从 LittleSkin 中加载皮肤，可参照本文中的 [手动修改配置文件](#edit-csl-config) 部分进行操作，以达到 **3.** 的效果。 | ||
|
|
||
|  | ||
| ::: | ||
|
|
||
| ::: details 3. 手动修改配置文件，将 LittleSkin 设置为最高优先级 | ||
| 若参照本文中的 [手动修改配置文件](#edit-csl-config) 部分进行操作，即可达到以下效果。 | ||
|
|
||
|  | ||
| ::: | ||
|
|
||
| ::: details 4. 默认配置 & Mojang 上有同名角色 & 尝试加载全部材质 | ||
| 若 Mojang 中的同名角色设置了皮肤但未设置披风，CustomSkinLoader 会尝试从后续的服务器加载披风。 | ||
|
|
||
|  | ||
| ::: | ||
|
|
||
| ## CompatibilityLayerForCustomSkinLoader {#clfcsl} | ||
|
|
||
| > [!NOTE] 介绍 | ||
| > CustomSkinLoader 从 14.7 以来就已经放弃对 Minecraft 1.7.10 的支持，但是相较后续的 Minecraft 版本而言，从网络获取皮肤的过程并没有发生太大的变化。 | ||
| > | ||
| > 此 Mod 可以使 CustomSkinLoader 在 1.7.10 中正常运行。 | ||
| 名称意为 _CustomSkinLoader 兼容层_。 | ||
|
|
||
| 借助此 Mod，你可以<mark>在 Minecraft 1.7.10 中使用新版本的 CustomSkinLoader</mark>（仅限 _ForgeActive_ 通道）。 | ||
|
|
||
| 你可以在以下网站获取到关于 CompatibilityLayerForCustomSkinLoader 的更多信息。 | ||
|
|
||
| - [MC百科 (mcmod.cn)](https://www.mcmod.cn/class/4160.html) | ||
| - [CurseForge](https://www.curseforge.com/minecraft/mc-mods/compatibilitylayerforcustomskinloader) |