Mineuniverse
Log in Register
Mods

Variant Swap

Quickly cycle through block and item variants by holding a key and scrolling your mouse wheel (works with mods too!)
by Dooji
Download Claim this project
715 downloads
0 likes
Updated Jul 6, 2026
0 hypes
Cosmetic Utility & QoL

bc25

Variant Swap is a mod that lets you change the variant of the item you're holding by using a customizable key (Z by default) and scrolling. When you scroll, you'll also see at the top of the screen a quick preview of what's before and after the selected item (for a few seconds).

In Creative mode, you can switch through every available variant of the item, while in Survival mode it only shows items you have in your inventory. It works with both vanilla and modded items!

Variant Swap Showcase

Customization

The mod's generated mappings and configuration file are located in your Minecraft (or server) folder under /config/Variant Swap/.

Available settings in config.json:

  • OP level (4 by default) - for the /variant-swap command
  • Delay (50ms by default) - this is to throttle the scrolling

On servers it is recommended to change the OP level as desired. The /variant-swap command can be used to reset the delay (cooldown) to its default value or to change it to another value (still in ms).

For Developers

If your mod adds items or blocks and you want to organize them into specific custom categories, add a variant_swap tag to each item/block. This tag will determine the group in which the item is categorized.

For example, imagine you have a mod that adds various furniture items, and you want to categorize them by wood type instead of grouping all chairs together. You could tag all oak items with variant_swap:oak (so oak or whatever you wanna call the category), all spruce items with variant_swap:spruce, and so on.

[1.21.5] Variant Swap v0.1.7
MC 1.21.5, Fabric, Client, Server
Release 2025-05-10 Get

More from Dooji

Underlay
7,709,970
Server Notify
670
Electricity
5,081
Clipboard+
429
Lower My Paths and Slabs!
3,310
CraftSense
309,426

You Might Also Like

Liberty's Villagers
Quality of Life and AI improvements for Villagers
9,968,428
No More Pop-ups
A Minecraft mod to remove in-game pop-ups
996,708
BetterRandomSourceConcurrencyCrash
Improved logging of crashes caused by mods accessing RandomSources from the wrong thread
99,371
Exit Confirmation
Often accidentally closed Minecraft? This mod might help!
99,067
NoDynamicFps
Adds an option to disable Vanilla's Dynamic FPS implementation
99,004
Immersive Crafting
Adds crafting recipes to immersive portals
9,998