• 欢迎加入MineBBS QQ讨论群:点击查看所有的官方讨论群
  • 我们将于近期对服务器进行迁移,服务可能中断至多2日。请各位安排好自己的访问计划,造成不便敬请谅解!
  • MineBBS入站考试已经上线!想要成为【正式会员】解锁更多功能吗?快来参与吧!【点我去看】
NickSkinLoader — 离线服皮肤加载 | 让离线玩家互相看见皮肤

原创 闭源 NickSkinLoader — 离线服皮肤加载 | 让离线玩家互相看见皮肤 1.4.0

请登录后获取
本次更新跨越多个版本,核心是解决了离线服皮肤的根本限制:皮肤站的材质贴图托管在皮肤站自己的域名下,而 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.插件仅使用玩家昵称查询公开皮肤接口,不上传任何其他数据。
使用中遇到问题欢迎回帖反馈。
后退
顶部 底部