MCL皮肤

MCL皮肤

离线昵称的皮肤,从磁盘加载。没有披风或装饰品。!仅当你拥有TClauncher时!

装饰

MCL Skin

为你的离线昵称准备的皮肤,就在游戏内。

MCL Skin 是 TCLauncher 的游戏内部分。单独使用时,它只做一件事:读取一个已经被放在正确文件夹、正确名称、正确格式下的 PNG,并把它显示在你的角色上。

所有把 PNG 放到那里的工作都属于 TCLauncher:查找皮肤、转换、检查、命名,并为你的加载器和游戏版本安装正确的模组文件。

重要: 该模组在没有 TCLauncher 的情况下仍然可用,但功能少很多。每次更换皮肤时,你必须自己手动完成启动器的工作。

模组的作用

原版 Minecraft 只能从 Mojang 的服务器获取皮肤,而那些服务器不认识你的离线昵称。离线玩家只能停留在 Steve 或 Alex。本模组只修复这一点,且仅此一点。

  • 读取 <instance>/mclskin/skins/<nickname>.png
  • 也读取 <instance>/CustomSkinLoader/LocalSkin/skins/<nickname>.png,供从 CustomSkinLoader 迁移过来的用户使用
  • 在游戏中把该图像显示在你的角色上

一个文件进,一个皮肤出。

没有 TCLauncher: 你需要自己创建该文件。找到皮肤、检查格式、将其重命名为与你的昵称完全一致、找到实例文件夹、创建两个文件夹并放入文件。任何一步出错,你都会保持 Steve,而且没有任何提示告诉你原因。TCLauncher 一键完成所有操作。

皮肤格式

  • 64x64 是现代布局
  • HD 皮肤为 128x128、256x256 或任何 64 的倍数
  • 64x32 是 1.8 之前的旧布局,仍然受支持

模组根据图像本身判断纤细或经典手臂。纤细皮肤在右臂留下两列像素为空,模组会精确检查这两列,包括正面和外侧面。

没有 TCLauncher: 模组读取这些格式,但不做任何转换,且只接受 PNG。JPG、BMP、GIF 或比例错误的皮肤不会显示,而且你不会收到错误提示。TCLauncher 接受 PNG、JPG、BMP 和 GIF,使用最近邻缩放将其缩放到 64x64(因此第二层保持硬边缘),将 64x32 转换为现代布局,判断纤细或经典,并拒绝不是皮肤的图片,同时告诉你原因。

实时重载

  • 文件大约每秒检查一次。
  • 检查使用修改时间以及文件大小,因为复制的文件通常保留原始时间戳。
  • 替换 PNG 后,新皮肤无需重启游戏即可显示。

没有 TCLauncher: 你需要在游戏运行时手动替换文件。TCLauncher 允许你从皮肤库中选择,并先旋转 3D 预览。

适用于所有加载器

1.4 新增。

  • 在 1.4 之前,皮肤仅在 Quilt 和 26.x 的 Fabric 上可靠显示。Forge 直接拒绝该模组文件(其清单使用了仅 NeoForge 的字段),而且即使如此也从未启用模组的钩子。NeoForge 加载 authlib——模组过去挂钩的库——在模组无法更改它的位置,因此钩子静默地从未运行。1.20.3–1.21.8 上的 Fabric 和 Quilt 在启动时崩溃,因为模组调用了只有较新 authlib 版本才有的方法。Forge 和 NeoForge 还以优先 IPv6 启动游戏,本地皮肤地址以游戏拒绝的形式出现。
  • 模组现在挂钩游戏自身的皮肤管理器,通过名称查找对 authlib 的调用,这些名称从不混淆。相同的代码在 Fabric、Quilt、Forge 和 NeoForge 上工作。

其他玩家的皮肤

1.4 新增。

当 TCLauncher 登录其在线配置文件时,它会为你离线昵称选择的皮肤上传,其他使用 TCLauncher 的玩家在同一服务器上可以看到它。你也可以看到他们的。

  • 模组只请求那些自身配置文件没有皮肤的玩家,就像离线模式服务器上一样。真正的 Mojang 皮肤永远不会被替换。
  • 它请求 <server>/api/skins/<nickname>,其中 <server> 是 TCLauncher 写入 settings.json 的地址。如果没有地址,模组从不接触网络。
  • 请求在后台运行,具有短超时,每个昵称最多每几分钟一次。游戏从不等待它们。如果任何失败,该玩家保持默认皮肤。
  • 下载的皮肤缓存在 <instance>/mclskin/cache/ 下按其哈希存储,因此熟悉的皮肤立即出现,且仅当图像更改时才再次下载。
  • 你自己的皮肤仍然直接来自你的磁盘。它立即显示,并且也支持离线。
  • 一个昵称属于一个 TCLauncher 配置文件。如果其他人已经使用了你的,TCLauncher 会告诉你,并且只有你会看到你的皮肤。

没有 TCLauncher: 其他玩家看不到你的皮肤。只有启动器可以上传它,也只有启动器告诉模组在哪里查找其他人的皮肤。

披风

1.5 新增。

  • 读取 <instance>/mclskin/capes/<nickname>.png,标准的 64x32 披风(HD 倍数也可以)
  • 披风显示在你的背上,游戏用同一张图片绘制鞘翅
  • 在 TCLauncher 登录后,其他 TCLauncher 玩家在同一服务器上看到你的披风,你也看到他们的。模组以同样谨慎的方式请求 <server>/api/capes/<nickname>:在后台、短超时、按哈希缓存
  • 真正的 Mojang 披风永远不会被替换。模组只为没有披风的玩家填充

没有 TCLauncher: 你绘制或找到 64x32 披风,并自己放入该文件夹。TCLauncher 有披风目录、披风编辑器和 3D 预览,并为你放置文件。

