ClothesPlus, Wardrobe Plugin v3.1.4

ClothesPlus 3.1.4 Changelog
This release is a major stability, preview, resource-pack, creator, and quality-of-life update for ClothesPlus. It focuses on reducing MineSkin dependency during previews, removing the old NPC preview system, improving setup for new server owners, and making existing installations migrate cleanly.
Highlights

• Replaced the old NPC preview system with DynamicUV preview avatars.
• Removed
  Code:

  /npcpreview

  and the legacy PacketEvents NPC preview implementation.
• Added
  Code:

  /ccreator

  as a faster shortcut for the cursor character creator.
• Added
  Code:

  /clothes apikey <key>

  so MineSkin API keys can be set and applied from in-game.
• Added
  Code:

  /clothes extract

  to extract bundled
  Code:

  overlays.zip

  into the ClothesPlus data folder.
• Added automatic PacketEvents dependency installation from the bundled dependency when missing.
• Added YAML/default auto-updating for existing servers so new config/UI keys are added on update.
• Reworked cinematic camera commands and internals for smoother recorded and keyframed camera paths.
• Improved resource-pack generation, pack outputs, duplicate asset handling, and generated icon caching.
• Improved wardrobe, creator, cstore, barber, outfits, and custom-skin preview behavior.

Compatibility

• Requires Java 21 or newer.
• Targets modern Paper 1.21+ servers.
• Folia supported.
• Optional integrations include LuckPerms, Vault, ItemsAdder, Nexo, Oraxen, and CraftEngine.
• PacketEvents is still used by ClothesPlus, but ClothesPlus can now install the bundled PacketEvents jar automatically if the server does not already have it.

Breaking / Removed

• Removed the old
  Code:

  /npcpreview

  command.
• Removed
  Code:

  wardrobeclothes.npc

  and old NPC preview permissions.
• Removed the legacy
  Code:

  org.wardrobeclothes.npcpreview

  implementation.
• Removed PacketEvents NPC preview spawning from creator and previewer flows.
• Removed NPC fallback behavior. Preview flows now use DynamicUV when enabled/available, or the original natural preview flow without an avatar.
• Removed dead config sections such as the old standalone
  Code:

  npcpreview

  block.

Note: Some YAML keys are still named

Code:

npc:

or

Code:

npc-preview:

for backwards compatibility with existing user configs. These keys now control the DynamicUV preview avatar only. They do not spawn NPCs.
DynamicUV Preview Avatar

• Added DynamicUV preview avatar support across preview systems.
• Creator, wardrobe, cstore, barber, outfits, and cskins previews now use a local DynamicUV avatar instead of creating a new uploaded skin for every preview step.
• Preview texture changes now update the local avatar instead of constantly relying on MineSkin.
• Added DynamicUV animation configuration in
  Code:

  uis/creator/dynamicuv_animations.yml

  .
• Added support for
  Code:

  .bbmodel

  idle animations loaded from
  Code:

  uis/creator/dynamicuv_animations/

  .
• Added per-previewer animation toggles for wardrobe, cstore, barber, outfits, and cskins.
• Added creator class idle support so classes can use different idle animations.
• Added 2nd-layer handling for DynamicUV avatar parts to avoid visual clashes.
• Improved Steve/Alex slim-arm UV alignment and right-arm/forearm sizing.
• Improved avatar scale handling and live height/scale preview.
• Prevented animation restarts/stutters when only the preview texture changes.

Character Creator

• Added
  Code:

  /ccreator

  as a direct shortcut to the cursor creator.
• Removed cooldowns from
  Code:

  /wardrobe

  and
  Code:

  /clothes cursor creator

  flows.
• Improved creator UI hitbox math for buttons, labels, side panels, and editor elements.
• Improved hold-and-drag behavior in the cursor editor.
• Fixed text/name editing in the creator editor.
• Improved side-panel next/previous button hit detection.
• Improved color panel interactions for eyes, hair colors, and other palette-driven sections.
• Improved race/class filtering and availability handling.
• Improved human/elf availability handling for eye types and hair colors.
• Added better editor recovery when dragging/resizing releases unexpectedly.
• Improved cursor editor save/reload behavior.
• Added better creator diagnostics for invalid folders, corrupt cursor PNGs, and non-64x64 cursor textures.

Cinematic Camera System

• Reworked cinematics around top-level
  Code:

  /clothes cinematic

  commands.
• Added
  Code:

  /clothes cinematic new

  .
• Added
  Code:

  /clothes cinematic add

  .
• Added
  Code:

  /clothes cinematic record

  .
• Added
  Code:

  /clothes cinematic play

  .
• Added
  Code:

  /clothes cinematic stop

  .
• Added
  Code:

  /clothes cinematic list

  .
• Added
  Code:

  /clothes cinematic delete

  .
• Added
  Code:

  /clothes cinematic firstjoin

  .
• Added
  Code:

  /clothes cinematic reload

  .
• Kept
  Code:

  /clothes cursor cinematic

  as a legacy alias.
• Added precompiled per-tick camera timelines.
• Added smoother keyframe interpolation and camera playback.
• Improved head/yaw/pitch smoothing during camera turns.
• Added timed cinematic actions inspired by Typewriter-style sequencing.
• Improved restore-state handling when cinematics end or are interrupted.
• Added first-join cinematic support through creator configuration.

Wardrobe, Outfits, and Overlay Handling

