ItemSwapper Mod FAQ

Hold the hotkey (default R) while an item is in your main hand. The interface appears based on what you're holding, and releasing the key swaps to whatever you selected.

The item in your main hand probably has no mapped alternatives, so nothing appears. Try holding a block, tool, food, or potion, or hold the key with an empty hand to see your inventory.

Keep holding the hotkey and move your mouse toward the option you want, then release the key to swap it into your main hand. For the list view, scroll with the mouse wheel to highlight an entry and release to confirm.

Hold the hotkey while holding any tool to bring up the item list, scroll to the tool you want, and release. This lets you cycle between pickaxes, axes, shovels, and similar tools without opening your inventory.

While an option is selected in the wheel, pressing the middle mouse button switches to related items if any exist. This lets you drill into variants or subcategories of the currently highlighted entry.

Hold a block and press the hotkey to open the wheel, which groups related blocks like stone variants, wood types, or colored blocks. Move the mouse to the palette you want and release to swap.

Yes, but only if the mod or plugin is also installed on the server. With that in place, shulker boxes in your inventory are treated as item sources when the wheel or list is open.

Hold the hotkey with nothing in your main hand, and the interface shows your inventory contents. Select an item and release the key to place it directly into your main hand.

Yes, the hotkey is rebindable through the standard Minecraft controls menu under the mod's keybind category. Change it there if R conflicts with another mod or your own muscle memory.

It works on servers, though shulker box support requires the mod or plugin server-side. The interface is lightweight and only active while the hotkey is held, so it has minimal impact on performance.