🗂️How to configure and setup config.yml

1 Quick Start

# Wardrobe Clothes – default config.yml
enable-messages: false
accessories_limit: 3

token_settings:
  - group: default
    tokens: '1'
  - group: admin
    tokens: '5'

mineskin:
  api-key: urapikey        # supply your own key for faster generation

base_skin: true            # < UNDER DEVELOPMENT – leave as-is >
sound: true                # play a “click” when skins change

npcpreview:
  use_slowness_effect: true
  enter_message: '&fㄱ'
  exit_message:  '&fㄱ'
  npc_distance: 7          # blocks in front of the player

developer:
  self-visibility: false   # < WARNING – dev testing only >

Copy the file to plugins/WardrobeClothes/config.yml, reload the server, then edit as needed if in case you touched something and it broke.

2 Setting Reference

Path	Accepted Values	What It Does
enable-messages	`true` / `false`	Toggles chat feedback (“You equipped a hat”, “You have no accessories left”, etc.).
accessories_limit	Integer ≥ 1	Maximum accessories a player can wear simultaneously.
token_settings	One or more `{ group, tokens }` blocks	Integrates with LuckPerms. Each block grants n starting tokens to players in the specified group when they first join.
mineskin.api-key	Your MineSkin key or `""`	Optional but recommended. Higher-tier keys reduce skin-generation latency.
base_skin	`true` (placeholder)	Feature under active development. Do not change until release notes say otherwise.
sound	`true` / `false`	Plays a click when a player equips/unequips a skin.
npcpreview.use_slowness_effect	`true` / `false`	Adds a slow (zoom) potion effect during `/wardrobe` for cinematic focus.
npcpreview.enter_message	Mini-message or plain text	Title displayed when a player enters wardrobe mode. Supports NextX (NEXO) character images.
npcpreview.exit_message	Mini-message or plain text	Title shown when leaving wardrobe mode.
npcpreview.npc_distance	Integer ≥ 1	Distance (in blocks) from the player where the preview NPC spawns.
developer.self-visibility	`true` / `false`	Makes the dev account visible/invisible during previews. Leave untouched unless you are debugging the plugin.

3 MineSkin Tips

Why add a key? - The free rate limit is ~60 req/hr. Paid tiers bump that dramatically, which eliminates “waiting for skin” moments when many players join at once.
Paste your key in mineskin.api-key. No other changes are required.

4 FAQ

➤ Players don’t see chat confirmations

Set enable-messages: true, reload (/reload confirm), and test again.

➤ Someone needs more accessories than the global limit

Use LuckPerms’ per-player or per-group permission override:

lp user <name> meta set wardrobe.accessories_limit 8

(The plugin checks both config and meta values.)

➤ My preview NPC is too close / too far

Adjust npcpreview.npc_distance and run /wardrobe reload.

5 Need Help?

If something’s unclear, open a ticket or ping us in #📩ticket on Discord.
Please include:

your full config.yml
/version and /plugins output
steps to reproduce the issue