WSkinLoader

模组

· 作者 wupengabc

一个用于 Minecraft 的离线皮肤补丁,允许离线玩家加载自定义皮肤和披风,同时保持对正版玩家官方皮肤系统的兼容。

0 本站下载 0 关注 更新于 1 个月前

最新 1.6.2 · 1.20.6 · Fabric

一键开服(送7天)

WSkinLoader

English | 中文

一款 客户端 Minecraft Fabric 模组,可为离线玩家从 自定义 API(如 LittleSkin、Blessing Skin 等) 加载皮肤和披风,同时 正版玩家保留其官方 Mojang 纹理。包含玩家间纹理映射、类原版的内置游戏配置界面以及 3D 皮肤预览功能。


功能特性

  • 正版优先加载策略(可配置):优先加载 Mojang 纹理;仅当该账号没有皮肤/披风时才使用自定义 API。可关闭此功能以完全跳过 Mojang。
  • Mojang 不可用时的保护机制(可配置):如果 Mojang 会话服务器暂时无法访问,你的正版皮肤绝不会静默被第三方皮肤替换。
  • 自定义皮肤/披风 API:添加任意数量的 HTTP(S) API,每个 API 均可设置显示别名和 %name% 占位符。API 按顺序依次尝试。
  • 单个玩家覆盖设置:强制使用自定义 API、跳过正版检查、选择固定的 API 索引,或锁定模型类型(自动 / 纤细 / 宽体)。
  • 玩家纹理映射:通过一条命令穿戴其他玩家的皮肤或披风,立即生效,无需重新登录。
  • 类原版配置界面:包含“常规”、“皮肤 API”、“披风 API”、“玩家覆盖”和“缓存”五个选项卡,完全基于原版小部件构建,因此资源包和 UI 模组可以对其重新样式化。
  • 3D 皮肤预览:支持拖拽旋转、滚轮缩放以及模型类型切换。
  • Tab 列表头像跟随玩家模型上显示的自定义皮肤。
  • 皮肤来源标签显示在玩家名称标签旁边(例如“LittleSkin”/“Premium”),可切换开关。
  • 缓存管理:在游戏中查看已缓存的玩家并清除缓存;更改即时重载,无需重新登录。
  • 稳健的网络处理:Mojang 查找失败后设有 30 秒冷却时间,对玩家名称进行 URL 编码,并正确处理连接清理。
  • 安全的配置保存:先写入临时文件然后原子替换配置文件;旧版配置格式会在首次加载时自动迁移。
  • 10 种语言:English, 简体中文, 繁體中文, Deutsch, Español, Français, 日本語, 한국어, Português (Brasil), Русский.

指令

所有指令均为客户端指令;输入 /wskin 可查看用法。

指令 效果
/wskin skin <player> 将 <player> 的皮肤用作你自己的
/wskin cape <player> 将 <player> 的披风用作你自己的
/wskin reset skin 移除皮肤映射
/wskin reset cape 移除披风映射
  • 将自己映射到他人等同于重置。
  • 映射关系会保存到单个玩家的覆盖配置中并立即生效(无需重新登录)。
  • 使用映射时,手臂模型(纤细/宽体)会自动跟随源玩家的皮肤。

配置

游戏中(推荐)

  1. 安装 ModMenu。
  2. 打开 Mods → WSkinLoader → Configure(配置)。
  3. 在五个选项卡下编辑设置:
    • General(常规):Tab 列表头像、名称标签标签、正版优先策略、回退行为。
    • Skin API(皮肤 API)/ Cape API(披风 API):添加、编辑、重排或删除 API 源。
    • Player Override(玩家覆盖):单个玩家规则及皮肤/披风映射,附带 3D 预览按钮。
    • Cache(缓存):缓存统计信息和“全部清除”。

通过文件

配置文件:.minecraft/config/wskinloader.json

{
  "enableTabListHeads": true,
  "enableNameTagLabel": true,
  "premiumFirst": true,
  "keepPremiumWhenUnavailable": true,
  "skinApis": [
    { "url": "https://littleskin.cn/skin/%name%.png", "alias": "LittleSkin" }
  ],
  "capeApis": [
    { "url": "https://littleskin.cn/cape/%name%.png", "alias": "LittleSkin" }
  ],
  "playerOverrides": {
    "PlayerName": {
      "skipPremiumCheck": false,
      "modelType": "auto",
      "skinSourcePlayer": "",
      "capeSourcePlayer": "",
      "skin":   { "useCustomApi": false, "apiIndex": -1 },
      "cape":   { "useCustomApi": false, "apiIndex": -1 }
    }
  }
}

字段说明

全局设置

