Compatibility
Minecraft: Java Edition
26.3
Platforms
Supported environments
Client-side
Tags
Creators
Details
Licensed ARR
Published 46 minutes ago
Updated 2 weeks ago
macOS fixes
A client-side Fabric mod that fixes the most annoying macOS bugs and quirks in Minecraft.
Input & Controls
| Feature | What it does |
|---|---|
| Restore Pressed Keys | Keeps WASD, jumping, and other held keys down when closing chests or inventory screens so you don't stop moving. |
| Camera Snap Fix | Stops your camera from violently snapping to the sky when unpausing or closing menus. |
| Shift + Scroll Remap | Fixes hotbar cycling while sneaking. macOS turns Shift+Scroll into sideways scrolling; this maps it back to vertical. |
| Option + Q Stack Drop | Drops the entire item stack from your hand or inventory slot using Option + Q. |
| Language Switch Suppression | Stops Ctrl + Space (sprint-jumping) from popping up the macOS input language switcher over your game. |
| Unstick Modifier Keys | Automatically clears stuck Command and Option keys when switching back into Minecraft after Cmd + Tab. |
| Unstick Mouse Buttons | Prevents endless auto-attacking or mining if macOS drops a click release event during a lag spike. |
Display & Window
| Feature | What it does |
|---|---|
| Notch Safe Area Insets | Pushes the HUD, boss bars, player tab list, and toasts safely below the MacBook camera notch and rounded display corners in fullscreen. |
| 1x Resolution (Disable Retina) | Runs the game at 1x logical resolution instead of 2x Retina. Delivers a huge FPS boost and keeps your MacBook cool and quiet. (Requires game restart to apply). |
| Fullscreen Focus & Auto-Hide | Ensures the macOS Menu Bar and Dock hide properly when entering fullscreen. |
| Cursor Reconfinement | Keeps the mouse cursor locked inside the game window when returning from Mission Control or another monitor. |
Text & System
| Feature | What it does |
|---|---|
| Cmd + Q Quit Protection | Requires pressing Cmd + Q three times in a row (with an on-screen countdown toast) to exit, preventing accidental quits during combat. Also stops Cmd + Q from tossing your held item. |
| Native Mac Text Editing | Enables standard macOS text shortcuts in chat, books, and anvils: Option + Arrows (jump by word), Cmd + Arrows (jump to line start/end), and Option/Cmd deletion. |
| Clipboard Sanitizer | Cleans up copied commands on paste: converts non-breaking spaces to standard spaces, removes invisible zero-width characters, and converts curly quotes to straight quotes. |
Configuration
Every feature can be toggled on or off.
Configure options in-game via Mod Menu (requires Cloth Config), or edit:
config/macos_fixes.json
Requirements & Installation
- Install Fabric Loader.
- Put
macos_fixesin your.minecraft/modsfolder. - (Optional) Install Mod Menu and Cloth Config for in-game settings.
100% client-side. Works on any multiplayer server without issues.


