macOS fixes

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

1. Install Fabric Loader.
2. Put macos_fixes in your .minecraft/mods folder.
3. (Optional) Install Mod Menu and Cloth Config for in-game settings.

100% client-side. Works on any multiplayer server without issues.