Documentation - ClothesPlus Wiki

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

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

wardrobeclothes.use

/outfits

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

wardrobeclothes.outfits

/clothes cursor start

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

wardrobeclothes.create

Clothing Commands

Manage player clothing overlays

/clothes wear <category/overlay>

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

wardrobeclothes.use

/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 section 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`

Creator Setup

Overview

The Creator is an advanced character creation system that uses a mouse cursor-like interface for players to customize their character. It supports:

First-join character creation (automatic for new players)
Gender/race selection with customizable stages
Interactive NPC preview with drag-to-spin
Custom items from Nexo, ItemsAdder, or Oraxen for UI elements
Camera positioning for cinematic experience

Important: This cursor-based creator is now the primary and recommended character creation system.

Quick Setup

Create a dedicated area/world for character creation
Stand where you want the camera to be and run /clothes cursor setcamera
Add your overlay PNGs to the creator folders (see structure below)
Run /clothes cursor reload to regenerate the config
Test with /clothes cursor start

Overlay Folder Structure

The creator auto-detects overlays from these folders:

Folder Structure

plugins/ClothesPlus/overlays/
├── hairs/
│   └── creator/
│       ├── female/           # Gender-specific folder
│       │   ├── Ponytail.png
│       │   └── Long_Hair.png
│       └── male/
│           ├── Buzz_Cut.png
│           └── Spiky.png
├── skin-colours/
│   └── creator/
│       ├── steve-skin-1.png  # Unisex (no gender folder)
│       └── steve-skin-2.png
└── eyes/
    └── creator/
        ├── female/
        │   └── 1.png
        └── male/
            └── 1.png

Auto-Detection: File names become display names. Use underscores for spaces (e.g., Long_Hair.png → "Long Hair")

Creator Commands

Command	Description
`/clothes cursor start`	Start the cursor creator for yourself
`/clothes cursor start <player>`	Start creator for another player
`/clothes cursor stop`	Stop current cursor session
`/clothes cursor setcamera`	Set camera position at your location
`/clothes cursor setjoincamera`	Set first-join camera position
`/clothes cursor reload`	Reload cursor creator configuration

cursor_creator.yml Reference

Key configuration sections in cursor_creator.yml:

Section	Description
`enabled`	Enable/disable the cursor creator system
`first-join`	First-join character creation button settings
`cursor`	Cursor appearance, sensitivity, bounds
`camera`	Main camera position (set with /clothes cursor setcamera)
`npc-preview`	NPC preview settings, zoom, drag-to-spin
`stages`	Define selection stages (gender, race, hair, etc.)
`ui-elements`	Button positions, icons, text

Configuration

Configuration Files

Click on the tabs below to browse each configuration file. Each tab shows the full reference with all available options.

config.yml - Full Reference

Main plugin settings including MineSkin API, caching, MySQL, and more.

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

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'

guis.yml - Wardrobe GUI Configuration

Controls the wardrobe GUI layout, icons, navigation, and category displays.

YAML

#################################################################
#  ClothesPlus – wardrobe section
#################################################################
wardrobe:
  # Global overlay item defaults (when player clicks to wear)
  overlay-item:
    material: PAPER
    custom-model-data: 0
    name: "&b{overlay}"
    glow-enchant: unbreaking

  # Unequip button appearance
  overlay-unequip-item:
    material: BARRIER
    custom-model-data: 0
    name: "&cUnequip {overlay}"

  # Tooltips
  overlay-lore:
    - "&7Click to equip"
  overlay-lore-locked:
    - "&cYou don't own this overlay"
  unequip-lore:
    - "&7Remove current overlay"

  # Navigation bar configuration
  navigation:
    rows: 6                # GUI size: 2-6 rows
    navigation-row: 5      # 0-based row for nav buttons

    prev:
      slot: 0
      material: PAPER
      custom-model-data: 550002
      name: "&6Previous"

    next:
      slot: 8
      material: PAPER
      custom-model-data: 550004
      name: "&6Next"

    outfits:
      slot: 4
      material: PAPER
      custom-model-data: 550003
      name: "&bOutfits"

    back:
      slot: 5
      material: PAPER
      custom-model-data: 550001
      name: "&cBack"

    exit:
      slot: 7
      material: BARRIER
      name: "&cExit"

    search:
      slot: 3
      material: PAPER
      custom-model-data: 550005
      name: "&bSearch"

  # Window titles (supports MiniMessage formatting)
  titles:
    categories: "&f"
    overlays: "&f"

  # Category definitions
  categories:
    shirts:
      title: "&f"
      slots: [0, 1, 2, 9, 10, 11]
      item:
        material: PAPER
        custom-model-data: 550000
    # Add more categories as needed...

Custom Model Data: The custom-model-data values are used for resource pack icons. Set to 0 for vanilla items.

cursor_creator.yml - Cursor Creator Configuration

Complete configuration for the cursor-based character creation system.

Basic Settings

YAML

enabled: true
debug: false

First-Join Settings

YAML

first-join:
  enabled: true
  delay-ticks: 40  # 20 ticks = 1 second

  camera:
    enabled: true
    world: world
    position:
      x: 0.0
      y: 100.0
      z: 0.0
    rotation:
      yaw: 0.0
      pitch: 0.0

  button:
    text: '<green><bold>✦ Create Character ✦</bold></green>'
    x: 0.0
    y: 0.5
    z: 0.5
    scale: 1.0

  commands: []  # Commands to run when clicked

HUD Settings

YAML

hud:
  hide-exp-bar: true
  hide-hotbar: true
  hide-boss-bars: true
  hide-chat: true

Cursor Settings

YAML

cursor:
  material: PAPER
  custom-model-data: 10007
  # Custom item from Nexo/ItemsAdder/Oraxen
  # Formats: ':item:', ':nexo:item:', ':ia:item:', ':oraxen:item:'
  custom-item-id: ''
  scale: 0.2
  sensitivity:
    x: 0.5
    y: 0.5
  max-bounds:
    x: 4.0
    y: 5.5
  glow: false
  brightness:
    enabled: true
    block-light: 15
    sky-light: 15
  click-effect:
    enabled: true
    custom-model-data: 10008
    duration-ticks: 3

Camera Settings

Set with /clothes cursor setcamera:

YAML

camera:
  world: world
  position:
    x: 0.0
    y: 100.0
    z: 0.0
  rotation:
    yaw: 0.0
    pitch: 0.0
  distance: 3.5

NPC Preview Settings

YAML

npc-preview:
  enabled: true
  distance: 4.0
  height-offset: -0.6
  auto-spin: true
  spin-speed: 2.0
  zoom-mode: fixed
  zoom-multiplier: 0.6
  zoom-position:
    x: -0.3
    y: -0.8
    z: 2.5
  drag-to-spin:
    enabled: true
    sensitivity: 2.0

creator.yml - Hotbar Creator (Legacy)

Configuration for the legacy hotbar-based character creator. The cursor creator is recommended for new setups.

YAML

character-creator:
  enabled: true
  disable-cooldowns: false
  stage-cooldown: 1500      # 1.5 seconds
  option-key-cooldown: 2000 # 2 seconds

  loading-title: '&6Loading in...'
  loading-subtitle: '&7Please wait'
  loading-fadein: 20
  loading-stay: 80
  loading-fadeout: 20

  actionbar: true
  actionbar-customization:
    header: '&6§l<< Creator >> '
    footer: '&7[Slot 4: Prev | Slot 5: Next]'

  # Commands on start/end
  start_command:
    - '%p warp creatorspace'
    - 'DELAY 30'
    - '%p npcpreview'
  end_command:
    - '%p npcpreview'
    - 'DELAY 50'
    - '%p warp spawn'

  # Define creation stages
  stages:
    - number: 0
      id: race-gender
      display-set: set1
      gender_options:
        - male_human:
            display: '&fMale Human'
            commands:
              - '%p clothes race male human'
        - female_human:
            display: '&fFemale Human'
            commands:
              - '%p clothes race female human'

Legacy System: The hotbar creator is deprecated. Use the cursor creator (/clothes cursor start) for a better experience.

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