> ## Documentation Index
> Fetch the complete documentation index at: https://support.zonely.gen.tr/llms.txt
> Use this file to discover all available pages before exploring further.

# SkinsRestorer

> SkinsRestorer is a plugin that allows players on offline Minecraft servers to change their appearance (skin). Players can choose any skin they want, independent of Minecraft’s default skin system. With the integrated web system, users can also change their skins directly from the website, ensuring consistent appearance both in-game and online.

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/](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:

```yaml theme={null}
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:

```yaml theme={null}
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**:

<Steps>
  <Step title="Upload the skin file">
    Upload your custom skin file (`.png` format, 64x64 pixels) to your server directory:

    `/plugins/SkinsRestorer/skins/`
  </Step>

  <Step title="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`
  </Step>

  <Step title="Add the skin tag to the default list">
    Go back to `config.yml` and add your custom skin tag to the default skins list:

    ```yaml theme={null}
    storage:
        defaultSkins:
            enabled: true
            applyForPremium: false
            list:
              - Zonely
              - WhiteEffect
              - CustomSkin # Your uploaded skin
    ```
  </Step>

  <Step title="Apply the changes">
    Run the following command on your server to activate the changes:

    `/skinsrestorer reload`
  </Step>
</Steps>

<Check>
  Now, each time players join the server, their assigned default or custom skins will apply automatically.
</Check>