• Fixed overlay previews not showing complete composed skins in cstore/preview lore.
• Fixed wardrobe overlays not appearing correctly in preview flows.
• Fixed removing jackets, beards, and similar overlay categories reverting too much of the skin.
• Improved overlay rollback behavior when MineSkin generation fails.
• If MineSkin generation fails, clothing/overlay state is restored instead of silently equipping a failed change.
• Improved wardrobe outfit behavior so outfit overlays properly replace conflicting clothing categories and can be removed again.
• Improved wardrobe behavior for outfit category conflicts with shirts, jackets, pants, and shoes.

# ClothesPlus v3.0.4 — Changelog

Release Date: March 21, 2026
Minecraft Support: 1.20.x – 1.21.10+
PacketEvents: 2.11.3

---

## New Features

### Wardrobe Category Pagination (Multi-Page Categories)
The wardrobe categories menu now supports multiple pages, allowing servers with many overlay categories to spread them across separate pages with individual titles.

How it works:

• Each category in guis.yml can optionally specify page: <number> (defaults to 1 if omitted)
• A new wardrobe.pages section defines per-page titles
• Prev / Next navigation buttons appear automatically when more than one page exists
• Clicking "Back" from an overlay menu returns the player to the same page they were on
• Fully backward-compatible — existing configs without page or pages work identically to before

Configuration (guis.yml):

YAML:

wardrobe:
  # Per-page title overrides
  pages:
    1:
      title: "&6&lWardrobe - Categories"
    2:
      title: "&6&lWardrobe - More Categories"

  categories:
    shirts:
      page: 1                              # appears on page 1
      slots: [0, 1, 2, 9, 10, 11]
      # ...existing item/overlay-icons...
    eyes:
      page: 2                              # appears on page 2
      slots: [0, 1, 2, 9, 10, 11]
      # ...

Details:

• Pages can have unlimited categories, each with their own slot positions
• The Prev / Next buttons use the existing disabled material variants on boundary pages
• The Exit button in the navigation bar now properly closes the inventory
• Page state is cleaned up on player quit to prevent memory leaks
• Running /clothes reload hot-reloads page definitions without a restart

---

### Auto-Migration of guis.yml for Existing Servers
Servers upgrading from v3.0.3 or earlier no longer need to manually edit guis.yml. On startup, the plugin automatically:

1. Injects the pages section after wardrobe.titles if missing — includes default page 1 title and a commented-out page 2 example
2. Adds page: 1 to every existing category that lacks a page property

All injections preserve existing formatting, comments, and custom values. A log message confirms each migration step.

---

### Exit Button Now Functional in Wardrobe
The exit button defined in wardrobe.navigation was previously configured but non-functional. It now properly closes the inventory when clicked.

---

## Technical Notes

• Minimum Java Version: 21
• API Version: 1.21+
• Folia Support: Yes
• All changes are fully backwards-compatible with existing configs
• The page property defaults to 1 — no config changes required for single-page setups

---

Thank you for using ClothesPlus! Report issues on our support channel.

---
---

# ClothesPlus v3.0.3 — Patch Changelog

Release Date: March 19, 2026
Minecraft Support: 1.20.x – 1.21.10+
PacketEvents: 2.11.3

---

## Bug Fixes

### Scale/Height Section Not Showing Options Until Manual Refresh
The scale/height section in the character creator would appear as if no options were available. Players had to manually save cursor_creator.yml and run /clothes cursor refresh for scale options to actually appear.

Root Cause: The scale section and its configuration were not being auto-injected into existing user configs on plugin load. Users who updated the plugin without manually copying the new scale section from the default config would see an empty section.

Fix: The scale section (with default height presets) is now automatically injected into cursor_creator.yml on startup if missing. This happens before the YAML is parsed, so it works immediately — no manual save/refresh needed. The injection also adds a scale button to the main menu if one isn't present.

---

### Scale Value Not Written When Saving Config via Regenerate
When using /clothes cursor regenerate or any config save operation, the scale-value field for cycle options was silently dropped. This meant regenerated configs would lose all scale preset values.

Fix: The writeSectionToConfig method now properly serializes scale-value for cycle options alongside all other properties.

---

## New Features

### Scale System Enable/Disable Toggle
A new scale-system-enabled option has been added to cursor_creator.yml, allowing server admins to completely enable or disable the height/scale feature.

YAML:

# Enable scale/height system (uses Minecraft 1.20.5+ generic.scale attribute)
# When true: Height button shows on main menu, players can adjust their character height
# When false: Height button hidden, scale selection unavailable
# NOTE: Requires Minecraft 1.20.5+ for the attribute to actually work
scale-system-enabled: true

When disabled (false):

• The Height button is hidden from the main creator menu
• The scale section cannot be opened
• Scale is not applied to players or NPCs

---

### Auto-Injection of Scale Section for Existing Configs
Users upgrading from older versions no longer need to manually copy the scale section into their cursor_creator.yml. On every load/reload, the plugin checks for:

1. scale-system-enabled — Injected after class-system-enabled if missing
2. scale section under sections: — Full default scale section with 5 height presets (Tiny, Short, Normal, Tall, Giant) injected if missing
3. scale button in the main menu — Height button auto-added before the exit button if missing

All injections preserve existing formatting and comments.

---

## Technical Notes

• Minimum Java Version: 21
• API Version: 1.18+
• Folia Support: Yes
• All changes are fully backwards-compatible with existing configs

---

Thank you for using ClothesPlus! Report issues on our support channel.

---
---

