config.yml

Main ClothesPlus configuration sections and current defaults.

plugins/ClothesPlus/config.yml owns global behavior. UI layout and preview placement live in the uis/ folder.

License

The license key is not stored in config.yml. Put it here:

plugins/ClothesPlus/licensing/clothesplus-license.key

The validator contacts the license server on first successful validation, then schedules the next server check 5 to 6 days later. A valid cached license has a 7 day offline grace period. Transient server failures retry after 12 hours while keeping cached validation active.

MineSkin

mineskin:
  api-key: urapikey

If this is blank or a placeholder, ClothesPlus rotates bundled testing keys. Set a real key with:

/clothes apikey <mineskin-api-key>

That command saves the key, reloads config.yml, reinitializes the MineSkin client, and disables bundled testing keys immediately.

Skin base behavior

base_skin: true
apply_skin_tone: true
use_base_skin_parts: false
reset_to_mojang_when_empty: true
allow-auto-fit: true

• base_skin: true uses bundled base skins from base_skin/.
• base_skin: false uses the player's Mojang skin and requires body type plus palette selection before wardrobe use.
• apply_skin_tone samples the player's skin tone when base_skin: false.
• use_base_skin_parts replaces covered body parts with alex.png or steve.png when base_skin: false.
• allow-auto-fit converts Steve/Alex overlay sizing when possible.
• reset_to_mojang_when_empty restores the original Mojang skin after all overlays are removed.

Wardrobe filtering

wardrobe:
  filter-overlays-by-skin-colour: true

When true, wardrobe overlays are filtered by the player's selected body type/skin-colour context. When false, the wardrobe shows all overlays the player can access by permission or store/barber purchase state.

Database

Use database for network-safe storage:

database:
  enabled: false
  type: "mysql"
  host: "127.0.0.1"
  port: 3306
  database: "clothesplus"
  username: "clothesuser"
  password: "changeme"
  pool-size: 10
  use-ssl: false
  ssl-mode: ""

Supported backends are mysql, mariadb, and postgresql. The older mysql block is still read as a legacy fallback when database.enabled is false.

Resource pack

The current resource-pack system is under resourcepack. See the resource-pack page for full details.

resourcepack:
  enabled: true
  provider: auto
  send-native-pack: false
  auto-install-provider-pack: true
  pack-folder: "resourcepack-edit"
  pack-types-folder: "pack-types"
  generate-plugin-pack-types: true

Wiki server

wiki:
  enabled: true
  address: "0.0.0.0"
  port: 8765
  public-url: ""

/clothes wiki returns the current local admin wiki URL and points to files copied into:

plugins/ClothesPlus/wiki/

Developer logging

developer:
  logging: false
  debug:
    cursor: false
    cursor-scanner: false
    previewer: false
    shared-ui: false
    cache: false
    skin: false
    npc: false
  enhanced_cache_logging: false

Legacy per-YAML debug keys are ignored and removed during migration.