Back to mods
macOS fixes project artwork

CurseForge · Minecraft mod

macOS fixes

Patches macOS-specific Minecraft quirks, inputs, windowing, and bugs.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which macOS fixes release matches 26.3?

Updated yesterday
Best match for your filters macOS fixes 1.2.0-build1
Game version 26.3
Loader Fabric

macOS fixes 1.2.0-build1 targets 26.3 with Fabric. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.

Where it goes

Is macOS fixes required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Fabric
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does macOS fixes 1.2.0-build1 need?

macOS fixes 1.2.0-build1 on 26.3. Every mod below is checked against that same setup.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add macOS fixes without breaking your instance.

Built for macOS fixes 1.2.0-build1 on 26.3. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use macOS fixes 1.2.0-build1. It targets 26.3 with Fabric; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside macOS fixes 1.2.0-build1. It opens that exact file at the source.

About this project

What does macOS fixes add?

macOS fixes

Minecraft Fabric Java Cloth Config Mod Menu

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.

Project description from CurseForge.

Pick your setup

macOS fixes by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

1 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

macOS fixes versions and loaders

3 of 3 releases match
Clear filters

Looking for an older file? The official CurseForge project page is in Resources.