All Mods Resource Packs Data Packs Shaders Modpacks Plugins
Quick Skin

Quick Skin

by ThePlum • Downloads: 0 • Followers: 0
Description
Gallery
Changelog
Versions

Quick Skin - Banner

The default Minecraft skin system is rigid. Changing your look requires leaving the game, you're stuck with standard resolutions, and cool customizations like animated capes are impossible. QuickSkin completely overhauls this experience, giving you total control over your appearance directly in-game with powerful features for both single-player and multiplayer.


Quick Skin - Title - Core Features

The Ultimate Skin Management GUI

Access a powerful and intuitive menu from the Title or Pause screen to manage your entire look.

  • Skin Library: Save skins from other players by username or import your own local files.
  • Model Swapping: Instantly switch between Classic and Slim player models.
  • Drag & Drop: Simply drag skin files onto the menu to import them into your local library.
  • Cape Selector: Choose from a library of built-in capes or your own imported animated/static capes.

High-Definition Skin Engine

Break free from 64x64 limitations! QuickSkin's HD Texture Processor allows you to use high-resolution skins.

  • Automatic Normalization: The mod intelligently handles different skin formats, converting legacy skins (64x32) to the modern format on import.
  • Performance Scaling: HD skins are automatically downsampled for previews and thumbnails to ensure smooth UI performance, with quality settings available in the config.
  • Full Resolution In-Game: Enjoy your detailed HD skins in all their glory in the world.

Animated Cape Engine

Equip dynamic, eye-catching animated capes using standard GIF files.

  • GIF Processing: The mod automatically processes GIFs into an efficient texture atlas for smooth in-game animation.
  • Performance First: Control the maximum FPS, memory usage, and concurrent animations to keep your game running smoothly.
  • Speed Control: Adjust the playback speed of your animated cape in the Cape Selection menu to get the perfect effect.

Mod Compatibility

QuickSkin is designed to work seamlessly alongside popular player customization, rendering, and utility mods.

Currently supported mods include:

If you find any conflicts, please report them!

❤ Discord ➜ https://discord.gg/EeQgres2Fz

All Versions

