Skip to content

Commit

Permalink
⚡️ perf: csl and faq/in-game
Browse files Browse the repository at this point in the history
  • Loading branch information
SerinaNya committed May 19, 2024
1 parent 17a7c3d commit 7e51fa5
Show file tree
Hide file tree
Showing 2 changed files with 85 additions and 63 deletions.
12 changes: 6 additions & 6 deletions docs/faq/in-game.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ head:
以 CustomSkinLoader 为例,它的默认加载顺序为 _Mojang_ > _LittleSkin_
所以,如果你的角色名与某位正版用户相同,那么 CustomSkinLoader 会优先加载那位正版用户的皮肤。

要解决此问题,可以参照 [新手指引 > 配置 Mod > 手动修改配置文件](/newbee/mod.md#edit-csl-config) 章节手动调整加载顺序。
要解决此问题,可以参照 [新手指引 > 配置 Mod > 手动修改配置文件](/newbee/csl#edit-csl-config) 章节手动调整加载顺序。

## <Badge type="info">皮肤 Mod</Badge> 别人看不到我的材质 {#no-skin-by-other-players}

Expand All @@ -34,7 +34,7 @@ head:

解决方案:正确安装并配置皮肤 Mod。

你可以在 [新手指引 > 配置 Mod](/newbee/mod.md) 中学习如何正确配置皮肤 Mod;
你可以在 [新手指引 > 配置 Mod](/newbee/mod) 中学习如何正确配置皮肤 Mod;
:::

::: details 2. 你安装的其它 Mod(如 _NonUpdate_)干扰了皮肤 Mod 与 LittleSkin 之间的连接
Expand All @@ -55,15 +55,15 @@ head:
解决方案:

- 对于 1.7.10,请使用 SkinPort 加载材质。SkinPort 在 1.7.10 上提供了对 Alex 模型的支持。
参考 [新手指引 > 配置 Mod > SkinPort](/newbee/mod.md#skinport) 进行配置。
参考 [新手指引 > 配置 Mod > SkinPort](/newbee/mod#skinport) 进行配置。
- 对于更低版本,目前无解,你只能更换为 Steve 模型的皮肤。
:::

::: info 使用的是外置登录,但在多人游戏中不显示皮肤?
如果你使用外置登录的方式加载材质,并遇到了如标题所说的问题,请阅读 [下一条👇](#no-skin-in-server)
:::

如果你确定你的问题不是以上原因引起的,或者你按照以上的解决方案做了之后你的角色的材质依然没有显示或更新,请在详细阅读 [👉 遇到问题怎么办](/problems.md) 以后,带上你的皮肤 Mod 的日志,加入 [官方用户交流群](/user-group.md)[发送邮件工单](/email.md) 询问,或直接购买一对一远程技术支持服务。
如果你确定你的问题不是以上原因引起的,或者你按照以上的解决方案做了之后你的角色的材质依然没有显示或更新,请在详细阅读 [👉 遇到问题怎么办](/problems) 以后,带上你的皮肤 Mod 的日志,加入 [官方用户交流群](/user-group)[发送邮件工单](/email) 询问,或直接购买一对一远程技术支持服务。

## <Badge type="info">外置登录</Badge> 单人游戏中可以正常显示皮肤,但在多人游戏中就不行 {#no-skin-in-server}

Expand All @@ -72,7 +72,7 @@ head:
由于 Minecraft 的材质加载机制,在多人游戏中,只有正确配置了外置登录(即**同时满足以下全部条件**),才能正常地在多人游戏中显示你在 LittleSkin 上设置的材质:

- 服务端启用了在线模式(`server.properties``online-mode=true`
- [在服务端配置了 Yggdrasil 外置登录](/yggdrasil/server.md)
- [在服务端配置了 Yggdrasil 外置登录](/yggdrasil/server)

否则,就会出现如同标题中描述的问题。

Expand All @@ -94,7 +94,7 @@ head:

如果重新登录无法解决问题,请检查你在 LittleSkin 绑定的邮箱中是否存在大写英文字母,如果有,请将其更改为全小写字母,然后再次在启动器中重新登录。

如果以上操作均无法解决问题,请在完整阅读并理解 [遇到问题怎么办](/problems.md) 后,加入 [官方用户交流群](/user-group.md#主用户群) 询问。
如果以上操作均无法解决问题,请在完整阅读并理解 [遇到问题怎么办](/problems) 后,加入 [官方用户交流群](/user-group#主用户群) 询问。

## LittleSkin 支持 Minecraft 中国版(国服)吗? {#about-netease}

Expand Down
136 changes: 79 additions & 57 deletions docs/newbee/csl.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,3 @@
---
outline: [2, 3]
---

<script setup>
import GetCSL from '../../components/GetCSL.vue'
import { faFileArrowDown } from '@fortawesome/free-solid-svg-icons'
Expand All @@ -13,7 +9,9 @@ CustomSkinLoader 是我们最推荐的皮肤 Mod,也被称为 **CSL** 或 **

LittleSkin 自 CustomSkinLoader 14.7 起被添加到了 CustomSkinLoader 的默认加载列表中,加载顺序仅次于正版皮肤。

在大部分情况下,安装完成后无需进行任何修改,即可加载来自 LittleSkin 的材质。
本文提供了修改 CustomSkinLoader 配置文件的方法,以令其优先从 LittleSkin 加载材质。

## 下载此 Mod {#download}

你可以在以下网站获取到关于 CustomSkinLoader 的更多信息

Expand All @@ -22,52 +20,20 @@ LittleSkin 自 CustomSkinLoader 14.7 起被添加到了 CustomSkinLoader 的默

<GetCSL />

<!--@include: ./mod-tips.template.md-->

## 工作原理

CustomSkinLoader 会使用游戏内的玩家名查询不同的服务器,以此加载皮肤。

CustomSkinLoader 有一个加载列表,里面存放和定义着如何加载你的材质:

- **从哪个服务器加载?**
- **加载的先后顺序?**
- 其他高级加载策略

目前的情况下,若不对 CustomSkinLoader 的配置文件进行修改,默认的加载顺序如下:

1. Mojang 官方
2. **LittleSkin**
3. Blessing Skin
4. ...

有一些流程示意图可帮助你理解加载列表这个机制:

::: details 1. 默认配置 & Mojang 上不存在同名角色
![默认配置 且 Mojang 上没有同名角色时的加载流程](./assets/mods/flow-regular.webp)
:::

::: details 2. 默认配置 & Mojang 上有同名角色
此时若要优先从 LittleSkin 中加载皮肤,可参照本文中的 [手动修改配置文件](#edit-csl-config) 部分进行操作,以达到 **3.** 的效果。

![默认配置 且 Mojang 上有同名角色时的加载流程](./assets/mods/flow-mojang-only.webp)
:::
---

::: details 3. 手动修改配置文件,将 LittleSkin 设置为最高优先级
若参照本文中的 [手动修改配置文件](#edit-csl-config) 部分进行操作,即可达到以下效果。
<!--@include: ./mod-tips.template.md-->

![修改了配置文件,将 LittleSkin 设置为最高优先级时的加载流程](./assets/mods/flow-littleskin-only.webp)
:::
## 版本:14.7+ <Badge type="tip" text="✨ 当前版本" />

::: details 4. 默认配置 & Mojang 上有同名角色 & 尝试加载全部材质
若 Mojang 中的同名角色设置了皮肤但未设置皮肤,CustomSkinLoader 会尝试从后续的服务器加载披风。
如果不存在与你同名的正版角色导致冲突的问题,一般无需修改 CustomSkinLoader 的配置文件。

![默认配置,尝试加载全部材质时的加载流程](./assets/mods/flow-loadall.webp)
:::
以下是同名冲突在游戏内的典型表现:

## 版本:14.7+ <Badge type="tip" text="✨ 当前版本" />
- 显示的是你从**未使用过的陌生皮肤**
- 只加载了皮肤而没有加载披风 <Badge type="info" text="仅旧版" />

如果你在游戏内加载了你从未使用过的皮肤,或者只加载了皮肤而没有加载披风,通常是因为存在与你同名的正版角色导致冲突而无法加载来自 LittleSkin 的材质,请参考本文中的 [手动修改配置文件](#edit-csl-config) 部分进行操作。
如果出现了上述情况,请参考本文中的 [手动修改配置文件](#edit-csl-config) 部分进行操作,以使其优先从 LittleSkin 加载材质

## 版本:早期 <Badge type="danger" text="👎 不再推荐" />

Expand Down Expand Up @@ -110,39 +76,95 @@ https://skin.prinzeugen.net/cape/*.png

## 手动修改配置文件 {#edit-csl-config}

> [!TIP] 什么情况下需要手动修改 CustomSkinLoader 配置文件?
> [!NOTE] 什么情况下需要手动修改 CustomSkinLoader 配置文件?
> 👉 **一般来说,你只需要简单地安装 CustomSkinLoader Mod 即可,无需进行任何额外的配置。**
>
> 然而有时事与愿违,游戏中你的皮肤可能并不是你所期望的那个。
>
> 当你在这个手册上或者是其他地方得知,「你需要手动修改配置文件」时,那就是时候照着下面的步骤来做了。
💡 配置文件默认存放于 `.minecraft/CustomSkinLoader/` 目录中,仅有一个配置文件,文件名为 `CustomSkinLoader.json`
---

你可以使用记事本或者任意编辑器将其打开,将配置文件原有的所有内容替换成以下内容。

修改完成后别忘了先保存再退出。

::: details 图示:配置文件的具体位置
再次启动 Minecraft 之后,你应该就能在游戏里看到你在 LittleSkin 中设置的材质了。

---

配置文件: `CustomSkinLoader.json` [<BSButton style="background-color: var(--vp-c-success-3)"><FA :icon="faFileArrowDown" /> 下载此文件 </BSButton>](/CustomSkinLoader.json)

> [!IMPORTANT] ✅ 建议直接下载 CustomSkinLoader 配置文件
> 你可以下载到为 LittleSkin 量身定制的配置文件,此文件的内容与下面的内容一致。
>
> 你只需将下载到的文件覆盖掉原有的文件即可,而无需对原文件进行编辑。
> [!TIP] 配置文件的位置
> 配置文件默认存放于 `.minecraft/CustomSkinLoader/` 目录中,仅有一个配置文件,文件名为 `CustomSkinLoader.json`
> [!NOTE] 需要重启游戏
> 完成配置文件的修改后,你需要重启游戏才能使其生效。
::: details 🤔 找不到配置文件的具体位置?
![CustomSkinLoader 文件夹所处位置](./assets/mods/csl-folder.webp)

![CustomSkinLoader 的配置文件和日志文件](./assets/mods/csl-files.webp)
:::

你也可以使用记事本或者任意编辑器将其打开,将配置文件原有的所有内容替换成以下内容。
<<< @/public/CustomSkinLoader.json{4-9 json:line-numbers}

## 工作原理

CustomSkinLoader 会使用游戏内的玩家名查询不同的服务器,以此加载皮肤。

CustomSkinLoader 有一个加载列表,里面存放和定义着如何加载你的材质:

修改完成后别忘了先保存再退出。再次启动 Minecraft 之后,你应该就能在游戏里看到你在 LittleSkin 中设置的材质了。
- **从哪个服务器加载?**
- **加载的先后顺序?**
- 其他高级加载策略

配置文件: `CustomSkinLoader.json` [<BSButton><FA :icon="faFileArrowDown" /> 下载此文件 </BSButton>](/CustomSkinLoader.json)
目前的情况下,若不对 CustomSkinLoader 的配置文件进行修改,默认的加载顺序如下:

> [!IMPORTANT] 直接下载 CustomSkinLoader 配置文件
> 你可以下载到为 LittleSkin 量身定制的配置文件,此文件的内容与下面的内容一致。你只需将此文件覆盖原有文件即可。
1. Mojang 官方
2. **LittleSkin**
3. Blessing Skin
4. ...

<<< @/public/CustomSkinLoader.json{4-9 json:line-numbers}
有一些流程示意图可帮助你理解加载列表这个机制:

::: details 1. 默认配置 & Mojang 上不存在同名角色
![默认配置 且 Mojang 上没有同名角色时的加载流程](./assets/mods/flow-regular.webp)
:::

::: details 2. 默认配置 & Mojang 上有同名角色
此时若要优先从 LittleSkin 中加载皮肤,可参照本文中的 [手动修改配置文件](#edit-csl-config) 部分进行操作,以达到 **3.** 的效果。

![默认配置 且 Mojang 上有同名角色时的加载流程](./assets/mods/flow-mojang-only.webp)
:::

::: details 3. 手动修改配置文件,将 LittleSkin 设置为最高优先级
若参照本文中的 [手动修改配置文件](#edit-csl-config) 部分进行操作,即可达到以下效果。

![修改了配置文件,将 LittleSkin 设置为最高优先级时的加载流程](./assets/mods/flow-littleskin-only.webp)
:::

::: details 4. 默认配置 & Mojang 上有同名角色 & 尝试加载全部材质
若 Mojang 中的同名角色设置了皮肤但未设置皮肤,CustomSkinLoader 会尝试从后续的服务器加载披风。

![默认配置,尝试加载全部材质时的加载流程](./assets/mods/flow-loadall.webp)
:::

## CompatibilityLayerForCustomSkinLoader {#clfcsl}

> 由于新版 CustomSkinLoader 从 14.7 以来就已经放弃对 Minecraft 1.7.10 的支持,但是相较后续的 Minecraft 版本而言,从网络获取皮肤的过程并没有发生太大的变化。
> [!NOTE] 介绍
> CustomSkinLoader 从 14.7 以来就已经放弃对 Minecraft 1.7.10 的支持,但是相较后续的 Minecraft 版本而言,从网络获取皮肤的过程并没有发生太大的变化。
>
> 有了这个 Mod,就可以让新版 CSL 能够被 Forge 1.7.10 加载。
> 此 Mod 可以使 CustomSkinLoader 在 1.7.10 中正常运行。
名称意为 _CustomSkinLoader 兼容层_

名称意为 CSL 兼容层。借助此 Mod,你可以在 Minecraft 1.7.10 中使用新版本的 CustomSkinLoader(仅限 _ForgeActive_ 通道)。
借助此 Mod,你可以在 Minecraft 1.7.10 中使用新版本的 CustomSkinLoader(仅限 _ForgeActive_ 通道)。

你可以在以下网站获取到关于 CompatibilityLayerForCustomSkinLoader 的更多信息。

Expand Down

0 comments on commit 7e51fa5

Please sign in to comment.