Skip to content

Vivraan/godot-lang-support

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ—Ί Godot Languages Support

A community-maintained list of Language Support Projects for Godot Engine.

⚠ Disclaimer

We are in the midst of transitioning from Godot 3 to Godot 4. For this purpose, will Godot 4 become its own section or website, to show all the differences and advantages of the language bindings.

If you want to help, or if you are a language maintainer, see here: #46

The engine and modules are developed in C++. For those topics, please start with the official docs for contributing to the engine and understanding engine development.

In contrast, the languages provided here are for making scripts in Godot projects. Godot has many methods for granting language support:

  • Modules: Maintainers/Developers define custom implementations of Godot's Script, ScriptInstance, and ScriptLanguage types in a module. Users add the module to the engine source code and compile the engine themselves (or a developer may provide precompiled binaries). Now you have a new built-in language.
  • PluginScript: Maintainers/Developers write an EditorPlugin addon which teaches the Editor how to understand the target language as a ScriptLanguage. Users should only need to download the addon. Powered by Godot's GDNative C interface module.
  • NativeScript: Maintainers write tools to generate and build "bindings" in the target language. Developers use the tools to create bindings, write scripts, and compile them into a native library for an addon. Users download the addon and use the native scripts in their projects. To write custom functionality, most people are both Developers and Users. Powered by Godot's GDNative C interface module.
    • Note: The Developer role's complexity is dependent on the quality of the Maintainer's tools. As such, it is language-dependent. Usually, they are difficult. Your mileage may vary!

Categories

By editor support

  • 🧬 Can be edited inside Godot Engine (includes language bindings which use PluginScript and the Script API).
  • πŸ”Œ Can be edited in an External Editor (includes languages bindings which use NativeScript).

By maintainer

  • πŸ’ Official
  • πŸ‘₯ Community-maintained

By method

  • βš™οΈ Module
  • πŸ“œ PluginScript
  • πŸ”§ NativeScript
  • πŸ„ "Surfs" on an existing language's functionality to work with Godot.

πŸ† Full support

  1. GDScript πŸ’ 🧬 πŸ”Œ βš™οΈ

    GDScript is actively maintained and documented and is stable. It is the primary language, has the most tutorials online, and has deep in-Godot editor support.

  2. VisualScript πŸ’ 🧬 βš™οΈ

    VisualScript can be considered as a secondary scripting language with blocks-and-nodes. It too provides rich support, although there is a community effort to make it more intuitive to use as a design tool instead of what users describe as a one-to-one mapping of code with terse programming jargon where it should be more humanized.

πŸ₯‡ Production Ready

These languages are documented and stable. Some people use these in production.

  1. C# πŸ’ πŸ”Œ βš™οΈ

    C# support is an official module. If you have a Mono-version of Godot Engine, it comes built into the engine. Most people are using the VSCode extension.

  2. JavaScript πŸ‘₯ πŸ”Œ βš™οΈ

    JavaScript support is a 3rd-party module. Modules add built-in support (like GDScript) but require compiling it into the engine. With JavaScript, you also get support for languages that transpile to JavaScript, like CoffeeScript and F# Fable.

  3. Lua πŸ‘₯ 🧬 πŸ”Œ πŸ“œ

    This version of Lua uses PluginScript, so you dont need to recompile the engine.

  4. Nim πŸ‘₯ πŸ”Œ πŸ”§

    Nim has standard NativeScript features for the moment, but wishes to go beyond that by improving its user experience to automate repetitive boilerplate tasks.

  5. Rust πŸ‘₯ πŸ”Œ πŸ”§

    You can find the project homepage here.

  6. TypeScript πŸ‘₯ πŸ”Œ βš™οΈ

    The same project that supports JavaScript, also supports TypeScript. In contrast to other 'compile to JavaScript' languages like Fable, does that mean that you get in-Editor support in Godot. It is also implemented as a 3rd-party module. Modules ask you to compile them into the engine.

πŸ₯ˆ Nearly There

Stable and not documented yet.

  1. Clojure πŸ‘₯ πŸ”Œ πŸ„

    Based on Mono. No API documentation. Usable and community supported.

  2. D πŸ‘₯ πŸ”Œ πŸ”§

    Maintained by Sheep. Available in the official Discord channel. It is feature complete, performant and pretty much without any documentation.

  3. Haskell πŸ‘₯ πŸ”Œ πŸ”§

    Maintained by the SimulaVR folks. Feature complete and rudimentary documented.

  4. Haxe/C# πŸ‘₯ πŸ”Œ πŸ„

    Provides Haxe/C# bindings to the mono module, exposing almost all of the C# API. It has a small editor plugin to help attach a Haxe script to nodes.

  5. Lua πŸ‘₯ 🧬 πŸ”Œ βš™οΈ

    This version of Lua is currently undergoing a rewrite of its parser.

