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 |
移除披风映射 |
- 将自己映射到他人等同于重置。
- 映射关系会保存到单个玩家的覆盖配置中并立即生效(无需重新登录)。
- 使用映射时,手臂模型(纤细/宽体)会自动跟随源玩家的皮肤。
配置
游戏中(推荐)
- 安装 ModMenu。
- 打开 Mods → WSkinLoader → Configure(配置)。
- 在五个选项卡下编辑设置:
- 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 按以下顺序解析源:
- 强制自定义 API — 玩家的
useCustomApi 为开启状态,或设置了 skipPremiumCheck → 直接从自定义 API 加载。
- 全局关闭正版优先(
premiumFirst = false)→ 对所有玩家同上。
- 正版优先开启(默认):
- 在
api.mojang.com 查询玩家。
- 非正版 / 未找到 → 回退到自定义 API。
- 正版 → 从 Mojang Session Server 获取纹理并缓存。
- 该账号没有对应类型的皮肤/披风 → 回退到自定义 API。
- Mojang 暂时不可用 →
keepPremiumWhenUnavailable 开启(默认)时保持正版皮肤不变,否则回退。
- 所有来源都失败时,使用原版默认皮肤。
下载的纹理会按「玩家 + 来源」缓存到本地,刷新即时、支持离线。失败的 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 |
清除披风映射 |
- 映射到自己等同于重置。
- 映射会保存到玩家覆盖配置中,立即生效(无需重登)。
- 使用映射时,粗细手臂模型会自动跟随来源玩家的皮肤。
配置
游戏内配置(推荐)
- 安装 ModMenu。
- 打开 模组 → WSkinLoader → 配置。
- 在五个标签页中修改设置:
- 通用: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 按以下顺序解析来源:
- 强制自定义 API — 玩家的
useCustomApi 为开启状态,或设置了 skipPremiumCheck → 直接从自定义 API 加载。
- 全局关闭正版优先(
premiumFirst = false)→ 对所有玩家同上。
- 正版优先开启(默认):
- 在
api.mojang.com 查询玩家。
- 非正版 / 未找到 → 回退到自定义 API。
- 正版 → 从 Mojang Session Server 获取纹理并缓存。
- 该账号没有对应类型的皮肤/披风 → 回退到自定义 API。
- Mojang 暂时不可用 →
keepPremiumWhenUnavailable 开启(默认)时保持正版皮肤不变,否则回退。
- 所有来源都失败时,使用原版默认皮肤。
下载的纹理会按「玩家 + 来源」缓存到本地,刷新即时、支持离线。失败的 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
WSkinLoader
English | 中文
A client-side Minecraft Fabric mod that loads skins and capes from custom APIs (LittleSkin, Blessing Skin, etc.) for offline players, while premium players keep their official Mojang textures. Includes player-to-player texture mapping, a vanilla-style in-game config screen, and a 3D skin preview.
Features
- Premium-first loading strategy (configurable): Mojang textures are loaded first; custom APIs are only used when that account has no skin/cape. Can be turned off to skip Mojang entirely.
- Protection when Mojang is unavailable (configurable): if the Mojang session server is temporarily unreachable, your premium skin is never silently replaced by a third-party one.
- Custom skin/cape APIs: add any number of HTTP(S) APIs, each with a display alias and a
%name% placeholder. APIs are tried in order.
- Per-player overrides: force custom APIs, skip the premium check, choose a fixed API index, or pin a model type (auto / slim / wide).
- Player texture mapping: wear another player's skin or cape with a single command, effective immediately without relogging.
- Vanilla-style config screen: General / Skin API / Cape API / Player Override / Cache tabs, built entirely from vanilla widgets so resource packs and UI mods can restyle it.
- 3D skin preview: drag to rotate, scroll to zoom, model type toggle.
- Tab list heads follow the custom skin shown on the player model.
- Skin source label next to player name tags (e.g. "LittleSkin" / "Premium"), toggleable.
- Cache management: view cached players and clear the cache in-game; changes reload instantly, no relog required.
- Robust networking: 30-second cooldown after failed Mojang lookups, URL encoding for player names, proper connection cleanup.
- Safe config saving: writes to a temp file then atomically replaces the config; older config formats are migrated automatically.
- 10 languages: English, 简体中文, 繁體中文, Deutsch, Español, Français, 日本語, 한국어, Português (Brasil), Русский.
Commands
All commands are client-side; type /wskin to print usage.
| Command |
Effect |
/wskin skin <player> |
Use <player>'s skin as your own |
/wskin cape <player> |
Use <player>'s cape as your own |
/wskin reset skin |
Remove the skin mapping |
/wskin reset cape |
Remove the cape mapping |
- Mapping onto yourself is the same as resetting.
- Mappings are saved to your per-player override config and take effect immediately (no relog).
- When mapping is used, the arm model (slim/wide) automatically follows the source player's skin.
Configuration
In-game (recommended)
- Install ModMenu.
- Open Mods → WSkinLoader → Configure.
- Edit settings under the five tabs:
- General: tab-list heads, name-tag labels, premium-first strategy, fallback behavior.
- Skin API / Cape API: add, edit, reorder, or remove API sources.
- Player Override: per-player rules and skin/cape mapping, with a 3D preview button.
- Cache: cache statistics and "clear all".
Via file
Config file: .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 }
}
}
}
Fields
Global
| Field |
Default |
Description |
enableTabListHeads |
true |
Show player heads in the Tab list, following custom skins. |
enableNameTagLabel |
true |
Show the skin source (API alias or "Premium") next to player name tags. |
premiumFirst |
true |
Try Mojang premium textures first; use custom APIs only as fallback. false = never query Mojang, always use custom APIs. |
keepPremiumWhenUnavailable |
true |
When Mojang is temporarily unreachable, do not fall back to third-party skins. false = allow custom API fallback. |
skinApis / capeApis |
LittleSkin |
List of { "url", "alias" }. The URL must be HTTP/HTTPS and may contain %name%, which is replaced with the player name. |
playerOverrides |
— |
Per-player rules, keyed by player name. |
Per player (playerOverrides.<name>)
| Field |
Default |
Description |
skipPremiumCheck |
false |
Skip the Mojang check and load this player from the custom APIs. |
modelType |
"auto" |
"auto" / "slim" / "wide" for the arm model. |
skinSourcePlayer |
"" |
If non-empty, use this player's skin (same as /wskin skin). |
capeSourcePlayer |
"" |
If non-empty, use this player's cape (same as /wskin cape). |
skin.useCustomApi / cape.useCustomApi |
false |
Force the custom APIs for this texture type. |
skin.apiIndex / cape.apiIndex |
-1 |
0 = first API, 1 = second, … -1 = try all in order. |
Upgrading from an old version? The legacy skinUrls / capeUrls lists and missing new fields are migrated automatically on first load.
Loading strategy
For each texture (skin / cape), WSkinLoader resolves sources in this order:
- Forced custom API — the player's
useCustomApi is on, or skipPremiumCheck is set → load from the custom APIs directly.
- Global premium-first off (
premiumFirst = false) → same as above, for everyone.
- Premium-first on (default):
- Look up the player on
api.mojang.com.
- Not premium / not found → fall back to the custom APIs.
- Premium → fetch textures from the Mojang session server and cache them.
- Account has no skin/cape of that type → fall back to the custom APIs.
- Mojang temporarily unreachable → keep the premium skin untouched if
keepPremiumWhenUnavailable is on (default), otherwise fall back.
- If every source fails, the vanilla default skin is used.
Downloaded textures are cached locally (per player + source), so reloads are instant and offline-friendly. Failed Mojang lookups enter a 30-second cooldown to avoid request spam.
Example setups
Use LittleSkin for everything (offline servers)
"premiumFirst": false
Premium skin + third-party cape for one player
"PlayerName": {
"skipPremiumCheck": false,
"skin": { "useCustomApi": false, "apiIndex": -1 },
"cape": { "useCustomApi": true, "apiIndex": 0 }
}
Wear another player's skin
/wskin skin Notch
or in the config file:
"YourName": {
"skinSourcePlayer": "Notch"
}
中文
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 |
清除披风映射 |
- 映射到自己等同于重置。
- 映射会保存到玩家覆盖配置中,立即生效(无需重登)。
- 使用映射时,粗细手臂模型会自动跟随来源玩家的皮肤。
配置
游戏内配置(推荐)
- 安装 ModMenu。
- 打开 模组 → WSkinLoader → 配置。
- 在五个标签页中修改设置:
- 通用: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 按以下顺序解析来源:
- 强制自定义 API — 玩家的
useCustomApi 开启,或设置了 skipPremiumCheck → 直接从自定义 API 加载。
- 全局关闭正版优先(
premiumFirst = false)→ 对所有玩家同上。
- 正版优先开启(默认):
- 在
api.mojang.com 查询玩家。
- 非正版 / 未找到 → 回退到自定义 API。
- 正版 → 从 Mojang Session Server 获取纹理并缓存。
- 该账号没有对应类型的皮肤/披风 → 回退到自定义 API。
- Mojang 暂时不可用 →
keepPremiumWhenUnavailable 开启(默认)时保持正版皮肤不变,否则回退。
- 所有来源都失败时,使用原版默认皮肤。
下载的纹理会按「玩家 + 来源」缓存到本地,刷新即时、支持离线。失败的 Mojang 查询会进入 30 秒冷却,避免反复请求。
使用场景示例
离线服务器全局使用 LittleSkin
"premiumFirst": false
单个玩家:正版皮肤 + 第三方披风
"PlayerName": {
"skipPremiumCheck": false,
"skin": { "useCustomApi": false, "apiIndex": -1 },
"cape": { "useCustomApi": true, "apiIndex": 0 }
}
穿上其他玩家的皮肤
/wskin skin Notch
或在配置文件中:
"你的名字": {
"skinSourcePlayer": "Notch"
}
许可证
本项目代码采用 All-Rights-Reserved(保留所有权利) 许可发布。
问题反馈:GitHub Issues
评论 0
登录后参与评分
还没有评论,来抢沙发吧