Godot Libre Asset Manager
Godot plugin for finding, downloading and managing free, libre, and creative commons assets. Work in progress.
It can be quite tedious to download assets, unzip them, copy their files over to your Godot project and then setup resources to use the files. GLAM aims to make it easy to download and setup assets with a single click and then drag them directly into the scene or inspector. This can be useful if you want to quickly try out many different assets, or want to work quickly, such as in a game jam.
Many free asset licenses require attribution as part of their requirements and keeping track of license and attribution information can also be quite tedious. GLAM aims to make this easy by following the reuse specification and creating .license files along side downloaded assets that also include additional metadata such as author profile urls, original titles, and download sources. These files can then be used to automatically generate credits that can be added to the documentation or shown in-game.
GLAM offers (or plans to offer) integration with the APIs of the following sources. Some of these sources require an api account to use (see 'Account Required').
| Source | Account Required | Support | Notes |
|---|---|---|---|
| AmbientCG | No | Partial | Currently only PBR textures. No search filters |
| Pixabay | Yes | Partial | Currently only images (no videos). No search filters |
| Freesound | Yes | In progress | Sound Effects |
| Openclipart | Yes | Planned | Vector Graphics |
| FreeSVG | Yes | Planned | Vector Graphics |
| Noun Project | Yes | Planned | Icons, Images |
| Poly Haven | No | Planned | PBR Textures, 3D Models, HDRs |
| Sketchfab | Yes | Planned | 3D Models |
| Jamendo | Yes | Planned | Music |
| ccMixter | No | Planned | Music |
| SoundCloud | Yes | Planned | Music |
Copy the addons/glam directory in this repo to your Godot project.
Or install the gd-plug plugin. By adding the following to your plug.gd file (changing the commit hash to the version of GLAM you want to use):
plug("lihop/glam", {commit = "432cb3561db0b2e69471883b13e24e0f5d15e155", include = ["addons/glam"]})
If you cloned this repo locally and want to work on it you will need to install the plugins using the following command to install additional plugins:
godot --no-window -s plug.gd install
GLAM uses the Gut tool for testing. These tests can be run from the command line using:
godot --no-window -s addons/gut/gut_cmdln.gd
By default, only unit tests will be run. To run all tests (including integration tests) use:
godot --no-window -s addons/gut/gut_cmdln.gd -gconfig=.gutconfig_all.json
Note: Integration tests require Node.js to be installed as they use the npx command to start an http-server HTTP server. The integration tests also take a long time (more than 30 seconds) to run.