SkinOverlay icon

SkinOverlay -----

Change your skin's clothes (overlay) without opening a graphic editor and rejoining!




SkinOverlay 8.0.0-beta.1
View changes on GitHub

Release date: 2025-07-15

⚠️ Breaking Changes
  • Old configs and save data may not be compatible with the new version
  • Removed all old classes due to the recode
✨ Features
  • Recode of the entire plugin (2ec6cf8)
  • Start recode (6470152)
  • Velocity support (345924c)
  • Add Redis and PluginMessage support for skin synchronization (a649393)
  • Conditionally initialize message handling based on proxy setting (d77f772)
  • Recode encryption and message handling (0c901ef)
  • Messaging: recode messaging system with encryption and channels (9deaaf1)
  • Player: delay publishPlayerJoin when PROXY enabled and not proxy (07ae9a5)
  • Utilities: refactor message handling and add MessageParser (2f35d09)
  • Velocity: add VelocityCommandManager initialization (f9b59c5)
Bug Fixes
  • Completion: handle empty args array in tab completion (9dffca3)
  • Prevent saving entities in non-proxy mode when proxy enabled (1381f51)
  • Velocity: pass plugin instance to audience provider (2996a13)

For full commit history, visit the GitHub repository.
----------, Jul 15, 2025

7.0.0 (2023-11-09)
Bug Fixes
  • commands: Fix method signature and add try-catch block for loading skins (c19d79c)
  • Fix file extension check in SkinFileCache (14164df)
  • Move width/height to Section (daf098b)
  • rename overlay options (cf08f38)
  • Return existing skin if it is an instance of Skin class (844474d)
Features
  • add mc-1-20-2 implementation and relocate snakeyaml (534a193)
  • Add overlay skin rendering and configuration (c1d6342)
  • Add SerializableBufferedImage class for serializing BufferedImage objects (73cb9c3)
  • Add skin configuration files and utility classes (e76f799)
  • Add SkinFileCache to improve performance (cc55fa2)
  • Add support for Minecraft version 1.20.2 (b5c7f92)
  • core: add DataManager and Data classes (1e21d59)
  • manager: add UserManager class for managing User objects (54d32cd)
  • Moved the Skin and User classes (9e30f2a)
  • PlayerObject: Add support for default skin parts (984b743)
  • Removed SkinOptions and the unused CompletableFutureManager class (511866e)
  • Skin: Add classes to manage skin parts (c93b2f5)
  • SkinHandler: Add support for overlaying different parts of the skin (c037e0a)
  • Update DataManager to UserManager and SkinManager (aa158e9)
  • Update skinsRestorerVersion to 15.0.3 (6f4bebd)
BREAKING CHANGES
  • API classes changed
----------, Nov 14, 2023

6.2.0 (2023-06-24)
Features
  • Add support for Minecraft 1.20 in build.gradle (79f5037)
  • folia: Add support for Folia 1.20 (392a727)
  • multiver: Add support for Minecraft 1.20 version (4bd9488)
----------, Jun 25, 2023

6.1.0 (2023-06-12)
Features
  • Add support for FoliaMC server software in SkinHandler for Minecraft 1.19.4 (4d1a6b1)
6.0.0 (2023-06-11)
Features
  • Add SkinException class to handle runtime exceptions related to skin overlay (dc53c82)
  • config: add mineskin api key option to config.yml (890256e)
  • Glowstone: Dropped glowstone support (74b8036)
  • Implement the new changes of SkinHandler (43935d4)
  • Rewrite SkinHandler (3912014)
  • This is an empty commit read desc (5434fde)
BREAKING CHANGES
  • The old saved data won't work with the new release because of numerous internal and API changes.
----------, Jun 12, 2023

5.3.1 (2023-05-30)
Bug Fixes
  • core: update database and save user modifications (0dd7686)
----------, May 30, 2023

5.2.0 (2023-05-14)
Features
  • Locale: Added proper locale support. (656c65f)
Added proper locale support to the plugin by including a new 'locale' option in config.yml.
The default locale setting is 'en_US', and for now, 'en_US' and 'el' are the only available options.
If you try to use another locale without the appropriate file, the plugin will not work.
Additionally, a custom Locale class has been added to improve support for different locales.

