From 8e220d5941e50f9f5bf44f56b83a44e2534e041f Mon Sep 17 00:00:00 2001 From: Henrique Alves Date: Mon, 25 Jul 2022 22:01:15 -0300 Subject: Add README file --- README.md | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000..bfe8118 --- /dev/null +++ b/README.md @@ -0,0 +1,37 @@ +# GLAM - Godot Lightweight Addon Manager +✨GLAM✨ is a CLI tool to facilitate addon managing for Godot projects. It's lightweight and focused on providing basic addon managament such as installing, removing, and applying changes to any addon that can be installed via git. It does so by adding two files to your project: a **.glam** file that tracks each installed addon and their installed commit, and a **.glam.d/** folder that stores the addons repositories, so you can easily update or apply changes to them - after installing or updating an addon, it's files are copied to the Godot project `addons/` folder. The tool also provides a meaningful `help` for all commands. + +This is **not** a one-size-fits-all kind of solution. I created it because I wanted an easy way to start a Godot project with addons I use often without having to download them via the Asset Manager, and to develop my own Addons while I use them on other projects (hence `glam apply`). If you are interested in other alternatives, check the **Alternatives** section. + +## Installing +**This is a WIP project**, so I'm not too focused on providing releases; right now, the easiest way to install this project is via `cargo install`. This may change if this project gain traction. + +## Example +You can initialize your project (with meaningful `.gitignore` and `.gdignore` files) with: +``` +glam init +``` + +You can install new addons with: +``` +glam install-package https://github.com/henriquelalves/GodotTIE +``` + +If you want to use ✨GLAM✨ with a CI/CD, you can `.gitignore` the `addons/` folder and install all addons listed in the `.glam` file with: +``` +glam install +``` + +If you are developing an Addon, you can apply changes made in the addon to their `.glam.d` repository with: +``` +glam apply GodotTIE +``` + +## Disclaimer +**This project is a WIP!** This is a beta release to anyone interested in using or contributing to this project. It may contain bugs that may ruin your project if you don't make any backups or use version-control wisely. + +## Alternatives +- https://github.com/imjp94/gd-plug +This is an addon that inspired and works similarly to this CLI tool, but using GDScript (and the Godot executable). I prefered creating the Rust CLI tool though, so I wouldn't need to bootstrap my Godot projects to use it, and to easier extend the tool to my needs. +- https://crates.io/crates/gotpm +Another Rust solution; the GitHub repository seems to be missing, though. -- cgit v1.2.3