Minecraft plugin SkinsRestorer

🔌 About SkinsRestorer

SkinsRestorer — is a plugin for Minecraft servers that allows changing, uploading and restoring player skins (works for online and offline mode servers). SkinsRestorer helps server owners offer customisation without forcing players to log into Mojang; it solves skin availability on offline/cracked servers and adds an in‑game GUI and commands for skin management on Paper/Spigot servers.

🎯 Purpose

SkinsRestorer addresses two common problems:

• Restoring player skins on offline (cracked) servers.
• Letting players change and upload skins without requiring external account login.

SkinsRestorer integrates with third‑party skin services (e.g. MineSkin) to apply skins via URLs, and provides a GUI and commands to manage skins on your Minecraft server.

⚙ Main features

• Change player skin with /skin and related commands.
• In‑game GUI (/skins) to browse and apply skins.
• Upload skins via URL or the SkinsRestorer upload page.
• Create server‑wide custom skins and apply skins to all players.
• Proxy (centralized) mode for BungeeCord/Velocity networks.
• Public API for other plugins.
• Troubleshooting and incompatibility documentation.

🧩 Who is it for

SkinsRestorer is suitable for:

• Server owners running Paper/Spigot (and forks) who need skin support.
• Networks using BungeeCord or Velocity (use proxy mode).
• Offline/cracked servers that must restore skins locally.
• Servers that want skin GUI and per‑skin permission control.

🏗 Example uses

• Allow cracked players to have their chosen skins on join.
• Event: /sr setskinall Santa classic to set a temporary skin for all online players.
• Staff can create curated server skins with /sr createcustom staff Notch.

⚡ Notable behaviour

• Official installation recommends downloading from Modrinth/official site and placing the JAR in plugins/.
• SkinsRestorer uses external skin services (MineSkin) when players set skins via URL; the plugin relays signed profile data to clients.
• The plugin exposes an API and has a GitHub repository for issues and contributions.

⌨️ Commands

Notes: The above commands are taken from the official SkinsRestorer documentation. Use the /sr help command to list full subcommands on your installed version.

🔐 Permissions

Default column: official documentation lists permission nodes and examples but does not consistently document default/OP settings for each node. If you require precise defaults, check your installed plugin version's plugin.yml or test on a staging server.

⚙ Installation

📥 Installation

• Download the SkinsRestorer JAR from the official source (Modrinth or SkinsRestorer site).
• Place SkinsRestorer.jar in your server plugins/ folder.
• Fully restart the server (do not use /reload).
• Verify plugin loaded via /plugins and server console.

📦 Dependencies

• No mandatory plugin dependencies documented. SkinsRestorer can operate standalone on supported platforms.
• Optional integrations: MineSkin (used for skin URL uploads), and various external APIs referenced in docs.

🧾 Configuration

• On first run the plugin creates its plugin folder and config.yml.
• The config.yml exposes options for commands, cooldowns, disabled skins, proxy mode, and database settings.
• Documentation shows database: configuration fields (host, port, username, etc.). Official docs indicate database support but do not clearly state the default storage engine; check your installed version for exact defaults.

Supported platforms

• Official docs list support for: Bukkit, Spigot, Paper (and forks), Folia, BungeeCord, Velocity, latest Fabric and Forge (server/plugin variants). Hybrid server types (Magma, Mohist, Cardboard) are explicitly not officially supported.

🧠 Additional information

Known conflicts

• Some plugins may conflict with SkinsRestorer (plugins that modify profiles, nicking or chat/tab handlers). The official incompatibility list names several common culprits and recommends testing on a staging server.
• Some proxy/server forks may break behavior; follow proxy installation guide for networks.

Limitations

• Behavior depends on platform and external skin services. URL skin application relies on third‑party services (MineSkin) to obtain signed skin data.
• Not all server forks (hybrid mod+plugin platforms) are supported.

FAQ (selected)

Q: Does SkinsRestorer work on offline (cracked) servers? A: Yes — SkinsRestorer is commonly used to restore skins on offline mode servers, per official docs.

Q: Can players upload skins via in‑game commands? A: Yes. /skin url "<url>" and /skin upload (which points to upload instructions) are supported; the upload flow uses MineSkin in the documented workflow.

Q: Is there a GUI to browse skins? A: Yes — use /skins to open the GUI.

Q: Does SkinsRestorer collect metrics? A: SkinsRestorer is listed on bStats; the plugin exposes metrics to bStats per its listing.

Q: Is there support / community? A: The project maintains an official Discord and GitHub repository for support and issues.

Keywords present: SkinsRestorer, minecraft plugin, paper plugin, spigot plugin, minecraft server, plugin commands, plugin permissions.

Sources: Official documentation and project pages (SkinsRestorer docs, SkinsRestorer site, Modrinth, GitHub, bStats, Discord).