字段 默认值 描述
enableTabListHeads true 在 Tab 列表中显示玩家头像,跟随自定义皮肤。
enableNameTagLabel true 在玩家名称标签旁显示皮肤来源(API 别名或“Premium”)。
premiumFirst true 优先尝试 Mojang 正版纹理;仅在作为回退时使用自定义 API。设为 false = 从不查询 Mojang,始终使用自定义 API。
keepPremiumWhenUnavailable true 当 Mojang 暂时无法访问时,不回退到第三方皮肤。设为 false = 允许自定义 API 回退。
skinApis / capeApis LittleSkin { "url", "alias" } 列表。URL 必须是 HTTP/HTTPS,并可包含 %name%,它将被替换为玩家名称。
playerOverrides — 单个玩家规则,以玩家名称为键。

单个玩家设置 (playerOverrides.<name>)

字段 默认值 描述
skipPremiumCheck false 跳过 Mojang 检查并从自定义 API 加载该玩家。
modelType "auto" 手臂模型的类型:"auto"(自动)/ "slim"(纤细)/ "wide"(宽体)。
skinSourcePlayer "" 如果非空,则使用该玩家的皮肤(与 /wskin skin 相同)。
capeSourcePlayer "" 如果非空,则使用该玩家的披风(与 /wskin cape 相同)。
skin.useCustomApi / cape.useCustomApi false 强制对该纹理类型使用自定义 API。
skin.apiIndex / cape.apiIndex -1 0 = 第一个 API,1 = 第二个 API,… -1 = 按顺序尝试所有 API。

从旧版本升级?旧的 skinUrls / capeUrls 列表以及缺失的新字段会在首次加载时自动迁移。


加载策略

对于每种纹理(皮肤/披风),WSkinLoader 按以下顺序解析源:

  1. 强制自定义 API — 玩家的 useCustomApi 为开启状态,或设置了 skipPremiumCheck → 直接从自定义 API 加载。
  2. 全局关闭正版优先(premiumFirst = false)→ 对所有玩家同上。
  3. 正版优先开启(默认):
    • 在 api.mojang.com 查询玩家。
    • 非正版 / 未找到 → 回退到自定义 API。
    • 正版 → 从 Mojang Session Server 获取纹理并缓存。
      • 该账号没有对应类型的皮肤/披风 → 回退到自定义 API。
      • Mojang 暂时不可用 → keepPremiumWhenUnavailable 开启(默认)时保持正版皮肤不变,否则回退。
  4. 所有来源都失败时,使用原版默认皮肤。

下载的纹理会按「玩家 + 来源」缓存到本地,刷新即时、支持离线。失败的 Mojang 查询会进入 30 秒冷却,避免反复请求。


示例配置

离线服务器全局使用 LittleSkin

"premiumFirst": false

单个玩家:正版皮肤 + 第三方披风

"PlayerName": {
  "skipPremiumCheck": false,
  "skin":   { "useCustomApi": false, "apiIndex": -1 },
  "cape":   { "useCustomApi": true,  "apiIndex": 0 }
}

穿上其他玩家的皮肤

/wskin skin Notch

或在配置文件中:

"YourName": {
  "skinSourcePlayer": "Notch"
}

Chinese

English | 中文

一个 Minecraft Fabric 客户端模组:为离线玩家从自定义 API(LittleSkin、Blessing Skin 等)加载皮肤和披风,同时正版玩家继续使用 Mojang 官方纹理。支持玩家间皮肤/披风映射、原版风格的游戏内配置界面和 3D 皮肤预览。


功能特性

  • 正版优先加载策略(可配置):默认优先加载 Mojang 正版皮肤/披风,只有该账号没有对应纹理时才使用自定义 API;关闭后完全跳过 Mojang。
  • Mojang 不可用保护(可配置):Mojang 服务暂时不可用时,不会用第三方皮肤覆盖正版皮肤。
  • 自定义皮肤/披风 API:可添加任意多个 HTTP(S) API,支持显示别名和 %name% 占位符,按顺序回退加载。
  • 玩家级覆盖:强制使用自定义 API、跳过正版检测、指定 API 索引、固定模型类型(自动 / 纤细 / 宽体)。
  • 玩家纹理映射:一条命令穿上其他玩家的皮肤或披风,立即生效、无需重登。
  • 原版风格配置界面:通用 / 皮肤 API / 披风 API / 玩家覆盖 / 缓存 五个标签页,全部使用原版控件,可被资源包和界面模组一同美化。
  • 3D 皮肤预览:拖拽旋转、滚轮缩放、模型类型切换。
  • Tab 列表头像:与玩家模型上显示的自定义皮肤保持一致。
  • 皮肤来源标签:在玩家名称标签旁显示皮肤来源(如 "LittleSkin" / "正版"),可关闭。
  • 缓存管理:游戏内查看缓存玩家并一键清除;修改后立即刷新,无需重进游戏。
  • 稳健的网络请求:Mojang 查询失败后 30 秒冷却、玩家名 URL 编码、连接正确关闭。
  • 安全的配置保存:先写临时文件再原子替换;旧版配置自动迁移。
  • 10 种语言:简体中文、繁體中文、英语、德语、西班牙语、法语、日语、韩语、巴西葡萄牙语、俄语。

命令

所有命令均为客户端命令;输入 /wskin 可查看用法。

