Quick Start Guide
Get SkinsRestorer running quickly with configuration templates for different setups.
Choose your setup type below for a quick configuration guide.
Choose your setup
Single Server Setup
For standalone Bukkit/Spigot/Paper servers without a proxy.
Steps:
- Download SkinsRestorer from Modrinth
- Place
SkinsRestorer.jarin yourpluginsfolder - Restart your server
- Done! The default config works out of the box
Recommended config tweaks:
# Optional: Set default skins for players without Mojang accounts
storage:
defaultSkins:
enabled: true
list:
- "<random>"
# Optional: Reduce cooldown for smaller servers
commands:
skinChangeCooldown: 15Test it:
/skin NotchPost-installation checklist
After installing, verify:
-
/skin Notchchanges your skin -
/skinsopens the GUI - Skins persist after rejoining
- (Proxy) Skins persist when switching servers
- No errors in console logs
Common quick fixes
| Issue | Solution |
|---|---|
| Commands don't work | Check permissions: /lp user <player> permission set skinsrestorer.player true |
| Skin doesn't apply | Check firewall allows connections to *.skinsrestorer.net |
| Proxy mode not detected | Verify player information forwarding is configured |
| Database errors | Check credentials and that MySQL is accessible |
Next steps
How is this guide?
Last updated on