本帖最后由 gooding300 于 2021-1-31 21:35 编辑

咕咕咕 咕咕咕~
交流群:651287593 欢迎加入~

0.引言
为什么要完全重写CustomSkinLoader?(13版本)
2013年,原作者JLChnToZ开发并发布了CustomSkinLoader的第一个版本以使Minecraft 1.4.4可以加载自定义皮肤。
2014年,我接手了CustomSkinLoader项目,并为1.7.2做支持。
3年间,Minecraft在皮肤加载方面改变了太多,从加载方式到新模型加入,不断对CustomSkinLoader所唯一支持的传统加载敲响警钟,感觉CustomSkinLoader原有的传统加载或许已经难以满足广大用户对皮肤多样化的需求,因此是时候也做出一些改变了。
CustomSkinLoader如今已经完全被重写,从代码方面,现在已经是一个完全原创的新mod(您可以自行比较新代码旧代码),请您使用新制的CustomSkinLoader以获取在皮肤方面更佳的体验。

感想与未来展望(14版本)
首先需要感谢每一位为CustomSkinLoader测试/反馈/报告bug/提出意见的支持者。
在新版本开发过程中,也感谢gplane为CSL进行了多次测试。
今天看到一个水贴,才发现自己在无意间已经入坑Minecraft 5年了,看着Minecraft一点一点从Notch的世界变成Jeb的世界,对大部分用户而言只是版本号的不断上升,在跳票与等待间的无限失望与惊喜,而时间的流逝与历史的伤痕只会隐藏在暗处。
下一年,又是人生一次重大的挑战,虽说不会像2年前那样停止更新一段时间,但是,也很难达到今年上半年的更新速度了。
希望大家可以理解,也希望会有更多人喜欢这一mod。

特别感谢
首先,无论如何都要感谢HeartyYFLittle Qiu,是你们帮助了CSL进行新功能新版本的测试,提供了服务器为更方便的安装方法给予了支持,在你们的帮助下,广大1.13的用户也能够方便的使用上CSL。
同时,也非常感谢 Mainyf 、Neubulae、FC_Studio、SPGoding、四娃烧烤等赞助者的支持,各位的赞助大大地给予了我继续开发增加更多新功能的动力。

联系方式
- github issue
- 邮箱: xfl03@hotmail.com
- 论坛私信
- QQ群
再次强调,不要在帖子里回复bug,版聊很难受。
对于只抱怨问题,不提供具体信息(截图/日志)的人,送上一句话
事不目见耳闻,而臆断其有无,可乎?
——苏轼《石钟山记》

1.简介
什么是CustomSkinLoader?
CustomSkinLoader,万用皮肤补丁,秉承万用的原则,能够由用户自定义加载来自任意皮肤站的皮肤。

功能
1)多皮肤加载API支持
CustomSkinLoader支持多种皮肤加载API(接口),您可以使用这一特性来加载来自任意您所喜欢的皮肤站的皮肤与披风。
如果您是皮肤站的拥有者,您只需实现以下任一API,您就可以使用CustomSkinLoader加载您的皮肤站。
目前支持的API:
- Mojang API (可用于离线模式下的正版加载)
- CustomSkinAPI
- CustomSkinAPIPlus(仅测试)
- UniSkinAPI
- 传统加载 (带用户名的网址)
2)高清皮肤/披风支持
CustomSkinLoader已经对高清皮肤功能进行修复,即使没有optifine,您也可以获得独特的高清视觉盛宴。
3)低版本双层支持
双层皮肤在1.8以下版本本会显示错误,不过请放心,CustomSkinLoader也修复了这个问题,您可以更加自由地制作或使用多样化的皮肤。
4)头颅加载及动态头颅支持
头颅加载时严重的掉帧问题已经缓解*,放心玩转自定义头颅吧。
同时,动态头颅也已经可用,材质列表也可以通过索引文件加载,文档稍后补充,您也可以自行探究相关的源代码
*相对于原版头颅加载而言,针对14.1及以后的版本
6)皮肤缓存
在减少网络使用量的同时保证了皮肤更新。
更为甚者,还可以在无网络时继续使用皮肤*。
*此功能需要您手动设置配置文件开启
7)本地皮肤支持
离开皮肤站,也可以使用任意API*加载本地皮肤。
您还可以使用这一功能快速测试皮肤甚至是修改默认皮肤/皮肤模型。
*鉴于Mojang API的特殊性,无法支持本地皮肤
**在默认设置下,您可以直接将皮肤放于 ".minecraft/CustomSkinLoader/LocalSkin/skins/用户名.png",将披风放于 ".minecraft/CustomSkinLoader/LocalSkin/capes/用户名.png",将鞘翅放于".minecraft/CustomSkinLoader/LocalSkin/elytras/用户名.png"以使用本地皮肤。
***本地皮肤仅自己可见
8)透明皮肤支持
鬼畜的缺胳膊少腿以及莫名的黑色皮肤已被修复。
9)增量加载列表功能
由支持的皮肤站提供,方便用户将皮肤站加入CustomSkinLoader加载列表。
供皮肤站拥有者参考的文档: https://github.com/xfl03/CustomS ... /ExtraList-zh_CN.md

