tutorials/scripting/c_sharp/c_sharp_basics

[giscus[bot]]

tutorials/scripting/c_sharp/c_sharp_basics

Introduction: This page provides a brief introduction to C#, both what it is and how to use it in Godot. Afterwards, you may want to look at how to use specific features, read about the differences...

https://docs.godotengine.org/en/stable/tutorials/scripting/c_sharp/c_sharp_basics.html

[EricPendergast]

The example .csproj for the "Using NuGet packages in Godot" is somewhat misleading since newtonsoft is currently broken in the editor per godotengine/godot#78513

[ondesic]

Very important. When converting from 3.x to 4.x, Newtonsoft would not work. It couldn't be found. I noticed that the old .mono folder was in the main project folder. I closed all editors and code IDEs, renamed .mono to .monoOLD and restarted it. had to reimport Newtonsoft in the Rider|NuGut manager and then it finally recognized it!

[dreamReason]

In order to see the DotNet tree to configure the editor in 4.4.1, you must turn on 'advanced settings'

[shyamjayakannan]

I found using using System.Text.Json; to be a good replacement for NewtonSoft

[ondesic]

I stopped using System.Text.Json because though it works on Windows, it crashes on Android. Has this been fixed?

…

On Wed, Jul 16, 2025, 2:38 AM Shyam Jayakannan ***@***.***> wrote: I found using using System.Text.Json; to be a good replacement for NewtonSoft — Reply to this email directly, view it on GitHub <#38 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AGNLJESZCXXMFNVPRAVFBRT3IYFSFAVCNFSM6AAAAABMSANWAKVHI2DSMVQWIX3LMV43URDJONRXK43TNFXW4Q3PNVWWK3TUHMYTGNZXGQ2DMNQ> . You are receiving this because you commented.Message ID: <godotengine/godot-docs-user-notes/repo-discussions/38/comments/13774466@ github.com>

[shyamjayakannan]

how are you exporting to android in the first place? as far as i remember it's still experimental for c# projects as of godot 4.4.

[ondesic]

I have had no problem exporting for Android

…

On Wed, Jul 16, 2025, 12:30 PM Shyam Jayakannan ***@***.***> wrote: how are you exporting to android in the first place? as far as i remember it's still not supported for c# projects as of godot 4.4. — Reply to this email directly, view it on GitHub <#38 (reply in thread)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AGNLJEQL33STZREPW52RJL33I2K5ZAVCNFSM6AAAAABMSANWAKVHI2DSMVQWIX3LMV43URDJONRXK43TNFXW4Q3PNVWWK3TUHMYTGNZYGEYDINY> . You are receiving this because you commented.Message ID: <godotengine/godot-docs-user-notes/repo-discussions/38/comments/13781047@ github.com>

[ondesic]

I have the .net version.

…

On Wed, Jul 16, 2025, 1:32 PM j ***@***.***> wrote: I have had no problem exporting for Android On Wed, Jul 16, 2025, 12:30 PM Shyam Jayakannan ***@***.***> wrote: > how are you exporting to android in the first place? as far as i remember > it's still not supported for c# projects as of godot 4.4. > > — > Reply to this email directly, view it on GitHub > <#38 (reply in thread)>, > or unsubscribe > <https://github.com/notifications/unsubscribe-auth/AGNLJEQL33STZREPW52RJL33I2K5ZAVCNFSM6AAAAABMSANWAKVHI2DSMVQWIX3LMV43URDJONRXK43TNFXW4Q3PNVWWK3TUHMYTGNZYGEYDINY> > . > You are receiving this because you commented.Message ID: > <godotengine/godot-docs-user-notes/repo-discussions/38/comments/13781047@ > github.com> >

[sappqa]

One thing worth noting if you're having issues finding the 'Dotnet' option in the editor settings, make sure 'Advanced Options' is enabled, then the 'Dotnet' option should appear at the bottom of the left scroll menu.

[fiery-prometheus]

I found it unclear whether the newest version of godot (4.5), requires .net or mono, the download page itself says mono, but the mono runtime is not the same as .net 9 which should be the consolidated cross platform version. This page itself talks about godot being based on .net 8. So does godot require mono, or use mono, or use .net 8?

[Calinou]

You need .NET 9 with Godot 4.5 to be specific. The Mono runtime isn't used in Godot 4 anymore (it was used in Godot 3).

Godot's C# integration is still called mono for legacy reasons, but it's fully based on .NET as of now.

Pull request opened:

• Update C# basics for .NET 9 godot-docs#11348

[raulsntos]

As @Calinou said, Godot's C# integration is fully based on modern .NET hosting since 4.0, we no longer use the Mono embedding APIs. However, to be clear, modern .NET includes the Mono runtime which was merged into .NET in 5.0.

Godot itself uses the Mono runtime for Android exports, since there is no CoreCLR support for Android yet. For iOS we use NativeAOT. And for all other supported platforms (Windows, Linux, and macOS) we use CoreCLR by default but other runtimes (Mono and NativeAOT) are also supported. But you don't have to worry about which runtimes are supported, just install the latest .NET SDK and you're good to go.

As for which specific version of .NET is required, the minimum should be .NET 8 since that's what Godot's packages target. However, on Android we require .NET 9 to support the latest Google Play requirements. But your project can always target a newer version if you want.

Regardless of which version your project targets, it's still always recommended to use the latest .NET SDK to build your projects. So, as of now, that would be .NET 9, but feel free to update to .NET 10 this November.