MacOS Input Fixes - NeoForge
Finally, Minecraft on Mac feels right.
This is a native NeoForge port of the highly acclaimed MCMacOSInputFixes by hamarb123. It utilizes a custom native library to hook directly into macOS, fixing long-standing input bugs that have plagued Mac players for years.
The Problems
This mod fixes the following issues:
- Ctrl + Left Click = Right Click
- Fixes MC-122296. Minecraft defaults to treating
Ctrl + Clickas a Right Click on macOS. This mod separates them, allowing you to sprint-hit or useCtrlkeybinds properly.
- Fixes MC-122296. Minecraft defaults to treating
- Uncontrollable Scrolling
- Broken Shift-Scrolling
- Fixes MC-121772. Shift-scrolling (often used for moving items quickly) finally works as intended.
- And much more!
How It Works
Unlike simple key mappers, this mod uses a native C++ library that bundles with the mod. It intercepts input events at the operating system level before they even reach Minecraft/GLFW, ensuring robust and lag-free fixes.
Configuration
No complex setup required!
- Install the mod.
- Go to Options → Controls → Mouse Settings.
- Toggle the fixes you want (enabled by default).
Credits
- Markap: NeoForge Port & Modernization
- hamarb123: Original Author & Native Implementation
Note: This mod is client-side only.
DISCLAIMER As required to mention prominently according to Mojang - THIS IS NOT AN OFFICIAL MINECRAFT PRODUCT. NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.
View the license for the disclaimer of the actual mod.
How to Install MacOS Input Fixes (Neoforged) (Mod)
MacOS Input Fixes (Neoforged) by Markap is verified for Fabric, Forge, Neoforge across Minecraft versions 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21.1, 26.1.2 (latest release: 26.10.03-p, file size: 116 KB). Follow the steps below to install it safely from ModCraft.tv:
- Click the Download button above and select your Minecraft version (1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21.1, 26.1.2) and platform (Fabric, Forge, Neoforge).
- Make sure you have the compatible loader or environment installed for Fabric, Forge, Neoforge.
- Move the downloaded MacOS Input Fixes (Neoforged) file into your Minecraft
.minecraft/modsfolder and launch the game.
All Versions
+ Add Version- Fixed: the mod's options now show up in Controls → Mouse Settings in every language. Before, they only appeared with the game set to English.
- Fixed: the mod's options now show up in Controls → Mouse Settings in every language. Before, they only appeared with the game set to English.
- Built for NeoForge 26.1.2.109. Older NeoForge 26.1.2 versions still work.
- Fixed: the mod's options now show up in Controls → Mouse Settings in every language. Before, they only appeared with the game set to English.
- New option, "Ctrl for Text Shortcuts": choose whether copy, paste, cut and select-all in chat use Cmd (the default, like other Mac apps) or Ctrl. It doesn't change which key drops a whole stack.
- New option, "Ctrl for Text Shortcuts": choose whether copy, paste, cut and select-all in chat use Cmd (the default, like other Mac apps) or Ctrl. It doesn't change which key drops a whole stack.
- No more log spam: the mod no longer writes down every key you press or every scroll. Your log files stay small and don't reveal which shortcuts you use.
- Fixed lag spikes that could happen when holding Cmd.
- Fixed a startup warning about the mod's icon.
- New option, "Ctrl for Text Shortcuts": choose whether copy, paste, cut and select-all in chat use Cmd (the default, like other Mac apps) or Ctrl. It doesn't change which key drops a whole stack.
- No more log spam: the mod no longer writes down every key you press or every scroll. Your log files stay small and don't reveal which shortcuts you use.
- Fixed lag spikes that could happen when holding Cmd.
- No more log spam: the mod no longer writes down every key you press or every scroll. Your log files stay small and don't reveal which shortcuts you use.
- Fixed lag spikes that could happen when holding Cmd.
- Reminder: Ctrl+Q drops a whole stack and Cmd+V still pastes in chat, so you don't need an extra mod for that.
- > This is a deprecated BETA Version that was mainly developed for the FORGE Version 1.20.1
- Ctrl / Strg + Q drops a full stack again on Mac, including from the hotbar (not just single items). (Try to disable "USE COMMAND KEY" if it does not work)
- Inventory and shortcuts that rely on Control should behave more like on Windows when you’re not using ⌘ as “control”.
- Optional blocking of ⌘ Q so Minecraft doesn’t quit when you hit Command+Q by mistake — matches the in-game toggle; rebuild included native library so this works reliably.
- Small cleanup under the hood so fewer moving parts clash with NeoForge keybind behaviour.
- Mod version is set automatically from the build date (shown like 26.04.27), so you always see how fresh a build is without manual version bumps.
- GitHub Actions now runs the build when you push to main or master, not only on tags — so checks run on normal updates too.
### New Languages
- 🇫🇷 Added French translations
### Improvements
- Improved GitHub Actions workflows
- Switched to date-based versioning (YYYY.MM.DD-HHMM)
- Build workflow now only triggers on branches, not tags
- Publish workflow includes debug step for artifact verification
### Languages Included
- 🇺🇸 English
- 🇩🇪 German
- 🇪🇸 Spanish
- 🇫🇷 French
### Requirements
- Minecraft 1.21.1
- NeoForge 21.1+