皮肤与披风

SkinsAndCapes

一个客户端模组，从您控制的HTTP源加载玩家皮肤和披风（按用户名/UUID）——支持高清纹理、GIF/APNG动画，在Minecraft 1.7.10到1.21.1版本中共享同一引擎。

如果您的任何配置源都没有为玩家返回内容，则保持其原始皮肤不变。模组不内置Mojang或第三方回退机制；它仅显示您源提供的内容。

仅客户端——服务器上无需安装任何内容。

安装

1. 从Releases获取与您的Minecraft版本和加载器对应的jar文件，并将其放入mods/文件夹。
2. 如果模组有运行时依赖，请添加：
   • 1.7.10 — UniMixins
   • 1.12.2 — MixinBooter
   • Fabric版本 — Fabric API
   • Forge 1.19/1.20.1和NeoForge 1.21.1无需额外内容。
3. 启动游戏一次。模组会创建一个禁用的配置文件config/skinsandcapes.json；编辑它（参见下文）以指向您的源。

配置

所有设置都位于config/skinsandcapes.json中。loadlist初始为空，这意味着模组不进行任何更改。添加一个或多个源以启用它。游戏运行时编辑内容会被重新读取——无需重启。

任何URL都可以包含{nickname}、{uuid}或{uuid_dashed}。

直接源

直接指向完成的纹理：

{
  "enableSkin": true,
  "enableCape": true,
  "enableAnimation": true,
  "hdMaxResolution": 512,
  "loadlist": [
    {
      "name": "my-cdn",
      "type": "direct",
      "priority": 100,
      "skin": "https://example.com/skins/{nickname}.png",
      "cape": "https://example.com/capes/{nickname}.png",
      "model": "auto"
    }
  ]
}

model为auto（从纹理自动检测纤细与宽大模型）、slim或wide。

API源

指向一个告诉模组纹理位置的端点。format为json、text或redirect：

{
  "name": "my-api",
  "type": "api",
  "priority": 200,
  "url": "https://example.com/api/{uuid}",
  "format": "json",
  "json": { "skin": "textures.skin.url", "cape": "textures.cape.url", "model": "textures.skin.model" }
}

当有多个源时，将从最低的priority值开始尝试，第一个返回纹理的源胜出。

其他键

键	默认值	含义
enableSkin / enableCape	true	是否覆盖皮肤/披风。
enableAnimation	true	播放GIF/APNG动画；关闭时仅显示第一帧。
hdMaxResolution	512	大于此尺寸（每边像素）的纹理将被缩小。
cacheTtlSeconds	90	解析后的URL在被重新检查源之前，重复使用的时间（秒）。
assetCacheDays	30	下载的纹理在磁盘上保留的时间（天）。
loadlistUrl	""	可选的URL，用于从外部拉取loadlist，而不是内联列出源。