joey
/
gdextension
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
GDExtension repo template taken from: https://github.com/nathanfranke/gdextension
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.
43 Commits
1 Branch
0 Tags
103 KiB
C++ 65%
Python 32.8%
GDScript 2.2%
 
 
 
main
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '68ab3ef05e'
${ noResults }
Go to file Use this template
Nathan Franke 68ab3ef05e
simplify method binds 		3 years ago
.github/workflows workflows: remove dead code 3 years ago
godot-cpp@8670305589 update upstream 3 years ago
project Fixes for building on macOS 3 years ago
src simplify method binds 3 years ago
.gitattributes add .gitattributes, minor github workflows change 4 years ago
.gitignore Fixes for building on macOS 3 years ago
.gitmodules godot-cpp tracks master 3 years ago
LICENSE update license url 3 years ago
README.md readme: elaborate on compatibility 3 years ago
SConstruct update comments and variable names in SConstruct 3 years ago

README.md

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.