Home Discord Store Get ClothesPlus Login
Esc

Installation

Step-by-step guide to install and configure ClothesPlus on your Minecraft server.

Requirements

Before installing ClothesPlus, make sure your server meets these requirements:

RequirementVersionNotes
Minecraft Server1.20.x – 1.21.10+Paper or Spigot recommended
Java17+Required for modern Minecraft versions
PacketEvents2.11.3+Required — Download from SpigotMC
MineSkin API Key—Required for skin generation (get one free)

PacketEvents is required! ClothesPlus will not function without PacketEvents installed.

Optional Dependencies

These plugins are not required but unlock additional features:

PluginPurpose
LuckPermsPermission-based token allocation and outfit slots
FastLoginCracked/offline server support
PlaceholderAPIPlaceholder support in other plugins
Nexo / ItemsAdder / OraxenCustom item support in cursor creator UI

Step 0: Get Your License Key

Before installing the plugin, you need a license key.

1
Open a License Ticket

Join our Discord server and open a license ticket in the support channel.

2
Provide Your Details

Share your email address and how many servers you will be running ClothesPlus on.

3
Add the Key

Copy the generated license key and paste it into the license.txt file inside plugins/ClothesPlus/.

4
Restart Your Server

Restart your server. It may take up to 2 restarts for the license to validate properly.

If your license does not validate on the first restart, restart once more. Some environments require a second boot to finalize validation.

Quick Install

Follow these steps to get ClothesPlus running:

1
Install PacketEvents

Download PacketEvents and place the JAR in your plugins folder.

2
Download ClothesPlus

Download the plugin from your preferred marketplace:

Download from BuiltByBit

Download from Polymart

3
Place the JAR

Place ClothesPlus-X.X.X.jar in your plugins folder.

4
Start Your Server

Start (or restart) your server. ClothesPlus will generate its default configuration files.

5
Set Up the Resource Pack

ClothesPlus includes its own resource pack for custom GUI icons, fonts, and cursor elements. Configure it in config.yml or use the vanilla-configs/ fallback for servers that don't want a pack.

If your server already uses a resource pack, merge the ClothesPlus assets into your existing pack. See the resource pack section below for details.

6
Get a MineSkin API Key

Follow the MineSkin setup section below to get your free API key.

7
Configure the API Key

Edit plugins/ClothesPlus/config.yml and add your MineSkin API key.

8
Reload

Run /clothes reload in-game or from the console.

MineSkin API Key Setup

MineSkin is a free service that generates signed Minecraft skin textures. ClothesPlus uses it to apply skin overlays to players.

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
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
3
Add to config.yml

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

```yaml Before

MineSkin API Key

mineskin: api-key: urapikey ```

Replace urapikey with your actual API key:

```yaml After

MineSkin API Key

mineskin: api-key: your-actual-api-key-here ```

Keep your API key private! Never share your API key publicly. If compromised, regenerate it at mineskin.org.

Resource Pack Setup

ClothesPlus includes its own resource pack that provides custom GUI icons, fonts, glyphs, and cursor textures for the best visual experience.

The plugin's resource pack is automatically generated and can be served to players. Configure your server to apply it on join or host it externally.

The pack provides:

  • Custom GUI icons — Wardrobe category icons, navigation buttons, and overlays
  • Custom fonts & glyphs — MiniMessage-compatible glyphs for GUI titles
  • Cursor textures — Custom cursor and click-effect textures for the creator

If your server already uses a resource pack, merge the ClothesPlus assets into your existing pack. Copy the ClothesPlus model and texture files into the corresponding paths in your pack.

For servers that don't want to use a resource pack, ClothesPlus ships with a vanilla configuration in the vanilla-configs/ folder. These configs replace all custom model data, glyphs, and plugin-specific items with vanilla Minecraft equivalents.

To use vanilla mode:

  1. Back up your current config files
  2. Copy all .yml files from plugins/ClothesPlus/vanilla-configs/ into plugins/ClothesPlus/
  3. Run /clothes reload and /clothes cursor reload

Vanilla mode differences:

  • Custom Model Data → all set to 0
  • GUI Titles → plain colored text (no or )
  • UI Backgrounds → native Text Display background-color (ARGB) instead of custom font images
  • Cursor Material → ARROW (visible without pack) instead of PAPER with custom model data

Vanilla configs use Minecraft's native Text Display background-color feature (1.19.4+) for UI backgrounds — no resource pack needed.

The custom-model-data values in guis.yml and creator/ui.yml correspond to the plugin's resource pack. Set them to 0 if using vanilla mode.

Plugin Folder Structure

After the first startup, ClothesPlus creates this folder structure:

  • plugins
    • ClothesPlus
    • creator.yml
    • guis.yml
    • previewer.yml
    • shading_config.yml
    • license.txt
    • creator
    • sections.yml
    • ui.yml
    • races.yml
    • classes.yml
    • panels.yml
  • base_skin
    • steve.png
    • alex.png
  • overlays
    • shirts
    • formal_shirt.png
  • pants
    • jeans.png
    • shorts.png
  • shoes
  • hats
  • accessories
  • hairs
  • eyes
  • skin-colours
  • eyebrows
  • vanilla-configs
    • config.yml
    • guis.yml
  • player_config
    • overlay_priorities.yml
  • shading
    • steveshade.png
    • alexshade.png
  • data
    • overlays/
    • creator/

Adding Clothing Overlays

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

  • overlays
    • shirts
    • 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.

Make sure your overlay PNGs only contain the clothing pixels. Transparent pixels will show the player's base skin underneath.

Extracting Bundled Overlays

ClothesPlus comes with bundled overlay templates. To extract them:

1
Enable extraction

Open config.yml and set overlay_extract.enabled to true:

```yaml config.yml overlay_extract: enabled: true # Set to true to extract bundled overlays ```

2
Reload the plugin

Run /clothes reload — the system will extract bundled overlays into the overlays folder.

3
Automatic reset

After extraction, the plugin automatically sets overlay_extract.enabled back to false.

Extraction may cause a brief lag spike on the server. It's recommended to do this during low player count.

MySQL Setup (Optional)

For cross-server synchronization on Velocity/BungeeCord networks, configure MySQL in your config.yml:

yaml
# 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
velocity:
  enabled: true  # Enable cross-server skin synchronization

See the full MySQL & Velocity setup guide for detailed instructions on configuring cross-server sync.

Verify Installation

Run these commands to verify ClothesPlus is working correctly:

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

Success! If the wardrobe GUI opens with your overlays, ClothesPlus is installed correctly. Head to the Commands reference for full usage instructions.

Troubleshooting

  • Make sure PacketEvents is installed and up to date
  • Check the server console for error messages
  • Verify you're running Minecraft 1.20+
  • Ensure your license.txt contains a valid license key
  • Verify your MineSkin API key is correct in config.yml
  • Check the console for MineSkin API errors
  • Ensure overlay PNG files are valid 64×64 Minecraft skin format
  • Try /clothes refresh to force a skin update
  • Default permissions are set to op — non-op players need explicit grants
  • Use LuckPerms or a permission plugin to grant wardrobeclothes.use
  • See the Permissions reference for all permission nodes
  • Restart the server twice — some environments need two boots
  • Make sure the key in license.txt has no extra spaces or line breaks
  • Open a ticket on Discord for help

Next Steps

Quick Start Guide
Get the wardrobe working for players in 5 minutes.
Creator Setup
Set up the character creator for first-join customization.
← PreviousIntroduction