Skip to content

Add instructions on how to use a pre-compiled GDExtension, + update a link in the GDExtension class reference #10960

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 4 commits into
base: master
Choose a base branch
from

Conversation

muno777
Copy link

@muno777 muno777 commented May 23, 2025

Currently, a Godot end-user who downloaded a pre-made GDExtension (such as SG Physics 2D) would struggle to find out how to use it in their own project. These instructions are not listed anywhere, and the current GDExtension docs only cater to people writing a GDExtension.

This PR adds a short section to the main GDExtension page describing this, and also changes the link in the GDExtension class doc to lead to the main GDExtension page instead of a sub-page.

Addresses #9277.

muno777 added 4 commits May 23, 2025 19:26
Update class_gdextension.rst
@Calinou Calinou added enhancement area:manual Issues and PRs related to the Manual/Tutorials section of the documentation topic:gdextension cherrypick:4.3 cherrypick:4.4 labels May 27, 2025
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This change needs to be done over here, changing the generated files is not allowed, see here

Comment on lines +12 to +13
In order to use a pre-compiled GDExtension in your Godot project, place the `.gdextension` file somewhere inside your
project's directory. Godot will then load the extension and you should be able to use it in your project.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think some folks may interpret this to mean that you only need to copy in the .gdextension file and nothing else.

Maybe something like:

Suggested change
In order to use a pre-compiled GDExtension in your Godot project, place the `.gdextension` file somewhere inside your
project's directory. Godot will then load the extension and you should be able to use it in your project.
In order to use a pre-compiled GDExtension in your Godot project, place all the files (including the `.gdextension` file) somewhere inside your
project's directory. Godot will then load the extension and you should be able to use it in your project.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area:manual Issues and PRs related to the Manual/Tutorials section of the documentation cherrypick:4.3 cherrypick:4.4 enhancement topic:gdextension
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants