guis.yml

Wardrobe GUI configuration — layout, icons, navigation buttons, categories, and titles.

Overview

guis.yml controls the wardrobe GUI layout, item appearances, navigation buttons, and category definitions. This file lets you fully customize the look and feel of the wardrobe interface.

Full Reference

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<shift:-11><glyph:wardrobecategory>"
    overlays: "&f<shift:-11><glyph:wardrobe_2>"

  # Category definitions
  categories:
    shirts:
      page: 1
      title: "&f<shift:-11><glyph:wardrobe_2>"
      slots: [0, 1, 2, 9, 10, 11]
      item:
        material: PAPER
        custom-model-data: 550000
        name: "&aShirts"
      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
    pants:
      # ... same structure ...
    shoes:
      # ... same structure ...
    jackets:
      # ... same structure ...
    accessories:
      # ... same structure ...
    hairs:
      # ... same structure ...

# Outfits GUI Configuration
gui:
  use_player_heads: true
  titles:
    no_buttons: '&f<shift:-29>ꐚ'
    left_button: '&f<shift:-29>ꐝ'
    right_button: '&f<shift:-29>ꐛ'
    both_buttons: '&f<shift:-29>ꐜ'
  outfit_item:
    material: PLAYER_HEAD
    custom_model_data: 0
    display_name: '&e{outfit_name}'
  add_button:
    material: PAPER
    custom_model_data: 550000
    display_name: '&aAdd Outfit'
  delete_button:
    material: PAPER
    custom_model_data: 550000
    display_name: '&cDelete Outfit'
  load_button:
    material: PAPER
    custom_model_data: 550000
    display_name: '&bLoad Outfit'
  tokens_display:
    material: PAPER
    custom_model_data: 550000
    display_name: '&6Tokens: &e{tokens}'
  exit_button:
    material: BARRIER
    custom_model_data: 0
    display_name: "&cExit"

Key Sections

Overlay Item Defaults

Controls how clothing items appear in the GUI:

Setting	Description
`material`	Item material in the GUI slot
`custom-model-data`	Model ID from the plugin's resource pack (set to `0` for vanilla)
`name`	Display name — `{overlay}` is replaced with the overlay filename
`glow-enchant`	Enchantment glow effect on equipped items

Setting	Description
`rows`	GUI size in rows (2–6)
`navigation-row`	Which row (0-based) contains the navigation buttons
`prev` / `next`	Pagination buttons
`outfits`	Quick access to outfit management
`back`	Return to category view
`exit`	Close the GUI
`search`	Search overlays by name

Titles

Window titles support MiniMessage formatting including custom fonts and glyphs from resource packs. For vanilla servers, use plain &-formatted strings:

yaml

titles:
  categories: "&8Wardrobe - Categories"
  overlays: "&8Wardrobe - {category}"

Categories

Each category maps to a folder inside overlays/. The plugin ships with default categories: shirts, pants, shoes, jackets, accessories, and hairs. You can add unlimited categories.

yaml

categories:
  shirts:
    page: 1                      # Which page this category appears on
    title: "&8Shirts"
    slots: [0, 1, 2, 9, 10, 11] # GUI slots for overlay items
    item:
      material: PAPER
      custom-model-data: 550000
      name: "&aShirts"
    overlay-icons:               # Per-category icon overrides
      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

Overlay Icon	Description
`available`	Shown when the overlay can be equipped
`locked`	Shown when the player doesn't own the overlay
`unequip`	The unequip/remove button for this category
`equipped`	Shown when the overlay is currently worn

Custom Model Data: The custom-model-data values reference the plugin's built-in resource pack. Set to 0 for vanilla item appearances if using vanilla mode without the pack.

← Previousconfig.yml Next →Creator Configuration