Mouse Tweaks Mod [1.21.11, 1.21.10, 1.21.8]

Mouse Tweaks Adds Custom RMB, LMB Drag, and Scroll Wheel Functionality

Mouse Tweaks overhauls the default right-click dragging behavior, introduces two fresh left-click drag mechanics, and enables rapid item movement using the scroll wheel.

Mod Installation

Install a compatible mod loader: 1.16.5 and later: install Minecraft Forge or Fabric. 1.14.4 and later: install Minecraft Forge. 1.12.2 and earlier: install either Minecraft Forge or LiteLoader (or both).
Put the Mouse Tweaks jar-file into the mods folder in your .minecraft directory.

Client-Side Only Installation

This mod runs entirely on the client side and does not require any server-side installation.

Mouse Tweaks API for Developers

Mouse Tweaks exposes an API that allows other mods to integrate and expand its drag‑and‑drop functionality.

Configuration file: .minecraft/config/MouseTweaks.cfg

RMB Tweak (Right Mouse Button Dragging)

The right‑mouse‑button drag behaves almost identically to the default mechanic, except that dragging over a slot multiple times places the item there more than once. When enabled, it supersedes the standard dragging behavior.

Configuration setting: RMBTweak=1

Right Mouse Button Drag Instructions

Hold down the right mouse button.

Crafting Grid Drag Instructions

Drag the mouse across the crafting grid.

Dragging Over Existing Items

Drag your mouse cursor across any item stacks already sitting inside an inventory slot to trigger a bulk interaction.

LMB Tweak (with item)

When you are holding an item, this tweak allows you to quickly pick up or relocate every stack of the same type in the inventory.

Configuration setting: LMBTweakWithItem=1

Left-Click Hold to Pick Up Items

Press and hold the left mouse button while hovering over an item to pick it up.

Drag to Collect Matching Items

Hold the left mouse button and drag across multiple inventory slots. All items of the same type will be collected onto your cursor.

Shift-Drag to Quickly Move Stacks

Hold the shift key while dragging the mouse across the inventory. Every matching stack is automatically shift-clicked, instantly sending it to the other inventory.

LMB Tweak (without item)

When your cursor is empty, this tweak lets you rapidly move whole item stacks from one inventory to another with a single click or drag.

Configuration setting: LMBTweakWithoutItem=1

Using Shift-LMB to Quick-Move an Entire Stack

Hold the Shift key and keep your left mouse button pressed. The cursor may not be visible during this operation.

Drag-to-Quick-Move Multiple Item Stacks

Drag your mouse across the inventory grid. Items will be shift-clicked automatically. Note that the cursor might disappear while dragging.

Wheel Tweak: Fast Inventory Sorting

Use the mouse wheel to move items between inventories quickly. Scrolling down on a stack sends items one by one to the other inventory. Scrolling up pulls items from the other inventory into the stack.

Configuration setting: WheelTweak=1

Configuration setting: WheelSearchOrder=1

Scroll Search Direction Preference

When set to 1, scrolling up searches for items from last to first. When set to 0, the search order is from first to last.

Configuration setting: WheelScrollDirection=0

Wheel Tweak Direction Modes

• Mode 1: Inverts default scroll behavior. Scrolling down pulls items, scrolling up pushes items.
• Mode 2: Enables inventory position-aware scrolling. If the target inventory is above the selected slot, scrolling up pushes items; if below, scrolling up pulls items. The opposite applies for scrolling down.

Obsolete / Removed Settings

These configuration options were available in earlier versions of Mouse Tweaks but have been removed and are no longer functional.

Configuration setting: OnTickMethodOrder=Forge, LiteLoader

Mouse Tweaks can use multiple APIs for an OnTick method that it requires. You can use this setting to control the API it prefers. This shouldn't really matter at all. If a method isn't supported (for example, you don't have the API installed) the mod will proceed to check the next ones.

Configuration setting: ScrollHandling=0

Mouse Scroll Smoothness Configuration

The smooth scrolling toggle accepts two values: 0 (smooth scrolling, minor issues) and 1 (non-smooth scrolling, no issues). When smooth scrolling is active, you may occasionally scroll through mod interfaces such as JEI due to the smoothing effect. Selecting non-smooth scrolling eliminates these problems, but the mouse wheel movement will be noticeably less fluid. Non-smooth scrolling relies on the Forge OnTick method to function.

By default, the option is set to smooth scrolling because the conflicts with other mods are rare and require specific conditions to occur, while a fluid scrolling experience is used constantly and greatly impacts user comfort.

Mouse Tweaks Compatibility

Mouse Tweaks is compatible with everything based on GuiContainer (as long as the behavior isn't changed too much).

If your GUI isn't based on GuiContainer , or if you want to improve compatibility (making Mouse Tweaks ignore some slot, for example), take a look at the API documentation .

Modpack Inclusion Policy

You are welcome to include Mouse Tweaks in any public or private modpack. No additional permission is required.

Mouse Tweaks Mod Frequently Asked Questions

Other Mods on the Minecraft Catalog

• Architecture Api
• GeckoLib
• Just Enough Items