joey
/
gdextension
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
main
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '05eeb3fc9f'
${ noResults }
gdextension/README.md

2.2 KiB
Raw Blame History

gdextension

GDExtension template that automatically builds into a self-contained addon for the Godot Asset Library.

Compatibility warning:

This template is only intended to work with the latest version of Godot 4.x on GitHub, not the latest point release, such as beta1. Before reporting an issue, make sure you are on the latest 4.x and the submodule godot-cpp is up-to-date by running the command git submodule update --remote.

Getting started:

  1. Clone this repository (or a new repository with this template) with submodules.
    • git clone --recurse-submodules https://github.com/nathanfranke/gdextension.git
      cd gdextension
  2. Build all libraries for the current platform.
    • scons
  3. Import, edit, and play project/ using Godot Engine 4+.
  4. Check the output: 
    Hello GDScript!
Hello GDExtension Node!
Hello GDExtension Singleton!

Repository structure:

  • project/ - Godot project boilerplate.
    • addons/example/ - Files to be distributed to other projects.¹
    • demo/ - Scenes and scripts for internal testing. Not strictly necessary.
  • src/ - Source code of this extension.
  • godot-cpp/ - Submodule needed for GDExtension compilation.

¹ Before distributing as an addon, all binaries for all platforms must be built and copied to the bin/ directory. This is done automatically by GitHub Actions.

Make it your own:

  1. Rename project/addons/example/ and project/addons/example/example.gdextension. The library name is automatically changed to the gdextension file name.
  2. Replace LICENSE, README.md, and your code in src/.
  3. Not required, but consider leaving a note about this template if you found it helpful!

Distributing your extension on the Godot Asset Library:

  1. Go to Repository→Actions and download the latest artifact.
  2. Test the artifact by extracting the addon into a project.
  3. Create a new release on GitHub, uploading the artifact as an asset.
  4. On the asset, Right Click→Copy Link to get a direct file URL. Don't use the artifacts directly from GitHub Actions, as they expire.
  5. When submitting/updating on the Godot Asset Library, Change "Repository host" to Custom and "Download URL" to the one you copied.