Documentation

Complete reference for commands, configuration, and permissions

Commands

Command Aliases: /clothes can also be used as: /wc, /wardrobeclothes, /cpls, /cps, /clothing, /clothe, /cloth, /skinwardrobe

GUI Commands

These commands open interactive GUIs for players

/wardrobe preview
/wardrobe

Opens the wardrobe GUI where players can browse and equip clothing overlays by category.

wardrobeclothes.use
/outfits preview
/outfits

Opens the outfit management GUI to save, load, and delete complete outfit combinations.

wardrobeclothes.outfits
/clothes cursor start preview
/clothes cursor start

Starts the cursor-based character creator with mouse-driven UI navigation.

wardrobeclothes.create

Clothing Commands

Manage player clothing overlays

/clothes wear preview
/clothes wear <category/overlay>

Applies a clothing overlay to the player. Example: /clothes wear shirts/hoodie

wardrobeclothes.use
/clothes preview
/clothes unwear <category/overlay>

Removes a specific clothing overlay from the player.

wardrobeclothes.use

Full Command Reference

Command Description Permission
/clothes wear <path> Apply a clothing overlay wardrobeclothes.use
/clothes unwear <path> Remove a clothing overlay wardrobeclothes.use
/clothes save <name> Save current outfit wardrobeclothes.use
/clothes load <name> Load a saved outfit wardrobeclothes.use
/clothes delete <name> Delete a saved outfit wardrobeclothes.use
/clothes reset Reset skin to original Mojang skin wardrobeclothes.reset
/clothes refresh Refresh current skin display wardrobeclothes.use
/clothes info Show plugin information wardrobeclothes.use
/clothes help Show help message wardrobeclothes.use

Creator Commands

Deprecation Notice: The hotbar-based creator (/clothes create, /clothes stage) is deprecated and will be removed in a future update. The cursor-based creator (/clothes cursor) is now the primary method for character creation. See the Creator page for setup instructions.
Command Description Permission
/clothes create DEPRECATED Enter character creator mode (hotbar-based) - deprecated wardrobeclothes.create
/clothes stage <id> DEPRECATED Jump to a specific creator stage - deprecated wardrobeclothes.create
/clothes exit DEPRECATED Exit creator mode - deprecated wardrobeclothes.exit
/clothes cursor start RECOMMENDED Start cursor-based character creator wardrobeclothes.create
/clothes cursor stop Stop cursor creator session wardrobeclothes.create

Configuration

Configuration Files

File Purpose
config.yml Main plugin settings, MineSkin API, caching, MySQL, etc.
creator.yml Hotbar-based character creator stages and options
cursor_creator.yml Cursor-based character creator settings
guis.yml Wardrobe GUI layout, icons, and categories

config.yml - Full Reference

YAML 
# Wardrobe Clothes Plugin Configuration
enable-messages: false
accessories_limit: 3

# FOR LUCKPERMS - Token allocation by permission group
token_settings:
  - group: default
    tokens: '1'
  - group: admin
    tokens: '5'

# MineSkin API Key - REQUIRED for skin generation
# Get your key at: https://mineskin.org/apikey
mineskin:
  api-key: urapikey

# Pre-cache system (UNDER DEVELOPMENT - do not enable)
precache:
  enabled: false
  owner_username: "YourMinecraftUsername"
  max_items: 20
  delay_seconds: 2
  priority_categories:
    - "shirts"
    - "pants"
    - "hats"

# Shared Cache Configuration
shared_cache:
  enabled: true

# Creator Cache Configuration
creator_cache:
  enabled: true

# Base Skin Cache Configuration
base_skin_cache:
  enabled: true

# Base Skin Mode
# true: Uses base skin from base_skin folder
# false: Uses player's Mojang skin as base
base_skin: true

# Skin Tone Detection (only when base_skin: false)
apply_skin_tone: true

# Strip Second Layer (only when base_skin: false)
strip_second_layer: false

# Use Base Skin Parts
use_base_skin_parts: false

# Sound effects
sound: true

# Auto-Fit System
allow-auto-fit: true

# Reset to Mojang Skin
reset_to_mojang_when_empty: true

# NPC Preview Configuration
npcpreview:
  use_slowness_effect: true
  enter_message: '&fLoading...'
  exit_message: '&fExiting...'
  npc_distance: 7

# MySQL Configuration
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

# Overlay Auto-Extract System
overlay_extract:
  enabled: false

# Developer Options (DO NOT TOUCH)
developer:
  self-visibility: false
  logging: false
  enhanced_cache_logging: false
  avatar: false

Key Settings Explained

Base Skin Mode

Controls how player base skins are handled:

  • base_skin: true - All players use steve.png or alex.png as base
  • base_skin: false - Players keep their Mojang skin as base

Cache System

ClothesPlus has three independent cache systems:

  • shared_cache - Caches clothing combinations for all players
  • creator_cache - Caches previews during character creation
  • base_skin_cache - Per-player cache when using Mojang skins

Auto-Fit System

When allow-auto-fit: true, the plugin automatically converts clothing between Steve and Alex models.

Token Settings (LuckPerms)

Tokens control how many outfit slots players can have:

YAML 
token_settings:
  - group: default
    tokens: '1'
  - group: vip
    tokens: '3'
  - group: mvp
    tokens: '5'
  - group: admin
    tokens: '10'

Permissions

Default Permissions: Most permissions default to op. Use a permission plugin like LuckPerms to grant permissions to players.

Core Permissions

Permission Description Default
wardrobeclothes.use Allows use of /clothes and /wardrobe commands op
wardrobeclothes.outfits Allows opening the outfit GUI via /outfits op
wardrobeclothes.npc Allows starting NPC preview via /npcpreview op
wardrobeclothes.reset Allows resetting skins and overlays op

Admin Permissions

Permission Description Default
wardrobeclothes.admin Admin-level actions: reload, update notifications, target other players op
wardrobeclothes.config.reload Allows reloading configuration files op
wardrobeclothes.overlay.extract Allows extracting bundled overlays op

Creator Permissions

Permission Description Default
wardrobeclothes.create Allows entering creator mode (/clothes create, /clothes cursor start) op
wardrobeclothes.exit Allows exiting creator mode op
wardrobeclothes.race Allows use of /clothes race command op

Token Permissions

Permission Description Default
wardrobeclothes.addtoken Allows adding tokens to players op
wardrobeclothes.removetoken Allows removing tokens from players op

Cache & Other Permissions

Permission Description Default
wardrobeclothes.cache Allows managing cache systems op
wardrobeclothes.cache.clear Allows clearing all cache systems op
wardrobeclothes.palette Allows generating and reloading color palettes op
wardrobeclothes.mysql Allows managing MySQL operations op

LuckPerms Examples

Basic Player Setup

Commands 
# Give all players access to wardrobe and outfits
/lp group default permission set wardrobeclothes.use true
/lp group default permission set wardrobeclothes.outfits true
/lp group default permission set wardrobeclothes.npc true
/lp group default permission set wardrobeclothes.reset true

VIP/Donor Setup

Commands 
# VIP group with character creator access
/lp group vip permission set wardrobeclothes.use true
/lp group vip permission set wardrobeclothes.outfits true
/lp group vip permission set wardrobeclothes.npc true
/lp group vip permission set wardrobeclothes.create true
/lp group vip permission set wardrobeclothes.exit true

Admin Setup

Commands 
# Admin group with all permissions
/lp group admin permission set wardrobeclothes.* true