- Clean separation of assets, resources, scenes, scripts and shaders code
- Continuous integration via GitHub Actions
- Code formatting enforced by gdformat for gdscript code, and clang-format for shaders, via pre-commit
- Keep track of licenses and attribution by following the reuse specification
- Addons management with gd-plug
- Automatic dependencies bumping with renovate for Godot and addons
- Command runner with just, with a provided
Justfile
that handle tools installation, exporting, publishing ...
- Use this repo as a template.
- Replace all occurrences of "Greeter" with the name of your project
- Replace files with your own
- Happy coding!
Eventually, you can remove any unused files, such as irrelevant github workflows for your project. Feel free to replace the License with one suited for your project.
Released binaries are available on Itch.io and on the Github repository, in the release section.
Download the zip archive, accordingly to your OS, and unzip it.
- Windows: Double click on
Greeter.exe
. - MacOS: Double click on
Greeter.app
. - Linux: In a terminal, run
./Greeter.x86_64
.
Important
For this installation, you need to have the Godot Editor installed.
Clone the source locally:
git clone https://github.com/MechanicalFlower/godot-template.git
You need to install addons first:
godot --headless --script plug.gd install
And simply run the game as any Godot project:
godot
The project use:
just
as command runner,pre-commit
to run formatters, this requires Python 3.
Important
Actually, just
recipes only support Linux.
To check all available recipes, run:
just
To run formatters:
just fmt
To install, and run the game:
just install-addons
just godot
Tip
In just
recipes, the Godot Editor is installed
automatically. This ensure that you
use the right version of the engine.
We welcome community contributions to this project.
Please read our Contributor Guide for more information on how to get started.
Please read our Release Guide for more information on how we manage our releases.