godotengine/godot-git-plugin

Godot Git Plugin

Git implementation of the Godot Engine VCS interface in Godot. We use libgit2 as our backend to simulate Git in code.

Installation

1. Grab the platform binaries from the Asset Store, or from GitHub Releases.
2. Read the installation instructions.

Build

This section onwards is only meant to be used if you intend to compile the plugin from source.

Required tools

• Full copy of the source code. Remember to use git clone --recursive, or initialize submodules with git submodule update --init.
• SCons (v3.1.2+), CMake, and Perl.
• C++17 and C90 compilers detectable by SCons and present in PATH.

Release build

scons platform=<platform> target=editor

You may get the GDExtension dump yourself from Godot using the instructions in the next section, or use the ones provided in godot-cpp.

For more build options, run scons platform=<platform> -h

Dev builds

When new features are being worked on for the Godot VCS Integration, the build process sometimes requires developers to make changes in the GDExtension API along with this plugin. This means we need to manually generate the GDExtension API from the custom Godot builds and use it to compile godot-cpp, and then finally link the resulting godot-cpp binary into this plugin.

If you need to use a custom GDExtension API:

1. Dump the new bindings from the custom Godot build.

./path/to/godot/bin/godot.<platform>.editor.<arch> --headless --dump-gdextension-interface --dump-extension-api

2. Build the plugin along with the godot-cpp library.

scons platform=<platform> target=editor generate_bindings=yes dev_build=yes

You only need to build godot-cpp once every change in the GDExtension API, hence, generate_bindings=yes should only be passed in during the first time after generating a new GDExtension API dump.

3. To test the plugin, set up a testing project with Godot, and copy or symlink the addons folder.

To view more options available while recompiling godot-git-plugin, run scons platform=<platform> -h.

License

This plugin is under the MIT License. Third-party notices are present in THIRDPARTY.md.

OpenSSL License Attributions - This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit. (http://www.openssl.org/). This product includes cryptographic software written by Eric Young ([email protected])