Updating and Migration

How ClothesPlus updates existing config and UI YAML files.

ClothesPlus keeps existing server setups while merging new defaults into old configs.

Version marker

config.yml includes:

installed-version: "3.1.4"

When the bundled version differs from the installed file, the migrator runs once.

What gets backed up

Before migration, ClothesPlus backs up config.yml and known UI YAMLs under:

plugins/ClothesPlus/backup/<timestamp>/

The migrator does not touch:

• overlays/
• player_config/
• resourcepack-edit/
• scanner output in uis/creator/cursor_auto_generated.yml

UI YAML update pass

3.1.4 also has a same-version UI YAML update stamp:

plugins/ClothesPlus/migration-stamps/2026-06-20-ui-yaml-defaults.done

This pass merges missing default leaves into these files:

uis/wardrobe/guis.yml
uis/wardrobe/wardrobe.yml
uis/creator/cursor_settings.yml
uis/previewer/previewer.yml
uis/creator/shared_ui.yml
uis/creator/cursor_first_join.yml
uis/creator/cursor_blackout.yml
uis/creator/cursor_ui_layout.yml
uis/creator/cursor_menus.yml
uis/creator/cursor_messages.yml
uis/creator/dynamicuv_animations.yml
uis/outfits/outfits.yml
uis/skins/cskins.yml

Forced default updates

These are plugin-owned defaults and are corrected even on existing installs:

# uis/previewer/previewer.yml
text-displays:
  open-gui:
    cooldown-seconds: 0

# uis/creator/cursor_settings.yml
buttontimer: 0s

# uis/creator/cursor_ui_layout.yml
navigation-arrows:
  prev:
    cooldown:
      enabled: false
  next:
    cooldown:
      enabled: false

DynamicUV animation IDs are filled when older files have blank values. Animation lookup is case-insensitive; the bundled .bbmodel contains Idle.

dynamicuv-animations:
  creator:
    default-idle: Idle
  previewers:
    wardrobe:
      idle: Idle

Removed legacy keys

These old leaves are stripped from UI YAMLs:

debug
creatorscannerdebug
custom-item-id
itemsadder-font-image
nexo-glyph

Debug settings now live under developer.debug in config.yml.

Restore bundled cursor UI defaults

Use this if an existing cursor YAML got damaged or stripped by an old save path:

/clothes cursor restore
/clothes cursor restore force

restore repairs damaged configs. restore force backs up and restores all cursor UI defaults from the jar.