# ClothesPlus v3.0.2 — Changelog

Release Date: March 18, 2026
Minecraft Support: 1.20.x – 1.21.10+
PacketEvents: 2.11.3

---

## Bug Fixes

### Cursor System Lag/Freeze on 1.21.2 – 1.21.9 (Critical Fix)
The cursor in /wardrobe (cursor mode) and /outfits previewer would freeze on servers running Minecraft 1.21.2 – 1.21.9. The cursor item would only jump to the correct position when the player pressed Shift, then freeze again.

Root Cause: On MC 1.21.2-1.21.9, the combination of mounting the player on a pig AND repeatedly sending WrapperPlayServerCamera packets pointing at that pig every tick causes the Minecraft client to suppress PLAYER_ROTATION packets. Without rotation data, the cursor position cannot be calculated.

Fix (3 layers):
1. Throttled camera packet resends — Camera packets are now sent only on mount/remount and every 20 ticks (1s) instead of every tick. This prevents the client from suppressing PLAYER_ROTATION packets.
2. PLAYER_INPUT rotation sync — On 1.21.2+, PLAYER_INPUT packets are sent by the client as a heartbeat. When no recent PLAYER_ROTATION packet has been received, we use PLAYER_INPUT as a trigger to force-sync rotation from Bukkit's player.getLocation().
3. Faster Bukkit fallback — Reduced the Bukkit location rotation fallback threshold from 500ms to 100ms (~2 ticks), so the cursor recovers almost immediately when packet-based tracking fails.
4. Added VehicleExitEvent handler for the Previewer system to prevent pig dismounting via Bukkit API (was already present in Cursor system but missing from Previewer).

Affected systems: Cursor menu, Previewer (/wardrobe, /outfits)

---

### Multiverse-Core Compatibility — Cursor Not Spawning in Mob-Disabled Worlds
On servers using Multiverse-Core with animal/mob spawning disabled per-world, the cursor system would fail to start. The cursor item wouldn't appear, and the previewer would get stuck.

Root Cause: ClothesPlus spawns a Pig (invisible camera mount) and an ArmorStand (cursor marker) as part of the cursor/previewer system. When Multiverse-Core disables mob spawning in a world, it cancels the CreatureSpawnEvent for these entities — preventing them from ever being created.

Fix: A new entity spawn protection system tags all ClothesPlus-spawned entities via PersistentDataContainer at spawn time. A CreatureSpawnEvent listener at HIGHEST priority detects tagged entities that were cancelled by other plugins and un-cancels them. This ensures ClothesPlus entities always spawn, without affecting general mob spawning rules set by Multiverse-Core or similar plugins.

Affected systems: Cursor menu, Previewer (/wardrobe, /outfits)
Compatibility: Works with Multiverse-Core, Multiverse-Inventories, and any plugin that cancels CreatureSpawnEvent

---

### GUI Buttons Not Working on 1.21.4 (Critical Fix)
The /wardrobe and overlay selection menus were completely unresponsive on servers running Minecraft 1.21+. Clicking any button — categories, overlays, pagination, outfits — did nothing.

Cause: Paper 1.21 changed InventoryView from an abstract class to an interface. Any plugin compiled against the older API that calls getView().getTitle() directly would crash with a NoSuchMethodError at runtime, silently breaking all inventory click handling.

Fix: All GUI title checks now use a new reflection-based compatibility layer (CompatInventory.getTitle()) that works seamlessly on both 1.20.x and 1.21.4+ servers.

Affected menus: Wardrobe categories, overlay selection, pagination (prev/next), outfit manager, search

---

### NPC Preview Not Reacting to Clicks
Left-clicking and right-clicking the NPC in /npcpreview was not triggering spin toggles on 1.21.4.

Cause: The packet listener was incorrectly grouping all interaction types together and only processing ATTACK actions. Right-click interactions (INTERACT / INTERACT_AT) were never handled.

Fix: The NPC packet listener now properly separates:

• Left-click on NPC → Toggle counter-clockwise spin
• Right-click on NPC → Toggle clockwise spin
• Left-click in air → Toggle counter-clockwise spin
• F key (swap hand) → Zoom in / out

---

### Outfit Loading Reverts to Default Skin
When using /outfit to save an outfit and then clicking it to load, the player's skin would briefly show the outfit and then snap back to their original Mojang skin.

Cause: The outfit loader called resetPlayerSkins() before applying overlays, which triggers an async HTTP request to the Mojang session server. This request would complete after the outfit overlays were already applied, overwriting them with the vanilla skin.

Fix: Outfit loading no longer calls the Mojang API reset. Instead, it clears the current overlay list in-memory and applies the saved outfit overlays directly — no race condition, no flickering.

---

### PacketEvents Updated to 2.11.3
Upgraded the PacketEvents dependency from 2.11.1 to 2.11.3, bringing:

• Full 1.21.4 protocol support
• NPC team name uniqueness fixes
• Entity spawn packet improvements
• Registry synchronization fixes

---

## New Features

### Player Scale / Height Selection (1.20.5+)
Players can now adjust their character's height in the character creator. A new Height category appears in the main menu, allowing players to cycle through configurable scale options.

How it works:

• Each click on Previous/Next cycles through scale presets (e.g., Tiny → Short → Normal → Tall → Giant)
• Scale is applied instantly to the player using the generic.scale attribute
• The NPC preview reflects the selected scale in real-time — the NPC visually grows or shrinks
• Scale persists across sessions and server restarts (saved in character data JSON)
• Scale is re-applied automatically on player join

Configuration (cursor_creator.yml):

YAML:

sections:
  scale:
    title: <gradient:#32CD32:#228B22>━━ 📏 Height ━━</gradient>
    cycle-enabled: true
    show-navigation: true
    cycle-options:
      - id: scale_tiny
        display: <gray>Tiny
        scale-value: 0.5
      - id: scale_normal
        display: <green>Normal
        scale-value: 1.0
      - id: scale_tall
        display: <aqua>Tall
        scale-value: 1.2
      # Add as many options as you want!

Details:

• The scale-value field accepts any double from 0.0625 (1/16th) to 16.0 (16× size)
• Reasonable values for roleplay are 0.5 – 2.0
• Requires Minecraft 1.20.5+ for the generic.scale attribute; on older servers the section appears but scale won't visually apply
• NPC preview scale works in all three systems: Character Creator, Previewer (/outfits), and NPC Preview (/npcpreview)

---

### /npcpreview <playername> — Preview Another Player's Skin
You can now preview any online player's current appearance by specifying their name.

Usage:

Code:

/npcpreview              — Preview your own skin (existing behavior)
/npcpreview Steve        — Preview Steve's current skin/outfit

Details:

• Tab-completion for online player names
• Requires wardrobeclothes.npcpreview.other permission (or wardrobeclothes.admin)
• The NPC shows the target player's current skin including any active overlays
• All existing controls work (spin, zoom, toggle stop)

---

### PlaceholderAPI Integration
ClothesPlus now registers a full PlaceholderAPI expansion that exposes skin and overlay data to any plugin that supports PAPI.

Available Placeholders:

| Placeholder | Description |
|---|---|
| %clothesplus_skin_texture% | Current skin texture value (Base64) |
| %clothesplus_skin_signature% | Current skin signature value |
| %clothesplus_overlays% | Comma-separated list of currently worn overlays (or none) |
| %clothesplus_overlay_count% | Number of currently worn overlays |
| %clothesplus_has_overlay_<path>% | Whether the player is wearing a specific overlay (true/false) |
| %clothesplus_model% | Player's skin model type (steve/alex) |

Example: %clothesplus_has_overlay_hairs/wizard_hat% → true if the player has that overlay equipped.

Use Cases:

• Display outfit info on scoreboards, tab lists, or holograms
• Save/restore skin states via external plugins
• Conditional logic in DeluxeMenus, ConditionalEvents, etc.

Requires PlaceholderAPI to be installed (soft dependency).

---

### Item Model Component Support (1.21.4+)
ClothesPlus now supports Minecraft's item_model component alongside traditional Custom Model Data.

Since Minecraft 1.21.4, item_model is the preferred way to specify custom item appearances. It offers better organization, namespace support, and is more flexible than integer-based Custom Model Data.

How to use in config:

YAML:

# Works on 1.21.4+ (takes priority when supported):
item-model: "mynamespace:custom_shirt_icon"

# Fallback for servers running 1.20.x – 1.21.3:
custom-model-data: 1234

Both keys can coexist — the plugin automatically detects server capability and uses the appropriate one.

Supported in:

• Wardrobe category icons
• Overlay item icons (available / equipped / locked / unequip)
• Navigation buttons (prev / next / outfits / back / search)
• Outfit GUI items and control buttons
• Previewer cursor displays
• All per-category icon overrides

---

## Technical Notes

• Minimum Java Version: 21
• API Version: 1.18+
• Folia Support: Yes
• Tested on: Paper 1.21.4, Paper 1.20.4
• All changes are fully backwards-compatible with 1.20.x servers

---

## Dependency Changes

| Dependency | Old Version | New Version |
|---|---|---|
| PacketEvents (Spigot) | 2.11.1 | 2.11.3-SNAPSHOT |

---

Thank you for using ClothesPlus! Report issues on our support channel.

# ClothesPlus v3.0.3 — Patch Changelog

Release Date: March 19, 2026
Minecraft Support: 1.20.x – 1.21.10+
PacketEvents: 2.11.3

---

## Bug Fixes

### Scale/Height Section Not Showing Options Until Manual Refresh
The scale/height section in the character creator would appear as if no options were available. Players had to manually save cursor_creator.yml and run /clothes cursor refresh for scale options to actually appear.

Root Cause: The scale section and its configuration were not being auto-injected into existing user configs on plugin load. Users who updated the plugin without manually copying the new scale section from the default config would see an empty section.

Fix: The scale section (with default height presets) is now automatically injected into cursor_creator.yml on startup if missing. This happens before the YAML is parsed, so it works immediately — no manual save/refresh needed. The injection also adds a scale button to the main menu if one isn't present.

---

### Scale Value Not Written When Saving Config via Regenerate
When using /clothes cursor regenerate or any config save operation, the scale-value field for cycle options was silently dropped. This meant regenerated configs would lose all scale preset values.

Fix: The writeSectionToConfig method now properly serializes scale-value for cycle options alongside all other properties.

---

## New Features

### Scale System Enable/Disable Toggle
A new scale-system-enabled option has been added to cursor_creator.yml, allowing server admins to completely enable or disable the height/scale feature.

YAML:

# Enable scale/height system (uses Minecraft 1.20.5+ generic.scale attribute)
# When true: Height button shows on main menu, players can adjust their character height
# When false: Height button hidden, scale selection unavailable
# NOTE: Requires Minecraft 1.20.5+ for the attribute to actually work
scale-system-enabled: true

