Command

This tool is controlled exclusively from a command line. The example given will usually show commands running in a Windows environment, but they will do the same thing on the Mac and in Linux.

gspm [options] <command>

Options

--version

Show the Version and Exit.

-h, --help

Show the Help and Exit.

-c, --config {CONFIG}

Use a specific Configuration file. The default is project.yml.

-f, --force

Force a command to execute with Warnings. Use this when you are sure of what you are doing.

--verbose, --more-verbose

Change the level of messages generated when executing.

--quiet

Only the most important Messages, Errors and Warnings will show. The logo will also be supressed.

--log

Log all output to gspm.log file.

Commands

Clean

Remove all assets from the Project and Repository, but leave the Godot executable in the repository. This is useful when you want to reinstall your assets if you know there are updates.

When the addons folder is empty after cleaning, it will also be removed from the project folder.

Note

Inactive assets are not included in this cleanup.

Note

When you have removed an asset from your project configuration, it will not be able to clean it up, and you will have to do this manually.

Edit

Starts the GODOT editor and opens your project.

-c, --console

Open the project with the Godot console (command-line mode).

path

The path to the project directory. Defaults to current directory.

Export

Exports your project with the configuration specified.

name

The name of the export you want to use from your configuration file.

Install

Pulls Godot and the other Assets specified in the projects configuration file.

--headless

When installing, use the headless version of Godot. This is useful when you want to build your game from a continuous integration server.

-a, --assets

Install only the assets, skipping Godot engine and project setup. Useful when you want to update specific assets.

assets ...

Specific asset(s) to install. If not specified, all active assets will be installed.

New

Create a new project for Godot.

-t {name}, --template {name}

Use a Template when creating new project.

-gv {version}, --godot-version {version}

Specify the Godot version to use for the new project (e.g., 3.3, 4.2).

-gr {release}, --godot-release {release}

Specify the Godot release to use (e.g., stable, beta1, rc1).

name

The name of the new project (required).

Run

Run the project using the Startup scene.

Test

Run unit tests for your project.

Update

Update your project assets.

Examples

# edit using the configuration file my_project.yml
gspm -c my_project.yml edit