Quick answer: Godot 4 .NET export failing on Apple Silicon with 'mono-sdk not found'? Editor needs the ARM64 .NET runtime, not the x64 Mono one - install via dotnet workload.

Export button greyed out on Mac M2. Editor log: Could not find .NET SDK for target architecture arm64-darwin.

Install ARM64 .NET

dotnet workload install ios maccatalyst

The Godot template needs both. Verify with dotnet workload list; macOS targets need the maccatalyst workload even for pure desktop builds.

Pin .NET SDK version

Add a global.json with {"sdk": {"version": "8.0.x"}}. Multiple installed SDKs confuse Godot's discovery on the first run.

Use the official installer

Homebrew's dotnet formula is community-maintained and lags. Microsoft's installer matches what Godot's docs are tested against.

“Cross-architecture .NET on macOS works - once you have the right SDK installed.”

Document the exact dotnet command in your README. New contributors hit this once; the documentation saves them an afternoon.