Find a file
Ignacio Etcheverry ced77b1e9b C#: Switch games to MSBuild Sdks and .NET Standard
Godot.NET.Sdk
-------------

Godot uses its own custom MSBuild Sdk for game
projects. This new Sdk adds its own functionality
on top of 'Microsoft.NET.Sdk'.

The new Sdk is resolved from the NuGet package.

All the default boilerplate was moved from game
projects to the Sdk. The default csproj for
game project can now be as simple as:

```
<Project Sdk="Godot.NET.Sdk/4.0.0-dev2">
  <PropertyGroup>
    <TargetFramework>netstandard2.1</TargetFramework>
  </PropertyGroup>
</Project>
```

Source files are included by automatically so
Godot no longer needs to keep the csproj in sync
when creating new source files.

Define constants
----------------

Godot defines a list of constants for conditional
compilation. When exporting games, this list also
included engine 'features' and platform 'bits'.
There were a few problems with that:

- The 'features' constants were only defined when
  exporting games. Not when building the game for
  running in the editor player.
- If the project was built externally by an IDE,
  the constants wouldn't be defined at all.

The new Sdk assigns default values to these
constants when not built from the Godot editor,
i.e.: when built from an IDE or from the command
line. The default define constants are determined
from the system MSBuild is running on.

However, it's not possible for MSBuild to
determine the set of supported engine features.
It's also not possible to determine if a project
is being built to run on a 32-bit or 64-bit
Godot executable.

As such the 'features' and 'bits' constants had
to be removed.
The benefit of checking those at compile time
was questionable, and they can still be checked
at runtime.

The new list of define constants includes:

- GODOT
- GODOT_<PLATFORM>
  Defaults to the platform MSBuild is running on.
- GODOT_<PC/MOBILE/WEB>
- TOOLS
  When building with the 'Debug' configuration
  (editor and editor player).
- GODOT_REAL_T_IS_DOUBLE
  Not defined by default unless $(GodotRealTIsDouble)
  is overriden to be 'true'.

.NET Standard
-------------

