Commands and Permissions
What every ClothesPlus command does, when to use it, and which permission controls it.
This page documents the command surface exposed by ClothesPlus. The command descriptions are grouped by system so server owners can give players only the access they need.
The tutorial video library is available at Tutorial Videos. Use it beside this command reference when setting up the plugin for the first time.
Command syntax notes
<value> means the value is required. [value] means it is optional.
<overlay>[,<overlay>...] means one overlay or multiple comma-separated overlays. For example, hats/redhat,jackets/black_jacket.
Most player-facing commands require the player to be online because ClothesPlus reads or writes skin, overlay, GUI, camera, or NPC preview state.
Admins with wardrobeclothes.admin can use admin-only operations and, for supported /clothes actions, can target another online player through the admin forms shown below.
First-run admin flow
Run these after installation before opening the plugin to normal players:
/clothes wiki
/clothes apikey <mineskin-api-key>
/clothes extract
/clothes cursor generate
/clothes cursor reload
/clothes reload/clothes wiki prints the local admin wiki URL and the docs file path when the bundled wiki is enabled.
/clothes apikey <mineskin-api-key> saves your MineSkin key and immediately reloads the MineSkin client. This avoids relying on testing keys during real server usage.
/clothes extract extracts the bundled overlay pack into the plugin data folder. It also reloads overlay data and refreshes cursor systems when available.
/clothes cursor generate scans overlay folders and creates missing generated cursor data without overwriting edited cursor layouts.
/clothes cursor reload reloads cursor configuration, overlays, and active creator sessions.
/clothes reload reloads the plugin configuration after setup changes.
Player menu commands
/wardrobe
Opens the wardrobe overlay GUI for the player. Players use this to browse and apply wardrobe overlays from configured categories.
Permission: wardrobeclothes.use
If base_skin: false, ClothesPlus requires the player to select a body type and save palette data before the wardrobe opens. This keeps Alex, Steve, female, and skin-tone overlay handling consistent.
/wardrobe reload
Reloads wardrobe page configuration, category titles, GUI layout data, and overlay cache state.
Permission: wardrobeclothes.wardrobe.reload, wardrobeclothes.reload, or wardrobeclothes.admin
Use this after changing wardrobe page YAML files or generated wardrobe overlay settings.
/outfits
Opens the saved outfit GUI. Players use this to browse outfits they saved with /clothes save.
Permission: wardrobeclothes.outfits
/cskins
Opens the custom skins GUI. This is separate from normal outfit overlays and is controlled by the wardrobeclothes.cskins permission family.
Permission: wardrobeclothes.cskins
/cgifts
Opens the received gifts menu.
Permission: wardrobeclothes.cgifts
/cgifts sent
Opens the sent gifts menu so the player can review gifts they sent.
Permission: wardrobeclothes.cgifts
/npcpreview [player]
Toggles an NPC preview for your own skin, or previews another online player when a player name is supplied.
Permission: wardrobeclothes.npc
Previewing another player also requires wardrobeclothes.npcpreview.other or admin access.
Core /clothes commands
/clothes help [page]
Shows the in-game ClothesPlus command help. Use page numbers when the help output spans multiple pages.
Permission: wardrobeclothes.use
/clothes info
Shows plugin information and useful links.
Permission: wardrobeclothes.use
/clothes model
Shows the player's detected Mojang skin model and the compatible overlay body type ClothesPlus will use.
Permission: wardrobeclothes.use
Use this when a player reports that an overlay fits the wrong arm size or body model.
/clothes download
Uploads the player's current skin and returns a download link.
Permission: wardrobeclothes.use
Use this when a player wants a copy of the skin result after overlays have been applied.
/clothes wear <overlay>[,<overlay>...] [ticks]
Applies one or more overlays to the player's current skin.
Permission: wardrobeclothes.use
The player must also have access to the specific overlay unless an admin bypass is being used. Overlay access is normally controlled with wardrobeclothes.overlay.* or more specific overlay permissions from your configuration.
The optional ticks value is used by the plugin's timed overlay handling. Use it only when you intentionally want the wear action to be time-based.
/clothes unwear <overlay>[,<overlay>...] [ticks]
Removes one or more currently worn overlays.
Permission: wardrobeclothes.use
Use the same overlay ids used by /clothes wear. The optional ticks value follows the plugin's timed overlay handling.
/clothes save <outfitName>
Saves the player's currently worn overlays as a named outfit.
Permission: wardrobeclothes.save
Players can load this outfit later from /clothes load or the /outfits GUI.
/clothes load <outfitName>
Loads a saved outfit by name.
Permission: wardrobeclothes.load
This replaces the player's current overlay state with the saved outfit state.
/clothes delete <outfitName>
Deletes one of the player's saved outfits.
Permission: wardrobeclothes.delete
This only deletes the saved outfit entry. It does not delete overlay files from the server.
/clothes admin delete <player> <outfitName>
Deletes another player's saved outfit.
Permission: wardrobeclothes.admin.delete or wardrobeclothes.admin
Use this for moderation or cleanup when a player cannot remove an outfit themselves.
/clothes add <player> <tokens>
Adds outfit tokens to an online player.
Permission: wardrobeclothes.addtoken
The token amount must be within the plugin's accepted range.
/clothes remove <player> <tokens>
Removes outfit tokens from an online player.
Permission: wardrobeclothes.removetoken
Use this to correct balances or undo accidental token grants.
/clothes refresh
Refreshes the player's currently applied skin.
Permission: wardrobeclothes.refresh or wardrobeclothes.admin
Use this when the skin should be re-applied without changing the player's saved outfit or overlay choices.
/clothes reset
Resets the player's skin, overlays, and character data where applicable.
Permission: wardrobeclothes.reset or wardrobeclothes.admin
Use this for recovery when a player's overlay state, selected body type, or generated skin state is wrong.
Base-skin and palette commands
These commands are most important when base_skin: false.
/clothes selection
Re-opens the body type selection UI.
Permission: wardrobeclothes.selection
Use this when a player needs to choose a different configured body type before using wardrobe overlays.
/clothes select <alex_male|steve_male|female>
Sets the player's body type directly from command input.
Permission: wardrobeclothes.selection
This is useful for admins or scripted setup flows because it skips reopening the selection GUI.
/clothes palette
Starts the skin-tone palette mapper.
Permission: wardrobeclothes.palette
This lets ClothesPlus map skin tones correctly for base-skin overlays.
/clothes palette view
Shows the player's saved palette mapping.
Permission: wardrobeclothes.palette
Use this for support when checking whether a player has completed palette setup.
/clothes palette reset
Deletes the player's saved palette mapping.
Permission: wardrobeclothes.palette
Use this when a player selected the wrong palette or changed base-skin setup.
Admin and maintenance commands
/clothes reload
Reloads plugin configuration.
Permission: wardrobeclothes.reload or wardrobeclothes.admin
This is the general reload command after editing ClothesPlus configuration files.
/clothes debug
Runs a read-only cursor overlay validation scan. It checks for invalid cursor folders and corrupt or non-64x64 cursor PNGs.
Permission: clothesplus.cursor.reload or wardrobeclothes.admin
Use this before regenerating cursor data when creator overlays do not appear correctly.
/clothes cache stop [player]
Stops active cache work globally or for a specific online player.
Permission: wardrobeclothes.cache or wardrobeclothes.admin
Use this when skin generation or cache operations need to be paused.
/clothes cache status
Reports active cache operations and whether global stop mode is active.
Permission: wardrobeclothes.cache or wardrobeclothes.admin
Use this before deciding whether to stop, continue, or delete cache data.
/clothes cache continue
Resumes enhanced cache work when it can continue and clears the global stop flag.
Permission: wardrobeclothes.cache or wardrobeclothes.admin
/clothes cache delete <player|all>
Deletes personal cache data for one player or all players after GUI confirmation.
Permission: wardrobeclothes.cache or wardrobeclothes.admin
This does not delete shared cache data.
/clothes apikey <key>
Saves the MineSkin API key to configuration and immediately applies it to the MineSkin client.
Permission: wardrobeclothes.admin
This command can be run from console.
/clothes extract
Extracts bundled overlays.zip into the plugin data folder, reloads overlay management, and refreshes cursor data when available.
Permission: wardrobeclothes.admin
This command can be run from console. It reports extracted files, directories, skipped files, and warnings.
/clothes wiki
Prints the local admin wiki URL and wiki file path.
Permission: wardrobeclothes.wiki or wardrobeclothes.admin
This command requires the bundled wiki to be enabled.
/clothes previewer refresh
Refreshes active previewer displays.
Permission: wardrobeclothes.admin
From console, it refreshes all active preview displays. From a player, it refreshes that player's preview target.
/clothes previewer reload
Reloads previewer configuration.
Permission: wardrobeclothes.admin
Use this after editing previewer position, DynamicUV, or display settings.
/clothes nsl
Internal diagnostic command that forces NSL folder generation for the target player.
Permission: wardrobeclothes.admin
This is not part of the normal player setup flow.
Resource pack commands
/clothes pack apply
Rebuilds the served resource pack from editable files and sends the updated pack to players.
Permission: wardrobeclothes.pack or wardrobeclothes.admin
Use after editing pack files manually.
/clothes pack reload
Rereads resource pack settings and rebuilds without forcing bundled files to be re-extracted.
Permission: wardrobeclothes.pack or wardrobeclothes.admin
Use after changing pack configuration.
/clothes pack restore-bundled
Restores bundled plugin pack files from the jar, rebuilds the pack, and resends it.
Permission: wardrobeclothes.pack or wardrobeclothes.admin
Use this when the editable pack files are broken and you need to return to plugin defaults.
/clothes pack restore
Alias for restoring bundled pack files.
Permission: wardrobeclothes.pack or wardrobeclothes.admin
/clothes pack wardrobe-icons
Generates wardrobe overlay icons and overlay configuration data, then rebuilds the resource pack.
Permission: wardrobeclothes.pack or wardrobeclothes.admin
Use this after adding wardrobe overlays that need generated GUI icons.
Cursor creator commands
/ccreator is a shortcut for the cursor creator. It uses the same creator handler as /clothes cursor.
/ccreator
Starts the cursor creator.
Permission: clothesplus.cursor.use
/ccreator start [section]
Starts the creator at a section. If no section is supplied, the plugin uses the default section.
Permission: clothesplus.cursor.use
/ccreator open [section]
Opens the creator, optionally at a section.
Permission: clothesplus.cursor.use
/ccreator section <section>
Moves the current creator session to a section.
Permission: clothesplus.cursor.use
/ccreator exit
Exits the current creator session.
Permission: clothesplus.cursor.use
/clothes cursor
Starts the cursor creator.
Permission: clothesplus.cursor.use
/clothes cursor start [section]
Starts the creator at the supplied section.
Permission: clothesplus.cursor.use
/clothes cursor open [section]
Opens the creator at the supplied section.
Permission: clothesplus.cursor.use
/clothes cursor section <section>
Switches the current creator session to another section.
Permission: clothesplus.cursor.use
/clothes cursor exit
Exits the current creator session.
Permission: clothesplus.cursor.use
Aliases include stop and close.
/clothes cursor editor [section]
Opens the admin editor for cursor UI buttons and text.
Permission: clothesplus.cursor.editor or wardrobeclothes.admin
Use this to edit creator layout without manually changing every setting in files.
/clothes cursor editor save
Saves staged cursor editor changes.
Permission: clothesplus.cursor.editor or wardrobeclothes.admin
/clothes cursor editor buttontext <size>
Stages the background button text size while in an editor session.
Permission: clothesplus.cursor.editor or wardrobeclothes.admin
/clothes cursor editor buttonposition <y,x>
Stages the background button text position while in an editor session.
Permission: clothesplus.cursor.editor or wardrobeclothes.admin
The command also accepts separated values as <y> <x>.
/clothes cursor editor colours <size>
Stages the hair or eye color block size.
Permission: clothesplus.cursor.editor or wardrobeclothes.admin
The American spelling colors is also accepted in related aliases.
/clothes cursor editor colourcount <count>
Stages how many palette colors are visible per page.
Permission: clothesplus.cursor.editor or wardrobeclothes.admin
Aliases include colorcount, colours-per-page, colors-per-page, and palettecount.
/clothes cursor reload
Reloads cursor configuration, overlays, and active sessions.
Permission: clothesplus.cursor.reload or wardrobeclothes.admin
Use this after editing creator config or generated cursor data.
/clothes cursor generate
Validates overlay folders and adds missing generated cursor data without rewriting edited layouts.
Permission: clothesplus.cursor.reload or wardrobeclothes.admin
Use this after adding new creator overlay folders.
/clothes cursor restore [force]
Restores bundled cursor UI configuration defaults.
Permission: clothesplus.cursor.reload or wardrobeclothes.admin
Without force, it restores damaged configs. With force, it restores all bundled cursor UI configs.
/clothes cursor setcamera
Saves the player's current location, yaw, and pitch as the creator camera.
Permission: clothesplus.cursor.admin or wardrobeclothes.admin
Stand where the preview should face before running this.
/clothes cursor setjoincamera
Saves the player's current location, yaw, and pitch as the first-join creator camera.
Permission: clothesplus.cursor.admin or wardrobeclothes.admin
/clothes cursor refresh
Refreshes creator display entities and NPC positions for the current creator session.
Permission: clothesplus.cursor.admin or wardrobeclothes.admin
/clothes cursor resetplayer <player>
Resets one player's creator data.
Permission: clothesplus.cursor.admin or wardrobeclothes.admin
This can be used for offline players that have joined before.
/clothes cursor resetall
Resets all character creator data.
Permission: clothesplus.cursor.admin or wardrobeclothes.admin
Use with care because this affects every saved creator profile.
/clothes cursor triggerjoin [player]
Triggers the first-join UI for yourself or an online target player.
Permission: clothesplus.cursor.admin or wardrobeclothes.admin
This only works when first-join creator flow is enabled.
/clothes cursor cinematic ...
Legacy alias for /clothes cinematic ....
Permission: clothesplus.cinematic.admin
Use /clothes cinematic directly in new documentation or staff instructions.
Cinematic commands
All cinematic commands require clothesplus.cinematic.admin or admin access.
/clothes cinematic new <id>
Creates an empty cinematic path.
Use this before adding keyframes manually.
/clothes cinematic add <id> [duration] [easing]
Adds the player's current location, yaw, and pitch as a keyframe.
duration is measured in ticks. The default is 40. Easing options include LINEAR, EASE_IN, EASE_OUT, EASE_IN_OUT, and SMOOTH.
/clothes cinematic add action <id> <tick> <console|player|message|title|sound> <value...>
Adds a timed action to a cinematic path.
Use console for console commands, player for player commands, message for chat messages, title for title/subtitle display, and sound for sound playback. Title values use title|subtitle.
/clothes cinematic record start <id> [interval-ticks]
Starts recording player movement into a cinematic path.
The default recording interval is 10 ticks.
/clothes cinematic record keyframe [duration] [easing]
Adds a manual keyframe while recording.
Alias: kf
/clothes cinematic record stop
Stops recording and saves the cinematic path.
/clothes cinematic record cancel
Cancels recording without saving the path.
/clothes cinematic play <id[,id...]> [transition-ticks]
Plays one path or a comma-separated sequence of paths.
When multiple paths are supplied, the transition default is 20 ticks.
/clothes cinematic stop
Stops current cinematic playback.
/clothes cinematic list
Lists cinematic paths, keyframe counts, action counts, durations, and first-join marker information.
/clothes cinematic delete <id>
Deletes a cinematic path.
/clothes cinematic firstjoin <id[,id...]|none> [transition-ticks]
Sets or disables the first-join cinematic for runtime use.
Use none to disable it. Update the config too if you need the change to persist across restarts.
/clothes cinematic reload
Reloads cinematic paths from disk.
/clothes cinematic scale <id> <multiplier>
Scales keyframe durations for a path.
Use values above 1 to slow the path down and values below 1 to speed it up.
Clothing store commands
/cstore
Opens the first configured clothing store.
Permission: wardrobeclothes.cstore
/cstore <store-id>
Opens a specific configured clothing store.
Permission: wardrobeclothes.cstore
If the store has a store-specific permission, the player must also have that permission. Store wildcard access is controlled by wardrobeclothes.cstore.*.
/cstore reload
Reloads clothing store configs, generated YAML files, and overlay cache state.
Permission: wardrobeclothes.cstore.admin, wardrobeclothes.reload, or wardrobeclothes.admin
/cstore setcamera [store-id]
Saves the player's current location as the preview camera for a store.
Permission: wardrobeclothes.cstore.admin or wardrobeclothes.admin
If no store is supplied, ClothesPlus tries to use the last store the player opened.
Barber commands
/barber
Opens the first configured barbershop in hair mode.
Permission: wardrobeclothes.barber
/barber <shop-id>
Opens a configured barbershop.
Permission: wardrobeclothes.barber
If the shop has a shop-specific permission, the player must also have it. Barber wildcard access is controlled by wardrobeclothes.barber.*.
/barber hair <shop-id>
Opens a barbershop in hair mode.
Permission: wardrobeclothes.barber
/barber beards <shop-id>
Opens a barbershop in beard mode.
Permission: wardrobeclothes.barber
/barber reload
Reloads barbershop configs, generated YAML files, and overlay cache state.
Permission: wardrobeclothes.barber.admin, wardrobeclothes.reload, or wardrobeclothes.admin
/barber setcamera [hair|beards] <shop-id>
Saves the player's current location as the preview camera for a barbershop mode.
Permission: wardrobeclothes.barber.admin or wardrobeclothes.admin
When possible, ClothesPlus can infer the last shop and mode the player used.
Sewing commands
/sew
Opens the sewing machine GUI.
Permission: wardrobeclothes.sew
Recipe permissions are handled by the sewing permission family. wardrobeclothes.sewing.* grants access to every sewing recipe permission.
Permission reference
Core permissions
| Permission | Purpose |
|---|---|
wardrobeclothes.use | Core /clothes and /wardrobe access |
wardrobeclothes.admin | Admin operations and broad staff bypasses |
wardrobeclothes.admin.delete | Delete another player's saved outfit |
wardrobeclothes.reload | Plugin reload access |
wardrobeclothes.wardrobe.reload | Wardrobe-only reload access |
wardrobeclothes.refresh | Refresh current applied skin |
wardrobeclothes.reset | Reset skin, overlays, and character data |
wardrobeclothes.cache | Cache stop, status, continue, and delete commands |
wardrobeclothes.pack | Resource pack rebuild and restore commands |
wardrobeclothes.wiki | Wiki URL command |
wardrobeclothes.overlay.* | Access every overlay permission |
wardrobeclothes.selection | Body type selection commands |
wardrobeclothes.palette | Palette mapper commands |
Outfit and custom skin permissions
| Permission | Purpose |
|---|---|
wardrobeclothes.outfits | Open saved outfit GUI |
wardrobeclothes.save | Save outfits |
wardrobeclothes.load | Load outfits |
wardrobeclothes.delete | Delete own outfits |
wardrobeclothes.cskins | Open custom skin GUI |
wardrobeclothes.cskins.save | Save custom skins |
wardrobeclothes.cskins.load | Load custom skins |
wardrobeclothes.cskins.delete | Delete custom skins |
wardrobeclothes.addtoken | Add outfit tokens |
wardrobeclothes.removetoken | Remove outfit tokens |
Creator and cinematic permissions
| Permission | Purpose |
|---|---|
clothesplus.cursor.use | Use /ccreator and /clothes cursor |
clothesplus.cursor.reload | Cursor reload, generate, restore, and debug operations |
clothesplus.cursor.editor | In-game cursor layout editor |
clothesplus.cursor.admin | Creator camera, refresh, reset, and first-join operations |
clothesplus.cinematic.admin | Cinematic path management |
Store, barber, preview, and sewing permissions
| Permission | Purpose |
|---|---|
wardrobeclothes.npc | Toggle own NPC preview |
wardrobeclothes.npcpreview.other | Preview another online player |
wardrobeclothes.cstore | Open clothing stores |
wardrobeclothes.cstore.admin | Reload stores and save store cameras |
wardrobeclothes.cstore.* | All clothing store permissions |
wardrobeclothes.cgifts | Gift menus |
wardrobeclothes.barber | Open barbershops |
wardrobeclothes.barber.admin | Reload barbershops and save barber cameras |
wardrobeclothes.barber.* | All barber permissions |
wardrobeclothes.sew | Open sewing machine GUI |
wardrobeclothes.sewing.* | Craft every sewing recipe |