Godot Engine – Multi-platform 2D and 3D game engine
Go to file
Rémi Verschelde 23ebae01dc Refactor version macros and fix related bugs
The previous logic with VERSION_MKSTRING was a bit unwieldy, so there were
several places hardcoding their own variant of the version string, potentially
with bugs (e.g. forgetting the patch number when defined).

The new logic defines:

- VERSION_BRANCH, the main 'major.minor' version (e.g. 3.1)
- VERSION_NUMBER, which can be 'major.minor' or 'major.minor.patch',
  depending on whether the latter is defined (e.g. 3.1.4)
- VERSION_FULL_CONFIG, which contains the version status (e.g. stable)
  and the module-specific suffix (e.g. mono)
- VERSION_FULL_BUILD, same as above but with build/reference name
  (e.g. official, custom_build, mageia, etc.)
  Note: Slight change here, as the previous format had the build name
  *before* the module-specific suffix; now it's after
- VERSION_FULL_NAME, same as before, so VERSION_FULL_BUILD prefixed
  with "Godot v" for readability

Bugs fixed thanks to that:

- Export templates version matching now properly takes VERSION_PATCH
  into account by relying on VERSION_FULL_CONFIG.
- ClassDB hash no longer takes the build name into account, but limits
  itself to VERSION_FULL_CONFIG (build name is cosmetic, not relevant
  for the API hash).
- Docs XML no longer hardcode the VERSION_STATUS, this was annoying.
- Small cleanup in Windows .rc file thanks to new macros.
2018-02-23 20:15:29 +01:00
core Refactor version macros and fix related bugs 2018-02-23 20:15:29 +01:00
doc Added documentation for VehicleBody 2018-02-22 17:39:25 +11:00
drivers 2D Skeletons WORK IN PROGRESS 2018-02-21 17:24:00 -03:00
editor Refactor version macros and fix related bugs 2018-02-23 20:15:29 +01:00
main Refactor version macros and fix related bugs 2018-02-23 20:15:29 +01:00
misc Dist: Update manpage and macOS version string 2018-01-25 23:21:31 +01:00
modules Update warning about C# support 2018-02-21 22:47:44 +01:00
platform Refactor version macros and fix related bugs 2018-02-23 20:15:29 +01:00
scene Refactor version macros and fix related bugs 2018-02-23 20:15:29 +01:00
servers 2D Skeletons WORK IN PROGRESS 2018-02-21 17:24:00 -03:00
thirdparty Add base support for 2D meshes in Godot, including Sprite -> Mesh2D conversion. 2018-02-21 09:39:09 -03:00
.appveyor.yml Add GDnative wrapper lib on CI build 2018-01-04 20:32:12 +01:00
.clang-format Style: Apply clang-format to Java files 2017-12-10 01:16:07 +01:00
.editorconfig Enforce insert_final_newline in the editorconfig. 2018-02-16 19:44:47 +01:00
.gitattributes Add .xml to .gitattributes 2017-10-13 21:29:26 +11:00
.gitignore Added Geany/geany_plugins files to the ".gitignore". 2018-01-07 14:14:32 -02:00
.mailmap Disable colored output and progress bar when building outside of a TTY 2018-01-13 17:56:41 +01:00
.travis.yml Deleting OpenSSL module and library 2018-02-14 01:26:34 +01:00
AUTHORS.md Update AUTHORS list 2018-01-24 22:05:04 +01:00
CHANGELOG.md Add a project changelog 2018-02-22 18:25:40 +01:00
CONTRIBUTING.md fix some typos 2017-11-28 16:18:22 +01:00
COPYRIGHT.txt Remove OpenSSL license, add Mbed TLS 2018-02-14 08:13:08 +01:00
DONORS.md Update DONORS list 2018-02-02 10:04:45 +01:00
ISSUE_TEMPLATE.md Issue template: Remove checkbox and reword some comments 2018-01-05 10:58:04 +01:00
LICENSE.txt Update copyright statements to 2018 2018-01-01 14:40:47 +01:00
LOGO_LICENSE.md Improve documentation of thirdparty code snippets 2017-05-07 11:42:37 +02:00
README.md Add screenshot to the README 2017-10-31 10:15:36 +01:00
SConstruct Abort compilation on missing return values (CGG/clang) 2018-02-22 11:23:05 +02:00
compat.py Fix build with Python 3 on Windows 2017-10-29 19:27:12 +01:00
icon.png Use new Godot icon consistently everywhere 2017-05-17 19:53:59 +02:00
icon.svg Use new Godot icon consistently everywhere 2017-05-17 19:53:59 +02:00
logo.png Use new Godot icon consistently everywhere 2017-05-17 19:53:59 +02:00
logo.svg Use new Godot icon consistently everywhere 2017-05-17 19:53:59 +02:00
methods.py Fix typos with codespell 2018-02-21 19:46:06 +01:00
version.py Bump version to 3.1-dev 2018-01-30 00:19:24 +01:00

README.md

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

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.

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 AppVeyor Build Status Code Triagers Badge