正版是否需要皮肤补丁?
毫无疑问是需要的。
1.正版皮肤本身不支持高清,且大部分正版用户没有披风。
2.现仍有许多玩家没有购买正版,您只能看到千篇一律的默认皮肤。
3.从1.7.6开始,在离线模式服务器上,即使是正版玩家也不会加载皮肤,而目前国内大部分服务器是没有正版验证的(即离线模式),更多信息请您参阅皮肤加载基本原理
4.从1.8.4开始,不再可以使用来自非Mojang服务器的自定义头颅材质,请您参阅 MC-78491

默认加载列表
虽然您完全可以自定义加载列表,不过如果您没有修改加载列表的话,默认列表如下:
- Mojang (Minecraft 正版皮肤/披风)
- LittleSkin
- Blessing Skin
- Skin Me
- 本地皮肤(参见1.7)
如果您希望某个皮肤站也加入默认加载列表,请您联系我。
默认列表要求

2.安装
CustomSkinLoader支持多种安装方式,几乎涵盖了安装mod的所有方法,
您可以根据实际情况与自己的偏好选择任一方式进行安装;
如果您还有其他更猎奇的安装mod的方法,请务必告诉我;
无论有无forge,CustomSkinLoader都能正常使用。
1.使用forge加载(有forge版本推荐方法)
2.使用LiteLoader加载
3.使用Meddle加载(1.9)
4.修改其他文件(14.12-)
5.库文件挂载(14.12-)
库文件挂载(14.12+)6.使用Rift加载(1.13)
7.使用Fabric加载(1.14+)

3.配置文件
如果您已满意于默认加载列表,您其实并不需要知道如何修改配置文件。
关于配置文件的修改请参阅LittleSkin帮忙编写的新教程: https://csl.littleservice.cn/faq/config-csl.html

4.下载
这里的CustomSkinLoader版本从14.1开始,之前的版本请参见(7.过时的内容)。
下载地址
开发版
开发版不适用于普通玩家。
开发版一般包含更多功能。
构建时,所有正在维护的版本都会进行构建。
CI: https://circleci.com/gh/xfl03/MCCustomSkinLoader
稳定版
根据版规,本人使用营利链接无可厚非。
如果拒绝使用营利链接,您可以去github获得源代码后自行构建。
【4-6】营利相关
版权(所有权)无争议的原创Mod允许使用营利性链接/网盘以及在帖内放置自愿捐助链接。

Forge通用版mod此版本需要安装Forge
1.7.10 https://www.mcbbs.net/thread-1109996-1-1.html
1.8-1.16.1 https://www.curseforge.com/minec ... oader/files/2998090 [14.12]
1.16.2-1.16.4 https://www.curseforge.com/minec ... oader/files/3106765 [14.13-s199]
Fabric通用版mod此版本需要安装Fabric
1.14-1.16.4 https://www.curseforge.com/minec ... oader/files/3106767 [14.13-s199]
原版mod(在无Forge、Fabric环境下安装)
1.16.1 https://csl.littleservice.cn/ ... /CustomSkinLoader_1.16.1-14.12.jar [14.12]
1.16.2 https://csl.littleservice.cn/lib ... 13-SNAPSHOT-165.jar [14.13-s165]
(可以不下载这一文件,更方便的安装方法请见上文)

请注意,以上版本均已具体到子版本,1.x并不代表1.x.*。

升级指南
请升级到稳定版,今后稳定版更新速度将放缓。
稳定版是经过多次测试积累一定修改后才发布的版本,可放心使用。

更新日志

