Welcome to Custom Skin

Custom Skin is a Minecraft plugin that enables animated and customizable skins on your server. Players can create multi-frame animations, apply color effects, and see changes in real-time.

Features

🎬

Frame Animation

Upload PNG files with multiple 64px frames stacked vertically. The plugin automatically extracts frames and animates them in-game.

🎨

Color Effects

Apply hue shifts, saturation adjustments, and generate color variants (rainbow, warm/cool, monochrome, neon) directly in the web dashboard.

⚡

Real-time Sync

Changes made in the dashboard apply instantly via WebSocket connection. No server restart needed.

💾

Local Persistence

Skins are cached locally using SQLite, so they persist between logins even if the API is temporarily unavailable.

How It Works

Install the plugin on your Paper/Spigot server
Configure the API connection and permissions
Players run /skin link to get a dashboard link
Customize skins in the web dashboard
Apply instantly - changes sync to the server in real-time

Quick Start


# Download the plugin
curl -L -o plugins/CustomSkin.jar https://github.com/th0rgal/customskin/releases/latest/download/customskin.jar
 
# Restart your server
# Configure plugins/CustomSkin/config.yml
 
# In-game, run:
/skin link

See the Installation guide for detailed setup instructions.

Requirements

Java 17 or newer
Paper 1.20+ or Spigot 1.20+
A Custom Skin API instance (self-hosted or managed)

Support

GitHub Issues - Bug reports and feature requests
Discord - Community support and discussion