Quick Start Guide

Select your server setup. Then complete the steps in that tab.

Choose your setup

Single Server Setup

Use this setup for one Bukkit, Spigot, or Paper server without a proxy.

Download SkinsRestorer from Modrinth.
Put SkinsRestorer.jar in the plugins folder.
Restart the server.

The default configuration works for a single server.

Optional configuration changes:

# Optional: Set default skins for players without Mojang accounts
storage:
  defaultSkins:
    enabled: true
    list:
      - "<random>"

# Optional: Reduce cooldown for smaller servers
commands:
  skinChangeCooldown: 15

Test the plugin: Run this command in the game.

/skin Notch

Post-installation checklist

After the installation, make sure that each item works:

/skin Notch changes your skin
/skins opens the GUI
Skins stay active after players rejoin
On a proxy network, skins stay active when players switch servers
The console logs contain no errors

Common quick fixes

Issue	Solution
Commands do not work	Grant permission: `/lp user <player> permission set skinsrestorer.player true`
A skin does not apply	Allow connections to `*.skinsrestorer.net` through the firewall
Proxy Mode is not active	Configure player information forwarding
Database errors occur	Make sure that the credentials are correct and MySQL is available