πŸ₯‰ Has Potential

In active development, comparable to being in beta stage.

  1. F# πŸ‘₯ πŸ”Œ πŸ„

    With C#, you also get support for integrating other Mono-supported languages, e.g. F# or VisualBasic. But, Godot currently hardcodes C# usage. Any class attached to a Node or Resource must be a C# script. For tools to automate the use of F# with Godot's C# scripts, see Godot F# Tools.

  2. Go (godot-go) πŸ‘₯ πŸ”Œ πŸ”§

    Go bindings from godot-go are a recent project in alpha. There is decent documentation of the build workflow and example scripts. It is actively being developed.

  3. Kotlin JVM πŸ‘₯ πŸ”Œ βš™οΈ

    Currently in Alpha. More or less feature complete with a few missing targets and some limitations, but with documentation and good performance characteristics. Their Discord is nice and friendly.

  4. Python πŸ‘₯ 🧬 πŸ”Œ πŸ“œ

    Python is the language for which PluginScript, the API that provides Godot-editor support, got designed for. It provides editor integration as GDScript does - it's still in beta. Currently, the bottleneck to its stability is its flawed export system. PyCharm is another way of doing Python for Godot, and this one supports visual debugging

  5. Swift πŸ‘₯ πŸ”Œ πŸ”§

    Provides bindings and a Swift Package Manager-powered build system for creating Godot native libraries from Swift frameworks. GDScript APIs are written in terms of Swift protocols and generics, allowing for seamless Swift-to-Godot interoperability. Automates nearly all of the process of registering types and members with the Godot runtime, and ships with an expressive, SIMD-accelerated math library. Has comprehensive API documentation and tutorials.

  6. WASM πŸ‘₯ πŸ„

    Bindings for wasm. Implemented via the Rust bindings.

  7. Zig πŸ‘₯ πŸ”Œ πŸ”§

    Almost feature complete, with room for some improvements, quite usable as is, except for some issues that root from the Zig compiler and C ABI code gen compatibility.

πŸ… Okay, I guess?

Potential skub.

  1. C++ GDNative support πŸ’ πŸ”Œ πŸ”§

    C++ is a bit of a hot potato anywhere, and it is here as well: some people like to use it, but it could use better documentation in places. Some peeves such as not being able to use modern C++ features starting from C++11 dwell in this API.

🐣 Up and coming

Comparable to being in alpha stage.

  1. Ada πŸ‘₯ πŸ”Œ πŸ”§

    This isn't documented or (probably) stable, but it is still very new.

  2. Dart πŸ‘₯ πŸ”Œ πŸ„

    Uses Godot's C# API to make calls to Dart script code. Has code for generating scripts.

  3. Smalltalk πŸ‘₯ πŸ”Œ πŸ„

    Used in production, still certain core features missing. Uses a custom C# VM to interpret arbitrary bytecode from a Pharo Smalltalk library. Cuis Smalltalk support planned. Discord server available.

⚰️ Left 4 Dead

  1. AngelScript πŸ‘₯ πŸ”Œ πŸ”§

    AngelScript was @Geequlim's first forray into GDNative, before making the ECMAScript bindings.

  2. Crystal πŸ‘₯ πŸ”Œ βš™οΈ

    Mentions nothing about its usability, unmaintained since over 2 years.

  3. Go (ShadowApex) πŸ‘₯ πŸ”Œ πŸ”§

    Go bindings from ShadowApex haven't been updated since 2018. Not documented or stable enough for production.

  4. Haxe πŸ‘₯ πŸ”Œ πŸ”§

  5. Kotlin Native πŸ‘₯ πŸ”Œ πŸ”§

    Kotlin Native bindings are declared unready for production use and deprecated due to performance problems. Although, it was feature complete at the time of the drop. Here is the old documentation of it.

  6. Object Pascal πŸ‘₯ πŸ”Œ πŸ”§

  7. Ruby πŸ‘₯ πŸ”Œ πŸ”§

    Ruby bindings haven't been updated since 2018. It's an attempted PluginScript system, but it's designed poorly with ~15x performance loss vs. GDScript. Not documented or stable enough for use.

🌐 Other Useful links

  • See the language/scripting section on Wikipedia.
  • Gamesfromscratch made a video about some of the supported languages.
  • (You can expand this list!)

Enjoy ^-^

About

A community-maintained list of Language Support Projects for Godot Engine.

Topics

Resources

License

Stars

Watchers

Forks