Blessing Skin 用户手册

# 修改 CustomSkinLoader 配置文件

如果您想从 CustomSkinLoader 的默认加载列表之外的皮肤站加载材质，您需要修改配置文件。

CustomSkinLoader 的配置文件位于 .minecraft/CustomSkinLoader/ 目录下，文件名为 CustomSkinLoader.json（如果启用了版本隔离，则是在 .minecraft/versions/{version}/CustomSkinLoader/ 目录下，其中 {version} 为对应的版本）。

# ExtraList

ExtraList 是 CustomSkinLoader 14.4 引入的一项特性，提供了快捷的添加皮肤站的功能。

对于一般用户来说，只需要将皮肤站提供的 ExtraList 文件放入 .minecraft/CustomSkinLoader/ExtraList/ 目录下（同样的，如果启用了版本隔离，则是在 .minecraft/versions/{version}/CustomSkinLoader/ExtraList/ 目录下）并启动游戏即可。

在使用 ExtraList 添加皮肤站时，如果需要一次添加多个皮肤站且需要对皮肤站进行排序，则需要将 ExtraList 文件重命名至对应的顺序。

启动游戏后，ExtraList 文件将会被删除，这是正常现象。此时皮肤站即已被添加进加载列表中的最顶端。

如果想要了解如何编写 ExtraList 文件，请查看：https://github.com/xfl03/CustomSkinLoaderAPI/blob/master/ExtraList/ExtraList-zh_CN.md

# 在线修改配置文件

您可以使用 CustomSkinLoade GUI 在线修改配置文件。它提供图形化界面来让您调整 CustomSkinLoader 的配置文件。直接访问 https://mc-csl.netlify.app/ (opens new window) 即可。

# 手动修改配置文件

我们推荐使用专业的代码编辑器（如 Notepad++ (opens new window)、Visual Studio Code (opens new window)、Sublime Text (opens new window)）修改配置文件。

CustomSkinLoader 的配置文件使用 JSON 格式，并对格式有着严格的要求。如果配置文件的格式有误，则会重置到默认配置文件。修改完配置文件后，可以使用 BeJSON (opens new window) 对配置文件内容进行格式化校验。

不建议没有相关经验的小白手动修改配置文件。

配置文件中有以下几个配置项：

  • version
  • enable
  • loadlist
    • name
    • type
    • root
    • checkPNG
    • skin
    • model
    • cape
    • elytra
    • apiRoot
    • sessionRoot
    • userAgent
  • enableSkull
  • enableDynamicSkull
  • enableTransparentSkin
  • ignoreHttpsCertificate
  • forceLoadAllTextures
  • enableCape
  • threadPoolSize
  • cacheExpiry
  • enableUpdateSkull
  • enableLocalProfileCache
  • enableCacheAutoClean

其中除 version、loadlist、threadPoolSize 和 cacheExpiry 外的配置项的值均应为布尔值（true 或 false，分别表示「启用」和「禁用」）。

根据 CustomSkinLoader 版本不同，适用的配置项也有可能不同。不是所有的配置项都必须填写。

# version

该配置项表示 CustomSkinLoader 的版本。请不要修改此项！

# enable

该配置项表示是否启用 CustomSkinLoader。

# loadlist

该配置项即加载列表，内容与顺序决定了皮肤来源与加载顺序。CustomSkinLoader 会以上到下的顺序尝试获取皮肤。其中子配置项的意义请见下方：

# name

该配置项表示皮肤站名称。

# type

该配置项表示皮肤站的 API 类型。可选的值有：

  • MojangAPI
  • CustomSkinAPI
  • UniSkinAPI
  • Elyby
  • GlitchlessAPI
  • Legacy

请根据皮肤站的 API 实现来选择正确的值。不同 API 的意义不同，其对应的剩余的配置项和值也不同。

