Quick Start

GDCC is an open-source GDScript compiler and toolchain that compiles GDScript scripts into plain C code and native dynamic library modules executed through the GDExtension interface.

Install

Download GDCC from the GDCC GitHub Releases page.

You will see two package types:

• gdcc-<version>-<os>-<arch>.zip includes only the gdcc launcher and core files.
• gdcc-<version>-<os>-<arch>-full.zip includes those files plus all toolchains required to run GDCC, so it works out of the box.

For later updates, you can download the package that only contains the gdcc launcher and core files and use it to overwrite the existing installation.

Compile a Script

The basic command shape is:

gdcc [options] <files...>

Compile one script:

gdcc -o build/demo src/player.gd

Compile multiple scripts into one module:

gdcc -o build/demo src/player.gd src/enemy.gd

Compile a Godot Project Script

When a script belongs to a Godot project, pass the project file so GDCC can emit .gdextension metadata:

gdcc --project game/project.godot -o build/demo game/src/player.gd

Common Options

• -o / --output <output> sets the output target path. If omitted, GDCC derives a name from the input files.
• --gde <version> selects the Godot GDExtension API version. Currently only 4.5.1 is supported, with compatibility for newer versions.
• --opt / --optimize <level> selects debug or release.
• --target <platform> selects a target such as linux-x86-64, windows-x86-64, or linux-aarch64.
• --prefix <prefix> and --class-map Source=Canonical control generated top-level canonical class names.