Common issues
Find the cause of a common SkinsRestorer problem.
This page lists common causes of SkinsRestorer problems.
Host-specific issues
Your Minecraft hosting provider can block some SkinsRestorer functions.
Servers with a forced proxy
Some providers, such as Minehut, put each server behind a proxy. Customers cannot always configure this proxy.
If the proxy manages skins and capes, it can override SkinsRestorer. Ask the hosting provider if it can disable the proxy skin system.
Servers with a misconfigured firewall
A hosting firewall can block the SkinsRestorer APIs.
If /sr status reports connection errors, use the firewall guide.
Platform-specific issues
Unsupported server software can cause errors.
Supported platforms
We only support the following platforms:
- Bukkit
- Spigot
- Paper and supported forks, such as Purpur and Pufferfish
- Folia
- BungeeCord (and forks like Waterfall)
- Velocity
- Latest Fabric
- Latest NeoForge
Hybrid platforms such as Magma, Mohist, and Cardboard are not supported.
Plugin-specific issues
Other plugins can change player profiles. These changes can override SkinsRestorer.
Plugins with known issues
Read the incompatibility list. If a plugin is listed, contact its developer.
Client-specific issues
Some launchers include a skin system that overrides server skins. Use the launcher guide to disable that system.
Get more help
If these guides do not correct the problem, contact the SkinsRestorer team:
How is this guide?
Last updated on