5.常见问题
如果您在使用过程中遇到了问题,请您先参考以下参见问题。
如果仍然未能得到解决,请您联系我,向我反馈(请带上必要的日志文件 例如CustomSkinLoader.log)。
1.如何修改皮肤加载列表?
请参见(3.配置文件)
2.皮肤没有加载
此时请您确认以下问题:
- 配置文件再修改后是否是合格的json
- 如果有forge的话,forge是否是稳定版
- 是否正确安装皮肤补丁
- 是否有不兼容的mod(请详细查看常见问题3)
- 对于1.9多人联机,请您看以下内容:
如果仍然不能正常加载,可能这一补丁不适合您的客户端,请舍弃。
3.与其他mod兼容吗?
CustomSkinLoader与大部分主流mod保持了良好的兼容,若您使用以下mod,请您查看详情信息。
UniSkinMod / OfflineSkin / Skin Me
Et Futurum
Optifine
SkinPort
HeadCrumbs
SlimeFun
4.可以使用什么格式的皮肤/披风?
(除高清皮肤外)与原版一致
皮肤: 64*32(单层) 或者 64*64(双层) 或 其整倍数(高清,例如 128*64 128*128)
披风: 64*32 或 其整倍数(高清,例如128*64)
特别注意: 请将22*17的披风自行转换成64*32使用
鞘翅: 直接画在披风上,或独立材质文件(使用本地皮肤或者皮肤站支持)
5.可以将这个皮肤补丁做给其他版本的Minecraft吗?
您可以带上您的版本请求联系我,不过请您注意以下几点:
- CustomSkinLoader从13.1开始,不会再去支持1.7.6以下的版本
- CustomSkinLoader从14.7开始,不会再去支持1.8以下的版本
- 请尽量不要让我去支持每周快照(即CSL原则上只会去支持正式版)
6.可以让这个皮肤补丁支持新的功能吗?
您可以带上您的请求联系我,
不过以下内容除非特别受欢迎,不然不会去支持:
- 动态皮肤(保护眼睛)
- 22*17披风格式(请自行转换成64*32披风格式)
7.这个皮肤补丁支持国服(Minecraft网易版)吗?
支持,但不建议使用且不提供相关技术支持。
6.源代码与传播许可
源代码
GPLv3开源,若您使用或参考CustomSkinLoader的源代码,您的项目必须以GPLv3或更高版本开源,并署上我与原作者的名字。
源代码基本会比编译成品多一些更新内容,欢迎自行编译测试。
源代码:https://github.com/JLChnToZ/MCCustomSkinLoader
为避免混淆,使用代码时必须修改包名。

致皮肤站拥有者与开发者
CustomSkinLoader为其通用性使用了复杂的结构,这并不利于您在CSL的基础上制作您自己的皮肤补丁。
推荐您直接在您的皮肤站使用CSL,CSL也提供了方便的'ExtraList'让用户方便地将您的皮肤站加入列表。
以及,罗马不是一天建成的,如果不是特别需求,非常不建议制作一个新的皮肤补丁。

传播许可
您可以在不经我许可的情况下,以任意方式传播这一mod以及jar文件(例如加入整合包)。
在加入整合包时,请必须在帖子内mod列表中明确写上"万用皮肤补丁"或者"CustomSkinLoader"或者附上本贴地址。
您不得对CustomSkinLoader的成品jar内部内容进行任何修改
您不得在未经许可的情况下,在国内外任何网站进行二次发布(包括皮肤站)。
您不得以任何形式出售CustomSkinLoader或任何使用或参考CustomSkinLoader源代码的作品。

7.过时的内容
14.6a
最终版本1.7.10
13.x
最终版本:1.9.1-1.9.2
10.x-12.x
最终版本:1.6.4 1.7.2-1.7.9
8.0
最终版本1.4.4-1.6.2
实在是太老了,请进入以下贴子查看。
http://www.mcbbs.net/thread-102922-1-1.html


8.结束语
如果您觉得CustomSkinLoader是一个不错的mod,请您将这一mod推荐给您的朋友与身边的人。
如果您感觉对CustomSkinLoader非常失望,请您务必告诉我原因,我会加以改正。
有空去github star一下的话,那更是极好的。
最后,您的回复与评分是对我最大的鼓励(注:加人气不扣自身人气)
如果您愿意支持CustomSkinLoader的发展,欢迎给我打钱
[afd]xfl03[/afd][groupid=1645]Nuclear Fusion[/groupid]