Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for SRTeam

Ability to restore/change skins on servers! (Offline and Online Mode)

Report SkinsRestorer?


Join us at our Discord server for support :)

Completely working from 1.8 till 1.19.4 Spigot!
IF you use Tlauncher, turn "Use Skins" OFF under account settings

Wiki | Discord Support Chat | DEV build | Source


Useful tools for custom skins:

SkinFile Generator

With SkinFile Generator you can upload your own custom .png skin to get a unique .skin file that you can put in your skins folder. Check it out here: https://skinsrestorer.github.io/SkinFile-Generator/


SkinSystem is a website that can interact with AuthMe (and forum) to allow users to upload, manage, view and select custom skins on a website. Check it out here: https://github.com/SkinsRestorer/SkinSystem

What is SkinsRestorer?

SkinsRestorer is a plugin that restores skins for offline mode servers & networks that gives the players ability to change their skins by typing a single command.

Any videos about SkinsRestorer?

Yes. There are videos about SkinsRestorer in French, Spanish, German, Italian and portuguese!


(They might be outdated!)


@YouTube Spanish @YouTube German @YouTube Italian @YouTube Português @YouTube Nederlands @YouTube**

Where can I use SkinsRestorer?

Currently, you can use SkinsRestorer on these platforms:


  • CraftBukkit
  • Spigot
  • Paper
  • TacoSpigot
  • SpongeVanilla (not Forge)


  • BungeeCord
  • Waterfall (PaperMC)
  • FlexPipe
  • VelocityPowered

How can I install SkinsRestorer?

It's easy to install SkinsRestorer. Follow this little guide, so you don't go wrong :) For more info, see [wiki] Note: Make sure to review BungeeCord installation steps if you're using a proxy!

For Spigot / Paper:

  • Place the plugin in ./plugins/ folder.
  • Restart the server.
  • Optional Edit the config.yml inside ./plugins/SkinsRestorer/ folder.

For BungeeCord / Waterfall:

  • Place the plugin in /plugins/ folders of every Spigot server.
  • Place the plugin in /plugins/ folder of every BungeeCord server.
  • Check & set on every Spigot server spigot.yml -> bungeecord: true
  • Give permissions inside the bungee server
  • Restart the server.
  • Optional Edit the config inside bungee/plugins/SkinsRestorer/ folder.

For Sponge:

  • Place the plugin in ./mods/ folder (where Sponge is located).
  • Restart the server.

For Velocity: [!] Paper is suggested for velocity [!]

  • Place the SkinsRestorer.jar in /plugins/ folders of every Paper server.
  • Place the SkinsRestorer.jar in /plugins/ folder of every Velocity server.
  • Check & set on every Paper server paper.yml -> velocity-support: enabled: true
  • Restart (/restart or /stop) all servers [PlugMan and /reload are NOT supported, use /stop or /end]
  • Optional Edit the config inside velocity/plugins/skinsrestorer/ folder.

What are the Commands?

Here's a list with commands and permissions to use them Note: If you use the plugin with bungeecord you will need to set the permission on the bungeecord side (e.g. config.yml)

More info & Permissions see: [wiki] [!] only works with "NewPermissions: true" (if false see old perms!) [!] wildcards ("*") don't work

Player commands: /skin - main command. /skin - Sets your skin. /skin url <skin.png url> [steve / slim] - set a skin from a .png url /skin update - Updates your current skin. /skin clear - clears your skin. /skins - GUI

Admin commands: /sr - main admin command /skin set - Sets player's skin. /skin clear - clear a player's skin. /skin update update a player's skin. /sr drop - Removes skins data from database. /sr createcustom <skin.png url> - Define a usable custom skin. /sr reload - Reloads config and locale. /sr props - Returns properties of a player. /sr status - check the plugin status.

Additional Permissions: *skinsrestorer.*bypasscooldown -> bypasses skinscooldown config *skinsrestorer.*bypassdisabled -> bypass the disabledskins list

What if I need support?

If you need any support you can Join us at our Discord channel, so we can help you out :)

Meet the Team:

xknat - Developer Pistonmaster - Developer

Logics - Maintainer SloPlays - Website & backend Angel_0 - support mono21400 - support CodeR - Skinsystem intergration dev ITZVGcGPmO - Skinsystem intergration dev

McLive - Retired dev Th3Tr0LLeR - Retired Founder Blackfire62 - Retired dev DoNotSpamPls - Retired dev HyperGaming18 - Retired support


Bukkit: https://bstats.org/signatures/bukkit/SkinsRestorer.svg BungeeCord: https://bstats.org/signatures/bungeecord/SkinsRestorer.svg Velocity: https://bstats.org/signatures/velocity/SkinsRestorer.svg

bstats sponge **Sponge:** ![https://bstats.org/signatures/sponge/SkinsRestorer.svg](https://bstats.org/signatures/sponge/SkinsRestorer.svg)

***Want to support us and the plugin ?

We have spent many of our time by working on to this, we made it free so that any server could enjoy it. If you're a big server and plan to use this consider donating to us (PM) so that I can thank you and keep working on this.***

Plugins that use SkinsRestorer

Plugin List [SybHideAndSeek](https://www.spigotmc.org/resources/sybhideandseek.76143/) - Play Hide and Seek on minecraft.
(we are not open for paid advertising)

end, no seriously just rate us already ^w^.


Published onApril 23, 2023


Avatar for SRTeam