同时，除 MojangAPI 外的所有 API 均可指定 User-Agent，将 userAgent 配置项的值设为您想指定的 User-Agent 即可。

# MojangAPI

使用 Yggdrasil API 加载材质。需要配置以下两个配置项：

  • apiRoot：Yggdrasil API 的根（Root）地址；
  • sessionRoot：Yggdrasil API 的会话服务器（Session Server）的地址。
# CustomSkinAPI

使用 CustomSkinAPI 加载材质。仅需要配置一个配置项：root，表示皮肤站的 CustomSkinAPI 的根（Root）地址。

# UniSkinAPI

使用 UniSkinAPI 加载材质。仅需要配置一个配置项：root，表示皮肤站的 UniSkinAPI 的根（Root）地址。

# Elyby

从 Ely.By (opens new window) 加载材质。无需配置其它配置项。

# GlitchlessAPI

使用 GlitchlessAPI 加载材质。仅需要配置一个配置项：root，表示皮肤站的 GlitchlessAPI 的根（Root）地址。

# Legacy

使用传统方式加载皮肤。需要配置以下几个配置项：

  • checkPNG：检查图像文件的格式是否为 PNG，值为布尔值；
  • skin：皮肤文件地址；
  • model：皮肤模型，可选值的有：
    • default：默认模型，即 Steve 模型；
    • slim：纤细模型，即 Alex 模型，仅 1.8 及以上的 Minecraft 支持；
    • auto：自动判断材质模型；
  • cape：披风文件地址；
  • elytra：鞘翅文件地址，仅 1.9 以上的 Minecraft 支持。

其中 skin、cape 和 elytra 配置项的值中，可使用 {USERNAME} 或 {UUID} 占位符来表示玩家的名称或 UUID。

# enableSkull

表示是否启用头颅加载。默认启用。

# enableDynamicSkull

表示是否允许动态头颅。默认启用。

# enableTransparentSkin

表示是否允许透明皮肤。默认启用。

# ignoreHttpsCertificate

表示是否忽略 HTTPS 证书检查结果。默认禁用。

启用此项后，即使皮肤站的 HTTPS 证书无效，仍会从该皮肤站加载皮肤。

通常情况下不建议启用此项，否则可能会带来一定的安全隐患。

# forceLoadAllTextures

表示是否强制加载一个玩家的所有材质。即，是否加载皮肤又加载披风后才停止加载。默认禁用。

禁用此项时，一旦玩家成功从加载列表内的某一皮肤站成功加载某一材质（皮肤或披风），即会停止继续加载；启用此项时，若玩家未能从某一皮肤站加载所有材质，则会继续尝试从加载列表内剩余的皮肤站加载材质，直到成功加载所有材质或加载列表内无更多皮肤站。

# enableCape

表示是否允许加载披风。默认启用。

# threadPoolSize

表示加载皮肤和头颅的线程池大小。默认为 1，推荐的值的范围为 1 到 16。

游玩在线人数较多的服务器时，可以适当增大该项的值，但也请不要设置得太高。

# cacheExpiry

表示玩家信息缓存的过期时间，单位为秒。默认为 30。

玩家信息缓存中包含了玩家的材质的地址，但不包含材质文件。

设置为 -5 或更低即相当于关闭玩家信息缓存。不建议设置得太小或太大。

# enableUpdateSkull

表示是否开启头颅更新。默认禁用。

头颅更新容易引起卡顿，不建议启用此项。

# enableLocalProfileCache

表示是否启用本地皮肤缓存（不是上面 cacheExpiry 设置项中提到的玩家信息缓存）。默认禁用。

启用此项后可在无网络时继续使用缓存的皮肤。不建议在网络状态稳定（例如能一直接入网络的台式机）时仍然开启。

# enableCacheAutoClean

表示是否在 Minecraft 启动时自动清理 所有 玩家信息缓存。默认禁用。

如果启用了本地皮肤缓存，则本项将被强制禁用。