When disabled (false):

• The Height button is hidden from the main creator menu
• The scale section cannot be opened
• Scale is not applied to players or NPCs

---

### Auto-Injection of Scale Section for Existing Configs
Users upgrading from older versions no longer need to manually copy the scale section into their cursor_creator.yml. On every load/reload, the plugin checks for:

1. scale-system-enabled — Injected after class-system-enabled if missing
2. scale section under sections: — Full default scale section with 5 height presets (Tiny, Short, Normal, Tall, Giant) injected if missing
3. scale button in the main menu — Height button auto-added before the exit button if missing

All injections preserve existing formatting and comments.

---

## Technical Notes

• Minimum Java Version: 21
• API Version: 1.18+
• Folia Support: Yes
• All changes are fully backwards-compatible with existing configs

---

Thank you for using ClothesPlus! Report issues on our support channel.

---
---

# ClothesPlus v3.0.2 — Changelog

Release Date: March 18, 2026
Minecraft Support: 1.20.x – 1.21.10+
PacketEvents: 2.11.3

---

## Bug Fixes

### Cursor System Lag/Freeze on 1.21.2 – 1.21.9 (Critical Fix)
The cursor in /wardrobe (cursor mode) and /outfits previewer would freeze on servers running Minecraft 1.21.2 – 1.21.9. The cursor item would only jump to the correct position when the player pressed Shift, then freeze again.

Root Cause: On MC 1.21.2-1.21.9, the combination of mounting the player on a pig AND repeatedly sending WrapperPlayServerCamera packets pointing at that pig every tick causes the Minecraft client to suppress PLAYER_ROTATION packets. Without rotation data, the cursor position cannot be calculated.

Fix (3 layers):
1. Throttled camera packet resends — Camera packets are now sent only on mount/remount and every 20 ticks (1s) instead of every tick. This prevents the client from suppressing PLAYER_ROTATION packets.
2. PLAYER_INPUT rotation sync — On 1.21.2+, PLAYER_INPUT packets are sent by the client as a heartbeat. When no recent PLAYER_ROTATION packet has been received, we use PLAYER_INPUT as a trigger to force-sync rotation from Bukkit's player.getLocation().
3. Faster Bukkit fallback — Reduced the Bukkit location rotation fallback threshold from 500ms to 100ms (~2 ticks), so the cursor recovers almost immediately when packet-based tracking fails.
4. Added VehicleExitEvent handler for the Previewer system to prevent pig dismounting via Bukkit API (was already present in Cursor system but missing from Previewer).

Affected systems: Cursor menu, Previewer (/wardrobe, /outfits)

---

### Multiverse-Core Compatibility — Cursor Not Spawning in Mob-Disabled Worlds
On servers using Multiverse-Core with animal/mob spawning disabled per-world, the cursor system would fail to start. The cursor item wouldn't appear, and the previewer would get stuck.

Root Cause: ClothesPlus spawns a Pig (invisible camera mount) and an ArmorStand (cursor marker) as part of the cursor/previewer system. When Multiverse-Core disables mob spawning in a world, it cancels the CreatureSpawnEvent for these entities — preventing them from ever being created.

Fix: A new entity spawn protection system tags all ClothesPlus-spawned entities via PersistentDataContainer at spawn time. A CreatureSpawnEvent listener at HIGHEST priority detects tagged entities that were cancelled by other plugins and un-cancels them. This ensures ClothesPlus entities always spawn, without affecting general mob spawning rules set by Multiverse-Core or similar plugins.

Affected systems: Cursor menu, Previewer (/wardrobe, /outfits)
Compatibility: Works with Multiverse-Core, Multiverse-Inventories, and any plugin that cancels CreatureSpawnEvent

---

### GUI Buttons Not Working on 1.21.4 (Critical Fix)
The /wardrobe and overlay selection menus were completely unresponsive on servers running Minecraft 1.21+. Clicking any button — categories, overlays, pagination, outfits — did nothing.

Cause: Paper 1.21 changed InventoryView from an abstract class to an interface. Any plugin compiled against the older API that calls getView().getTitle() directly would crash with a NoSuchMethodError at runtime, silently breaking all inventory click handling.

Fix: All GUI title checks now use a new reflection-based compatibility layer (CompatInventory.getTitle()) that works seamlessly on both 1.20.x and 1.21.4+ servers.

Affected menus: Wardrobe categories, overlay selection, pagination (prev/next), outfit manager, search

---

### NPC Preview Not Reacting to Clicks
Left-clicking and right-clicking the NPC in /npcpreview was not triggering spin toggles on 1.21.4.

Cause: The packet listener was incorrectly grouping all interaction types together and only processing ATTACK actions. Right-click interactions (INTERACT / INTERACT_AT) were never handled.

Fix: The NPC packet listener now properly separates:

• Left-click on NPC → Toggle counter-clockwise spin
• Right-click on NPC → Toggle clockwise spin
• Left-click in air → Toggle counter-clockwise spin
• F key (swap hand) → Zoom in / out

---

### Outfit Loading Reverts to Default Skin
When using /outfit to save an outfit and then clicking it to load, the player's skin would briefly show the outfit and then snap back to their original Mojang skin.

Cause: The outfit loader called resetPlayerSkins() before applying overlays, which triggers an async HTTP request to the Mojang session server. This request would complete after the outfit overlays were already applied, overwriting them with the vanilla skin.

