ZenScroll

The ZenScroll mod provides modpack creators with a powerful tool for organizing cyclic switching between items directly in the game. Using CraftTweaker capabilities, you can create special scroll groups that allow instant item switching with a simple action.

To activate the function, simply hold the modifier key (default ALT) and scroll the mouse wheel - the selected item will automatically change to the next one in your group.

Scroll Group Configuration

Detailed instructions for creating scroll groups are available in the GitHub documentation. Here are some practical configuration examples:

import mods.zenscroll.ZenScroll;

// Basic group of three items
ZenScroll.add(<minecraft:apple>, <minecraft:gravel>, <minecraft:dirt>);

// Group using metadata
ZenScroll.add(<minecraft:wool:>);
ZenScroll.add(<minecraft:stained_hardened_clay:>);

Advanced Features

The mod supports complex usage scenarios with additional functions:

// Creating a composite group with NBT tag preservation
var glasses = ScrollGroup.of(<minecraft:stained_glass:>, <minecraft:stained_glass_pane:>);
glasses.copyTag(); // preserves all NBT tags when switching
ZenScroll.add(glasses);

// Custom switching processing
// In this example, apple turns into cookie, but not vice versa
ZenScroll.add(<minecraft:apple>).processor(
  function(prev as IItemStack, next as IItemStack) {
    return <minecraft:cookie>;
  }
)

This system opens endless possibilities for creating intuitive interfaces and simplifying gameplay in your modpacks.