mcopt README

The project's README from github.com/noahdunnagan/mcopt. As one markdown file: README.md.

mcopt

[!NOTE] mcopt no longer requires Sodium ๐ŸŽ‰

A Minecraft performance mod for Apple Silicon Macs. Since 0.3.0-alpha.1 it draws the world with its own Metal renderer. Very much alpha: expect bugs, and back up your worlds.

Requirements

Install

  1. Install Fabric for Minecraft 26.3: https://fabricmc.net/use/installer/ (or in Prism Launcher: new instance, 26.3, loader Fabric).
  2. Download the mcopt jar from Releases.
  3. Put it in ~/Library/Application Support/minecraft/mods. Create the mods folder if it's missing (Finder: Go > Go to Folder). In Prism: Edit the instance > Mods > Add file.
  4. Start Minecraft with the Fabric profile.

Sodium isn't needed anymore: mcopt won't start alongside it, so take Sodium out of that folder if it's there. Fabric API isn't required; keep it if your other mods need it.

To check it's working: press F3 (fn + F3 on a Mac keyboard); the bottom right says Metal 3 (mcopt).

Shows an fps counter in the top-left corner (hidden with F1 or F3; fn + F1 or fn + F3 on a Mac keyboard).

Settings

Numbers

fps spinning / flying, same test world, 1920x1080, render distance 16, VSync off, at least two runs each:

Mac vanilla Sodium 0.9.3 0.2.0-alpha.3 0.3.0-alpha.1
Mac mini M4 (10-core GPU, 16 GB) 156 / 146 275-281 / 253-267 1202-1223 / 1068-1074 1209-1211 / 1068-1069
MacBook Neo (A18 Pro, 5-core GPU, 8 GB) 79-81 / 69-72 133-146 / 85-91 514-579 / 422-449 591-638 / 477-504
Mac mini M6 (12-core GPU, 16 GB) 297-328 / 283-291 454-460 / 406-413 1988-1991 / 1738-1742 2020-2022 / 1690-1704

The mini and Neo cells ran on 6c133ecc, whose only difference from 9865a0a3 is vGroup, which is gated off on those GPUs. The Neo's vanilla and Sodium cells come from the da566d00 run. This build differs from 9865a0a3 only in code that runs when Distant Horizons is installed.

For the most fps: Options > Video Settings, VSync off and Max Framerate Unlimited. The numbers above are with VSync off.

Known issues

Plans

Licence and credits

Apache License 2.0. Keep the NOTICE file with any copy, and credit mcopt.

mcopt (noahdunnagan/mcopt)

fabric
Searching Databaseโ€ฆ

520 ยทGitHub
What is this?mcopt is a Minecraft mod that adds a native Metal renderer for Minecraft: Java Edition, aimed specifically at making the game run faster on Apple Silicon Macs.
Is this a standalone app or a mod I load into Minecraft?It is a Fabric mod jar file that you drop into your Minecraft mods folder alongside a specific build of Sodium; it is not a separate application.
What do I need before installing this?You need an Apple Silicon Mac on macOS 26+, Java 25, Minecraft 26.3, Fabric Loader 0.19.5, and exactly Sodium 0.9.3 (sodium-fabric-0.9.3-alpha.1+mc26.3.jar) โ€” other Sodium versions won't launch.
What should I watch out for before trying this?It's explicitly alpha software, so the README warns to back up your worlds; only the exact pinned Sodium build works, mods that call OpenGL directly can't render on the Metal backend, and Distant Horizons forces mcopt back to plain OpenGL, losing the renderer speedup.
Does this work on Intel Macs too?No, it's built only for Apple Silicon Macs on macOS 26 or later; there's no Intel support mentioned anywhere in the README.
How much of an fps boost does mcopt give?On a Mac mini M4 it went from roughly 1094-1103 fps to 1072-1119 fps while spinning, and on a 5-core GPU MacBook from 379-449 fps to 460-471 fps, so gains are modest on high-end GPUs and bigger on lower-end ones.
What is the 'far terrain' setting?It's an experimental opt-in long-distance terrain feature enabled by setting mcopt.lod=true in config/mcopt.properties, recommended only for Macs with 10 or more GPU cores since it costs significant fps on weaker GPUs.
Does mcopt work with other optimization mods like Lithium?Yes, but mcopt deliberately disables some of its own chunk patches when Lithium, C2ME, or ScalableLux are installed to avoid conflicts.
What's planned for future versions?The roadmap includes enabling far terrain by default with tiers for smaller Macs, optional custom BSL-level shaders, faster native world generation, more server-tick/chunk optimizations, and faster startup.
Size
1.1 MB
Stars
520
Updated
CommitOct 08
Age
1mo
Commits ยท 90 Days