Mineuniverse
Mods
Variant Swap

Variant Swap

MOD
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
899 downloads
0 likes
Updated Oct 14, 2026
0 hypes
Cosmetic Utility & QoL
Advertisement Remove ads with Premium →

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.20-4] Variant Swap v0.1.7
MC 1.20.2, Fabric, Client, 1.20.3, 1.20.1, 1.20, 1.20.4, Server
Release 2025-05-10 Get
[1.21] Variant Swap v0.1.7
MC 1.21, Fabric, Client, 1.21.1, Server
Release 2025-05-10 Get
[1.21.2-4] Variant Swap v0.1.7
MC Fabric, Client, 1.21.4, 1.21.3, Server, 1.21.2
Release 2025-05-10 Get
[1.21.5] Variant Swap v0.1.7
MC 1.21.5, Fabric, Client, Server
Release 2025-05-10 Get

More from Dooji

Advertisement Remove ads with Premium →

You Might Also Like