Skin Restorer

Mod

by Lionarius

A server-side mod for managing and restoring player skins.

Type

Mod

CurseForge Downloads

1,501,320

CurseForge ID

443823

Modrinth Downloads

1,232,862

Modrinth ID

ghrZDhGW

Last Updated

Jun 12, 2026

Description

SkinRestorer

A server-side mod for managing and restoring player skins.

⚠️ Important Disclaimer

This mod is an independent project and is NOT related to SkinsRestorer plugin.

They are separate projects with different maintainers. Please do not seek support for this mod from their community, or vice-versa.

✨ Features

Set skins from Mojang Account: Fetch and apply skins using a valid Minecraft username.
Set skins from Ely.by: Fetch and apply skins using a valid Ely.by username.
Set skins from URL: Fetch and apply skins from any image URL, supporting both classic (Steve) and slim (Alex) skin models.
Automatic skin fetching: Automatically fetch skin from Mojang/Ely.by when a player joins the server running in offline/insecure mode (configurable).
Singleplayer support: Apply skins individually for each world.
Permissions API support
SkinShuffle support: Allow players with SkinShuffle installed to apply skins using GUI.

📜 Command Usage Guide

For a detailed list of available commands and their usage, please visit the commands wiki page.

❌ Known Incompatibilities

Arclight (<=1.20.1): Trials or older versions are not compatible due to mixin conflicts. As an alternative, consider using the SkinsRestorer plugin.
Launchers with 3rd party skinning systems (e.g., TLauncher): Not supported. SkinRestorer uses the official skinning system, and since these launchers override it, skins will not be displayed on the client.

❓ FAQ

Q: /skin set web gives "trailing data" or URL not accepted?
A: Put the full URL in double quotes "..." - Minecraft chat parsing requires it for URLs with special characters.
Q: Ely.by skins not working ("no profile with name ...")
A: Reapply/set skin on ely.by site first. Ensure username exists & spelled correctly.
Q: Mojang skins not working ("not found" / "no profile")
A: Verify username exists. Temporary Mojang API outage/rate-limit - retry in 5-30 min. Delete config/skinrestorer/mojang_profile_cache.json.

🆘 Where to Get Help

Need assistance with SkinRestorer? Reach out through these support channels:

GitHub Issues: Report bugs or ask questions on GitHub Issues page.

🪙 Donation

If you enjoy using SkinRestorer and would like to support its development, you can contribute through the following platforms:

Bitcoin (BTC): bc1qnvrw46enetxhjeamr2lqy9d74ew0rdqwjw7p4k
USDT (TRC20): TTB8j1moevS7DG6eRips1ikxv16xq2TpZu
USDT (TON): UQCatk-XQh_Ab3nYUlXpl_Ok69QMVOTDdufikYa3foxLZKwD

Thank you for your generosity!