Fix: Outfit loading no longer calls the Mojang API reset. Instead, it clears the current overlay list in-memory and applies the saved outfit overlays directly — no race condition, no flickering.

---

### PacketEvents Updated to 2.11.3
Upgraded the PacketEvents dependency from 2.11.1 to 2.11.3, bringing:

• Full 1.21.4 protocol support
• NPC team name uniqueness fixes
• Entity spawn packet improvements
• Registry synchronization fixes

---

## New Features

### Player Scale / Height Selection (1.20.5+)
Players can now adjust their character's height in the character creator. A new Height category appears in the main menu, allowing players to cycle through configurable scale options.

How it works:

• Each click on Previous/Next cycles through scale presets (e.g., Tiny → Short → Normal → Tall → Giant)
• Scale is applied instantly to the player using the generic.scale attribute
• The NPC preview reflects the selected scale in real-time — the NPC visually grows or shrinks
• Scale persists across sessions and server restarts (saved in character data JSON)
• Scale is re-applied automatically on player join

Configuration (cursor_creator.yml):

YAML:

sections:
  scale:
    title: <gradient:#32CD32:#228B22>━━ 📏 Height ━━</gradient>
    cycle-enabled: true
    show-navigation: true
    cycle-options:
      - id: scale_tiny
        display: <gray>Tiny
        scale-value: 0.5
      - id: scale_normal
        display: <green>Normal
        scale-value: 1.0
      - id: scale_tall
        display: <aqua>Tall
        scale-value: 1.2
      # Add as many options as you want!

Details:

• The scale-value field accepts any double from 0.0625 (1/16th) to 16.0 (16× size)
• Reasonable values for roleplay are 0.5 – 2.0
• Requires Minecraft 1.20.5+ for the generic.scale attribute; on older servers the section appears but scale won't visually apply
• NPC preview scale works in all three systems: Character Creator, Previewer (/outfits), and NPC Preview (/npcpreview)

---

### /npcpreview <playername> — Preview Another Player's Skin
You can now preview any online player's current appearance by specifying their name.

Usage:

Code:

/npcpreview              — Preview your own skin (existing behavior)
/npcpreview Steve        — Preview Steve's current skin/outfit

Details:

• Tab-completion for online player names
• Requires wardrobeclothes.npcpreview.other permission (or wardrobeclothes.admin)
• The NPC shows the target player's current skin including any active overlays
• All existing controls work (spin, zoom, toggle stop)

---

### PlaceholderAPI Integration
ClothesPlus now registers a full PlaceholderAPI expansion that exposes skin and overlay data to any plugin that supports PAPI.

1.
Use Cases:

• Display outfit info on scoreboards, tab lists, or holograms
• Save/restore skin states via external plugins
• Conditional logic in DeluxeMenus, ConditionalEvents, etc.

Requires PlaceholderAPI to be installed (soft dependency).

---

### Item Model Component Support (1.21.4+)
ClothesPlus now supports Minecraft's item_model component alongside traditional Custom Model Data.

Since Minecraft 1.21.4, item_model is the preferred way to specify custom item appearances. It offers better organization, namespace support, and is more flexible than integer-based Custom Model Data.

How to use in config:

YAML:

# Works on 1.21.4+ (takes priority when supported):
item-model: "mynamespace:custom_shirt_icon"

# Fallback for servers running 1.20.x – 1.21.3:
custom-model-data: 1234

Both keys can coexist — the plugin automatically detects server capability and uses the appropriate one.

Supported in:

• Wardrobe category icons
• Overlay item icons (available / equipped / locked / unequip)
• Navigation buttons (prev / next / outfits / back / search)
• Outfit GUI items and control buttons
• Previewer cursor displays
• All per-category icon overrides

---

## Technical Notes

• Minimum Java Version: 21
• API Version: 1.18+
• Folia Support: Yes
• Tested on: Paper 1.21.4, Paper 1.20.4
• All changes are fully backwards-compatible with 1.20.x servers

---

## Dependency Changes

| Dependency | Old Version | New Version |
|---|---|---|
| PacketEvents (Spigot) | 2.11.1 | 2.11.3-SNAPSHOT |

---

Thank you for using ClothesPlus! Report issues on our support channel.

# ClothesPlus v3.0.2 — Changelog

Release Date: March 18, 2026
Minecraft Support: 1.20.x – 1.21.10+
PacketEvents: 2.11.3

---

## Bug Fixes

### Cursor System Lag/Freeze on 1.21.2 – 1.21.9 (Critical Fix)
The cursor in /wardrobe (cursor mode) and /outfits previewer would freeze on servers running Minecraft 1.21.2 – 1.21.9. The cursor item would only jump to the correct position when the player pressed Shift, then freeze again.

Root Cause: On MC 1.21.2-1.21.9, the combination of mounting the player on a pig AND repeatedly sending WrapperPlayServerCamera packets pointing at that pig every tick causes the Minecraft client to suppress PLAYER_ROTATION packets. Without rotation data, the cursor position cannot be calculated.

