配置 Mod

如果你在单人游戏或离线模式服务器中游玩，可以通过安装客户端皮肤 Mod 来加载 OakSkin 上的皮肤与披风。本文介绍常见的皮肤 Mod 及其配置方式。

CustomSkinLoader

俗称 万用皮肤补丁，是 Minecraft 社区中使用广泛的开源客户端皮肤模组，同时维护 Forge、Fabric 双平台版本，适配众多游戏版本。

原版 Minecraft 仅能从 Mojang 官方服务器获取玩家皮肤资源，离线账号只能使用史蒂夫、爱丽克丝默认模型。该模组通过修改游戏内部逻辑接管皮肤管理器，打破原版的接口限制，可对接各类第三方皮肤 API，同时保留对 Mojang 官方接口的兼容。

工作原理

模组依靠 loadlist 加载列表管理多个皮肤数据源。游戏渲染玩家皮肤时，会按列表从上至下依次发起网络请求，获取到有效皮肤材质即终止查询；遇到请求超时、无返回数据时，自动降级尝试下一个数据源。

主要特性：

• 支持高清皮肤与透明披风
• 自带皮肤本地缓存，降低重复网络请求
• 支持读取本地皮肤文件进行离线替换

主配置路径：.minecraft/config/CustomSkinLoader/config.json 修改配置后必须 重启游戏 才会生效。

配置步骤

1. 从皮肤站的 模组配置页 下载 CustomSkinLoader 的配置文件，或直接修改 config.json
2. 在 loadlist 数组的最前面添加如下条目：

{
  "name": "OakSkin",
  "type": "CustomSkinAPI",
  "root": "https://skin.oak-ms.top/csl/"
}

3. 保存文件并重启游戏

CustomSkinLoader ExtraList

ExtraList 并不是独立模组，是 CustomSkinLoader 14.4 版本新增的配置导入机制，目的是简化第三方皮肤站的接入流程，降低手动编辑主配置 JSON 出错的概率。

使用方法

1. 从 OakSkin 模组配置页 下载 ExtraList JSON 文件
2. 将文件放入 .minecraft/CustomSkinLoader/ExtraList 目录（如不存在请手动创建）
3. 启动游戏，模组会自动读取目录中的文件并把其中的数据源合并追加到主配置加载列表的顶部

支持特性：

• 可放入多个 ExtraList 文件，通过文件名可控制导入先后顺序
• 模组自带去重逻辑，避免同一皮肤站重复添加
• 仅适用于 CustomSkinLoader，无法作用于其他皮肤模组

Universal Skin Mod（UniSkinMod）

一款较早问世的第三方皮肤模组，主要面向 Forge，项目现已 停止维护，目前更多作为兼容旧环境的备选方案。

它的功能定位和 CustomSkinLoader 相同，用于加载第三方皮肤站的皮肤与披风，但使用完全独立的配置体系。配置依靠 rootURIs 数组填写皮肤站接口地址：

{
  "rootURIs": [
    "https://skin.oak-ms.top/usm/",
    "https://skin.prinzeugen.net/"
  ]
}