Installation Guide

• LuckPerms - For permission-based token allocation and outfit slots
• FastLogin - For cracked server support
• PlaceholderAPI - For placeholder support in other plugins
• Nexo / ItemsAdder / Oraxen - For custom item support in cursor creator

1. Download PacketEvents and place it in your plugins folder
2. Download ClothesPlus from BuiltByBit or Polymart
3. Place ClothesPlus-X.X.X.jar in your plugins folder
4. Start (or restart) your server
5. Get a MineSkin API key (see below)
6. Edit plugins/ClothesPlus/config.yml and add your API key
7. Run /clothes reload

Step 1: Create a MineSkin Account

1. Go to mineskin.org
2. Click "Login" in the top right
3. Sign in with your Discord, GitHub, or Microsoft account

Step 2: Generate an API Key

1. After logging in, go to mineskin.org/apikey
2. Click "Create new API Key"
3. Give it a name (e.g., "ClothesPlus")
4. Copy the generated API key

Step 3: Add to config.yml

Open plugins/ClothesPlus/config.yml and find the MineSkin section:

# MineSkin API Key
mineskin:
  api-key: urapikey

Replace urapikey with your actual API key:

# MineSkin API Key
mineskin:
  api-key: your-actual-api-key-here

After first startup, ClothesPlus creates this folder structure:

plugins/ClothesPlus/
├── config.yml           # Main configuration
├── creator.yml          # Character creator stages
├── cursor_creator.yml   # Cursor creator settings
├── guis.yml             # Wardrobe GUI configuration
├── base_skin/           # Base skins (steve.png, alex.png)
├── overlays/            # Your clothing overlays
│   ├── shirts/
│   ├── pants/
│   ├── shoes/
│   ├── hats/
│   └── accessories/
├── player_config/       # Per-player settings
│   └── overlay_priorities.yml
├── races/               # Race configurations
│   └── human.yml
└── shading/             # Shading templates
    ├── steveshade.png
    └── alexshade.png

Overlays are PNG files in standard Minecraft skin format (64x64 pixels). Place them in the appropriate category folder:

plugins/ClothesPlus/overlays/
├── shirts/
│   ├── casual_tshirt.png
│   ├── formal_shirt.png
│   └── hoodie.png
├── pants/
│   ├── jeans.png
│   └── shorts.png
└── hats/
    ├── baseball_cap.png
    └── wizard_hat.png

After adding overlays, run /clothes reload to refresh the wardrobe.

ClothesPlus comes with bundled overlay templates. To extract them:

1. Open config.yml
2. Set overlay_extract.enabled to true
3. Run /clothes reload
4. The system will extract bundled overlays and automatically set this back to false

# Overlay Auto-Extract System
# Automatically extracts bundled overlay ZIP from the plugin JAR on startup if set true
# You can also run the command /clothes reload to extract it on the server live. Just bare it might lag for a moment.
# When you finish extracting the overlays, the system with set this back to false automatically.
overlay_extract:
  enabled: false  # Set to true to extract bundled overlays on next startup or /clothes reload

For cross-server synchronization (Velocity/BungeeCord networks), configure MySQL:

# mySQL setup for Velocity/BungeeCord servers
mysql:
  enabled: false
  host: "127.0.0.1"
  port: 3306
  database: "clothesplus"
  username: "clothesuser"
  password: "changeme"
  pool-size: 10
  use-ssl: false

# Velocity/BungeeCord Cross-Server Sync
# Enable this when running behind a Velocity or BungeeCord proxy
# Requires ClothesPlusVelocity plugin on the proxy for full functionality
velocity:
  enabled: true  # Set to true to enable cross-server skin synchronization
  # When enabled, skin resets and updates are broadcast to all backend servers
  # This ensures players see consistent skins across server switches

Run these commands to verify ClothesPlus is working:

/clothes info      # Shows plugin version and status
/clothes help      # Shows available commands
/wardrobe          # Opens the wardrobe GUI (requires overlays)