CustomSkinLoader

这是什么？

CustomSkinLoader 是一个 Minecraft 模组，可以从在线皮肤 API 或本地文件加载皮肤、披风和鞘翅纹理。

此分支是 MCCustomSkinLoader 的通用版本。它使用一个引导程序构件替代旧版针对不同版本的独立 JAR 文件。引导程序 JAR 会准备运行时所需的 CustomSkinLoader-Common.jar，根据当前 Minecraft 映射命名空间对其进行重映射，并在运行时应用所需的加载器专用类补丁。

支持的加载器

• Forge Legacy 和 Forge ModLauncher
• NeoForge
• Fabric
• 兼容 Quilt 的 Fabric Loader 环境

功能

通用运行时

所有受支持的加载器都使用同一个面向用户的 JAR。生成的可安装构件为：

Bootstrap/build/libs/CustomSkinLoader_Universal-<version>.jar

Common/build/libs/Common-<version>.jar 是嵌套的运行时载荷，不应直接安装。

支持多种皮肤加载 API，并可自定义皮肤加载列表

支持的皮肤加载 API：

• MojangAPI
• CustomSkinAPI
• CustomSkinAPIPlus
• UniSkinAPI
• ElyByAPI
• Legacy

支持的特殊皮肤网站和配置：

• Glitchless
• MinecraftCapes
• OptiFineCape
• Cloaks+
• 支持兼容 Wynntils 的配置

你可以自定义皮肤加载列表，并从任何兼容的皮肤服务器加载纹理。皮肤服务器所有者也可以使用 ExtraList 文件，帮助用户添加自己的服务器。

支持高清皮肤和披风

CustomSkinLoader 可以加载和处理高清皮肤与披风。需要时，OptiFine 披风纹理会被转换为标准披风格式。

配置缓存

• 减少重复的网络请求。
• 在网络不可用时，允许加载已缓存的配置。

本地皮肤

无需皮肤服务器即可加载皮肤。使用默认的 Legacy 路径时，请将纹理放置在：

.minecraft/CustomSkinLoader/LocalSkin/skins/<USERNAME>.png
.minecraft/CustomSkinLoader/LocalSkin/capes/<USERNAME>.png
.minecraft/CustomSkinLoader/LocalSkin/elytras/<USERNAME>.png

额外列表

皮肤服务器可以提供 ExtraList JSON 文件。用户可以将它们放入 .minecraft/CustomSkinLoader/ExtraList，从而将服务器添加到加载列表中。

透明纹理支持

渲染补丁经过设计，可在受支持的版本中正确保留皮肤和披风的透明效果。

默认加载列表

• Mojang (MojangAPI)
• LittleSkin (CustomSkinAPI)
• BlessingSkin (CustomSkinAPI)
• ElyBy (ElyByAPI)
• TLauncher (ElyByAPI)
• Glitchless (兼容 ElyBy 的档案)
• LocalSkin (旧版)
• MinecraftCapes
• OptiFineCape
• Cloaks+

如果你想向默认列表中添加其他皮肤服务器，请提交一个 issue。

致皮肤服务器所有者

CustomSkinLoader 旨在从多种服务器实现中加载纹理。通常，支持 CustomSkinLoader 的某个 API 比复制此模组的内部实现更好。如果你维护着一个皮肤服务器，你可以提供一个 ExtraList 文件，或请求将其纳入默认加载列表。

版权与许可

主要贡献者

• 2013-2014 Jeremy Lam (JLChnToZ)
• 2014-2024 Alexander Xia (xfl03)
• 2020-2026 ZekerZhayard

二进制文件

你可以在整合包中使用和分享未经修改的官方二进制文件。在整合包中使用时，CustomSkinLoader 必须列在模组列表中。未经许可，请勿将此模组重新发布到其他网站。

源代码

源代码采用 GPL-3.0-only 许可。参见 LICENSE。

包 customskinloader 包含来自以下项目的代码或思路：

• AsteriskTeam/TabIconHackForge (GPLv3)
• RecursiveG/UniSkinMod (GPLv3)
• NekoCaffeine/Alchemy (GPLv3)

如果你重新分发修改过的构建版本，请更改包名并清楚标明该构建版本已被修改，以避免与官方 CustomSkinLoader 发布版本混淆。