C#/.NET
=======

C# is a high-level programming language developed by Microsoft. Godot supports
C# as an option for a scripting language, alongside Godot's own :ref:`GDScript<toc-learn-scripting-gdscript>`.

The standard Godot executable does not contain C# support out of the box. Instead,
to enable C# support for your project you need to `download a .NET version <https://godotengine.org/download/>`_
of the editor from the Godot website.


.. toctree::
   :maxdepth: 1
   :name: toc-learn-scripting-C#

   c_sharp_basics
   c_sharp_features
   c_sharp_style_guide
   diagnostics/index

Godot API for C#
----------------

As a general purpose game engine Godot offers some high-level features as a part
of its API. Articles below explain how these features intergrate into C# and how
C# API may be different from GDScript.

.. toctree::
   :maxdepth: 1
   :name: toc-learn-scripting-C#-differences

   c_sharp_differences
   c_sharp_collections
   c_sharp_variant
   c_sharp_signals
   c_sharp_exports
   c_sharp_global_classes

.. _doc_c_sharp_platforms:

C# platform support
-------------------

As of Godot 4.2 projects written in C# support all desktop platforms (Windows, Linux,
and macOS), as well as Android. Android support is currently experimental and has a few
limitations.

- Projects targeting Android need to be created using .NET 7.0 or higher. This requires
  modifying the `.csproj` file generated by Godot.

- Only some Android architectures are supported: ``arm64`` and ``x64``.

Currently, projects written in C# cannot be exported to iOS and web platforms. To use C#
on those platforms, consider Godot 3 instead.