Colors
Modrinth
Mod
Mouse Tweaks
Enhances inventory management by adding various functions to the mouse buttons.
Minecraft product info
Important product information
Compatibility, Minecraft versions, loaders, and external source data.
Type
Mod
Access
Free
Latest version
26.2-2.31-forge
Downloads
50 008 681
Loaders / Platforms
fabric
forge
modloader
neoforge
Minecraft versions
1.16.2 – 1.16.5
1.17.1 – 1.20.4
1.20.6 – 1.21.1
1.21.3 – 1.21.11
26.1
26.1.1
26.1.2
26.2
Categories
storage
utility
Description
Detailed information
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
1. 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).
2. 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
[**Mouse Tweaks API**](https://github.com/YaLTeR/MouseTweaks/tree/master/src/main/java/yalter/mousetweaks/api)
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](https://github.com/YaLTeR/MouseTweaks/blob/2dc5bb108c2663f9a07b3a181483733a0274b41a/src/api/java/yalter/mousetweaks/api/IMTModGuiContainer3.java).
## Modpacks
Feel free to include Mouse Tweaks in modpacks.
Product gallery
Project images
Screenshots and images from the original Modrinth page.
Change log
Project versions
Published versions and original Modrinth files.
26.2-2.31-forge
Current
Release
18.06.2026
[26.2 Forge] Mouse Tweaks 2.31
Supported Minecraft versions
26.2
Loaders / Platforms
forge
Show changes
Updated to Minecraft 26.2.
Sign in
0.07 MB
26.2-2.31-neoforge
Release
16.06.2026
[26.2 NeoForge] Mouse Tweaks 2.31
Supported Minecraft versions
26.2
Loaders / Platforms
neoforge
Show changes
Updated to Minecraft 26.2.
Sign in
0.07 MB
26.2-2.31-fabric
Release
16.06.2026
[26.2 Fabric] Mouse Tweaks 2.31
Supported Minecraft versions
26.2
Loaders / Platforms
fabric
Show changes
Updated to Minecraft 26.2.
Sign in
0.07 MB
26.1-2.31-fabric
Release
29.03.2026
[26.1 Fabric] Mouse Tweaks 2.31
Supported Minecraft versions
26.1
26.1.1
26.1.2
Loaders / Platforms
fabric
Show changes
- Updated to Minecraft 26.1.
- Wheel tweak will no longer reset the smelting progress when scrolling items from the furnace input slot.
- Wheel tweak will now work as expected when holding a Bundle on the mouse (it will move items the same way as when holding any other item).
- Fixed a rare and hard to hit bug where very quick scrolling could push fewer items than expected into empty slots.
The way the wheel tweak changes work under the hood is that the wheel tweak will now grab the items with a right click instead of a left click. This leaves half of the stack in the slot instead of taking the whole stack out temporarily. For a furnace input slot, this lets the smelting continue instead of interrupting it.
Sign in
0.07 MB
26.1-2.31-neoforge
Release
29.03.2026
[26.1 NeoForge] Mouse Tweaks 2.31
Supported Minecraft versions
26.1
26.1.1
26.1.2
Loaders / Platforms
neoforge
Show changes
- Updated to Minecraft 26.1.
- Wheel tweak will no longer reset the smelting progress when scrolling items from the furnace input slot.
- Wheel tweak will now work as expected when holding a Bundle on the mouse (it will move items the same way as when holding any other item).
- Fixed a rare and hard to hit bug where very quick scrolling could push fewer items than expected into empty slots.
The way the wheel tweak changes work under the hood is that the wheel tweak will now grab the items with a right click instead of a left click. This leaves half of the stack in the slot instead of taking the whole stack out temporarily. For a furnace input slot, this lets the smelting continue instead of interrupting it.
Sign in
0.07 MB
26.1-2.31-forge
Release
29.03.2026
[26.1 Forge] Mouse Tweaks 2.31
Supported Minecraft versions
26.1
26.1.1
26.1.2
Loaders / Platforms
forge
Show changes
- Updated to Minecraft 26.1.
- Wheel tweak will no longer reset the smelting progress when scrolling items from the furnace input slot.
- Wheel tweak will now work as expected when holding a Bundle on the mouse (it will move items the same way as when holding any other item).
- Fixed a rare and hard to hit bug where very quick scrolling could push fewer items than expected into empty slots.
The way the wheel tweak changes work under the hood is that the wheel tweak will now grab the items with a right click instead of a left click. This leaves half of the stack in the slot instead of taking the whole stack out temporarily. For a furnace input slot, this lets the smelting continue instead of interrupting it.
Sign in
0.07 MB
1.21.11-2.30-fabric
Release
12.12.2025
[1.21.11 Fabric] Mouse Tweaks 2.30
Supported Minecraft versions
1.21.11
Loaders / Platforms
fabric
Show changes
Updated to Minecraft 1.21.11.
Sign in
0.07 MB
1.21.11-2.30-forge
Release
12.12.2025
[1.21.11 Forge] Mouse Tweaks 2.30
Supported Minecraft versions
1.21.11
Loaders / Platforms
forge
Show changes
Updated to Minecraft 1.21.11.
Sign in
0.07 MB
1.21.11-2.30-neoforge
Release
12.12.2025
[1.21.11 NeoForge] Mouse Tweaks 2.30
Supported Minecraft versions
1.21.11
Loaders / Platforms
neoforge
Show changes
Updated to Minecraft 1.21.11.
Sign in
0.07 MB
1.21.9-2.29-fabric
Release
05.10.2025
[1.21.9+ Fabric] Mouse Tweaks 2.29
Supported Minecraft versions
1.21.9
1.21.10
Loaders / Platforms
fabric
Show changes
Updated to Minecraft 1.21.9.
Sign in
0.07 MB
1.21.9-2.29-forge
Release
05.10.2025
[1.21.9+ Forge] Mouse Tweaks 2.29
Supported Minecraft versions
1.21.9
1.21.10
Loaders / Platforms
forge
Show changes
Updated to Minecraft 1.21.9.
Sign in
0.07 MB
1.21.9-2.29-neoforge
Release
05.10.2025
[1.21.9+ NeoForge] Mouse Tweaks 2.29
Supported Minecraft versions
1.21.9
1.21.10
Loaders / Platforms
neoforge
Show changes
Updated to Minecraft 1.21.9.
Sign in
0.07 MB
1.21.6-2.28-forge
Release
24.06.2025
[1.21.6+ Forge] Mouse Tweaks 2.28
Supported Minecraft versions
1.21.6
1.21.7
1.21.8
Loaders / Platforms
forge
Show changes
Updated to Minecraft 1.21.6.
Sign in
0.07 MB
1.21.6-2.28-fabric
Release
18.06.2025
[1.21.6+ Fabric] Mouse Tweaks 2.28
Supported Minecraft versions
1.21.6
1.21.7
1.21.8
Loaders / Platforms
fabric
Show changes
Updated to Minecraft 1.21.6.
Sign in
0.07 MB
1.21.6-2.28-neoforge
Release
18.06.2025
[1.21.6+ NeoForge] Mouse Tweaks 2.28
Supported Minecraft versions
1.21.6
1.21.7
1.21.8
Loaders / Platforms
neoforge
Show changes
Updated to Minecraft 1.21.6.
Sign in
0.07 MB
1.21.5-2.28-neoforge
Release
27.03.2025
[1.21.5 NeoForge] Mouse Tweaks 2.28
Supported Minecraft versions
1.21.5
Loaders / Platforms
neoforge
Show changes
Updated to NeoForge for Minecraft 1.21.5.
Sign in
0.07 MB
1.21.3-2.27-fabric
Release
29.10.2024
[1.21.3+ Fabric] Mouse Tweaks 2.27
Supported Minecraft versions
1.21.3
1.21.4
1.21.5
Loaders / Platforms
fabric
Show changes
Fixed wheel tweak overriding bundle scrolling on Fabric.
Sign in
0.07 MB
1.21.3-2.26.1-fabric
Release
26.10.2024
[1.21.3 Fabric] Mouse Tweaks 2.26.1
Supported Minecraft versions
1.21.3
Loaders / Platforms
fabric
Show changes
Updated to Minecraft 1.21.3.
Sign in
0.07 MB
1.21.3-2.26.1-neoforge
Release
26.10.2024
[1.21.3–1.21.4 NeoForge] Mouse Tweaks 2.26.1
Supported Minecraft versions
1.21.3
1.21.4
Loaders / Platforms
neoforge
Show changes
Updated to Minecraft 1.21.3.
Sign in
0.07 MB
1.21.3-2.26.1-forge
Release
26.10.2024
[1.21.3+ Forge] Mouse Tweaks 2.26.1
Supported Minecraft versions
1.21.3
1.21.4
1.21.5
Loaders / Platforms
forge
Show changes
Updated to Minecraft 1.21.3.
Sign in
0.07 MB
1.21-2.26.1-neoforge
Release
17.08.2024
[1.21+ NeoForge] Mouse Tweaks 2.26.1
Supported Minecraft versions
1.21
1.21.1
Loaders / Platforms
neoforge
Show changes
Updated to the new NeoForge, fixing a config screen crash.
Fabric and Forge do not need any changes, so only NeoForge has 2.26.1.
Sign in
0.07 MB
1.21-2.26-fabric
Release
17.06.2024
[1.21+ Fabric] Mouse Tweaks 2.26
Supported Minecraft versions
1.21
1.21.1
Loaders / Platforms
fabric
Show changes
- Updated to Minecraft 1.21.
Sign in
0.07 MB
1.21-2.26-neoforge
Release
17.06.2024
[1.21 NeoForge] Mouse Tweaks 2.26
Supported Minecraft versions
1.21
Loaders / Platforms
neoforge
Show changes
- Updated to Minecraft 1.21.
Sign in
0.07 MB
1.21-2.26-forge
Release
17.06.2024
[1.21+ Forge] Mouse Tweaks 2.26
Supported Minecraft versions
1.21
1.21.1
Loaders / Platforms
forge
Show changes
- Updated to Minecraft 1.21.
Sign in
0.07 MB
1.20.6-2.26-forge
Release
12.06.2024
[1.20.6 Forge] Mouse Tweaks 2.26
Supported Minecraft versions
1.20.6
Loaders / Platforms
forge
Show changes
- Updated to Minecraft 1.20.6 (thanks @danorris709 for fixing the Forge Mouse Tweaks version).
Sign in
0.07 MB
1.20.1-2.25.1-forge
Release
12.05.2024
[1.20.1 Forge] Mouse Tweaks 2.25.1
Supported Minecraft versions
1.20.1
Loaders / Platforms
forge
Show changes
- Fixed an incompatibility with certain mods that was causing a crash (specifically, Nether Chested was triggering this Mouse Tweaks issue).
- Improved compatibility with slots with custom stack limits (like in the Nether Chested mod).
Sign in
0.07 MB
1.20.6-2.26-fabric
Release
01.05.2024
[1.20.6 Fabric] Mouse Tweaks 2.26
Supported Minecraft versions
1.20.6
Loaders / Platforms
fabric
Show changes
- Updated to Minecraft 1.20.6.
Sign in
0.07 MB
1.20.6-2.26-neoforge
Release
01.05.2024
[1.20.6 NeoForge] Mouse Tweaks 2.26
Supported Minecraft versions
1.20.6
Loaders / Platforms
neoforge
Show changes
- Updated to Minecraft 1.20.6.
Sign in
0.07 MB
1.20.4-2.26-neoforge
Release
02.04.2024
[1.20.4 NeoForge] Mouse Tweaks 2.26
Supported Minecraft versions
1.20.4
Loaders / Platforms
neoforge
Show changes
- Improved compatibility with slots with custom stack limits (like in the Nether Chested mod).
Sign in
0.07 MB
1.20.2-2.26-forge
Release
02.04.2024
[1.20.2–1.20.4 Forge] Mouse Tweaks 2.26
Supported Minecraft versions
1.20.2
1.20.3
1.20.4
Loaders / Platforms
forge
Show changes
- Improved compatibility with slots with custom stack limits (like in the Nether Chested mod).
Sign in
0.07 MB
1.20-2.26-fabric
Release
02.04.2024
[1.20–1.20.4 Fabric] Mouse Tweaks 2.26
Supported Minecraft versions
1.20
1.20.1
1.20.2
1.20.3
1.20.4
Loaders / Platforms
fabric
Show changes
- Improved compatibility with slots with custom stack limits (like in the Nether Chested mod).
Sign in
0.07 MB
1.20.4-2.25-neoforge
Release
04.03.2024
[1.20.4 NeoForge] Mouse Tweaks 2.25
Supported Minecraft versions
1.20.4
Loaders / Platforms
neoforge
Show changes
Ported to NeoForge (thanks ErrorMikey).
Sign in
0.07 MB
1.20.2-2.25-forge
Release
01.10.2023
[1.20.2+ Forge] Mouse Tweaks 2.25
Supported Minecraft versions
1.20.2
1.20.3
1.20.4
Loaders / Platforms
forge
Show changes
- Updated to Minecraft 1.20.2.
Sign in
0.07 MB
1.20-2.25-fabric
Release
11.06.2023
[1.20+ Fabric] Mouse Tweaks 2.25
Supported Minecraft versions
1.20
1.20.1
1.20.2
1.20.3
1.20.4
Loaders / Platforms
fabric
Show changes
- Updated to Minecraft 1.20.
Sign in
0.07 MB
1.20-2.25-forge
Release
11.06.2023
[1.20–1.20.1 Forge] Mouse Tweaks 2.25
Supported Minecraft versions
1.20
1.20.1
Loaders / Platforms
forge
Show changes
- Updated to Minecraft 1.20.
Sign in
0.07 MB
1.19.4-2.24-fabric
Release
16.03.2023
[1.19.4] Mouse Tweaks 2.24 Fabric
Supported Minecraft versions
1.19.4
Loaders / Platforms
fabric
Show changes
- Updated to Minecraft 1.19.4.
Sign in
0.07 MB
1.19.4-2.24-forge
Release
16.03.2023
[1.19.4] Mouse Tweaks 2.24 Forge
Supported Minecraft versions
1.19.4
Loaders / Platforms
forge
Show changes
- Updated to Minecraft 1.19.4.
Sign in
0.07 MB
1.19.3-2.24-fabric
Release
21.12.2022
[1.19.3] Mouse Tweaks 2.24 Fabric
Supported Minecraft versions
1.19.3
Loaders / Platforms
fabric
Show changes
- Updated to Minecraft 1.19.3, fixing crash in the Mouse Tweaks configuration menu.
Sign in
0.07 MB
1.19.3-2.24-forge
Release
21.12.2022
[1.19.3] Mouse Tweaks 2.24 Forge
Supported Minecraft versions
1.19.3
Loaders / Platforms
forge
Show changes
- Updated to Minecraft 1.19.3, fixing crash in the Mouse Tweaks configuration menu.
Sign in
0.07 MB
b1.7.3-2.7.2-modloader
Release
07.08.2022
[b1.7.3] Mouse Tweaks 2.7.2
Supported Minecraft versions
b1.7.3
Loaders / Platforms
modloader
Show changes
This is a backport of Mouse Tweaks 2.7.2 to Minecraft **Beta 1.7.3**. You will need [Risugami's ModLoader](https://www.mediafire.com/file/vb5bq3aoitdkgx8/ModLoader_B1.7.3.zip/file).
Thanks to FabiClawZ for the backporting work!
Sign in
0.07 MB
1.19-2.23-forge
Release
12.07.2022
[1.19+] Mouse Tweaks 2.23
Supported Minecraft versions
1.19
1.19.1
1.19.2
Loaders / Platforms
forge
Show changes
- Updated to Forge 41.0.94, fixing crashes with the new Forge versions.
The Fabric version does not have any changes so it stays at 2.22.
Sign in
0.07 MB
1.19-2.22-fabric
Release
12.06.2022
[1.19+] Mouse Tweaks 2.22
Supported Minecraft versions
1.19
1.19.1
1.19.2
Loaders / Platforms
fabric
Show changes
- Updated to Minecraft 1.19.
- Removed the Architectury issue workaround as it's been fixed in Architectury a while ago.
Sign in
0.07 MB
1.19-2.22-forge
Release
12.06.2022
[1.19] Mouse Tweaks 2.22
Supported Minecraft versions
1.19
Loaders / Platforms
forge
Show changes
- Updated to Minecraft 1.19.
- Removed the Architectury issue workaround as it's been fixed in Architectury a while ago.
Sign in
0.07 MB
1.18-2.22-fabric
Release
12.06.2022
[1.18+] Mouse Tweaks 2.22
Supported Minecraft versions
1.18
1.18.1
1.18.2
Loaders / Platforms
fabric
Show changes
- Fixed compatibility with Replay Mod.
- Changed how RMBTweak works to support Bundles and Bundle-like mod items.
- RMB-dragging a Bundle with RMBTweak will "right click" items out of a Bundle into the slots as you're dragging over them.
- RMB-dragging with a Bundle over items will now pick the items up into the Bundle.
- Enabled RMBTweak by default again.
- Added a config menu accessible from the Mods menu in Forge and from Mod Menu in Fabric.
- Adjusted inventory-position-aware scrolling type to be a bit more intuitive. In particular, scrolling down from the crafting output slot in the player inventory now moves the item into the player inventory as expected.
- (Fabric) Fixed Wheel Tweak blocking the open container's wheel handling. This improves compatibility with Modern Industrialization. The Fabric version behavior now matches the Forge version behavior better in this regard.
- (Fabric) Fixed compatibility with Architectury.
Sign in
0.07 MB
1.16.5-2.22-fabric
Release
13.01.2022
[1.16.5] Mouse Tweaks 2.22
Supported Minecraft versions
1.16.5
Loaders / Platforms
fabric
Show changes
This is a backport of Mouse Tweaks 2.22 to 1.16.5 Fabric. The GUI options menu is not included because it was too complex to support on 1.16.5.
Sign in
0.07 MB
1.18-2.22-forge
Release
13.01.2022
[1.18+] Mouse Tweaks 2.22
Supported Minecraft versions
1.18
1.18.1
1.18.2
Loaders / Platforms
forge
Show changes
- Fixed compatibility with Replay Mod.
- Changed how RMBTweak works to support Bundles and Bundle-like mod items.
- RMB-dragging a Bundle with RMBTweak will "right click" items out of a Bundle into the slots as you're dragging over them.
- RMB-dragging with a Bundle over items will now pick the items up into the Bundle.
- Enabled RMBTweak by default again.
- Added a config menu accessible from the Mods menu in Forge and from Mod Menu in Fabric.
- Adjusted inventory-position-aware scrolling type to be a bit more intuitive. In particular, scrolling down from the crafting output slot in the player inventory now moves the item into the player inventory as expected.
- (Fabric) Fixed Wheel Tweak blocking the open container's wheel handling. This improves compatibility with Modern Industrialization. The Fabric version behavior now matches the Forge version behavior better in this regard.
- (Fabric) Fixed compatibility with Architectury.
Sign in
0.07 MB
1.18-2.16-fabric
Release
04.12.2021
[1.18] Mouse Tweaks 2.16
Supported Minecraft versions
1.18
Loaders / Platforms
fabric
Show changes
- Updated to Minecraft 1.18.
- Internal change: replaced reflection with Mixin accessors, everything should keep working fine but if there are any issues with mod support, please report them to GitHub.
Sign in
0.07 MB
1.18-2.16-forge
Release
04.12.2021
[1.18] Mouse Tweaks 2.16
Supported Minecraft versions
1.18
Loaders / Platforms
forge
Show changes
- Updated to Minecraft 1.18.
- Internal change: replaced reflection with Mixin accessors, everything should keep working fine but if there are any issues with mod support, please report them to GitHub.
Sign in
0.07 MB
1.17.1-2.15-fabric
Release
04.11.2021
[1.17.1] Mouse Tweaks 2.15
Supported Minecraft versions
1.17.1
Loaders / Platforms
fabric
Show changes
- Added Fabric support! This is the Fabric version, check another file for the Forge version. Thanks FabiClawZ for helping with the Fabric support.
- Fixed right-clicking into bundles when RMBTweak is enabled.
- Disabled RMBTweak by default to improve compatibility with mods adding bundle-like right clicking, until Mouse Tweaks gets a proper fix for it.
Sign in
0.08 MB
1.17.1-2.15-forge
Release
04.11.2021
[1.17.1] Mouse Tweaks 2.15
Supported Minecraft versions
1.17.1
Loaders / Platforms
forge
Show changes
- Added Fabric support! This is the Forge version, check another file for the Fabric version. Thanks FabiClawZ for helping with the Fabric support.
- Fixed right-clicking into bundles when RMBTweak is enabled.
- Disabled RMBTweak by default to improve compatibility with mods adding bundle-like right clicking, until Mouse Tweaks gets a proper fix for it.
Sign in
0.08 MB
1.17.1-2.14
Release
25.07.2021
[1.17.1] Mouse Tweaks 2.14
Supported Minecraft versions
1.17.1
Loaders / Platforms
forge
Show changes
Updated to Minecraft 1.17.1.
Sign in
0.06 MB
1.16.2-2.14
Release
20.03.2021
[1.16.2+] Mouse Tweaks 2.14
Supported Minecraft versions
1.16.2
1.16.3
1.16.4
1.16.5
Loaders / Platforms
forge
Sign in
0.06 MB