Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/godotengine/godot-git-plugin
Git implementation of the VCS interface in Godot
https://github.com/godotengine/godot-git-plugin
gdextension gdnative git godot plugin
Last synced: 30 days ago
JSON representation
Git implementation of the VCS interface in Godot
- Host: GitHub
- URL: https://github.com/godotengine/godot-git-plugin
- Owner: godotengine
- License: mit
- Created: 2019-05-16T08:36:05.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-07-10T16:06:58.000Z (4 months ago)
- Last Synced: 2024-09-29T03:43:13.884Z (about 1 month ago)
- Topics: gdextension, gdnative, git, godot, plugin
- Language: C++
- Homepage:
- Size: 245 MB
- Stars: 699
- Watchers: 24
- Forks: 67
- Open Issues: 74
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/godotengine/godot-git-plugin/actions/workflows/build.yml)
# Godot Git Plugin
Git implementation of the Godot Engine VCS interface in Godot. We use [libgit2](https://libgit2.org) as our backend to simulate Git in code.
> Planned for the upcoming version of Godot. Look for other branches for support in other Godot releases.
## Installation Instructions
1. Grab the platform binaries here:
2. Then read the installation instructions: https://github.com/godotengine/godot-git-plugin/wiki
## Build Instructions
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`.
- [SCons](https://scons.org/pages/download.html) (v3.0.1+)
- C++17 and C90 compilers detectable by SCons and present in `PATH`.
- Platforms Specific Setup
- Windows
- No extra steps required other than setting up the compilers.
- MacOS
- For making universal builds targeting both Apple Silicon and x86_64, you can optionally run `build_openssl_universal_macos.sh` to build OpenSSL yourself and replace the already prebuilt libraries provided inside `thirdparty/openssl/`, otherwise, just run `brew install [email protected]` to use the prebuilt libraries provided in this repository.
- Linux
- Run `sudo apt-get install libssl-dev`, or your local package manager's equivalent.
### Release Build
```
scons platform= target=editor -j 6
```
> You may get the gdextension dump yourself from Godot using the instructions in the next section, or use the ones provided in `godot-cpp/gdextension` or `ci/`.
For more build options, run `scons 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.
```shell
cd local/copy/of/godot/source
.\bin\godot.xxx --headless --dump-gdextension-interface --dump-extension-api
```
2. Build the plugin along with the godot-cpp library.
```
scons platform= target=editor generate_bindings=yes dev_build=yes -j 6
```
> 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. Open the project provided inside `demo/` in the custom Godot build.
To view more options available while recompiling godot-git-plugin, run `scons platform= -h`.
---
## License
This plugin is under the MIT License. Third-party notices are present in [THIRDPARTY.md](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])