Fix (3 layers):
1. Throttled camera packet resends — Camera packets are now sent only on mount/remount and every 20 ticks (1s) instead of every tick. This prevents the client from suppressing PLAYER_ROTATION packets.
2. PLAYER_INPUT rotation sync — On 1.21.2+, PLAYER_INPUT packets are sent by the client as a heartbeat. When no recent PLAYER_ROTATION packet has been received, we use PLAYER_INPUT as a trigger to force-sync rotation from Bukkit's player.getLocation().
3. Faster Bukkit fallback — Reduced the Bukkit location rotation fallback threshold from 500ms to 100ms (~2 ticks), so the cursor recovers almost immediately when packet-based tracking fails.
4. Added VehicleExitEvent handler for the Previewer system to prevent pig dismounting via Bukkit API (was already present in Cursor system but missing from Previewer).

Affected systems: Cursor menu, Previewer (/wardrobe, /outfits)

---

### Multiverse-Core Compatibility — Cursor Not Spawning in Mob-Disabled Worlds
On servers using Multiverse-Core with animal/mob spawning disabled per-world, the cursor system would fail to start. The cursor item wouldn't appear, and the previewer would get stuck.

Root Cause: ClothesPlus spawns a Pig (invisible camera mount) and an ArmorStand (cursor marker) as part of the cursor/previewer system. When Multiverse-Core disables mob spawning in a world, it cancels the CreatureSpawnEvent for these entities — preventing them from ever being created.

Fix: A new entity spawn protection system tags all ClothesPlus-spawned entities via PersistentDataContainer at spawn time. A CreatureSpawnEvent listener at HIGHEST priority detects tagged entities that were cancelled by other plugins and un-cancels them. This ensures ClothesPlus entities always spawn, without affecting general mob spawning rules set by Multiverse-Core or similar plugins.

Affected systems: Cursor menu, Previewer (/wardrobe, /outfits)
Compatibility: Works with Multiverse-Core, Multiverse-Inventories, and any plugin that cancels CreatureSpawnEvent

---

### GUI Buttons Not Working on 1.21.4 (Critical Fix)
The /wardrobe and overlay selection menus were completely unresponsive on servers running Minecraft 1.21+. Clicking any button — categories, overlays, pagination, outfits — did nothing.

Cause: Paper 1.21 changed InventoryView from an abstract class to an interface. Any plugin compiled against the older API that calls getView().getTitle() directly would crash with a NoSuchMethodError at runtime, silently breaking all inventory click handling.

Fix: All GUI title checks now use a new reflection-based compatibility layer (CompatInventory.getTitle()) that works seamlessly on both 1.20.x and 1.21.4+ servers.

Affected menus: Wardrobe categories, overlay selection, pagination (prev/next), outfit manager, search

---

### NPC Preview Not Reacting to Clicks
Left-clicking and right-clicking the NPC in /npcpreview was not triggering spin toggles on 1.21.4.

Cause: The packet listener was incorrectly grouping all interaction types together and only processing ATTACK actions. Right-click interactions (INTERACT / INTERACT_AT) were never handled.

Fix: The NPC packet listener now properly separates:

• Left-click on NPC → Toggle counter-clockwise spin
• Right-click on NPC → Toggle clockwise spin
• Left-click in air → Toggle counter-clockwise spin
• F key (swap hand) → Zoom in / out

---

### Outfit Loading Reverts to Default Skin
When using /outfit to save an outfit and then clicking it to load, the player's skin would briefly show the outfit and then snap back to their original Mojang skin.

Cause: The outfit loader called resetPlayerSkins() before applying overlays, which triggers an async HTTP request to the Mojang session server. This request would complete after the outfit overlays were already applied, overwriting them with the vanilla skin.

Fix: Outfit loading no longer calls the Mojang API reset. Instead, it clears the current overlay list in-memory and applies the saved outfit overlays directly — no race condition, no flickering.

---

### PacketEvents Updated to 2.11.3
Upgraded the PacketEvents dependency from 2.11.1 to 2.11.3, bringing:

• Full 1.21.4 protocol support
• NPC team name uniqueness fixes
• Entity spawn packet improvements
• Registry synchronization fixes

---

## New Features

### /npcpreview <playername> — Preview Another Player's Skin
You can now preview any online player's current appearance by specifying their name.

Usage:

Code:

/npcpreview              — Preview your own skin (existing behavior)
/npcpreview Steve        — Preview Steve's current skin/outfit

Details:

• Tab-completion for online player names
• Requires wardrobeclothes.npcpreview.other permission (or wardrobeclothes.admin)
• The NPC shows the target player's current skin including any active overlays
• All existing controls work (spin, zoom, toggle stop)

---

### PlaceholderAPI Integration
ClothesPlus now registers a full PlaceholderAPI expansion that exposes skin and overlay data to any plugin that supports PAPI.

1.
Use Cases:

• Display outfit info on scoreboards, tab lists, or holograms
• Save/restore skin states via external plugins
• Conditional logic in DeluxeMenus, ConditionalEvents, etc.

Requires PlaceholderAPI to be installed (soft dependency).

---

### Item Model Component Support (1.21.4+)
ClothesPlus now supports Minecraft's item_model component alongside traditional Custom Model Data.

Since Minecraft 1.21.4, item_model is the preferred way to specify custom item appearances. It offers better organization, namespace support, and is more flexible than integer-based Custom Model Data.

How to use in config:

YAML:

# Works on 1.21.4+ (takes priority when supported):
item-model: "mynamespace:custom_shirt_icon"

# Fallback for servers running 1.20.x – 1.21.3:
custom-model-data: 1234

Both keys can coexist — the plugin automatically detects server capability and uses the appropriate one.

Supported in:

• Wardrobe category icons
• Overlay item icons (available / equipped / locked / unequip)
• Navigation buttons (prev / next / outfits / back / search)
• Outfit GUI items and control buttons
• Previewer cursor displays
• All per-category icon overrides