命令 效果
/wskin skin <玩家> 使用该玩家的皮肤
/wskin cape <玩家> 使用该玩家的披风
/wskin reset skin 清除皮肤映射
/wskin reset cape 清除披风映射
  • 映射到自己等同于重置。
  • 映射会保存到玩家覆盖配置中,立即生效(无需重登)。
  • 使用映射时,粗细手臂模型会自动跟随来源玩家的皮肤。

配置

游戏内配置(推荐)

  1. 安装 ModMenu。
  2. 打开 模组 → WSkinLoader → 配置。
  3. 在五个标签页中修改设置:
    • 通用:Tab 头像、名称标签、正版优先策略、不可用回退行为。
    • 皮肤 API / 披风 API:添加、编辑、排序或删除 API 源。
    • 玩家覆盖:按玩家配置规则和皮肤/披风映射,附 3D 预览按钮。
    • 缓存:缓存统计与"全部清除"。

通过配置文件

配置文件:.minecraft/config/wskinloader.json

{
  "enableTabListHeads": true,
  "enableNameTagLabel": true,
  "premiumFirst": true,
  "keepPremiumWhenUnavailable": true,
  "skinApis": [
    { "url": "https://littleskin.cn/skin/%name%.png", "alias": "LittleSkin" }
  ],
  "capeApis": [
    { "url": "https://littleskin.cn/cape/%name%.png", "alias": "LittleSkin" }
  ],
  "playerOverrides": {
    "玩家名": {
      "skipPremiumCheck": false,
      "modelType": "auto",
      "skinSourcePlayer": "",
      "capeSourcePlayer": "",
      "skin":   { "useCustomApi": false, "apiIndex": -1 },
      "cape":   { "useCustomApi": false, "apiIndex": -1 }
    }
  }
}

字段说明

全局

字段 默认值 说明
enableTabListHeads true 在 Tab 列表显示玩家头像,并跟随自定义皮肤。
enableNameTagLabel true 在玩家名称标签旁显示皮肤来源(API 别名或"正版")。
premiumFirst true 优先使用 Mojang 正版纹理,自定义 API 仅作回退;false = 不查询 Mojang,直接使用自定义 API。
keepPremiumWhenUnavailable true Mojang 暂时不可用时不回退到第三方皮肤;false = 允许回退到自定义 API。
skinApis / capeApis LittleSkin { "url", "alias" } 列表。URL 必须为 HTTP/HTTPS,可包含 %name%(替换为玩家名)。
playerOverrides — 按玩家名配置覆盖规则。

玩家级(playerOverrides.<玩家名>)

字段 默认值 说明
skipPremiumCheck false 跳过正版检测,直接从自定义 API 加载该玩家。
modelType "auto" 手臂模型:"auto" / "slim"(纤细)/ "wide"(宽体)。
skinSourcePlayer "" 非空时使用该玩家的皮肤(同 /wskin skin)。
capeSourcePlayer "" 非空时使用该玩家的披风(同 /wskin cape)。
skin.useCustomApi / cape.useCustomApi false 对应纹理类型强制使用自定义 API。
skin.apiIndex / cape.apiIndex -1 0 = 第一个 API,1 = 第二个,…… -1 = 按顺序尝试全部。

从旧版本升级?旧的 skinUrls / capeUrls 列表和缺失的新字段会在首次加载时自动迁移。


工作原理

对每个纹理(皮肤 / 披风),WSkinLoader 按以下顺序解析来源:

  1. 强制自定义 API — 玩家的 useCustomApi 为开启状态,或设置了 skipPremiumCheck → 直接从自定义 API 加载。
  2. 全局关闭正版优先(premiumFirst = false)→ 对所有玩家同上。
  3. 正版优先开启(默认):
    • 在 api.mojang.com 查询玩家。
    • 非正版 / 未找到 → 回退到自定义 API。
    • 正版 → 从 Mojang Session Server 获取纹理并缓存。
      • 该账号没有对应类型的皮肤/披风 → 回退到自定义 API。
      • Mojang 暂时不可用 → keepPremiumWhenUnavailable 开启(默认)时保持正版皮肤不变,否则回退。
  4. 所有来源都失败时,使用原版默认皮肤。

下载的纹理会按「玩家 + 来源」缓存到本地,刷新即时、支持离线。失败的 Mojang 查询会进入 30 秒冷却,避免反复请求。


使用场景示例

离线服务器全局使用 LittleSkin

"premiumFirst": false

单个玩家:正版皮肤 + 第三方披风

"PlayerName": {
  "skipPremiumCheck": false,
  "skin":   { "useCustomApi": false, "apiIndex": -1 },
  "cape":   { "useCustomApi": true,  "apiIndex": 0 }
}

穿上其他玩家的皮肤

/wskin skin Notch

或在配置文件中:

"YourName": {
  "skinSourcePlayer": "Notch"
}

许可证

本项目代码采用 All-Rights-Reserved(保留所有权利) 许可发布。

问题反馈:GitHub Issues

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源