Troubleshooting

Basic Troubleshoot

Basic Spigot Troubleshooting

1. Check the Basic Installation (opens in a new tab) steps and see if they're the same for your server

2. Remove your ./plugins/SkinsRestorer/plugin.yml & Messages.yml files

3. Update the plugin if needed! (SpigotMC) (opens in a new tab)

4. Restart the server and see if this resolved your issue

Basic BungeeCord Troubleshooting

1. Check the Basic Installation steps and see if they're the same for your server

2. IF you did configure spigot than remove the SkinsRestorer config.yml [SkinsRestorer should never make a config on spigot, if it does your spigot is not set to bungee mode!!]

3. Update the plugin if needed on BungeeCord (SpigotMC) (opens in a new tab)

4. restart the server and see if this resolved your issue

Advanced Troubleshoot

Commands not working

If commands aren't working, you need to make sure that you did follow our specific installation instructions. If it still doesn't work, try removing the config and messages and restart your bungee and if not bungee your spigot server. For perms check our permission section.

Plugin incompatibility

Some not well-coded plugins or plugins that modify the user profile mightn't work well with SkinsRestorer. You can see this when you, for example, change a skin, and you see the chunks reload but your skin just won't apply...

List of known incompatibility's:

• MundoSK
• scripting plugins in general
• some mods
• plugins that use ProtocoLib

To figure out IF it's a plugin incompatibility the best thing to do is running your server with SkinsRestorer as the only plugin and see if it then works. If so, you can try adding plugins and check each time if the plugin still works. This way you can identify the plugin that might cause this.

Server Incompatibility

We don't support forge, only CatServer some times..

we also don't support FlameCord as they change the loginresult.Property somehow and the sourcecode can't be found.

Connection

SkinsRestorer needs connection to download skin data, you can test your current connection using /sr status

How are you hosting your server? [ Local / Minecraft server hosting (panel) / VPS & Dedicated server hosting (root access) ]

Resolve Local Firewall

Resolve Local Firewall Linux

Resolve Local Firewall Windows

Resolve MC Provider Firewall

When you only have access to a panel like multicraft or cpanel, you aren't able to change firewall settings.

If you do have access to ssh / root command line, go to -> Dedicated server

Use the below template to create a ticket / send @ to your Minecraft hosting provider

Firewall issues - this is a email template copied from github:SkinsRestorer/SkinsRestorerX

Dear Mc-Service provider,

I believe that your firewall setup is restricting one of my plugins to work properly, namely, SkinsRestorer.
In order to allow it to function properly, I need to be able to open new outgoing connections to specific HTTP API services. You can see the list of required traffic at https://github.com/SkinsRestorer/SkinsRestorerX/wiki/Troubleshooting#firewall-passthrough-requirements.

I kindly request that you permit such traffic for all Minecraft hosting services associated with my account.

If you have any questions, feel free to contact SkinsRestorer's team via:
Discord - https://skinsrestorer.net/discord
Email - support@skinsrestorer.net

Kind regards.

Resolve dedicated server Firewall

The following script should allow new and established connections.

sudo iptables -I INPUT 1  -p udp -m state --state ESTABLISHED     -j ACCEPT
sudo iptables -I INPUT 1 -p tcp -m state --state ESTABLISHED     -j ACCEPT
sudo iptables -I OUTPUT 1 -p tcp -m state --state NEW,ESTABLISHED -j ACCEPT
sudo iptables -I OUTPUT 1 -p udp -m state --state NEW,ESTABLISHED -j ACCEPT
sudo update-ca-certificates -f
sudo /var/lib/dpkg/info/ca-certificates-java.postinst configure

Or you can see Firewall pass through requirements to manually allow api.

Firewall pass through requirements

All the required rules are outgoing, the only incoming traffic that should be accepted is the one from already established connections. Your server must be able to connect to the other networks. SkinsRestorer doesn't** require any incoming traffic from new connections to be accepted.