Changelog

3.1.1 (2026-10-11)

Added

• Compact Change Skin button

The new "Compact Change Skin Button" setting, in the Client tab, shows the Change Skin button of the title screen and the pause menu as a small Quick Skin icon, the same size as the language and accessibility buttons. The player preview and its buttons move to stand right above it. It is off by default and changes nothing when Essential is installed. @Suelvys thx for the idea!

• Players without Quick Skin can see your new account skin

Server owners can turn on shareAccountSkinWithVanillaClients in config/quickskin-server.json (off by default). On an online-mode server, when you upload a skin to your Mojang account with the Upload to Mojang button, players who don't have Quick Skin see the new skin within a minute or two instead of only after you rejoin. Capes, HD skins and CPM models are still only visible to players with Quick Skin.

• Upload limit for servers

Server owners can choose the biggest skin or cape that is synced to other players with maxTextureUploadKilobytes in config/quickskin-server.json (64 to 16384 KiB, 16384 by default). A skin or cape over the limit stays on your own screen, a chat message tells you why, and the rest of your appearance still syncs. Players on Quick Skin 3.1.0 or older should update before a server lowers the limit.

Fixes

• No more crash at launch with loading-screen mods

The game no longer crashes on startup ("No model for layer minecraft:player#main") when a mod that removes the loading screen, like Remove Reloading Screen, is installed. The title screen's player preview simply shows up once the game has finished loading. @Llohgun thx for reporting it!

• The Change Skin button lines up with Quit Game on NeoForge

On NeoForge, the title screen's Change Skin button, together with the player preview above it, sat a few pixels higher than the Options and Quit Game row. It now sits on that row. @Suelvys thx for reporting it!

• Importing skins on Android

On Android launchers, Import Skin now opens a file browser inside the game instead of doing nothing. If your file isn't listed, copy it into the game folder; the "Game folder" button takes you there. @GIGTY thx for reporting it!

• No more disconnects from big skins on servers with Quick Skin 2.x

On a server that still runs Quick Skin 2.x, another player's large skin or GIF cape no longer disconnects you with "ByteArray with size ... is bigger than allowed 32768".

• Smooth title-screen panorama with Very Many Players

With Very Many Players installed, the main menu's panorama turned in visible steps once the computer had been on for a few days, and jumped every few hours. It turns smoothly again.

• Better performance with many capes around

Every visible Quick Skin cape now takes less work per frame, which helps on servers with lots of caped players.

• The cape menu message no longer covers the buttons

The "Imported cape" and "Cape deleted" messages of the cape menu now show above the buttons instead of on top of Remove Cape.

• More translations

The newest texts (skin search errors, the cape editor and the preview settings) are now translated into every language instead of showing up in English.

3.1.0 (2026-10-05)

Added

• FancyMenu compatibility

You can now hide, move and resize the player preview of the title screen and the pause menu from FancyMenu's layout editor. Hiding it also hides its rotate and animation buttons. @Lappland and @EC thx for the idea!

• Option to hide the player preview in the menus

The new "Show Title Screen Preview" and "Show Pause Menu Preview" settings, in the Client tab, turn off the big player model on the title screen or on the pause menu. The Change Skin button stays. @Lappland and @EC thx for the idea!

• Edit button for capes made with the cape editor

Capes imported through the cape editor now have an Edit button that reopens the editor with the original image (every frame of a GIF included) and updates the cape in place.

• TaCZ guns in the in-game player preview

With a TaCZ gun in hand, the in-game player preview now shows the gun and plays its reload, recoil and melee animations, also in first person.

• Press Enter to search a player's skin

Pressing Enter in the username field now starts the search, no need to click the button.

Fixes

• The in-game player preview no longer twitches

The mini player model shown while playing was shaking when holding a TaCZ gun or with animation mods installed. It now stays steady. @The Man with Somewhat of a Name thx for reporting it!

• The skin menu buttons can always be clicked

The Modrinth, CurseForge, Discord and Settings buttons no longer hide behind the player model or stop working when the preview is moved or enlarged over them. @J20 MC thx for reporting it!

• No more crash with ImagineBook

Fixed a startup crash on NeoForge when Quick Skin and ImagineBook were installed together. @svxer thx for reporting it!

• CPM models inside skins work again

Importing a skin that carries a Customizable Player Models model no longer breaks the model, and other players on the server now see it too. @kiura thx for reporting it!

• Quick Skin and CPM no longer undo each other

Whatever you picked last, in Quick Skin or in CPM, is what you and other players see, also after relogging or restarting the game. @kiura thx for reporting it!

• Real Camera compatibility

Real Camera no longer turns off its first-person body ("Binding failed") when you use a Quick Skin skin. @I3AT5 thx for reporting it!

• Entity Texture Features compatibility

ETF's skin features (emissive pixels, blinking and so on) now work on standard 64x64 Quick Skin skins. @Milan4ikdudewtf thx for reporting it!

• Ears compatibility with its newest update

Ears features (snout, ears, tail and so on) show again on Quick Skin skins with Ears 2.x. @lapislizuli thx for reporting it!

• Your own skin on servers that give you a different UUID (1.20.1)

On Minecraft 1.20.1, Quick Skin now recognises your own player when an offline-mode server or a proxy gives you a different UUID from your launcher account.

• No more VarInt too big errors on servers with Quick Skin 2.x

Skins and capes bigger than 1 MiB are no longer sent to servers that still run Quick Skin 2.x, because those servers relayed them as one oversized packet that could disconnect other players. You still see it yourself; other players see you without it.

Changed

• Each launcher account keeps its own skin

Skin selections now belong to the account instead of the instance. If an instance is launched with another account, that account uses its own skin, or the one a Quick Skin 3.x server saved for it, instead of overwriting it. Capes and CPM models are still chosen per instance. @w0ot thx for reporting it!

• Clearer errors when searching a player's skin

A failed username search now tells you which step failed (finding the player, reading their profile or downloading the skin) instead of always saying "Player not found". @GOJO thx for reporting it!

3.0.1 (2026-09-27)

Fixed

• Fixed skins and capes never syncing in large modpacks. On Forge 1.20.1, when the client was slow to process the server's list of network channels (for example while JEI was still loading), Quick Skin decided on joining that the server did not have the mod and kept every appearance local for the whole session. The client now keeps checking for as long as it is connected and starts syncing as soon as the server's channels show up.
• Servers now also recognise Quick Skin 2.x clients whose channels arrive after they join.
• The server now saves a player's skin and cape as soon as they change, instead of only when the player leaves or the server stops, so a crash no longer loses the changes made in that session.

Changed

• On Forge, skins and capes now load right after joining, even in large modpacks. Quick Skin reads the server's mod list from Forge's login handshake instead of waiting for the channel list, so appearances sync within a few seconds instead of after long loading freezes such as JEI's startup (about 40 seconds in a 370-mod pack).
• Added log messages for when the connection with the server is set up, when the server's channels arrive late, and when the server does not answer.

Note: work on the features and bugs reported on Discord starts tomorrow; they should most likely be ready by the weekend.

3.0.0 (2026-08-09)

Added

• Added high-resolution cape support, together with a cape editor that repositions, scales, and zooms a cape, previews it on the front, the back, and the elytra, and can flatten cape transparency onto a colour chosen with red, green, and blue sliders or a hex field.

Changed

• Quick Skin's source code is now published at https://github.com/The-Plum-Team/Quick-Skin-Mod.

2.6.2.5

Fixed

• Fixed an IndexOutOfBoundsException when rendering the skin-list drop zone with one or two skins loaded.