Changed the SkinOptions serial number to 1L.
From now on, the serial number will only change when the file is modified to prevent compatibility issues.
----------, May 14, 2023

5.1.0 (2023-05-13)
Bug Fixes
  • Event: Ignore the handler if the event is cancelled. (3eff65b)
  • PlayerListeners: Change the event priority to HIGHEST (79d60fe)
  • PlayerObject: Removed debug message (4502a32)
  • SkinHandler_Legacy: Fixed for Minecraft 1.8.8 (03c26de)
Features
  • lang: Removed lang_en.yml and moved the messages to messages.yml (3c5107f)
----------, May 14, 2023

5.0.0 (2023-05-04)
Bug Fixes
  • User: Added serial version (afe2613)
  • User: Changed the class package (0bb98d5)
Features
  • Add CompletableFutureManager and getLoadedUsers() (7c47b19)
  • Command: Reintroduce command message (40a9745)
  • Enhance PlayerObject methods with the UserEvent#getUser() (58c07b0)
  • SGameProfile: Add extra constructor with name, UUID, and skin parameters (db13424)
  • Skin: Added Skin class to manage the player skins (d4ed272)
  • Skin: extends Skin to Entity (7eb5d14)
  • SkinHandler: Full usage of the Skin class (042e1de)
  • SkinOptions: Added static methods to de/serialize SkinOptions (c4fef62)
  • SkinOverlay: Added isPluginEnabled (4bd5663)
  • SkinOverlay: Implement overlay storage caching to optimize performance and avoid repeated requests. (6bebf7c)
  • SkinOverlay: Skins storage (bf4f39e)
  • Skins SQL table and Mongo collection (266aa50)
  • User: Added User class (c59a047)
  • Utilities: Generate UUID from String seed (fec41e1)
  • Utilities: Removed deprecated method (33e24b8)
BREAKING CHANGES
  • SkinHandler: The way internal user saves work has been changed. You should remove the old user data for File, SQL, and Mongo. Additionally, if you are using SQL tables or Mongo collection, delete them. The plugin is going through a lot of changes, and the version 5.x will not be backwards compatible.
----------, May 4, 2023

4.1.0 (2023-04-23)
Bug Fixes
  • Event: Override isCancel and cancel methods (650df6b)
  • Listener: Register PlayerListeners (d0a5d25)
  • User: Save user data only to the proxy if it is running in proxy mode. (2f5a920)
Features
  • Event: Refactored package structure and event invocation method. (3861de3)
  • Events: Improve management of Player connections and skin parts with new events. (1768d28)
  • Exception: Added EventException (86b6d63)
  • SkinOverlay: Added JavaDocs, new methods and changed old ones to public (3f674a6)
  • Sponge: Dropped Sponge support (8d46a21)
----------, Apr 23, 2023

4.0.0 (2023-04-17)
Features
  • GlowStone: Added GlowStone support (082aa4d)
  • ObservableListener: Changed UserManagerListener to ObservableListener (845cf67)
BREAKING CHANGES
  • ObservableListener: Bumped major version due to extensive internal API changes
----------, Apr 17, 2023

3.18.0 (2023-04-15)
Bug Fixes
  • Bukkit Async Skin Update (ac14a77)
  • Fixed ChannelNameTooLongException (b478004)
  • IllegalStateException Asynchronous player tracker update on thread (92e9b2d)
  • Listeners: Fixed all proxy and bukkit listeners (34ec157)
  • PlayerObject: Remove player from onlinePlayers and error handling (a6355da)
  • Proxy: Fixed Bungee updateSkin getServer() null exception (0d929ad)
  • Proxy: Fixed Plugin Messaging (2541202)
  • SkinOverlayImpl: Made print a default (e4fe0f6)
  • SProperty: Fixed SProperty null pointer exception (c2329a4)
  • Updater spamming in the console (2cf4dd0)
Features
  • Events: Changed how the Events work (2d32528)
  • Paper: Added Paper listener (38f4953)
  • SkinHookImpl: Added SkinHookImpl (20cc18c)
  • SkinOverlayImpl: Changed onlinePlayers to ObservableObjectMap (bc43b5b)
----------, Apr 15, 2023

3.17.0 (2023-04-11)
Bug Fixes
  • Events: Fixed PlayerObjectUpdateSkinEvent (da51ce5)
  • SGameProfile: Fixed addProperty method (803fafe)
