All Mods Resource Packs Data Packs Shaders Modpacks Plugins
SimpleSkinSwapper
Projects / Mods

SimpleSkinSwapper

by Raconteur • Downloads: 0 • Followers: 0
Install / Download
Description
Gallery
Changelog
Versions

Simple Skin Swapper

Simple Skin Swapper is a client-side Fabric mod for Minecraft 1.21.11 and 26.x that lets you switch between your local skin files on the fly, without restarting the game or navigating through external websites. Open a dynamic skin wheel with a keybind, hover over the skin you want, click, and you're done.

Skin wheel

Features and Usage

Skin wheel

Hold your keybind (default key is G) to open the overlay, hover over the skin you want, and click to apply it. You can scroll to explore the available wheels. Releasing the keybind without clicking simply closes the wheel and no skin will be changed.

Skin wheel

You can reorganize the wheel by dragging the skin out, then dropping it where you want.

Skin wheel reorder
Skin library screen

Allows you to add and organize your existing skins. You can open it from the main or pause menu. You can access it quickly by setting up the dedicated keybind as well.

Skin library screen

You can:

  • Drag and drop skins to organize them in a category
  • Drag and drop skins to add them to another category
  • Create your own categories and configure them to change the number of wheels they can have, their color, and name
  • Quickly add a skin in the mod from a Minecraft account or from an existing file on your computer
Skin drag and drop in category
Skin drag and drop in category
Multiplayer and servers

Skin switching also works in multiplayer and has all the other players see your skin change in real time! Three ways to make it work:

  • Server side mod: You can add this mod to your Fabric server
  • SkinShuffleBridge plugin: SimpleSkinSwapper is compatible with the SkinShuffleBridge plugin allowing it to work with paper servers
  • Server side skin update command: If your server has a command to update your skin, you can configure it too

In any case, other players DON'T need to have the mod to see your skin change.

AI Disclosure

This project uses generative AI at several levels (code, docs). What that means, and what it doesn't, is explained in AI_DISCLOSURE.md. Read it to decide whether this mod is for you.

Acknowledgements

  • cobrasrock for creating SkinSwapper under an open license that allowed me to reuse parts of its logic
  • imb11 for creating SkinShuffle, an outstanding mod that remains the most fully-featured in its category, and the one I would be using if not for the specific features I was looking for

License

GNU Lesser General Public License v3.0 or later

All Versions

+ Add Version
Name Game version Platforms Published Downloads Actions
26.3
Fabric
17d ago 1
26.2
Fabric
17d ago 1
26.1.x
Fabric
17d ago 1
1.21.11
Fabric
17d ago 1
26.3.x
Fabric
1mo ago 1
26.2
Fabric
1mo ago 1
26.1.x
Fabric
1mo ago 1
1.21.11
Fabric
1mo ago 1
1.21.11
Fabric
2mo ago 1
26.1.x
Fabric
2mo ago 1
26.2
Fabric
2mo ago 1
26.3-snapshot-9
Fabric
2mo ago 1
26.2
Fabric
3mo ago 1
26.1.x
Fabric
3mo ago 1
1.21.11
Fabric
3mo ago 1
26.1.x
Fabric
3mo ago 1
26.2
Fabric
3mo ago 1
1.21.11
Fabric
3mo ago 1
26.2.x
Fabric
5mo ago 1
1.21.11
Fabric
5mo ago 1
26.1.x
Fabric
5mo ago 1
1.21.11
Fabric
5mo ago 1
26.1.x
Fabric
5mo ago 1
26.1.x
Fabric
5mo ago 1
1.21.11
Fabric
5mo ago 1
1.21.11
Fabric
7mo ago 1
1.21.8
Fabric
8mo ago 1
1.21.8
Fabric
8mo ago 1
1.21.8
Fabric
8mo ago 1
1.21.8
Fabric
8mo ago 1
# 0.12.0

  • Skins can be reordered directly on the skin wheel: press a sector, drag it outward, the wheel reflows live, click to drop it in place
  • New All skins wheel option (Never / Fallback / Always), with a cap on how many all-skins wheels appear when categories have slots
  • The All skins and Uncategorized views are now reorderable by drag & drop, like category views
  • The delete popup always offers both actions, even on a skin's last category: remove from category, or delete everywhere
  • The add-skin panel flags skins that already exist and asks for confirmation before assigning a skin to a category card
  • The mod's UI chrome now ships its own textures: a resource pack can retheme the skin library without touching any vanilla asset
  • Category names no longer change when the skin's global display name is edited
  • Fixed the drag insertion gap opening in the wrong grid cell
  • Fixed forward card drags in the library grid and the add card staying pinned
  • The skin wheel keybind defaults to G
# 0.12.0

  • Skins can be reordered directly on the skin wheel: press a sector, drag it outward, the wheel reflows live, click to drop it in place
  • New All skins wheel option (Never / Fallback / Always), with a cap on how many all-skins wheels appear when categories have slots
  • The All skins and Uncategorized views are now reorderable by drag & drop, like category views
  • The delete popup always offers both actions, even on a skin's last category: remove from category, or delete everywhere
  • The add-skin panel flags skins that already exist and asks for confirmation before assigning a skin to a category card
  • The mod's UI chrome now ships its own textures: a resource pack can retheme the skin library without touching any vanilla asset
  • Category names no longer change when the skin's global display name is edited
  • Fixed the drag insertion gap opening in the wrong grid cell
  • Fixed forward card drags in the library grid and the add card staying pinned
  • The skin wheel keybind defaults to G
# 0.12.0

  • Skins can be reordered directly on the skin wheel: press a sector, drag it outward, the wheel reflows live, click to drop it in place
  • New All skins wheel option (Never / Fallback / Always), with a cap on how many all-skins wheels appear when categories have slots
  • The All skins and Uncategorized views are now reorderable by drag & drop, like category views
  • The delete popup always offers both actions, even on a skin's last category: remove from category, or delete everywhere
  • The add-skin panel flags skins that already exist and asks for confirmation before assigning a skin to a category card
  • The mod's UI chrome now ships its own textures: a resource pack can retheme the skin library without touching any vanilla asset
  • Category names no longer change when the skin's global display name is edited
  • Fixed the drag insertion gap opening in the wrong grid cell
  • Fixed forward card drags in the library grid and the add card staying pinned
  • The skin wheel keybind defaults to G
# 0.12.0

  • Skins can be reordered directly on the skin wheel: press a sector, drag it outward, the wheel reflows live, click to drop it in place
  • New All skins wheel option (Never / Fallback / Always), with a cap on how many all-skins wheels appear when categories have slots
  • The All skins and Uncategorized views are now reorderable by drag & drop, like category views
  • The delete popup always offers both actions, even on a skin's last category: remove from category, or delete everywhere
  • The add-skin panel flags skins that already exist and asks for confirmation before assigning a skin to a category card
  • The mod's UI chrome now ships its own textures: a resource pack can retheme the skin library without touching any vanilla asset
  • Category names no longer change when the skin's global display name is edited
  • Fixed the drag insertion gap opening in the wrong grid cell
  • Fixed forward card drags in the library grid and the add card staying pinned
  • The skin wheel keybind defaults to G
A rebuilt skin library and a cleaner card experience.

  • Skins now live in a mod-managed registry: duplicate textures are stored once as hash-named files, skins are texture+model pairs, and a one-time migration preserves your original files in User Files/
  • New Uncategorized view; every skin is always reachable
  • Cards simplified: the whole card drags to reorder, a click opens the editor, preview rotation lives only in the editor
  • Every deletion (skin or category) goes through one unified confirmation popup
  • The editor applies names and model switch when it closes, with a live model-switch preview
  • Guaranteed layout density: at least 5 tab strip slots (with ghost placeholders) and 5 sectors per wheel; empty wheels stay hidden; empty views show only the "+" card
  • New categories start with one wheel slot; new minimum card width setting
  • Fixed: equipped skin re-downloads when missing locally, dye icons on 1.21.11, MC 26.3-rc-3 support with updated dependencies
A rebuilt skin library and a cleaner card experience.

  • Skins now live in a mod-managed registry: duplicate textures are stored once as hash-named files, skins are texture+model pairs, and a one-time migration preserves your original files in User Files/
  • New Uncategorized view; every skin is always reachable
  • Cards simplified: the whole card drags to reorder, a click opens the editor, preview rotation lives only in the editor
  • Every deletion (skin or category) goes through one unified confirmation popup
  • The editor applies names and model switch when it closes, with a live model-switch preview
  • Guaranteed layout density: at least 5 tab strip slots (with ghost placeholders) and 5 sectors per wheel; empty wheels stay hidden; empty views show only the "+" card
  • New categories start with one wheel slot; new minimum card width setting
  • Fixed: equipped skin re-downloads when missing locally, dye icons on 1.21.11, MC 26.3-rc-3 support with updated dependencies
A rebuilt skin library and a cleaner card experience.

  • Skins now live in a mod-managed registry: duplicate textures are stored once as hash-named files, skins are texture+model pairs, and a one-time migration preserves your original files in User Files/
  • New Uncategorized view; every skin is always reachable
  • Cards simplified: the whole card drags to reorder, a click opens the editor, preview rotation lives only in the editor
  • Every deletion (skin or category) goes through one unified confirmation popup
  • The editor applies names and model switch when it closes, with a live model-switch preview
  • Guaranteed layout density: at least 5 tab strip slots (with ghost placeholders) and 5 sectors per wheel; empty wheels stay hidden; empty views show only the "+" card
  • New categories start with one wheel slot; new minimum card width setting
  • Fixed: equipped skin re-downloads when missing locally, dye icons on 1.21.11, MC 26.3-rc-3 support with updated dependencies
A rebuilt skin library and a cleaner card experience.

  • Skins now live in a mod-managed registry: duplicate textures are stored once as hash-named files, skins are texture+model pairs, and a one-time migration preserves your original files in User Files/
  • New Uncategorized view; every skin is always reachable
  • Cards simplified: the whole card drags to reorder, a click opens the editor, preview rotation lives only in the editor
  • Every deletion (skin or category) goes through one unified confirmation popup
  • The editor applies names and model switch when it closes, with a live model-switch preview
  • Guaranteed layout density: at least 5 tab strip slots (with ghost placeholders) and 5 sectors per wheel; empty wheels stay hidden; empty views show only the "+" card
  • New categories start with one wheel slot; new minimum card width setting
  • Fixed: equipped skin re-downloads when missing locally, dye icons on 1.21.11, MC 26.3-rc-3 support with updated dependencies
# 0.10.0
  • Add Minecraft 26.3 snapshot target
  • Replace SpruceUI/Yumi widgets with vanilla widgets (drops SpruceUI dependency)
  • Rebuild config screen with YACL list of per-server commands
  • Add left/right placement option for menu buttons
  • Improve skin wheel rendering performance (baked preview textures, sector meshes)
  • Fix edit boxes overflowing their borders
# 0.10.0
  • Add Minecraft 26.3 snapshot target
  • Replace SpruceUI/Yumi widgets with vanilla widgets (drops SpruceUI dependency)
  • Rebuild config screen with YACL list of per-server commands
  • Add left/right placement option for menu buttons
  • Improve skin wheel rendering performance (baked preview textures, sector meshes)
  • Fix edit boxes overflowing their borders
# 0.10.0
  • Add Minecraft 26.3 snapshot target
  • Replace SpruceUI/Yumi widgets with vanilla widgets (drops SpruceUI dependency)
  • Rebuild config screen with YACL list of per-server commands
  • Add left/right placement option for menu buttons
  • Improve skin wheel rendering performance (baked preview textures, sector meshes)
  • Fix edit boxes overflowing their borders
# 0.10.0

  • Add Minecraft 26.3 snapshot target
  • Replace SpruceUI/Yumi widgets with vanilla widgets (drops SpruceUI dependency)
  • Rebuild config screen with YACL list of per-server commands
  • Add left/right placement option for menu buttons
  • Improve skin wheel rendering performance (baked preview textures, sector meshes)
  • Fix edit boxes overflowing their borders
  • Fixed a crash on MC 26.2** when opening the skin carousel with more skins than fit on screen, or when scrolling it
(off-screen cards submitted invalid scissor rectangles)
  • Fixed the carousel layout at large GUI scales**: the top bar no longer overflows the right edge, and cards no
longer overlap it
  • Internal: codebase migrated to Kotlin, multi-version build via Stonecutter
  • Fixed a crash on MC 26.2** when opening the skin carousel with more skins than fit on screen, or when scrolling it
(off-screen cards submitted invalid scissor rectangles)
  • Fixed the carousel layout at large GUI scales**: the top bar no longer overflows the right edge, and cards no
longer overlap it
  • Internal: codebase migrated to Kotlin, multi-version build via Stonecutter
  • Fixed a crash on MC 26.2** when opening the skin carousel with more skins than fit on screen, or when scrolling it
(off-screen cards submitted invalid scissor rectangles)
  • Fixed the carousel layout at large GUI scales**: the top bar no longer overflows the right edge, and cards no
longer overlap it
  • Internal: codebase migrated to Kotlin, multi-version build via Stonecutter
# Simple Skin Swapper — 0.8.0 (1.21.11 / 26.1 / 26.2)

### New
  • Skin preview in the title and pause menus** — a live 3D preview of your currently selected skin is now shown directly on the title screen and pause menu.
  • Drag to rotate the skin preview** — click and drag a skin preview in the carousel to rotate it and see it from any angle; it springs back to its default orientation when released.
  • Delete skins from the carousel** — each skin card now has a Delete button with an inline confirmation step, so you can remove skins you no longer want without leaving the screen.
  • Add a skin from a local PNG file** — use the new "+ Add" button in the carousel toolbar to import a skin file directly from your computer.
  • Add a skin from a Minecraft account name** — use "+ Add from MC name" to fetch and import a player's current skin by their username. Invalid or unknown accounts are clearly flagged.

### Fixed
  • The Skin Swapper keybind category showed up untranslated in the Controls menu instead of displaying "Simple Skin Swapper". It was being registered under the wrong (default minecraft) namespace, so the game couldn't find its translation.
# Simple Skin Swapper — 0.8.0 (1.21.11 / 26.1 / 26.2)

### New
  • Skin preview in the title and pause menus** — a live 3D preview of your currently selected skin is now shown directly on the title screen and pause menu.
  • Drag to rotate the skin preview** — click and drag a skin preview in the carousel to rotate it and see it from any angle; it springs back to its default orientation when released.
  • Delete skins from the carousel** — each skin card now has a Delete button with an inline confirmation step, so you can remove skins you no longer want without leaving the screen.
  • Add a skin from a local PNG file** — use the new "+ Add" button in the carousel toolbar to import a skin file directly from your computer.
  • Add a skin from a Minecraft account name** — use "+ Add from MC name" to fetch and import a player's current skin by their username. Invalid or unknown accounts are clearly flagged.

### Fixed
  • The Skin Swapper keybind category showed up untranslated in the Controls menu instead of displaying "Simple Skin Swapper". It was being registered under the wrong (default minecraft) namespace, so the game couldn't find its translation.
# Simple Skin Swapper — 0.8.0 (1.21.11 / 26.1 / 26.2)

### New
  • Skin preview in the title and pause menus** — a live 3D preview of your currently selected skin is now shown directly on the title screen and pause menu.
  • Drag to rotate the skin preview** — click and drag a skin preview in the carousel to rotate it and see it from any angle; it springs back to its default orientation when released.
  • Delete skins from the carousel** — each skin card now has a Delete button with an inline confirmation step, so you can remove skins you no longer want without leaving the screen.
  • Add a skin from a local PNG file** — use the new "+ Add" button in the carousel toolbar to import a skin file directly from your computer.
  • Add a skin from a Minecraft account name** — use "+ Add from MC name" to fetch and import a player's current skin by their username. Invalid or unknown accounts are clearly flagged.

### Fixed
  • The Skin Swapper keybind category showed up untranslated in the Controls menu instead of displaying "Simple Skin Swapper". It was being registered under the wrong (default minecraft) namespace, so the game couldn't find its translation.
Update to 26.2
Backport of singleplayer support, and add serverside support directly in the mod allowing a fabric server to support it.
Add server side support (act like skinshuffle bridge)
Add singleplayer support

fix: wrong skin preview displayed + missing commons-logging dependency

Made texture key unique with path hash to fix collisions on similar/Cyrillic names; bundled commons-logging required by Apache HttpClient.
fix: wrong skin preview displayed + missing commons-logging dependency

Made texture key unique with path hash to fix collisions on similar/Cyrillic names; bundled commons-logging required by Apache HttpClient.
Migrate to mojang mappings and 26.1.2
Fix spruce ui inclusion
Version specific for 1.21.11 because it was not working before
Add a way to force the skin type
Fixed proxy always defining the skin as classic in MineSkins
Add skin shuffle bridge compatibility and sound effects in switch wheel
Multiple big changes, add skin switch wheel, rework configuration and other improvements
[0.1.0] SimpleSkinLoader 0.1.0 by Raconteur on Feb 27, 2026
Download
First version

Can defin a command to update skin on servers and switch skin from the dedicated screen

🌟 Related Projects

Similar modifications and resources you might like

View all →
Geckolib
G

Geckolib

by Gecko

A 3D animation library for entities, blocks, items, armor, and more!

620
mod
Immersive Portals
I

Immersive Portals

by qouteall

See through portals and teleport seamlessly

125
mod
Coordinates Display
C

Coordinates Display

by Boxadactle

A basic mod that displays your Coordinates on the In-game HUD.

118
mod
CreamyKeys
C

CreamyKeys

by cutebow

A mod that adds keyboard and mouse clicking sounds in game for your inputs, You can add your own sounds now!

88
mod
SimpleSkinSwapper Icon
Download SimpleSkinSwapper
Select game version
Select platform