The target framework of game projects was changed
to 'netstandard2.1'.
2020-07-25 19:22:01 +02:00
.github CI: Drop AppVeyor and desktop Travis builds 2020-07-20 10:35:53 +02:00
core Merge pull request #40450 from asmaloney/spelling 2020-07-21 22:14:04 +02:00
doc Merge pull request #40590 from Calinou/doc-inputeventmousemotion-polling-rate 2020-07-22 13:17:03 +02:00
drivers Vulkan: Fix struct init for VkClearAttachment 2020-07-22 16:31:22 +02:00
editor Merge pull request #40450 from asmaloney/spelling 2020-07-21 22:14:04 +02:00
main Disable file logging for the project manager 2020-07-14 12:42:51 +02:00
misc CI: Drop AppVeyor and desktop Travis builds 2020-07-20 10:35:53 +02:00
modules C#: Switch games to MSBuild Sdks and .NET Standard 2020-07-25 19:22:01 +02:00
platform Merge pull request #40450 from asmaloney/spelling 2020-07-21 22:14:04 +02:00
scene Merge pull request #40217 from theoway/visible_line_count_fix 2020-07-22 09:50:26 +02:00
servers Merge pull request #40450 from asmaloney/spelling 2020-07-21 22:14:04 +02:00
thirdparty ENetGodot: Apply clang-format and style guide 2020-07-21 11:48:14 +02:00
.clang-format Style: clang-format: Disable KeepEmptyLinesAtTheStartOfBlocks 2020-05-14 16:54:55 +02:00
.clang-tidy Style: Enforce braces around if blocks and loops 2020-05-14 21:57:34 +02:00
.editorconfig C#: Switch games to MSBuild Sdks and .NET Standard 2020-07-25 19:22:01 +02:00
.gitattributes Mark *.tza files as binary in .gitattributes for old Git versions 2020-05-12 09:49:19 +02:00
.gitignore Add Code::Blocks files to .gitignore. 2020-06-15 18:05:33 +01:00
.mailmap Update AUTHORS and DONORS list 2020-07-03 16:02:34 +02:00
.travis.yml Travis: Back to latest emsdk, use embedded mode properly 2020-07-21 17:19:06 +02:00
AUTHORS.md Update AUTHORS and DONORS list 2020-07-03 16:02:34 +02:00
CHANGELOG.md Fix spelling & grammar in comments, docs, and messages 2020-07-21 15:17:23 -04:00
CODE_OF_CONDUCT.md Add a link to the code of conduct in the repository 2019-12-22 18:05:24 +01:00
CONTRIBUTING.md Document the requirement to update the class reference when contributing 2020-06-10 10:36:59 +02:00
COPYRIGHT.txt oidn: Fix build for VS 2017 2020-06-06 21:27:32 +02:00
DONORS.md Update AUTHORS and DONORS list 2020-07-03 16:02:34 +02:00
gles_builders.py GLSL: Change shader type specifier from [vertex] to #[vertex] 2020-05-18 10:58:14 +02:00
icon.png Optimize images losslessly using oxipng -o6 --strip all --zopfli 2018-06-28 19:17:41 +02:00
icon.svg Use new Godot icon consistently everywhere 2017-05-17 19:53:59 +02:00
LICENSE.txt Update copyright statements to 2020 2020-01-01 11:16:22 +01:00
logo.png Optimize images losslessly using oxipng -o6 --strip all --zopfli 2018-06-28 19:17:41 +02:00
logo.svg Commit only the SVG files changed by file_format.sh 2020-07-13 14:08:55 -04:00
LOGO_LICENSE.md Improve documentation of thirdparty code snippets 2017-05-07 11:42:37 +02:00
methods.py Expand env vars for custom_modules build option 2020-07-10 15:58:16 +03:00
platform_methods.py SCons: Format buildsystem files with psf/black 2020-03-30 09:05:53 +02:00
README.md Add GitHub Actions badge to README.md 2020-07-15 22:53:55 +05:30
SConstruct SCons: Do not enable werror=yes by default 2020-07-14 12:33:17 +02:00
version.py Bump version to 4.0-dev 2020-01-29 13:37:17 +01:00

Godot Engine logo

Godot Engine

Homepage: https://godotengine.org

2D and 3D cross-platform game engine

Godot Engine is a feature-packed, cross-platform game engine to create 2D and 3D games from a unified interface. It provides a comprehensive set of common tools, so that users can focus on making games without having to reinvent the wheel. Games can be exported in one click to a number of platforms, including the major desktop platforms (Linux, Mac OSX, Windows) as well as mobile (Android, iOS) and web-based (HTML5) platforms.

Free, open source and community-driven

Godot is completely free and open source under the very permissive MIT license. No strings attached, no royalties, nothing. The users' games are theirs, down to the last line of engine code. Godot's development is fully independent and community-driven, empowering users to help shape their engine to match their expectations. It is supported by the Software Freedom Conservancy not-for-profit.

Before being open sourced in February 2014, Godot had been developed by Juan Linietsky and Ariel Manzur (both still maintaining the project) for several years as an in-house engine, used to publish several work-for-hire titles.

Screenshot of a 3D scene in Godot Engine

Getting the engine

Binary downloads

Official binaries for the Godot editor and the export templates can be found on the homepage.

Compiling from source

See the official docs for compilation instructions for every supported platform.

Community and contributing

Godot is not only an engine but an ever-growing community of users and engine developers. The main community channels are listed on the homepage.

To get in touch with the developers, the best way is to join the #godotengine IRC channel on Freenode.

To get started contributing to the project, see the contributing guide.

Documentation and demos

The official documentation is hosted on ReadTheDocs. It is maintained by the Godot community in its own GitHub repository.

The class reference is also accessible from within the engine.

The official demos are maintained in their own GitHub repository as well.

There are also a number of other learning resources provided by the community, such as text and video tutorials, demos, etc. Consult the community channels for more info.

Travis Build Status Actions Build Status AppVeyor Build Status Code Triagers Badge Translate on Weblate Total alerts on LGTM TODOs