Minecraft plugin SkinsRestorer

🔌 About SkinsRestorer

SkinsRestorer is a Minecraft plugin for restoring and managing player skins on both online-mode and offline-mode servers. It provides in-game commands, a GUI, caching and custom-skin features so servers can apply and change player skins reliably even when external skin services are unavailable.

🎯 Purpose

SkinsRestorer solves the problem of missing or default skins (Steve/Alex) on servers, particularly on offline/cracked servers or large networks where immediate or cached skin application is required. It is aimed at server administrators who need consistent skin handling across players and proxies.

⚙️ Features

• Apply a player's account skin on join or apply default/custom skins for non-premium players.
• Player-facing /skin command (including URL-based skin generation) and a GUI for browsing/selecting skins.
• Custom skins support (upload / URL-based skins) and server-wide custom skin creation.
• Caching and rate-limit-aware Mojang/MineSkin requests to improve reliability on large networks.
• Configuration options to restrict skins, per-skin permissions, default-skin behavior, and GUI settings.
• Proxy-aware operation and backend/proxy-specific configuration options.

🧩 Who It Is For

• Survival and SMP servers that want reliable skin display.
• Offline-mode or cracked servers that need cosmetic support for non-premium players.
• Networks using proxies or multiple backend servers that require cached or consistent skin behavior.

🏗️ Example Use Cases

• A private offline server lets players change skins with /skin <name> without needing Mojang account ownership.
• A network caches skins so player appearance remains stable when upstream skin services are slow or unavailable.
• An admin sets a default skin set for new or non-premium players via configuration.

⌨️ Commands

(Note: command registration can be toggled in configuration; exact permission nodes for many commands are documented in the plugin's commands & permissions guide.)

🔐 Permissions

⚙️ Installation

📥 Setup

• Download the official plugin JAR from the project's releases page.
• Place the JAR into your server's plugins/ directory on a Spigot/Paper-compatible backend (or the appropriate proxy/backend setup when used with proxies).
• Start or restart the server and check the server console to confirm SkinsRestorer loaded.

📦 Dependencies

• Optional integration with MineSkin is supported (an API key can be configured for faster skin generation). No other required plugin dependencies are listed in the official documentation.

🧾 Configuration

• The plugin uses a YAML configuration with options for default skins, command cooldowns, GUI tabs, per-skin permissions, proxy/backend settings, and caching.
• Configuration keys include flags such as forceDefaultPermissions, perSkinPermissions, disableSkinCommand, and enablePaperJoinListener (used to improve instant skin application on Paper).

🧠 Technical Notes

• Supports proxy-aware setups (backend vs proxy configuration) and has proxy-mode detection options.
• Provides caching and batching behavior to avoid API rate limits when contacting Mojang or third-party skin services.
• Configuration exposes MineSkin API key support for optional faster/managed skin generation.
• The project is open-source and maintained with releases on GitHub and documentation available on the official docs site.

🤝 When This Plugin Is Useful

If you need consistent, configurable skin handling for players across online/offline servers or proxy networks — including custom skins, URL-based skins, and caching to survive external outages — SkinsRestorer provides focused tools and configuration to manage those needs reliably.