BLOCKINTOSH DOCUMENTATION

From first launch
to your next world.

The practical guide to setting up and using the beta.

Check your Mac

Blockintosh requires an Apple Silicon Mac and your own Minecraft for Windows license. Choose a runtime and renderer that support your macOS version.

ComponentRequirement
Native launchermacOS 15.0 or later
FEX gameplaymacOS 15.0 or later; VKD3D-Proton or experimental Mullion
Rosetta with bundled GPTK 4macOS 27.0 or later; Rosetta installed
Rosetta with bundled GPTK 3macOS 15.4 or later; Rosetta installed
Experimental MullionmacOS 15.0 or later; Rosetta installed when using the Rosetta runtime
Game ownershipMicrosoft account with a valid Minecraft for Windows license

Blockintosh Wine 3.0 bundles both Rosetta and FEX runtimes. GPTK 3 is included; a separate download is no longer required. The Metal 3 fallback setting does not lower GPTK 4’s macOS requirement. Features and performance vary by Mac, Minecraft build and renderer.

Install Blockintosh

  1. Check the requirements above and the published release notes.
  2. Use Get Blockintosh to find the latest published download.
  3. Extract the app and move it to Applications before opening it.
  4. Follow the setup prompts. The packaged build includes its backend and runtimes; no developer checkout is needed.

The app is still in beta and is not notarized. If macOS blocks it, verify the download’s origin and follow the installation notes for that release.

Sign in and choose a build

  1. Use your Microsoft Store account to verify ownership and acquire Minecraft through your own license.
  2. Choose Release or Preview, then select and download the build you want.
  3. Sign in to Xbox separately for online features.
  4. Choose your profile and launch Minecraft.

Minecraft is not included with Blockintosh. Keep sign-in codes and account information private.

Choose how Minecraft runs

Open Settings → Runtime to choose Rosetta or FEX. Rosetta offers GPTK 4, GPTK 3 and experimental Mullion. FEX uses VKD3D-Proton by default, with Mullion as an experimental alternative. Use the requirements above to choose a supported renderer.

Each profile keeps its runtime and graphics preferences. Graphics changes apply on the next launch. RTX ray tracing and DLSS via MetalFX are experimental and depend on your renderer, Minecraft build and compatible content; enabling a toggle does not establish compatibility.

Worlds, profiles, and backups

FEX and Rosetta share worlds and add-ons within a launcher profile. Separate profiles, Minecraft accounts, Release and Preview keep their own data.

The first launch brings older runtime content into the shared library and retains recovery backups. If two versions of a world differ, both stay as separate saves. Conflicting pack versions remain in backups. The launch log records their location.

Close Minecraft before archiving, restoring or removing content. Profile archives use .bomprofile files; restored profiles start offline. Reconnect the intended account and keep a separate backup of important worlds before testing new builds, runtimes or mods.

Import and manage add-ons

Use the import flow or macOS Open With for .mcworld, .mcpack, .mcaddon, .mctemplate and .mcskin files.

To remove a pack, close Minecraft and open Add-ons → Installed → select the pack → Remove Pack. Multi-pack add-ons are removed one component at a time. Removing a template keeps worlds already created from it.

Optional client mods and shaders

Open Add-ons → Enhancements for the LeviLamina client loader, BetterRTX presets and native RTX pack tuning. Close Minecraft before changing them. Client loader and shader overlays are specific to the selected profile, runtime and Minecraft build.

The current client loader supports Minecraft 1.26.60 Release. Other builds need a matching loader. BetterRTX requires a compatible preset, renderer and active RTX resource pack. The launcher explains unsupported combinations; compatibility with every mod or preset is not guaranteed.

With Arke installed, recommended graphics settings are applied once and explained before launch when they change. Your later customizations are preserved. Read the Enhancements overview before experimenting.

Use a controller

Connect your controller before pressing Play. DualSense gameplay over Bluetooth has been checked on Rosetta and FEX. DualShock 4 and DualSense mappings are configured automatically; Minecraft may show Xbox button labels.

In the launcher, use the D-pad or left stick to move focus, A / Cross to select, B / Circle to go back, LB / RB to switch pages and the right stick to scroll. See the controller guide for pairing, quit shortcuts and hardware limits.

Launcher updates

The launcher uses Sparkle to check the published update feed. The website’s changelog reads that same feed.

Updates from recent releases can download only the changed parts. Sparkle checks the update before installing and falls back to the full download when needed. New installations always download the full app. Let installation finish and the launcher relaunch before continuing.

Troubleshooting

The game will not start

Check your macOS version against the selected renderer, the selected Minecraft build and the active profile. Rosetta gameplay requires Rosetta installed. Open Launcher activity → Open Launch Logs for the actual failure before changing your setup.

Online features are unavailable

Check Microsoft Store ownership and Xbox sign-in separately. Refresh expired Xbox sign-in and confirm the intended account. Realms and Marketplace still need wider testing.

A mod or shader setup stops working

Check that the loader, mod, preset and Minecraft build match. Graphics changes can affect Arke shaders. Restore your previous settings or remove the enhancement through the launcher before testing again.

The game freezes or a beta behaves unexpectedly

Record the launcher version, Minecraft build, runtime, renderer, macOS version and the steps that caused the problem. Keep a backup of your worlds and include the matching launch log when reporting the issue.

The website has no downloads or release notes

The public feed may be temporarily unreachable. Try again later. An empty changelog does not affect local worlds or profiles.

BLOCKINTOSH BETA

Let’s get you ready.

Checking for a published download…

Read installation & compatibility notes