⭐️ClothesPlus⭐️ 2.5.0
An easy to use Minecraft Clothes Plugin with unlimited ways of usage
-
Clohtes 2.5.0 Update:
Hello everyone and welcome to our 2.5.0 update, sorry this has taken a lot time. In this update alot has been change and fixed.
Just a heads up when packeteventAPI release the new version for 1.21.9 and 1.21.10 we will update the jar to support but for now it works upto 1.21.8
New features and Fixes:
- Mineskin V2 to V3.
- Added in new Cache system
- precahce (Still in testing don't touch)
- sharedcache( Allows you share clothing combination elimiting the need to redo a mineskin request)
- creatorcache (Allow cache combination without the need to redo a mineskin request if its already been done)
- base_skin_cache (Allow players to have there own cache, so if player requip same clothing before it wont request from mineskin)
- Fixed base_skin ( Now you can use own minecraft skin)
- Added in strip_second_layer (This fixes the issue with player outlayer skin overlapping over clothes png)
- Added in use_base_skin_parts (Allow you to equip equip clothing to certain parts of body without the need of removing all all of player skin)
- Added in allow-calssic-on-slim (This allows you to equip Classic Model clothing to Slim Model. However, this will cause slim players arm to be classic. Will still be worked on furture update)
- Added in enhanced_cache_logging in config to help developers see more logging with cache system
- Added in new commands
- /clothes (player) wear (overlay)
- /clothes (player) unwear (ovelay)
(This allows admins now to equip and remove outfits to players. (perm is wardrobeclothes.admin))
- Added in new cache delete feature
- /clothes cache delete (player) (This delete cache for that user all)
- /clothes cache delete (all) (This delete cache for all player, a pop up gui will pop up for you to confirm. This is for admin use only)
- Added in new model command
- /clothes model (This allow players to see what model they are and let them know what can be used and not used)
- Redid config to show new features and information. To get the new feature add them in or delete config to regenerate it
- Updated skin format
- Code clean up reducing file size.We all hope you enjoy the update. If any bugs do let us know on discord so we can update it on the next version.
As for next update 2.5.1 we hoping to have the following features:
- Fix precache system
- Add in lang.yml (Had to be removed in 2.5.0)
- Hopefully get Avatar feature working (Fingers Cross)
- And any bug fixesOnce again thank you for supportiung our plugin, do leave a review if can :)
Hey everyone this will be our last update for the 2.4.+ version unless something really broken needs fixing. We gonna be focusing on our big 2.5.0 Update which is likely gonna take us a month or 2 depending on how much we are changing.
So for this last update we have added and fixed the following list:
- Added in lang.yml (Its not 100% done and fully tested. In 2.5.0 will be done. People will need to test and give feedback)
- Fixed in Hair Section display_ID not spawning in any display text
- Fixed Hair Format from Old to New always rewrite it on every restart/startup. Made it now only checks for old once and that's it.
Thank you for supporting us 
In this version we have changes how our creator.yml looks like now. We had to update our hair system removing the old shift for color and move it back onto the keybind options. This is due to the limitation we had on with hair meaning you had no control over any custom race/gender.
We have made it a lot more flexible now
- Fixed Hair format to use updated system
- If have Old Hair Format, Jar will auto update it to New Hair Format
- Added in new line for hair (displayid1_alt) this allows you to display more than one image.
- Fixed not seeing correct amount of items in the Creator session.
- Fixed some small bugs
- Update Nexo and IA configs to have New Hair Format
Thank you all for your feedback and any bug find you do find.
Make sure to join our discord so you have a chance to also test the Dev version too
We have added in a few small fixes and added in our new License System.
- Fixed Hair Colour changing to cause NPC Dupe and also break creator after it duped itself
- Updated PacketEvent API to 2.9.4
- Can now use the plugin on 1.21.8
This is very important now. We have added in a license System to our plugin. This means, you will need to join discord and request for a license key till I fully setup up automatic license key send out.
We have done this due to many people still attempting to steal our plugin and leak it.
Small update:
- Fixed PacketEvents UUID system not being read correctly
- PacketEvents update for 2.9.1
- Support for newer versions of minecraft
ClothesPlus Changelog
Major Changes
- Removed SkinsRestorer dependency:
All code and logic related to SkinsRestorer have been removed. The plugin now exclusively uses the Paper API and MineSkin API for skin management.
Skin Reset Improvements
- Correct Mojang Skin Restoration:
The /clothes reset command now fetches and applies the player's real Mojang skin (not just Steve/Alex) by querying Mojang's session server using the player's UUID. - Force Skin Update:
After resetting a skin, the plugin now forces a visual update by hiding and showing the player, ensuring the skin change is visible to all players.
Thread Safety & Bukkit API Usage
- Main Thread Enforcement:
All Bukkit API calls (e.g., player.setPlayerProfile(...)) are now guaranteed to run on the main server thread using a runSync helper. - Asynchronous Handling:
All asynchronous operations (such as MineSkin API calls and Mojang session lookups) are handled off the main thread, with results applied on the main thread.
Error Handling & Logging
- Improved Directory Creation:
The ensureDir method now logs detailed errors if directory creation fails or if the directory is null. - Better Exception Handling:
All asynchronous tasks now include proper exception handling and user feedback.
Skin Type Auto-Detection
- Automatic Skin Type Detection:
The plugin now automatically detects the player's skin type ("classic" or "slim") by querying Mojang's session server and applies the correct skin type when uploading to MineSkin.
Code Quality
- Removed SkinsRestorer from Maven:
The SkinsRestorer dependency has been removed from pom.xml. - Refactored SkinManager and SkinProcessor:
Both classes have been updated to use only Paper API and MineSkin API, with improved thread safety and error handling.
Performance & Overlay Caching
- Overlay Path Caching:
Overlay/skin file scanning is now performed asynchronously and cached in memory. Overlay paths are never scanned on the main thread, eliminating major server lag from wardrobe/creator GUIs. - Direct Logic Calls:
Internal plugin actions (like applying/removing overlays) now call the underlying logic directly instead of routing through Bukkit commands, reducing stack depth and improving performance. - Busy/Cooldown Protections:
All async operations (especially skin changes) are protected by busy flags and cooldowns to prevent rapid re-entry and task spam.
Character Creator
- Stage and Option Cooldowns:
Added configurable cooldowns for stage switching and option changes in the character creator to prevent MineSkin/API spam. - Busy Flag for Async Changes:
Added a busy flag to block overlapping skin/hair/option changes, ensuring no changes are processed until the previous one is fully applied. - Async NPC Preview Sync:
NPC preview is now updated only after the player's skin is actually set, using a callback from MineSkin processing. - Session Isolation:
Fixed a bug where multiple players in the creator could affect each other's NPC preview. Each session now controls its own NPC.
Wardrobe GUI
- Anti-Spam Logic:
Added a busyPlayers set to prevent rapid/duplicate clicks and skin spamming in the wardrobe GUI., - Command Routing:
Clicking a skin/overlay in the wardrobe now triggers /clothes wear <path> (or /clothes remove <path>) exactly as if the player used the command, preventing MineSkin from being spammed., - Category Click Fix:
Fixed a bug where clicking a category icon would show a missing overlays error.
Overlay Menu
- Click Cooldown:
Added a per-player cooldown to prevent duplicate overlay application from multiple listeners or rapid clicks. - Error Handling:
Fixed NPEs and improved error messages for missing overlay data.
NPC Preview
- Preview Sync:
NPC preview now always matches the player's current skin, not the previous one, after any skin/overlay change. - Session Isolation:
Each preview session is now isolated per player, fixing cross-control bugs.
Outfits,
- Flexible Outfit Names:
Players can now save outfits with spaces and a wide range of characters. The plugin ensures safe handling for Minecraft skulls and storage, preventing errors with special or long names., - Validation:
Added validation for outfit names to allow only letters, numbers, spaces, and basic symbols, up to 32 characters.
Bugfixes & Improvements
- General:
- Improved error handling and user feedback throughout the plugin.
- Fixed race conditions and out-of-sync issues with skin/overlay application.
- Improved UX for creator and wardrobe navigation.
- All Bukkit API calls are now thread-safe.
These changes ensure that ClothesPlus is fully compatible with Paper and MineSkin, and that player skins are managed safely and correctly without SkinsRestorer.
Skin type is now auto-detected for best compatibility with player model