皮肤透明度

1.0.2 新增。

  • 选项 → 皮肤定制 中的滑块。
  • 0% 是正常皮肤,100% 完全不可见,中间值是幽灵状态。
  • 值保存在 <instance>/mclskin/settings.json 中。

透明度在游戏看到图像之前乘入图像的 alpha 通道。游戏渲染中的任何内容都没有改变,因此它在每个版本和每个加载器上工作相同。

注意:

  • 游戏为会话缓存玩家的皮肤,因此在世界中进行的更改在你重新加入后应用。如果你从主菜单设置,它会立即应用。
  • 在旧的 64x32 布局上,游戏在转换布局时使身体不透明,因此透明度在那里没有效果。
  • 纤细或经典由原始图像决定,从不来自透明副本。

此滑块是模组添加到游戏界面的唯一内容。

启动通知

游戏启动后的第一个屏幕显示一个面板,使用你的语言,解释该模组在没有 TCLauncher 的情况下功能少得多。

  • 使用 关闭 按钮、Esc 或 Enter 关闭它。
  • 勾选 不再显示,它就不会再出现(选择保存在 settings.json 中)。

语言

模组支持 15 种语言,与 TCLauncher 支持的语言相同:

乌克兰语、英语、俄语、白俄罗斯语、波兰语、捷克语、罗马尼亚语、西班牙语、法语、德语、意大利语、土耳其语、日语、中文、菲律宾语。

  • 语言跟随 options.txt 中游戏自身的设置。
  • 如果游戏语言不在列表中,或无法读取 options.txt,模组使用英语。
  • 设置每两秒检查一次,因此切换游戏语言无需重启即可更新模组文本。

皮肤如何到达游戏

游戏不接受皮肤作为文件。它只接受 URL,且其图像加载器只支持 HTTP,因此 file:// 路径不起作用。模组通过以下方式绕过此问题:

  • 它在回环地址 127.0.0.1 上启动一个微型 HTTP 服务器,端口由操作系统选择。你计算机之外的任何东西都无法访问它。
  • 它以图像内容的哈希作为名称提供图像。当皮肤更改时,地址也更改,因此游戏获取新皮肤而不是从缓存显示旧皮肤。
  • 游戏根据允许的 Mojang 域列表检查皮肤 URL。模组不会关闭该检查。它只自行解包自己的皮肤描述,并将其他所有皮肤留给游戏通常的检查。
  • 游戏仅在皮肤标记为已签名时才显示其他玩家的皮肤。模组标记它提供的皮肤,来自你的磁盘或来自 TCLauncher,以便其他玩家的皮肤不会被替换为默认皮肤。

模组不做的事情:

  • 它从不替换真正的 Mojang 皮肤或披风。
  • 它从不上传任何内容。你的皮肤仅通过启动器发送到 TCLauncher 的服务器,且仅在启动器登录时。
  • 在网络上,模组仅下载其他玩家的皮肤和披风,且仅在 TCLauncher 配置了服务器时。每个请求仅包含该玩家的昵称。

兼容性

  • 加载器: Fabric、Forge、NeoForge、Quilt
  • 版本: Minecraft 1.14 到 26.3
  • 156 个文件,每个加载器和版本对对应一个
  • 仅客户端。 服务器不需要它。
  • 需要模组加载器。它不能在纯原版中工作。

模组不使用映射,也从不按名称引用游戏方法。其钩子通过方法签名和游戏对 authlib 的调用来放置,这就是为什么三个构建覆盖约五十个游戏版本和四个加载器。如果出现它无法识别方法的版本,模组会跳过其界面添加,皮肤继续工作。它不会使游戏崩溃。

没有 TCLauncher: 你必须自己从 156 个文件中挑选正确的。如果你选错了,它不会加载,也不会告诉你太多。TCLauncher 知道每个实例的加载器和版本,并自行安装匹配的文件。

TCLauncher 添加的功能

这些功能属于启动器,而非模组:

  • 一个皮肤库,将所有皮肤保存在一个地方,并支持离线工作
  • 一个完整的 3D 模型预览,你可以用鼠标旋转
  • 按昵称获取: 从 Mojang 的公共 API 获取任何正版玩家的皮肤
  • 从文件添加皮肤,或将图像拖入窗口
  • 自动转换 PNG、JPG、BMP 和 GIF,包括 64x32 → 64x64 和 HD 重缩放
  • 当图像不是皮肤时给出清晰的错误消息
  • 将模组本身安装到正确的实例中,使用正确的构建
  • 对于 Microsoft 账户,将皮肤上传到 Minecraft 自己的皮肤服务,以便正版服务器上的每个玩家都能看到它
  • 对于离线昵称,将皮肤上传到 TCLauncher 的服务器,以便其他 TCLauncher 玩家看到它,并告诉模组在哪里获取他们的皮肤
  • 从实例中移除皮肤,无需寻找文件

它创建的文件

路径 内容
<instance>/mclskin/skins/<nickname>.png 你的皮肤(由 TCLauncher 放置)
<instance>/mclskin/capes/<nickname>.png 你的披风(由 TCLauncher 放置)
<instance>/mclskin/settings.json 透明度级别、启动通知是否已关闭,以及 TCLauncher 写入的服务器地址
<instance>/mclskin/cache/ 其他玩家的皮肤和披风,按其哈希保存,以及哪个昵称使用哪个的列表

不写入其他内容。模组从不上传任何内容。它仅下载其他玩家的皮肤和披风,且仅从 TCLauncher 配置的服务器下载。


MCL Skin 1.5 是 TCLauncher 的一部分。作者:tcleo。仅客户端。保留所有权利。