
Mouse Tweaks
Enhances inventory management by adding various functions to the mouse buttons.
About this Mod
Mouse Tweaks replaces the standard RMB dragging mechanic, adds two new LMB dragging mechanics and an ability to quickly move items with the scroll wheel.
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.
Mouse Tweaks is purely client-side. There is no server-side component.
Extras
Configuration file: .minecraft/config/MouseTweaks.cfg
Tweaks
RMB Tweak
Very similar to the standard RMB dragging mechanic, with one difference: if you drag over a slot multiple times, an item will be put there multiple times. Replaces the standard mechanic if enabled.
Configuration setting: RMBTweak=1
Hold your right mouse button:

Drag your mouse around the crafting grid:

You can drag your mouse on top of existing items:

LMB Tweak (with item)
Lets you quickly pick up or move items of the same type.
Configuration setting: LMBTweakWithItem=1
Hold your left mouse button to pick up an item:

Drag your mouse across the inventory. Items of the same type will be picked up:

Hold shift and drag. Items of the same type will get "shift-clicked":

LMB Tweak (without item)
Quickly move items into another inventory.
Configuration setting: LMBTweakWithoutItem=1
Hold shift, then hold your left mouse button:
(Mouse cursor is not visible for some reason)

Drag your mouse across the inventory. Items will get "shift-clicked":
(Mouse cursor is not visible for some reason)

Wheel Tweak
Scroll to quickly move items between inventories. When you scroll down on an item stack, its items will be moved one by one. When you scroll up, items will be moved into it from another inventory.
Configuration setting: WheelTweak=1
Configuration setting: WheelSearchOrder=1
When you scroll up, the mod will search for items from last to first (when this is set to 1) or from first to last (when this is set to 0).
Configuration setting: WheelScrollDirection=0
Set this to 1 to invert the default scroll actions. So, when set to 1, scrolling down will pull the items and scrolling up will push the items.
Set this to 2 to enable the inventory position aware scrolling. Scrolling up will push the items into the other inventory if it's above the selected slot, or pull items from the other inventory if it's below the selected slot. Vice versa for scrolling down.
Obsolete / Removed Settings
These settings existed in older Mouse Tweaks versions but were removed since.
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
Toggles between "smooth scrolling, minor issues" (0) and "non-smooth scrolling, no issues" (1). When set to smooth scrolling, minor issues may be experienced such as scrolling "through" JEI or other mods. When set to non-smooth scrolling, those issues will not happen, but the scrolling will be a little non-smooth. Non-smooth scrolling works only with the Forge OnTick method.
This option is set to smooth scrolling by default because the aforementioned issues require rather specific conditions to trigger and aren't very impactful, while scrolling items is something you do all the time and want the experience to be as good as possible.
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.
Modpacks
Feel free to include Mouse Tweaks in modpacks.
Available Versions
How to Install Mouse Tweaks on Your Client
Install the Mod Loader Locally
Install fabric for your local Minecraft version.
Download the Matching File
Choose the Mouse Tweaks file for fabric and Minecraft 26.2.
Install Mod
Place the .jar file in your local .minecraft/mods folder and restart Minecraft. No server-side installation is required.
Compatibility
Mod Loaders
Minecraft Versions
26.2, 26.1.2, 26.1.1 (+32 more)
Server-side
β UnsupportedRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Does Mouse Tweaks need to be installed on the Minecraft server?
No. Modrinth marks Mouse Tweaks as unsupported on the server side. Install it only in your local Minecraft mods folder. Your server can remain unchanged unless the mod page lists an additional dependency.
Which version and loader does Mouse Tweaks require?
Use a file for fabric, forge, modloader, neoforge and your exact Minecraft version. Supported versions include 26.2, 26.1.2, 26.1.1. Files for different loaders are not interchangeable.
Mouse Tweaks is not working β what should I check?
First check the Minecraft version, loader version and required dependencies. Put the .jar file in your local .minecraft/mods folder and remove older duplicates. Because this mod is client-side, adding server RAM will not fix it.
Similar Mods
Minecraft Server for Your Group
Mouse Tweaks stays on your client. Host a compatible world for your group.