CurseForge · Minecraft mod
Mouse Tweaks
Enhances inventory management by adding various functions to the mouse buttons.
Quick answer
Which Mouse Tweaks release matches 1.21.7 NeoForge?
Mouse Tweaks [1.21.6+ NeoForge] Mouse Tweaks 2.28 targets 1.21.8, 1.21.7, 1.21.6 with NeoForge. The project page does not say whether it belongs on the client. The project page does not say whether it belongs on the dedicated server. 1 required mod needs a matching file.
Where it goes
Is Mouse Tweaks required on the client, server, or both?
The project page does not say whether it belongs on the client. The project page does not say whether it belongs on the dedicated server.
The source does not explicitly classify this release as client-only or server-only.
What else does Mouse Tweaks [1.21.6+ NeoForge] Mouse Tweaks 2.28 need?
[1.21.6+ NeoForge] Mouse Tweaks 2.28 on 1.21.7 NeoForge. Every mod below is checked against that same setup.
Install Fabric API first, but 1 required mod has no matching file for this setup. Do not mix loader builds to force a match.
We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add Mouse Tweaks without breaking your instance.
Built for Mouse Tweaks [1.21.6+ NeoForge] Mouse Tweaks 2.28 on 1.21.7 NeoForge. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use [1.21.6+ NeoForge] Mouse Tweaks 2.28. It targets 1.21.8, 1.21.7, 1.21.6 with NeoForge; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
Install Fabric API first, but 1 required mod has no matching file for this setup. Do not mix loader builds to force a match.
- 03
Put it on the correct side
The project page does not say whether it belongs on the client. The project page does not say whether it belongs on the dedicated server.
- 04
Pick the file you checked
Use the “Get this file” button beside [1.21.6+ NeoForge] Mouse Tweaks 2.28. It opens that exact file at the source.
About this project
What does Mouse Tweaks add?
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.
Project description from CurseForge.
Pick your setup
Mouse Tweaks by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
b1.7.3
1 loader build26.2
3 loader builds26.1.2
3 loader builds26.1.1
3 loader builds26.1
3 loader builds1.21.11
3 loader builds1.21.10
3 loader builds1.21.9
3 loader builds1.21.8
3 loader builds1.21.7
3 loader builds1.21.6
3 loader builds1.21.5
3 loader buildsShowing the newest 12 of 36 game versions. Older files are in the list below.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Mouse Tweaks versions and loaders
[1.21.6+ NeoForge] Mouse Tweaks 2.28
MouseTweaks-neoforge-mc1.21.6-2.28.jar
18 Jun 2025
Looking for an older file? The official CurseForge project page is in Resources.