本次更新跨越多个版本,核心是解决了离线服皮肤的根本限制:皮肤站的材质贴图托管在皮肤站自己的域名下,而 Minecraft
原版客户端只信任 Mojang 官方域名的材质,导致皮肤站皮肤在纯净客户端上显示为默认皮肤。v1.4.0 采用与 SkinsRestorer 相同的方案
彻底解决了这个问题。
一、材质自动搬运(v1.4.0 新增)
皮肤站材质会自动经 MineSkin 转换为 Mojang 官方签名材质,原版客户端无需安装任何 Mod 或补丁即可直接显示皮肤站皮肤。转换失败时自动启用哈希匹配备用通道,仍失败则回退原始材质(装有皮肤补丁的客户端仍然可见)。Mojang 官方材质本就在白名单内,无需搬运,不占用任何资源。可在配置文件中填写 MineSkin API Key 提升转换速率,不填也能正常使用。
二、智能限流排队(v1.4.0 新增)
每分钟最多为 10 名玩家执行材质搬运(可在配置中自行修改),
正版玩家不受影响、不占用名额。超出限额的玩家按申请时间自动排队,并收到实时位置提示,例如:您当前正在皮肤加载排队队列中,当前位于第 1 位,当 14时52分33秒 将会为您加载皮肤。轮到后
自动完成搬运并刷新皮肤,全程无需玩家操作,不阻塞进服。
三、新增皮肤源(v1.3.0 新增)
皮肤源兜底链
扩充至 6 个,全部可单独开关,检索顺序为:Mojang 官方 → LittleSkin → 红石皮肤站 → HelloSkin → CelestiaSkin → MineTools → 自定义皮肤站。新增 HelloSkin(helloskin.cn)与 CelestiaSkin 群星联盟皮肤站(skin.mcstaralliance.com)。/updateskin helloskin、/updateskin celestiaskin 可
直接指定来源,
支持Tab
补全。
新增权限:
| 指令 | 作用 | 权限 | 默认使用者 |
| /updateskin [皮肤站] | 从指定皮肤站拉取并刷新自己的皮肤(30秒冷却) | nickskin.updateskin | 所有人 |
四、完整配置文件(config.yml)
老用户请删除旧配置文件后重启生成新配置,或按下文手动补加新增段落:
YAML:
request:
connect-timeout-ms: 3000 # HTTP 连接超时(毫秒)
read-timeout-ms: 3000 # HTTP 读取超时(毫秒)
cache:
expire-minutes: 10 # 皮肤查询结果缓存时间(退出即失效,重进必重新拉取)
negative-expire-seconds: 60 # 查询失败缓存,防止接口被频繁请求
command:
cooldown-seconds: 30 # /updateskin 指令冷却时间(秒)
providers:
mojang: true # 1) Minecraft 官方接口
littleskin: true # 2) LittleSkin 皮肤站(littleskin.cn)
redstone: true # 3) 红石皮肤站(mcskin.com.cn)
helloskin: true # 4) 新增:HelloSkin 皮肤站(helloskin.cn)
celestiaskin: true # 5) 新增:CelestiaSkin 群星联盟皮肤站(skin.mcstaralliance.com)
minetools: true # 6) MineTools 公共皮肤接口
custom: [] # 7) 自定义 Yggdrasil 皮肤站列表,按顺序兜底
# - id: myskin
# name: 我的皮肤站
# url: https://skin.example.com/api/yggdrasil
# 新增:材质搬运。把皮肤站材质转换为 Mojang 官方签名材质,原版客户端直接可见
relay:
enabled: true # 材质搬运总开关
mineskin-api-key: "" # 可选:MineSkin API Key,填写后转换速率更高,不填也能用
hash-fallback: true # 备用通道:MineSkin 不可用时用贴图哈希匹配 Mojang CDN 已有材质
max-per-minute: 10 # 每分钟最多搬运人数,超出的玩家按申请时间排队,可自行修改
五、注意事项
1.MineSkin 无法搬运披风,
仅保留皮肤本体 (正版玩家不受影响)。
2.首次转换需
1 至 3 秒,皮肤缓存后再次进服即时显示。
3.服务端要求
Paper 1.21.1(理论兼容 1.20.5+),Java 21 及以上。
4.插件仅使用玩家昵称查询公开皮肤接口,不上传任何其他数据。
使用中遇到问题欢迎回帖反馈。