Unreal Engine 5.6.1 (also 5.8) will not work on macOS 26.0 + Xcode 26.0

When I try to run UE 5.6.1, or UE 5.8 (Built from Source Code), I get the following metal error:

[Image Removed]

I have tried modifying the Apple_SDK.json and setting the Max versions to 26.0.0 and LLVM versions are fine.

I tried building u5_main source as well and get the same result. It builds fine, but when it goes to run same thing.

I have tried manually installing the Metal SDK from Xcode Directly, and from command line to no avail. I also tried the various hacks and tricks for the beta versions that I found in different forums.

Here is the Metal Toolchain information:

Metal Toolchain 26.0 (17A324) [com.apple.MobileAsset.MetalToolchain: 17.0 (17A324)] 
   (Installed)

Here is the Apple_SDK.json config:

{
    "//1": "Xcode versions:",
        "MainVersion": "15.2",
        "MinVersion": "15.2.0",
        "MaxVersion": "26.0.0",
    "//2": "!!!",
    "//3": "NOTE: If you update the MaxVersion, double check the AppleVersionToLLVMVersion array below!!!",
    "//4": "!!!",

    "//5": "The versions on Windows are iTunes versions:",
        "MinVersion_Win64": "1100.0.0.0",
        "MaxVersion_Win64": "8999.0",

    "//6": "This is not a version range, but a mapping of Xcode clang versions to LLVM versions, for shared version checks with other clangs",
    "//7": "Version mapping can be found at https://en.wikipedia.org/wiki/Xcode#Toolchain_versions",
    "//8": "The first half of the pair is the first version that is using the second version source LLVM",
    "//9": "For instance, Xcode 16 uses LLVM 17.0.6",
        "AppleVersionToLLVMVersions": [
            "14.0.0-14.0.0",
            "14.0.3-15.0.0",
            "15.0.0-16.0.0",
            "16.0.0-17.0.6",
            "16.3.0-19.1.4"
        ]
}

Any ideas?

Hi Yunhan,

Can you confirm the output of:

/usr/bin/xcrun -sdk macosx metal -von your machine?

Best regards.

Hi Yunhan,

Can you try the latest version of Apple_SDK.json and let us know if it resolves?

https://github.com/EpicGames/UnrealEngine/blob/ue5\-main/Engine/Config/Apple/Apple\_SDK.json

Best regards.

Glad that resolved the issue for you Yunhan.

Best regards.

Hi Jacoby, thank you for your reply, here is the output, hope this could help:

Apple metal version 32023.830 (metalfe-32023.830.2)

Target: air64-apple-darwin25.0.0

Thread model: posix

InstalledDir: /private/var/run/com.apple.security.cryptexd/mnt/com.apple.MobileAsset.MetalToolchain-v17.1.324.0.880O3M/Metal.xctoolchain/usr/metal/current/bin

[Image Removed]Best regards.

Thank you so much Jacoby!

I’ve tried the latest version, and problem solved.

Best regards.