---

## Technical Notes

• Minimum Java Version: 21
• API Version: 1.18+
• Folia Support: Yes
• Tested on: Paper 1.21.4, Paper 1.20.4
• All changes are fully backwards-compatible with 1.20.x servers

---

## Dependency Changes

| Dependency | Old Version | New Version |
|---|---|---|
| PacketEvents (Spigot) | 2.11.1 | 2.11.3-SNAPSHOT |

---

Thank you for using ClothesPlus! Report issues on our support channel.

Hello everyone,

Welcome to our brand new version (3.0.0), we are excited to bring a brand new feature we have been working over the last month

Introducing Cursor.

Cursor is our brand new creator 2.0 which introduce a brand new way of customizing players with the click of a mouse. Yes you heard it right your mouse.

We have worked extremely hard understanding PacketEvent to see how we could introduce using mouse instead of keybind stroke. And surprising we mange to do it, which open the door to alot of new possibility.

Also just a bit of heads up too. we have also increase our plugin price back from $9.99 to $15 USD now due to help the development team and to be able to host wiki and such other things.

So enough of me rambling along, update your plugin now to enjoy this brand new feature.

Changes:

• Added in Cursor
• Added new files, cursor_creator.yml and previewer.yml
• Updated wardrobe system to now use the new mouse feature
• Added in new folder path for cursor
• Added in new base skin for cursor in base_skin folder
• Added in race and class to cursor (This is just very basic stuff, new feature for this coming soon)
• Added brand new Nexo and IA textures for cursor
• Updated base skin for our base_skin folder
• Updated PacketEvent
• Now works on server for 1.21.11
• Updated Mineskin
• Added in brand new license system. Your old mclience files will now delete and new one will generate

(Make sure to ask in discord for your new keys)

• Added hair pallet to cursor. Was a highly requested feature to bring hair color options now.
• Updated to now use the correct model types in cursor
• Fixed npcpreview command in code we had spelt it as npcreview. (ops)
• Removed a bunch of alias
• Added in new permission for cursor
• Updated the avatar system. No longer in developerment. Now works in wardrobe when enabled
• Added Alex and Steve support to creator 1.0
• Fixed up wardrobe pagination system. This would cause performance issue
• Added in a new Velocity jar for clothesplus to help backend server be able to use the command /clothes reset
• Updated the overlay zip file to include the new cursor
• Code clean up

A big thing to do is to make sure you delete your old config and let it regenerate itself again so your get the more updated version. Or you can check the wiki to see what the new config looks like.
Make sure to remember your mineskin key before you delete it

New website link Clothesplus
New wiki link Wiki
Make sure to check it out

Thank you all for supporting us, we couldn't have done it all with out you all

ClothesPlus 2.5.5 Update


Hello everyone and welcome to our last big update for the year before we go on holiday.


New features:

- Have added in new re-equip mojang skin to players if they have no overlays on them when base_skin:false. You can enable this in the config.yml (reset_to_mojang_when_empty: true)

- Added in new debug logging to check if player are wearing a 64x32 skin or a 64x64 skin


Bug Fixes:

- Fixed skin tone, base parts, and second layer stripping system not working correct

- Fixed skin tone, base parts, and second layer stripping system not reloading with /clothes reload

- Fixed Outfits not saving on 1.21.10

- Fixed Outfits crashing server on 1.21.10

- Fixed Outfits not loading correct skin that was saved

- Fixed unequip not requiping mojang skin

- Fixed unequip not requiping correct skin format

- Fixed UV maping for palms. Players will always have skin color shown at the bottom of the hand

- Fixed UV maping for Left arm not showing overlays correctly

- Fixed hair overlay not showing correctly in overlay order. Players can delete thhe overlay_priorities.yml in player_config to generate new one

- Fixed Performance issue. (Have change clothing to a dedicated thread pool. If cause to much issue will revert back)

- Fixed Nexo pack for the Next button showing GRAY_DYE when it should be PAPER

- Code Cleanup


Also here is our wiki, it's in very early stages more to be added but here you go:

https://github.com/Turretedash7/ClothesPlusWiki/wiki


With this we hope you all enjoy the update. We will be back with some more updates next year. But, if there is any bugs from now to next year that are easy to fix we will try push them out quickly as we can.


With that we hope you all have a great christmast

Clothesplus 2.5.4 Update
Welcome everyone to another update and bug fix.
We have fixed some issue from 2.5.2 and 2.5.3 that were causing some problem for certain version etc...
Fixes:

• Fixed Skin tone in creator, have disabled it fully so it doesnt clash with the creator system. Only used outside of creator.
• Fixed 2nd overlay not stripping correctly on version below 1.21.10
• Fixed NPC not showing or working correctly on version below 1.21.10
• Fixed Overlay extract not working when you did /clothes reload.
• Fixed some small issue with Creator and base cache system not working correctly.
• Fixed some comments in config.

New Featues:

• We have added in underwear to overlays now. Will auto-generate on startup.
• Added Underwear to overlay_priorities.yml

It is highly recommend to delete you config.yml and regenerate a new one to get the latest comment in it etc... Make sure to save your mineskinkey first before you do.
Once again thank you all for the bug reports. Keep it coming

Hello everyone,

Please update to this version. I had forgotten to add in a version check. Cause the npc would kick player below 1.21.9. This has now been fixed

Sorry about that.