Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

C#/.NET

C# ist eine von Microsoft entwickelte High-Level-Programmiersprache. Godot unterstützt C# als eine Option zu einer Skriptsprache, neben Godots eigenem GDScript.

Das Standard Godot-Executable enthält von Haus aus keine C#-Unterstützung. Um die C#-Unterstützung für Ihr Projekt zu aktivieren, müssen Sie stattdessen eine .NET-Version des Editors von der Godot-Website herunterladen.

• C#-Grundlagen
• C#-Sprachfeatures
• C#-Styleguide
• C#-Diagnostik

Godot-API für C#

Als Allzweck-Spiel-Engine bietet Godot einige High-Level-Funktionen als Teil seiner API. In den folgenden Artikeln wird erläutert, wie diese Funktionen in C# integriert werden und wie sich die C#-API von GDScript unterscheiden kann.

• C# API-Unterschiede zu GDScript
• C#-Collections
• C#-Variant
• C#-Signale
• Exportierte Propertys in C#
• Globale C#-Klassen

C#-Plattform-Support

Ab Godot 4.2 unterstützen in C# geschriebene Projekte alle Desktop-Plattformen (Windows, Linux und macOS), sowie Android und iOS.

Die Android-Unterstützung ist derzeit experimentell und hat einige Einschränkungen.

• Projekte, die auf Android ausgerichtet sind, müssen auf .NET 7.0 oder höher ausgerichtet sein. Dazu muss die von Godot für bestehende Projekte generierte .csproj-Datei geändert werden. Die folgende Property wird zu neuen, mit 4.2 erstellten Projekten hinzugefügt und kann zu bestehenden Projekten hinzugefügt werden:

  <TargetFramework Condition=" '$(GodotTargetPlatform)' == 'android' ">net7.0</TargetFramework>
  

• Es werden nur einige Android-Architekturen unterstützt: arm64 und x64.

Die iOS-Unterstützung ist derzeit experimentell und hat einige Einschränkungen.

• Projekte, die auf iOS ausgerichtet sind, müssen auf .NET 8.0 oder höher ausgerichtet sein. Dazu muss die von Godot für bestehende Projekte erzeugte .csproj-Datei geändert werden. Die folgende Property wird zu neuen, mit 4.2 erstellten Projekten hinzugefügt und kann zu bestehenden Projekten hinzugefügt werden:

  <TargetFramework Condition=" '$(GodotTargetPlatform)' == 'ios' ">net8.0</TargetFramework>
  

• Die offiziellen Exportvorlagen für den iOS-Simulator unterstützen nur die x64-Architektur.

• Der Export zu iOS kann nur von einem MacOS-Gerät aus erfolgen.

Derzeit können in C# geschriebene Projekte nicht auf die Web-Plattform exportiert werden. Wenn Sie C# auf dieser Plattform verwenden möchten, sollten Sie stattdessen Godot 3 in Betracht ziehen.