tutorials/scripting/gdextension/gdextension_file

[giscus[bot]]

tutorials/scripting/gdextension/gdextension_file

Introduction: The.gdextension file in your project contains the instructions for how to load the GDExtension. The instructions are separated into specific sections. This page should give you a quic...

https://docs.godotengine.org/en/stable/tutorials/scripting/gdextension/gdextension_file.html

[markeel]

Note that if the extension only has entries for the build as "editor", it will not be exported because that isn't one of the feature tags normally used for exporting. In 4.3 this is silent but in 4.4 a warning will appear. If it is really an editor only extension, then simply exclude the extension in the Resources tab of the export dialog during export.

For example the Git plugin is editor-only and has something like:

macos.editor = "...dylib"
windows.editor.x86_64 = "...dll"
linux.editor.x86_64 = "...so"
linux.editor.arm64 = "...so"
linux.editor.rv64 = ""

and so cannot be exported to a linux platform for a non-editor build (and really makes no sense to), so it requires the project owner to update Resources to identify that plugin to be excluded.

[TheOathMan]

Can i comment off something in the .gdextension file ? Something equivalent to ## in gdscript.

[Ivorforce]

Yes, I believe comments can be added with a semicolon:

; Test test
macos.x86_64.single.debug = "./macos/numdot.macos.template_debug.x86_64.framework/numdot.macos.template_debug.x86_64"
; [...]

[Calinou]

This should work as the TSCN/TRES/ConfigFile formats allow comments starting with ;, similar to INI.

[Calinou]

Pull request opened:

• Document relative paths in .gdextension files being supported godot-docs#11381

[AndreasOM]

The .gdextension file supports relative paths for libraries and DLLs, which makes installation much more flexible for users.
However, most official examples only show res:// paths.
It should be clearly mentioned that relative paths are fully supported.
For reference, even the official C++ extension template uses relative paths:
https://github.com/godotengine/godot-cpp-template/blob/main/demo/bin/example.gdextension

And yes, I just did spent two hours banging my head on the keyboard finding any official confirmation that relative paths are working.

[Calinou]

Pull request opened:

• Document relative paths in .gdextension files being supported godot-docs#11381