Features
  • Debug: Added Debugging listeners (4d07eb8)
  • Events: Added Events API (ecaf5d2)
  • Events: Added new Events (7a7ff89)
  • Events: Call the events (72251f7)
  • Exception: Added UserException (99bbb34)
  • Utilities: Added Utilities.getMethodsAnnotatedWith (6342039)
----------, Apr 11, 2023

3.16.0 (2023-04-09)
Bug Fixes
  • Listeners: Event priority (e28d5ef)
Features
  • SkinOverlay: Fixed (de)serialization (3ed625a)
  • UserManagerListener (0970fa7)
----------, Apr 9, 2023

3.15.0 (2023-04-06)
Bug Fixes
  • PluginMessaging: Added a check if the source is Server (5a7698c)
  • SkinHandler: BungeeCord property signature (f691876)
  • SkinHandler: Fixed SkinHandler_BungeeCord.getGameProfile0 (9f9c093)
  • SkinHandler: Fixed SkinHandler.setSkin method (9201640)
Features
  • SkinHandler: Removed Callback from updateSkin (371f16d)
  • Type: change PAPER to BUKKIT (fd057db)
----------, Apr 6, 2023

3.14.0 (2023-04-02)
Features
  • Added SkinHandler classes for the proxies (1c30d7f)
  • PluginMessaging: Use Plugin Messaging API (c2e016b)
  • SkinHandler: Moved set/updateSkin to SkinHandler (020b545)
----------, Apr 2, 2023

3.13.0 (2023-04-02)
Bug Fixes
Features
  • A lot of internal changes (06d9a67)
  • Proxy: Encrypt Bungee plugin messaging (3a68882)
----------, Apr 2, 2023

Bug Fixes
  • Adventure: Fixed adventure (5f7ac73)
  • Proxy: Update skin on server switch (593756e)
  • SkinHandler: Fixed Legacy SkinHandler (4881d14)
  • SkinHandler: Fixed legacy SkinHandler index (9d1df53)
  • SkinsRestorer hook (1a184a4)
  • SkinsRestorer: More fixes for SkinsRestorer hook (d1d6505)
----------, Mar 18, 2023

Bug Fixes
----------, Mar 17, 2023

3.12.0 (2023-03-17)
Bug Fixes
  • SkinOptions: Improve proxy skin handlers (b847a9d)
  • SkinOptions: Serializable (a116c79)
  • URL subcommand (fb26a09)
Features
  • 1.19.4 support (3856a51)
  • Default database type (d518263)
  • PlayerObject: change skinName to skinOptions (13f26fd)
  • SkinHandler: SkinsRestorer custom skins hook (5762022)
  • SkinOptions: changed setSkin constructor String skinName to SkinOptions (1413354)
  • SkinOptions: Changed SkinOverlays to SkinOptions (5d93797)
  • SkinOptions: changed updateSkin vararg String skinName to SkinOptions (eb98186)
  • SkinOverlayCommand: Added url sub command (00656ad)
  • Updated onPluginMessageReceived to accept SkinOptions (136dfb5)
  • Utilities: proper usage of SkinOptions (b0b20c9)
  • Velocity: Update everything to use the new SkinOptions (d3c1bc8)
----------, Mar 17, 2023

3.11.0 (2023-03-10)
Bug Fixes
  • Check if a username is premium (6eab834)
  • SkinHandler: Fixed SkinHandlers on Spigot (a045ac6)
Features
  • User: New config option for default skin UUID (7cbef7d)
  • User: Removed Deprecated User class (7711190)
----------, Mar 10, 2023

3.10.0 (2023-03-09)
Bug Fixes
Features
  • New permission method (f00b729)
  • print method (ae239ba)
  • Updater: Send the update message to player (990bac2)
----------, Mar 9, 2023

Features
  • Reworked the entire database (f10ec9a)
Keep a backup of your config files and database
Please report any issues at https://github.com/GeorgeV220/SkinOverlay/issues
----------, Mar 5, 2023

Resource Information
Author:
----------
Total Downloads: 26
First Release: Mar 3, 2023
Last Update: Jul 15, 2025
Category: ---------------
All-Time Rating:
2 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings