Simple Skin Swapper

Simple Skin Swapper is a client-side Fabric mod for Minecraft 1.21.8+ 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.

---

Features

• Skin wheel — a radial menu that displays up to 10 of your local skins at once, opened with a configurable keybind
• Skin carousel — a classic list view for browsing skins more carefully, or for accessing skins that don't fit on the wheel when you have more than 10
• Server command support — automatically send a server command after applying a skin so your skin refreshes in real time for other players, without needing to reconnect
• SkinShuffle Bridge compatibility — when the SkinShuffle Bridge plugin is detected on the server, the mod uses the native skin refresh packet instead of a server command, for instant updates without any server configuration
• Per-server configuration — each server can have its own command configured

---

Disclaimer

This mod is heavily inspired by two existing mods:

• SkinSwapper by cobrasrock — the original skin swapping mod, no longer updated for recent Minecraft versions
• SkinShuffle by imb11 — the modern equivalent, and by far the most complete mod in this category

Simple Skin Swapper was created because some aspects of SkinShuffle's design did not fit my workflow, and because the ability to trigger a server-side skin refresh command was missing. SkinShuffle's approach to quick skin switching also relies on keybinds rather than a dynamic radial wheel.

This mod is not a replacement for SkinShuffle. If SkinShuffle works for you, use it — it still has more features. This mod exists to fill a specific gap (skin wheel and more focused features).

---

Limitations

• Multiplayer only. The mod is designed around the multiplayer experience and does not work in singleplayer worlds. Singleplayer support may be added in the future.
• Server command required for real-time updates (without SkinShuffle Bridge). If your server does not have the SkinShuffle Bridge plugin, other players will only see your new skin after you reconnect — unless your server has a command like /reloadskin configured.

---

Installation

1. Install Fabric Loader and Fabric API
2. Drop the mod .jar into your .minecraft/mods/ folder
3. Add your skin PNG files to .minecraft/skins/
4. Launch the game and bind the skin wheel key in Controls

---

Configuration

Open the configuration screen via ModMenu or from the carousel/wheel screen.

If the server does not have the SkinShuffle Bridge plugin, you can configure a command to send after applying a skin so other players see the change immediately. The server entry is created automatically on first connection with an empty command. Leave it empty to disable the feature for that server.

Note: This configuration is not needed if the server has the SkinShuffle Bridge plugin installed — the mod will detect it automatically and use the native skin refresh packet instead.

Config file location: .minecraft/config/simpleskinswapper.json

{
  "serverCommands": {
    "play.example.com": "/reloadskin",
    "another-server.net": ""
  }
}

---

Usage

Both the skin wheel and the skin carousel can be opened with a configurable keybind. You can set them in Options → Controls, under the Simple Skin Swapper category.

Skin wheel: hold your keybind to open the wheel, hover over the skin you want, and click to apply it. Releasing the keybind without clicking simply closes the wheel — no skin will be changed.

Skin carousel: open it by pressing its keybind once, or through ModMenu. Browse your skins and click the Apply button on the skin you want to switch to. You can also reorder skins using the arrow buttons — the order is saved, and it determines which skins appear on the wheel (the first 10 in the list).

Adding skins: drop any PNG skin file into the .minecraft/skins/ folder (or the skins/ folder of your instance if you use a custom launcher). A shortcut button to open that folder is available directly in the carousel screen.

---

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