Skip to main content
Before integrating your website with SkinsRestorer, make sure you are using the latest official version. You can download the newest SkinsRestorer release here:
https://www.spigotmc.org/resources/skinsrestorer.2124/

1. Connect the plugin to the database

First, open the /plugins/SkinsRestorer/config.yml file in your server’s main directory. Edit the database configuration section as shown below:

2. Set default skins for player login

When players join the server, premium account holders can display their original skins. For non-premium players, you can assign custom default skins. This helps enhance visual variety and improve player interaction on your server.
To do this, open the /plugins/SkinsRestorer/config.yml file and find the section below:
You can add Minecraft usernames directly to the list: section or include custom uploaded skins.

3. Upload and use your own custom skins

Follow the steps below to add custom skins without depending on usernames:
1

Upload the skin file

Upload your custom skin file (.png format, 64x64 pixels) to your server directory:/plugins/SkinsRestorer/skins/
2

Add the skin to SkinsRestorer

In-game, use the command below to load your skin and assign it a tag:/sr skin upload <skin> <skinname.png>Example:/sr skin upload CustomSkin /plugins/SkinsRestorer/skins/customskin.png
3

Add the skin tag to the default list

Go back to config.yml and add your custom skin tag to the default skins list:
4

Apply the changes

Run the following command on your server to activate the changes:/skinsrestorer reload
Now, each time players join the server, their assigned default or custom skins will apply automatically.