- 版权类型
- 原创
- 插件中文名称
- 离线皮肤加载
- 插件英文名称
- NickSkinLoader
- 支持的核心（服务端）
- Paper
- 语言支持
- 中文（简体）
- 适配版本（Java）
- 1.21
一款专为离线模式服务器打造的轻量级皮肤加载插件：进服自动按昵称拉取皮肤，全服可见，无需任何客户端 Mod、无需任何前置插件。
插件简介
离线模式（online-mode=false）下，服务器不会从 Mojang 获取玩家皮肤，所有人在别人眼里都是默认的史蒂夫/亚历克斯。NickSkinLoader 在玩家进服时自动以其游戏昵称查询公开皮肤源，把皮肤材质直接写入玩家实体，服务器内所有在线玩家（包括玩家自己）都能正常看到皮肤，全程服务端完成，客户端零要求。
功能特性
进服自动 加载：玩家进入服务器时自动读取昵称并检索皮肤，无需任何操作
多皮肤源兜底：依次查询 Mojang 官方接口 → MineTools → LittleSkin 皮肤站，任一命中即应用
全服强制可见：皮肤直接写入玩家 GameProfile，新老玩家进服、跑图、重生均正常显示
主动刷新指令：玩家在外部平台换肤后，执行 /updateskin 即可即时刷新，无需重进
重进自动更新：玩家退出时缓存立即失效，下次进服必定拉取最新皮肤
查不到不动：所有皮肤源均无结果时保持默认皮肤，不做任何修改
性能零负担：所有网络请求均在异步线程完成，不卡进服、不掉 TPS；带正/负缓存防止接口轰炸
隐私安全：仅使用玩家昵称查询公开皮肤资源，不上传任何其他数据，无任何后门
即插即用：仅依赖 Paper 服务端本身，无需 ProtocolLib 等任何前置插件
工作原理
玩家连接服务器 → 插件在异步线程按昵称依次查询皮肤源（不阻塞主线程）
在玩家实体生成之前把获取到的 textures 材质（含签名）写入玩家 GameProfile
首批登录包/玩家信息包/实体生成包天然携带皮肤 → 自己和他人进服即可见
运行中刷新（/updateskin）：重新拉取后重发玩家信息与实体生成包刷新他人视角，并通过重生包即时刷新本人 F5 视角（背包、血量、药水、经验等状态完整保留
指令与权限
配置文件（config.yml）
安装方法
服务端要求：Paper 1.21.1（理论兼容 1.20.5+ 的 Paper/其分支），Java 21+
将 NickSkinLoader-1.0.0.jar 放入 plugins 文件夹
重启服务器（不支持热加载）
玩家进服即可自动显示皮肤
插件简介
离线模式（online-mode=false）下，服务器不会从 Mojang 获取玩家皮肤，所有人在别人眼里都是默认的史蒂夫/亚历克斯。NickSkinLoader 在玩家进服时自动以其游戏昵称查询公开皮肤源，把皮肤材质直接写入玩家实体，服务器内所有在线玩家（包括玩家自己）都能正常看到皮肤，全程服务端完成，客户端零要求。
功能特性
进服自动 加载：玩家进入服务器时自动读取昵称并检索皮肤，无需任何操作
多皮肤源兜底：依次查询 Mojang 官方接口 → MineTools → LittleSkin 皮肤站，任一命中即应用
全服强制可见：皮肤直接写入玩家 GameProfile，新老玩家进服、跑图、重生均正常显示
主动刷新指令：玩家在外部平台换肤后，执行 /updateskin 即可即时刷新，无需重进
重进自动更新：玩家退出时缓存立即失效，下次进服必定拉取最新皮肤
查不到不动：所有皮肤源均无结果时保持默认皮肤，不做任何修改
性能零负担：所有网络请求均在异步线程完成，不卡进服、不掉 TPS；带正/负缓存防止接口轰炸
隐私安全：仅使用玩家昵称查询公开皮肤资源，不上传任何其他数据，无任何后门
即插即用：仅依赖 Paper 服务端本身，无需 ProtocolLib 等任何前置插件
工作原理
玩家连接服务器 → 插件在异步线程按昵称依次查询皮肤源（不阻塞主线程）
在玩家实体生成之前把获取到的 textures 材质（含签名）写入玩家 GameProfile
首批登录包/玩家信息包/实体生成包天然携带皮肤 → 自己和他人进服即可见
运行中刷新（/updateskin）：重新拉取后重发玩家信息与实体生成包刷新他人视角，并通过重生包即时刷新本人 F5 视角（背包、血量、药水、经验等状态完整保留
指令与权限
| 指令 | 说明 | 权限 | 默认使用者 |
| /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 官方接口
minetools: true # 2) MineTools 公共接口
littleskin: true # 3) LittleSkin 皮肤站安装方法
服务端要求：Paper 1.21.1（理论兼容 1.20.5+ 的 Paper/其分支），Java 21+
将 NickSkinLoader-1.0.0.jar 放入 plugins 文件夹
重启服务器（不支持热加载）
玩家进服即可自动显示皮肤
