SkinsRestorer 玩家皮肤管理插件

SkinsRestorer 插件介绍
概述
说明：存在两个同名项目。本文介绍的是面向 Bukkit/Spigot/Paper/BungeeCord/Velocity 服务端、在 SpigotMC 与 GitHub 发布的 SkinsRestorer 插件（开源地址 SkinsRestorer/SkinsRestorerX，最新 15.12.2）；它与 Modrinth 上 Lionarius 发布的、面向 Fabric/Forge/NeoForge/Quilt 的 SkinRestorer 服务端模组 是两个不同的项目，请勿混用。

SkinsRestorer 是 Minecraft 最受欢迎的皮肤管理插件之一，自 2012 年起持续维护。它解决的核心问题是：在离线模式（offline/cracked）服务器或代理网络上，玩家皮肤丢失、统一显示为 Steve/Alex 默认皮肤。插件能在玩家加入时自动从 Mojang/Ely.by 拉取并还原皮肤，同时允许玩家通过一条命令自行更换皮肤，且对正版（online）服务器同样适用。
插件名称：SkinsRestorer
团队/维护者：xknat、AlexProgrammerDE（AlexProgrammerDE）、Pistonmaster、SloPlays、mono21400 等
最新版本：15.12.2
许可协议：MIT（开源免费）
支持版本：Minecraft Java Edition 1.7 – 1.8 – 1.9 – 1.10 – 1.11 – 1.12 – 1.13 – 1.14 – 1.15 – 1.16 – 1.17 – 1.18 – 1.19 – 1.20 / 1.20.6 – 1.21 – 26.1
运行平台：CraftBukkit 及其分支（Spigot、Paper、Purpur、TacoSpigot）、Sponge（SpongeVanilla）、BungeeCord 及其分支（Waterfall、FlexPipe）、Velocity
项目地址：
SpigotMC：https://www.spigotmc.org/resources/skinsrestorer.2124/
GitHub：https://github.com/SkinsRestorer/SkinsRestorerX
官网/文档：https://skinsrestorer.net/、https://skinsrestorer.net/docs
核心特性
皮肤还原（Restore）
玩家加入服务器时自动从 Mojang（正版账户）或 Ely.by 拉取并应用皮肤，彻底解决离线模式服务器皮肤丢失、全员 Steve/Alex 的问题。
自动皮肤获取行为可配置开关。
皮肤更换（Change）
玩家只需一条命令即可更换皮肤：/skin <用户名> 套用某正版账户皮肤，/skin url "<图片URL>" 从网络图片生成并应用皮肤，/skin random 随机皮肤。
提供 /skins GUI 菜单，玩家可浏览、预览、收藏并一键应用皮肤，无需记命令。
管理员命令 /sr set、/sr reload、/sr props、/sr drop 等用于管理玩家皮肤数据与调试。
自定义皮肤系统
支持通过 URL 上传/生成自定义皮肤，并可创建服务器全局自定义皮肤条目（/sr createcustom），供全服统一使用。
支持为特定皮肤设置独立权限节点（per-skin permissions），实现 VIP/付费组专属皮肤。
缓存与限流
内置皮肤缓存，避免每次登录都重复请求 Mojang/MineSkin，显著降低外部 API 压力。
对 Mojang 与 MineSkin 请求做限流与批量处理，大型网络在高并发下依然稳定。
可选配置 MineSkin API Key，获得更快、更稳定的皮肤生成配额。
代理网络支持
原生支持 BungeeCord/Bungee 分支与 Velocity 代理网络，后端 Spigot/Paper 与代理端协同工作，跨服皮肤一致且即时更新。
提供后端（backend）与代理（proxy）两套配置，并有代理模式自动检测。
默认皮肤与权限控制
可配置新玩家/非正版玩家的默认皮肤集，也可强制全局默认皮肤。
提供 skinsrestorer.player 等权限节点，可关闭 /skin、/skins 命令注册，按服务器策略精细管控。
多语言与开放生态
支持多语言（locale）翻译，社区维护多种语言文件。
开源（MIT），接受 GitHub 贡献；提供 API 与 PlaceholderAPI 等生态集成，支持 TLauncher 等启动器的兼容性处理。
安装方法
环境要求
Java 8 及以上运行环境
服务器需开放 80（HTTP）/443（HTTPS）/53（DNS）端口出站访问，用于拉取 Mojang/Ely.by/MineSkin 皮肤数据
推荐使用 Paper 或其分支核心（Purpur 等）以获得更好的即时皮肤应用表现（Paper 端可启用 enablePaperJoinListener）
单服务端（Spigot/Paper）安装
从 SpigotMC 资源页或 GitHub Releases 下载最新 SkinsRestorer.jar（团队已不再在 SpigotMC 发布新版，最新构建请以 GitHub Releases 为准）。
将 JAR 文件放入服务端的 plugins/ 目录。
使用 /stop 或 /restart 重启服务器（禁止使用 /reload 或 Plugman，否则会破坏插件）。
插件首次启动后会自动生成 plugins/SkinsRestorer/ 目录及配置文件与语言文件。
按需编辑配置后重启或执行 reload 命令使配置生效。
BungeeCord 网络安装
将 SkinsRestorer.jar 放入每一个 Spigot/Paper 后端服务端的 plugins/ 目录。
同时将 SkinsRestorer.jar 放入 BungeeCord 服务端的 plugins/ 目录。
在每个后端服务端确认 spigot.yml 中 bungeecord: true，并在 Bungee 端 config.yml 中设置 ip_forward: true。
使用 /stop 重启所有服务端。
Velocity 网络安装
将 SkinsRestorer.jar 放入每一个 Paper 后端服务端的 plugins/ 目录，以及每一个 Velocity 服务端的 plugins/ 目录。
在每个 Paper 后端确认 paper.yml 中 velocity-support.enabled: true。
使用 /stop 重启所有服务端，随后在 Velocity 端进行插件配置。
适用场景
离线模式/非正版（cracked）服务器为玩家还原并显示皮肤
希望允许玩家自由更换皮肤（正版/非正版均可）的生存/SMP 服务器
BungeeCord/Velocity 跨服网络中需要统一、即时、可缓存的皮肤管理
需要默认皮肤、VIP 专属皮肤、URL 自定义皮肤等精细化运营控制的社区
相关链接
SpigotMC 资源页：https://www.spigotmc.org/resources/skinsrestorer.2124/
GitHub 源码：https://github.com/SkinsRestorer/SkinsRestorerX
官方网站：https://skinsrestorer.net/
官方文档：https://skinsrestorer.net/docs
贡献者：https://skinsrestorer.net/contributors
捐赠支持：https://skinsrestorer.net/donate