Why does Godot C# build fail with net8 runtime mismatch?

Godot's bundled .NET (net8 in 4.3+) and your project's TargetFramework must match. Edit .csproj <TargetFramework>net8.0</TargetFramework>. Install matching .NET SDK on the build machine.

How to switch versions?

global.json with sdk.version locks. Or set in .csproj. Both should agree with what Godot ships.

Install dotnet-sdk-8.0 on the agent. Use github actions/setup-dotnet@v4 with dotnet-version: 8.0.x.

Fix: Godot C# net8 Runtime Mismatch

Quick answer: .csproj <TargetFramework>net8.0</TargetFramework>. Install matching SDK. global.json pins.

Build error: “Project targets net6.0 which is not supported by the runtime.” Editor uses net8.

The Fix

<!-- MyProject.csproj -->
<Project Sdk="Godot.NET.Sdk/4.3.0">
  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
    <EnableDynamicLoading>true</EnableDynamicLoading>
  </PropertyGroup>
</Project>

# global.json
{
  "sdk": { "version": "8.0.300" }
}

Match TargetFramework to what the Godot editor ships. global.json prevents accidental version drift on different machines.

Verifying

dotnet --version reports 8.x. Build succeeds. Runtime loads cleanly in editor.

“Match net8. Pin via global.json.”

Related Issues

For C# GD.Print, see GD.Print. For C# property tracker, see property tracker.

Match runtime. Build clean.