SkinsRestorer documentation

SkinsRestorer lets players change their Minecraft Java Edition skin on a server. Server owners can restore account skins, offer custom skins, and manage who can change them.

What do you want to do?

Install SkinsRestorer

Choose your server or proxy and check your first skin.

Change a skin

Use a player name, upload a PNG, or restore your account skin.

Fix a problem

Start with the symptom and collect the right diagnostics.

Build an integration

Fetch, save, and apply skins through the Java API.

Find the right guide

New server owner: Start with installation. A proxy network needs SkinsRestorer on the proxy and every backend.
Player: Read change or reset your skin. Your server must provide SkinsRestorer and permission to use it.
Administrator: Configure player access, default skins, or shared storage.
Developer: Start with the first plugin tutorial, then read about persistent and temporary changes.

Exact command syntax and configuration keys live in the reference. The skin lifecycle explains why a visible skin and a saved selection can differ.

Version and support

These guides target SkinsRestorer 15.12.6. Each page shows its applicable platform and review date. Minecraft and Java requirements depend on the platform and download.

Use the compatibility guide before you install a mod or update a server. For a support request, collect a diagnostic report and recent log.