Variant Swap: Quick Item Switching for Minecraft

Variant Swap lets you cycle item variants with a key and scroll for faster building and inventory control in Minecraft. Download it today and streamline your gameplay.

Download variant swap for Minecraft 1.21.5, 1.21.4, 1.21, 1.20.2

Original name: variant swap

Minecraft: 1.20.2, 1.21, 1.21.4, 1.21.5

Loaders: Fabric

FileVersionLoaderSize
variant-swap-1.20-v0.1.7.jar1.20.2Fabric104 КБDownload
variant-swap-1.21-v0.1.7.jar1.21Fabric105 КБDownload
variant-swap-1.21.2-v0.1.7.jar1.21.4Fabric105 КБDownload
variant-swap-1.21.5-rc1-v0.1.7.jar1.21.5Fabric105 КБDownload

Variant Swap

Managing dozens of block variants in Minecraft can turn a simple build into a clicking marathon. Stairs, slabs, walls, wool colors, wood types, and modded furniture all compete for hotbar space, and before long your inventory is a mess of near-identical items. Variant Swap solves that problem with a single, elegant mechanic: hold a key, scroll, and watch your held item transform into another variant of the same block or item. It is one of those quality-of-life add-ons that feels obvious the moment you try it.

What Variant Swap Does

At its core, Variant Swap is a client-side convenience mod that lets you change the variant of the item you are holding using a customizable key, Z by default, combined with your scroll wheel. As you scroll, a quick preview appears at the top of the screen showing what comes before and after the currently selected variant, so you always know what you are about to switch to. The preview lingers for a few seconds and then fades, keeping your view clean during normal play.

The behavior adapts to your game mode, which is a thoughtful touch:

  • Creative mode: cycle through every available variant of the item, giving you instant access to the full palette without opening the inventory.
  • Survival mode: the mod only shows variants you actually have in your inventory, so it never breaks the rules of survival gameplay.
  • Vanilla and modded items: the system works across the board, including blocks and items added by other mods.

That last point matters a lot. Many inventory tweaks fall apart once modpacks enter the picture, but Variant Swap was built with modded content in mind, so a pack full of custom furniture, deco blocks, or building extensions still benefits from fast variant switching.

Supported Versions and Loaders

Variant Swap is designed for modern Minecraft releases and is distributed as a Fabric mod, with builds targeting recent 1.20.x and 1.21.x versions. Because it is lightweight and client-focused, it slots neatly into both vanilla-plus setups and large modpacks. If you are running a server, the mod can be installed there too, and server-side configuration is recommended so that command permissions behave the way you expect. Always check the file listing for the exact game version your launcher is running before you download Variant Swap, since matching the loader and game version is the most common source of startup crashes.

Customization and Commands

Configuration lives in your Minecraft or server folder under /config/Variant Swap/, where the mod generates its mappings and a config.json file. Two settings do most of the work:

  • OP level (4 by default): controls who can use the /variant-swap command on a server.
  • Delay (50ms by default): throttles scrolling so that a single flick of the wheel does not race through twenty variants at once.

The /variant-swap command can reset the delay cooldown to its default value or set a new one in milliseconds, which is handy if your mouse wheel is unusually sensitive. On multiplayer servers, lowering the OP level is strongly recommended so that regular players are not locked out of adjusting their own scroll behavior.

A Note for Mod Developers

If you develop mods and want your items grouped into sensible categories, Variant Swap supports a dedicated tag system. Add a variant_swap tag to each item or block, and that tag determines the group the item is sorted into. For example, a furniture mod could tag all oak pieces with variant_swap:oak and all spruce pieces with variant_swap:spruce, letting players cycle by wood type instead of wading through every chair in the game. It is a small feature that makes modded building feel far more organized.

How to Install Variant Swap

Getting started takes only a few minutes. First, confirm that Fabric Loader and the Fabric API are installed for your game version. Next, download Variant Swap for Minecraft from a trusted mod hosting site, making sure the file matches your exact game version. Drop the downloaded jar into your mods folder, launch the game through your launcher, and the mod will generate its config directory on first run. If you play on a server, install the same jar server-side and adjust the OP level in the config before inviting players in.

If you would rather skip manual file management, the foxygame.net launcher handles the entire process for you, offering Variant Swap through its curated add-on catalog with one-click installation and automatic updates. That approach removes the guesswork around loader versions and keeps the mod current without you touching a single folder.

Final Thoughts

Variant Swap is a small mod with an outsized impact on how you interact with blocks. By turning the scroll wheel into a variant selector with a clear on-screen preview, it cuts down on inventory clutter and speeds up building, terraforming, and decorating alike. Whether you are placing a hundred stair corners or matching wool colors across a castle, the mod keeps the right item one flick away. Install it once, and you will wonder how you ever built without it.