ClothesPlus – GUI Configuration (guis.yml)

This page dissects plugins/ClothesPlus/guis.yml line‑by‑line so you can reskin or re‑layout every built‑in menu without touching Java.

Commands:

/overlays
/outfits

Basic rule of thumb
• Anything under wardrobe: affects the overlay‑selection GUIs.
• Anything under gui: (bottom of the file) belongs to the Outfits manager.
• If a value is missing, the plugin falls back to the nearest parent (→ no mandatory keys).

1. Wardrobe Section

wardrobe:
  overlay-item:
    material: PAPER
    custom-model-data: 0
    name: "&b{overlay}"
    glow-enchant: unbreaking

1.1 overlay-item  (global available icon)

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

1.2 overlay-unequip-item

Fallback icon for the big red “unequip” button that shows on the first slot when you are wearing something inside a category.

1.3 Optional Tool‑tips

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

• Every list entry is a lore line.

• Placeholders: {overlay} again works here.

• overlay-lore-locked is shown if the player lacks the per‑overlay permission.

1.4 Navigation Bar

Placed on navigation-row (0 = top). The row itself and the amount of rows define the inventory size.

Each button block shares the same structure:

prev:
  slot: 0                # column (0‑8) inside navigation‑row
  material: PAPER
  custom-model-data: 550002
  name: "&6Previous"     # display when enabled
  material-disabled: PAPER
  custom-model-data-disabled: 550000

Keys ending in -disabled are used automatically when the button would do nothing – e.g. first page ⇒ prev is disabled.

Available buttons: prev, next, outfits, back, search. (All optional – remove a block to hide it.)

The Search button enters a chat‑based filter; set material-disabled or name-disabled if you want a greyed‑out state while a filter is active.

1.5 Window Titles

titles:
  categories: "&f<shift:-11><glyph:wardrobecategory>"
  overlays:   "&f<shift:-11><glyph:wardrobe_2>"

• categories ⇒ main wardrobe index (shirt/pants/… tiles).

• overlays ⇒ per‑category list.

• Mini‑place‑holders <shift:x> and <glyph:name> come from MiniMessage – they move text or insert a resource‑pack glyph.

1.6 Categories

categories:
  shirts:
    title: "&f<shift:-11><glyph:wardrobe_2>"
    slots: [0, 1, 2, 9, 10, 11]   # where THIS tile appears in the index GUI
    item:                         # icon for the tile itself
      material: PAPER
      custom-model-data: 550000
      name: "&aShirts"

1.6.1 Category keys

1.6.2 overlay-icons

Blocks: available, locked, unequip, equipped. Any missing key falls back up the chain → category → wardrobe → hard‑coded default.

overlay-icons:
  available:
    material: PAPER
    custom-model-data: 500000
  locked:
    material: PAPER
    custom-model-data: 500002
  unequip:
    material: PAPER
    custom-model-data: 500001
  equipped:
    material: PAPER
    custom-model-data: 500012

Tip  You can delete the whole overlay-icons section if you only want to swap the tile icon but keep global overlay materials.

2. Outfits GUI (gui:)

Same idea but fewer moving parts. All keys live under gui:.

2.1 Behaviour flags

• use_player_heads: true – show each outfit as the owner’s head (with CSP textures) instead of a leather chest‑plate.

2.2 Dynamic Titles

titles:
  no_buttons:  '&f<shift:-29>ꐚ'
  left_button: '&f<shift:-29>ꐝ'
  right_button:'&f<shift:-29>ꐛ'
  both_buttons:'&f<shift:-29>ꐜ'

The GUI picks one depending on whether a Previous/Next page exists.

2.3 Button / Item blocks

Structure identical to wardrobe items:

add_button:
  material: PAPER
  custom_model_data: 550000
  display_name: '&aAdd Outfit'

All strings use Spigot colour codes (& §). List values become lore lines.

Button IDs (all optional): outfit_item • add_button • delete_button • load_button • prev_page_button • next_page_button • sign_button • tokens_display

2.4 Sign Search

sign_button adds an in‑game sign prompt; inside it you can theme:

sign_button:
  sign:
    material: OAK_SIGN
    lines:
      - '%search%'
      - '----------------'
      - 'Please enter a'
      - 'search result.'

%search% becomes the typed query when the GUI re‑opens.

3. Placeholders & Colour Codes

4. Debugging Checklist

1. Resource‑pack – verify every custom‑model‑data actually exists.

2. Material names – must match Spigot API 1.18+ (PAPER, not paper).

3. YAML syntax – spaces, not tabs; use online YAML validator if in doubt.

4. Hot reload – /clothes reload or full server restart to apply edits.