Skip to content

dooji2/variant-swap

Repository files navigation

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.

About

A mod that lets you cycle through block and item variants by holding a key and scrolling your mouse wheel.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages