Guidefor players2 min read
Mouse Tweaks for Minecraft: what it does and how to install it
Mouse Tweaks adds faster inventory actions to Minecraft. See which versions and loaders it declares, where the client mod belongs and what to check after an update.
What Mouse Tweaks changes
Mouse Tweaks is a small inventory quality-of-life mod. It changes how common mouse actions behave in container screens, so moving stacks, distributing items and collecting matching items takes less repetitive clicking. It does not add a new world, block or server game mode; its value is in making the existing inventory interface faster to use.
The Mouse Tweaks project page is the authoritative place on this site for its current release history, supported Minecraft versions, loader information and source download links. The compatibility table is more useful than a generic “works with Minecraft” sentence because the exact release line matters.
Client or server?
Inventory input is a client concern. A player normally installs Mouse Tweaks in the client instance that displays the inventory screen. Do not assume every client mod belongs on a dedicated server: placing a client-only jar in the server's mods folder can cause a missing-class crash during startup.
The precise side can vary by release and loader metadata, so check the side label on the project page rather than copying an old installation note. When a server pack requires a matching mod on both sides, the release page should say so; when the change is local input handling, the server generally does not need it.
Installation checklist
- Identify the exact Minecraft version in your launcher profile.
- Choose the loader that the Mouse Tweaks release targets: Fabric, Forge or NeoForge. A jar for one loader is not a universal jar.
- Install the loader and start the instance once so it creates the
modsfolder. - Download the release from the author's own page linked on the MCReference entry.
- Put the jar in that instance's
modsfolder, not in the global.minecraftfolder if your launcher uses separate instances. - Start the game and test a chest or crafting screen before adding more mods.
Never rename a jar to change the loader or Minecraft version. The filename is not the compatibility declaration, and changing it cannot make an incompatible build load.
What to do after a Minecraft update
When Minecraft moves to a new release, a mod can remain unchanged while the game changes underneath it. If Mouse Tweaks disappears, the game refuses to launch or the inventory actions stop working, check three things in order:
- the installed jar lists your exact Minecraft version;
- the jar targets the loader in your profile;
- any dependency named in the crash report is installed at a compatible version.
The mod compatibility guide explains why “supports 1.21” is not the same as “supports every 1.21.x release”. The same principle applies to calendar versions such as 26.2.
Keep it separate from server troubleshooting
If players can join but one player cannot use the inventory shortcuts, investigate the client profile first. If nobody can join, the problem is probably server software, protocol, Java or a server-side mod rather than Mouse Tweaks itself. Separating those two paths prevents a harmless client convenience mod from becoming the first suspect for an unrelated connection error.
For the current version of the project, use the live Mouse Tweaks page instead of relying on a copied download link. MCReference does not host or repackage the file; it records the release metadata and links back to the publisher.
