OakSkinOakSkin
首页
新手指引
常见问题
Yggdrasil 外置登录
  • OAuth 应用
  • OAuth2 应用开发
  • 积分系统
  • 版权保护
遇到问题了?
首页
新手指引
常见问题
Yggdrasil 外置登录
  • OAuth 应用
  • OAuth2 应用开发
  • 积分系统
  • 版权保护
遇到问题了?
  • 首页
  • 新手指引
    • 新手指引
    • 验证邮箱
    • 创建角色
    • 设定材质
    • CustomSkinLoader 万用皮肤补丁
    • 配置其他 Mod 或插件
    • 绑定正版 Minecraft 账号
  • 常见问题
    • 常见问题解答
    • 站点使用相关
    • 游戏内加载相关
  • Yggdrasil 外置登录
    • Yggdrasil 外置登录
    • 在客户端配置 Yggdrasil 外置登录
    • 在服务端配置 Yggdrasil 外置登录
  • 进阶教程

    • /advanced/oauth.html
    • /advanced/oauth2.html
    • /advanced/score.html
    • /advanced/copyrights.html
  • 遇到问题了咋办

CustomSkinLoader 万用皮肤补丁

CustomSkinLoader 是我们最推荐的皮肤 Mod,也被简称为 CSL。其中文译名 万用皮肤补丁 更广为人知。

CustomSkinLoader 以游戏内的玩家名作为标识,按配置文件中设置的顺序依次从各个皮肤服务器尝试获取皮肤。

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

本文提供了修改 CustomSkinLoader 配置文件的方法,以令其优先从 OakSkin 加载材质。

下载此 Mod

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

  • MC百科 (mcmod.cn)
  • CurseForge
  • Modrinth

本文不会说明「如何安装 Mod」

如果你确实不会,请将本文分享给你的朋友或其他愿意帮助你的人士,让他们指导你操作。

找不到下文中说的配置文件?

在大多数情况下,安装皮肤 Mod 后需要启动一次游戏并进入存档,配置文件才会被自动生成。

如果你在启动器中启用了版本隔离,配置文件的路径还可能与本文中描述的有所不同。

不要轻易地同时安装多个皮肤 Mod

否则,轻则无法正常加载材质,重则导致游戏崩溃。

但并不是没有例外,比如:

  1. CompatibilityLayerForCustomSkinLoader 需要与 CustomSkinLoader 一起安装

版本:14.7+ (当前版本)

如果不存在与你同名的正版角色导致冲突的问题,一般无需修改 CustomSkinLoader 的配置文件。

以下是同名冲突在游戏内的典型表现:

  • 显示的是你从未使用过的陌生皮肤
  • 只加载了皮肤而没有加载披风(仅旧版)

如果出现了上述情况,请参考本文中的 手动修改配置文件 部分进行操作,以使其优先从 OakSkin 加载材质。

手动修改配置文件

什么情况下需要手动修改 CustomSkinLoader 配置文件?

一般来说,你只需要简单地安装 CustomSkinLoader Mod 即可,无需进行任何额外的配置。

然而有时事与愿违,如果你在使用过程中遇到了同名冲突这样的情况,那就是时候照着下面的步骤来做了。

配置文件位置

配置文件默认存放于 .minecraft/CustomSkinLoader/ 目录中,仅有一个配置文件,文件名为 CustomSkinLoader.json。

需要重启游戏

完成配置文件的修改后,你需要重启游戏才能使其生效。

配置文件内容

{
  "enable": true,
  "loadlist": [
    {
      "name": "OakSkin",
      "type": "CustomSkinAPI",
      "root": "https://skin.oak-ms.top/csl/",
      "userAgent": "CustomSkinLoader/oakskin-manual-edited"
    },
    {
      "name": "Mojang",
      "type": "MojangAPI"
    }
  ]
}

功能特性

仅在客户端有效

是一个客户端 Mod,在服务端上安装它不会起到任何作用。

多个皮肤来源 / 加载列表

会尝试从众多来源(皮肤站)逐个加载皮肤,直到皮肤和披风都加载完毕。

高清材质支持

提供了对大于 64*64 的皮肤和披风的高清材质的支持,在没有 Optifine 和 Sodium 等改善渲染的 Mod 的情况下也能正确显示高清材质。

低版本双层皮肤支持

在 1.7.10 以下的版本中正确显示原先不支持显示的双层皮肤。

透明皮肤支持

在部分低版本中可正确显示透明皮肤。

工作原理

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

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

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

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

  1. Mojang 官方
  2. OakSkin
  3. Blessing Skin
  4. ...

CompatibilityLayerForCustomSkinLoader(仅限 Minecraft 1.7.10)

CustomSkinLoader 从 14.7 以来就已经放弃对 Minecraft 1.7.10 的支持,但是相较后续的 Minecraft 版本而言,从网络获取皮肤的过程并没有发生太大的变化。

此 Mod 可以使 CustomSkinLoader 在 1.7.10 中正常运行。名称意为 CustomSkinLoader 兼容层。

借助此 Mod,你可以在 Minecraft 1.7.10 中使用新版本的 CustomSkinLoader。

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

  • MC百科 (mcmod.cn)
  • CurseForge

需要前置 Mod

除了 CompatibilityLayerForCustomSkinLoader 自身外,你还需要安装以下前置 Mod:

  • CustomSkinLoader
  • UniMixins

在安装 CustomSkinLoader 时,请下载适用于 Minecraft 1.8 的版本,其文件名通常带有 ForgeLegacy 或 ForgeV1 字样。

帮助我们完善页面
最近更新:: 2026/8/7 09:00
Contributors: Jasper-Ryanxu
Prev
设定材质
Next
配置其他 Mod 或插件