+ Add Version
Name Game version Platforms Published Downloads Actions
26.3
Neoforge
20h ago 1
26.1
Neoforge
20h ago 1
26.2
Neoforge
20h ago 1
26.1.2
Neoforge
20h ago 1
26.1.1
Neoforge
20h ago 1
1.21.8
Neoforge
20h ago 1
1.21.11
Neoforge
20h ago 1
1.21.9
Neoforge
20h ago 1
1.21.10
Neoforge
20h ago 1
1.21.4
Neoforge
20h ago 1
1.21.6
Neoforge
20h ago 1
1.21.7
Neoforge
20h ago 1
1.21.5
Neoforge
20h ago 1
1.21.3
Neoforge
20h ago 1
1.20.1
Forge
20h ago 1
1.21.1
Neoforge
20h ago 1
1.21.2
Neoforge
20h ago 1
26.3
Fabric
20h ago 1
26.1
Fabric
20h ago 1
26.2
Fabric
20h ago 1
26.1.2
Fabric
20h ago 1
26.1.1
Fabric
20h ago 1
1.21.8
Fabric
20h ago 1
1.21.11
Fabric
20h ago 1
1.21.9
Fabric
20h ago 1
1.21.10
Fabric
20h ago 1
1.21.4
Fabric
20h ago 1
1.21.6
Fabric
20h ago 1
1.21.7
Fabric
20h ago 1
1.21.5
Fabric
20h ago 1
1.21.3
Fabric
20h ago 1
1.20.1
Fabric
20h ago 1
1.21.1
Fabric
20h ago 1
1.21.2
Fabric
20h ago 1
26.3
Neoforge
20h ago 1
26.2
Neoforge
20h ago 1
26.1.1
Neoforge
20h ago 1
26.1.2
Neoforge
20h ago 1
26.1
Neoforge
20h ago 1
1.21.11
Neoforge
20h ago 1
1.21.9
Neoforge
20h ago 1
1.21.10
Neoforge
20h ago 1
1.21.8
Neoforge
20h ago 1
1.21.7
Neoforge
20h ago 1
1.21.5
Neoforge
20h ago 1
1.21.6
Neoforge
20h ago 1
1.21.4
Neoforge
20h ago 1
1.21.3
Neoforge
20h ago 1
1.21.1
Neoforge
20h ago 1
1.21.2
Neoforge
20h ago 1
26.3
Fabric
20h ago 1
26.2
Fabric
20h ago 1
26.1.1
Fabric
20h ago 1
26.1.2
Fabric
20h ago 1
26.1
Fabric
20h ago 1
1.21.11
Fabric
20h ago 1
1.21.9
Fabric
20h ago 1
1.21.10
Fabric
20h ago 1
1.21.8
Fabric
20h ago 1
1.21.7
Fabric
20h ago 1
1.21.5
Fabric
20h ago 1
1.21.6
Fabric
20h ago 1
1.21.4
Fabric
20h ago 1
1.21.3
Fabric
20h ago 1
1.21.1
Fabric
20h ago 1
1.21.2
Fabric
20h ago 1
1.20.1
Forge
20h ago 1
1.20.1
Fabric
20h ago 1
26.3
Neoforge
20h ago 1
26.1.1
Neoforge
20h ago 1
26.1.2
Neoforge
20h ago 1
26.2
Neoforge
20h ago 1
26.1
Neoforge
20h ago 1
26.3
Fabric
20h ago 1
1.21.9
Neoforge
20h ago 1
1.21.11
Neoforge
20h ago 1
1.21.10
Neoforge
20h ago 1
1.21.8
Neoforge
20h ago 1
26.1.1
Fabric
20h ago 1
1.21.5
Neoforge
20h ago 1
26.1.2
Fabric
20h ago 1
1.21.7
Neoforge
20h ago 1
26.2
Fabric
20h ago 1
1.21.6
Neoforge
20h ago 1
1.21.4
Neoforge
20h ago 1
26.1
Fabric
20h ago 1
1.21.3
Neoforge
20h ago 1
1.21.1
Neoforge
20h ago 1
1.21.9
Fabric
20h ago 1
1.21.11
Fabric
20h ago 1
1.21.10
Fabric
20h ago 1
1.21.8
Fabric
20h ago 1
1.21.5
Fabric
20h ago 1
1.21.7
Fabric
20h ago 1
1.21.6
Fabric
20h ago 1
1.21.4
Fabric
20h ago 1
1.21.3
Fabric
20h ago 1
1.21.2
Neoforge
20h ago 1
1.21.1
Fabric
20h ago 1
1.20.1
Forge
20h ago 1
1.21.2
Fabric
20h ago 1
1.20.1
Fabric
20h ago 1
1.21.11
Neoforge
20h ago 1
1.21.10
Neoforge
20h ago 1
26.3
Neoforge
20h ago 1
1.21.8
Neoforge
20h ago 1
1.21.9
Neoforge
20h ago 1
1.21.7
Neoforge
20h ago 1
1.21.6
Neoforge
20h ago 1
1.21.5
Neoforge
20h ago 1
1.21.4
Neoforge
20h ago 1
1.21.1
Neoforge
20h ago 1
1.21.2
Neoforge
20h ago 1
1.20.1
Forge
20h ago 1
1.21.11
Fabric
20h ago 1
26.3
Fabric
20h ago 1
1.21.10
Fabric
20h ago 1
1.21.8
Fabric
20h ago 1
1.21.9
Fabric
20h ago 1
1.21.7
Fabric
20h ago 1
1.21.6
Fabric
20h ago 1
1.21.5
Fabric
20h ago 1
1.21.4
Fabric
20h ago 1
1.21.1
Fabric
20h ago 1
1.21.2
Fabric
20h ago 1
1.20.1
Fabric
20h ago 1
1.21.3
Neoforge
20h ago 1
1.21.3
Fabric
20h ago 1
26.2
Neoforge
20h ago 1
26.2
Fabric
20h ago 1
26.1.2
Neoforge
20h ago 1
26.1.2
Fabric
20h ago 1
26.1.1
Neoforge
20h ago 1
26.1.1
Fabric
20h ago 1
26.1
Neoforge
20h ago 1
26.1
Fabric
20h ago 1
1.21.11
Neoforge
20h ago 1
1.21.11
Fabric
20h ago 1
1.21.10
Neoforge
20h ago 1
1.21.10
Fabric
20h ago 1
1.21.9
Neoforge
20h ago 1
1.21.9
Fabric
20h ago 1
1.21.8
Neoforge
20h ago 1
1.21.8
Fabric
20h ago 1
1.21.7
Neoforge
20h ago 1
1.21.7
Fabric
20h ago 1
1.21.6
Neoforge
20h ago 1
1.21.6
Fabric
20h ago 1
1.21.5
Neoforge
20h ago 1
1.21.5
Fabric
20h ago 1
1.21.4
Neoforge
20h ago 1
1.21.4
Fabric
20h ago 1
1.21.1
Neoforge
20h ago 1
1.21.1
Fabric
20h ago 1
1.20.1
Forge
20h ago 1
1.20.1
Fabric
20h ago 1
1.21.1
Fabric
20h ago 1
1.21.1
Neoforge
20h ago 1
1.20.1
Fabric
20h ago 1
1.20.1
Forge
20h ago 1
1.21.1
Neoforge
20h ago 1
1.21.8
Neoforge
20h ago 1
1.21.8
Fabric
20h ago 1
1.21.7
Neoforge
20h ago 1
1.21.7
Fabric
20h ago 1
1.21.6
Neoforge
20h ago 1
1.21.6
Fabric
20h ago 1
1.21.5
Neoforge
20h ago 1
1.21.5
Fabric
20h ago 1
1.21.4
Neoforge
20h ago 1
1.21.4
Fabric
20h ago 1
1.21.1
Neoforge
20h ago 1
1.21.1
Fabric
20h ago 1
1.20.1
Forge
20h ago 1
1.20.1
Fabric
20h ago 1
1.21.8
Neoforge
20h ago 1
1.21.8
Fabric
20h ago 1
1.21.7
Neoforge
20h ago 1
1.21.7
Fabric
20h ago 1
1.21.6
Neoforge
20h ago 1
1.21.6
Fabric
20h ago 1
1.21.5
Neoforge
20h ago 1
1.21.5
Fabric
20h ago 1
1.21.4
Neoforge
20h ago 1
1.21.4
Fabric
20h ago 1
1.21.1
Neoforge
20h ago 1
1.21.1
Fabric
20h ago 1
1.20.1
Forge
20h ago 1
1.20.1
Fabric
20h ago 1
1.21.1
Neoforge
20h ago 1
1.21.1
Fabric
20h ago 1
1.20.1
Forge
20h ago 1
1.20.1
Fabric
20h ago 1
1.21.1
Neoforge
20h ago 1
1.21.1
Fabric
20h ago 1
1.20.1
Forge
20h ago 1
1.20.1
Fabric
20h ago 1
1.21.1
Fabric
20h ago 1
1.21.1
Neoforge
20h ago 1
1.21.1
Neoforge
20h ago 1
1.21.1
Fabric
20h ago 1
1.21.1
Neoforge
20h ago 1
1.21.1
Neoforge
20h ago 1
1.21.1
Neoforge
20h ago 1
1.21.1
Fabric
20h ago 1
1.20.1
Forge
20h ago 1
1.20.1
Fabric
20h ago 1
1.21.1
Fabric
20h ago 1
1.21.1
Neoforge
20h ago 1
1.21.1
Fabric
20h ago 1
1.21.1
Neoforge
20h ago 1
1.20.1
Fabric
20h ago 1
1.20.1
Forge
20h ago 1
1.21.1
Neoforge
20h ago 1
1.21.1
Fabric
20h ago 1
1.21.1
Fabric
20h ago 1
1.21.1
Neoforge
20h ago 1
1.20.1
Forge
20h ago 1
1.20.1
Fabric
20h ago 1
1.21.1
Fabric
20h ago 1
1.21.1
Neoforge
20h ago 1
1.21.1
Fabric
20h ago 1
1.21.1
Neoforge
20h ago 1
1.20.1
Fabric
20h ago 1
1.20.1
Forge
20h ago 1
1.20.1
Forge
20h ago 1
1.20.1
Forge
20h ago 1
1.20.1
Forge
20h ago 1
1.20.1
Forge
20h ago 1
1.20.1
Forge
20h ago 1
1.20.1
Forge
20h ago 1
1.20.1
Forge
20h ago 1
1.20.1
Forge
20h ago 1
# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

# 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


## 2.6.2.5

### Fixed

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

Quick Skin Icon
Download Quick Skin
Select game version
Select platform