SkinChanger

SkinChanger

A modern, GUI-based skin changer for Paper 1.21.1. Players can change their skin to any premium player's skin with a clean menu or a single command, with no relog required.

✨ Features

• Interactive GUI: a color-coded chest menu with skin search, preview, premium skin apply, reset and a skin gallery.
• Instant skin change: the skin updates live for you and everyone around you, with no kick or rejoin.
• Skin preview: look up a player's skin first and see it as a head in the menu, then apply it with one click.
• Premium skins: type a premium player's name and their skin is applied instantly.
• Skin gallery: a paginated menu of ready-made skins. Add or remove entries from the config.
• Anvil or chat input: enter names through an anvil screen or the chat (configurable).
• Persistent skins: chosen skins are saved to SQLite and restored when the player joins again.
• Fully async: all web requests run off the main thread, so there is no server lag.
• 24-hour caching: skins are cached with Caffeine, and repeated or failed lookups don't hit the API again.
• Rate limit protection: if Mojang's API is rate limited or down, the plugin automatically falls back to a backup API (Ashcon).
• Fully customizable: every GUI title, button, lore line and message is editable in config.yml, with hex color support (&#RRGGBB).
• Offline-mode friendly: reset can return players to the premium skin matching their own name.

📜 Commands

Command · Description · Permission
/skinchanger · Open the skin menu · skinchanger.use
/skinchanger · Apply a premium player's skin · skinchanger.use
/skinchanger reset · Restore your original skin · skinchanger.use
/skinchanger reload · Reload the configuration · skinchanger.admin

Aliases: /skin, /skins

Extra permission: skinchanger.bypass.cooldown skips the skin change cooldown.

⚙️ Requirements

• Paper 1.21.1
• Java 21
• Internet access (for the Mojang skin API and for downloading the Caffeine library on first start)

No ProtocolLib or other plugin dependencies are needed.

📦 Installation

1. Download the jar and place it in your plugins folder.
2. Restart the server.
3. Edit plugins/SkinChanger/config.yml to customize menus, messages and the gallery.

Made by Andrewist.