Why doesn't NuGet package resolve in my Godot C# project?

Add PackageReference in .csproj. Run dotnet restore. Restart editor. If still failing, clear nuget cache: dotnet nuget locals all --clear.

Godot.NET.Sdk auto-detects PackageReferences in <ItemGroup>. .nupkg cached in ~/.nuget/packages/. SDK version mismatches break resolution.

Don't commit .nuget/. Commit packages.lock.json (if generated) for reproducible restore. Cache is reproducible from PackageReferences alone.

Fix: Godot NuGet Package Not Resolving

Quick answer: .csproj <PackageReference>. Run dotnet restore. Restart editor.

Add Newtonsoft.Json. Compile error: type not found. Restore wasn’t triggered.

The Fix

<Project Sdk="Godot.NET.Sdk/4.3.0">
  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Newtonsoft.Json" Version="13.0.3" />
  </ItemGroup>
</Project>

# Restore
$ dotnet restore
$ dotnet build

# Restart Godot

PackageReference + restore = NuGet pulls package into local cache. Editor reloads recognize the assembly.

Verifying

Using Newtonsoft.Json compiles. IntelliSense available. Without restore: assembly not found.

“PackageRef. Restore. Build.”

Related Issues

For C# net8 mismatch, see net8. For source generator, see generator.

Reference. Restore. Resolved.