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: 
database:
    enabled: true
    host: DATABASE_HOST
    port: DATABASE_PORT
    database: DATABASE_NAME
    username: DATABASE_USERNAME
    password: DATABASE_PASSWORD
    maxPoolSize: 30
    tablePrefix: zonely_
    connectionOptions: sslMode=disable&serverTimezone=UTC

​
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: 
storage:
    defaultSkins:
        enabled: true # Enables default skins.
        applyForPremium: false # Apply default skins to premium users?
        list: # Default skin names or custom uploaded skin tags
        - Zonely
        - WhiteEffect
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:
storage:
    defaultSkins:
        enabled: true
        applyForPremium: false
        list:
          - Zonely
          - WhiteEffect
          - CustomSkin # Your uploaded skin
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.