Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
G

GodotEnv

> 编程语言
Open source

Manage Godot versions and addons from the command line on Windows, macOS, and Linux.

565 stars0 likes0 views
WebsiteGitHub

About

Manage Godot versions and addons from the command line on Windows, macOS, and Linux.

GodotEnv

[![Chickensoft Badge][chickensoft-badge]][chickensoft-website] [][discord]

GodotEnv is a command-line tool that makes it easy to switch between Godot versions and manage addons in your projects.



GodotEnv can do the following:

  • ✅ Download, extract, and install Godot 3.0/4.0+ versions from the command line on Windows, macOS, and Linux (similar to tools like [NVM], [FVM], [asdf], etc.
  • ✅ Switch the active version of Godot by updating a symlink.
  • ✅ Automatically setup a user GODOT environment variable that always points to the active version of Godot.
  • ✅ Install addons in a Godot project from local paths, remote git repositories, or symlinks using an easy-to-understand addons.json file. No more fighting with git submodules! Just run godotenv addons install whenever your addons.json file changes.
  • ✅ Automatically create and configure a .gitignore, addons.json, and addons/.editorconfig in your project to make it easy to manage addons.
  • ✅ Allow addons to declare dependencies on other addons using a flat dependency graph.

Installation

GodotEnv is a .NET command line tool that runs on Windows, macOS, and Linux.

bash
dotnet tool install --global Chickensoft.GodotEnv

If you encounter the error No NuGet sources are defined or enabled, add a Nuget source or enable one and try installing GodotEnv again.

List the current sources and see which are enabled.

bash
dotnet nuget list source

If no sources are listed, add a new one.

bash
dotnet nuget add source https://api.nuget.org/v3/index.json -n nuget.org

Otherwise, make sure one is enabled.

bash
dotnet nuget enable source 

GodotEnv uses the local git installation and other processes available from the shell, so make sure you've installed git and [configured your local shell environment][ssh-github] correctly.

[!NOTE] Windows Users

Certain operations may require administrator privileges, such as managing symlinks or editing certain files. GodotEnv should prompt you in these cases for your approval, and certain operations will cause a command line window to pop open for a moment before disappearing — this is normal.

In some cases, enabling Developer Mode may be required for GodotEnv to correctly manage symlinks.

Quick Start

We'll walk through the commands in depth below, but if you prefer to get started right away you can use the --help flag with any command to get more information.

bash
# Overall help
godotenv --help

# Help for entire categories of commands
godotenv godot --help
godotenv addons --help

# Help for a specific godot management command
godotenv godot install --help

# etc...

Godot Version Management

GodotEnv can automatically manage Godot versions on your local machine for you.

‍♀️ Using GodotEnv to install Godot works best for local development. If you want to install Godot directly on a GitHub actions runner for CI/CD purposes, consider using Chickensoft's [setup-godot] action — it caches Godot installations between runs, installs the Godot export templates, and also works on Windows, macOS, and Ubuntu GitHub runners.

⬇️ Installing Godot

To get started managing Godot versions with GodotEnv, you'll need to first instruct GodotEnv to install a version of Godot.

bash
godotenv godot install 4.0.1
# or a non-stable version:
godotenv godot install 4.1.1-rc.1

Versions should match the format of the versions shown on the [GodotSharp nuget package][godot-sharp-nuget]. Downloads are made from [GitHub Release Builds][github-release-downloads].

By default, GodotEnv installs .NET-enabled versions of Godot.

If you really must install the boring, non-.NET version of Godot, you may do so .

bash
godotenv godot install 4.0.1 --no-dotnet

When installing a version of Godot, GodotEnv performs the following steps:

  • Downloads Godot installation zip archive (if not already downloaded).
  • Extracts Godot installation zip archive.
  • Activates the newly installed version by updating the symlink.
  • Makes sure the user GODOT environment variable points to the active Godot version symlink.

[!IMPORTANT] To run Godot, simply type $GODOT in a shell to execute the active version of Godot. The Godot executable should also be in your path after restarting your shell.

Windows users: the first time you install Godot, you may need to log out and log back in on Windows for the $GODOT variable to be picked up by your shell and other applications.

Listing Godot Versions

GodotEnv can show you a list of the Godot versions you have installed.

bash
godotenv godot list

Which might produce something like the following, depending on what you have installed:

4.0.1
4.0.1 *dotnet
4.1.1-rc.1
4.1.1-rc.1 *dotnet

Listing Available Godot Versions

GodotEnv also supports showing a list of remote Godot versions available to install using the -r option.

bash
godotenv godot list -r

Using a Different Godot Version

You can change the active version of Godot by instructing GodotEnv to update the symlink to one of the installed versions. By default, it only looks for the .NET-enabled version of Godot. To use a non-.NET version of Godot, specify --no-dotnet.

bash
# uses dotnet version
godotenv godot use 4.0.1

# uses non-dotnet version
godotenv godot use 4.0.1 --no-dotnet

Installing or Using a Project-Specific Godot Version

You may want to install or use the version of Godot that is appropriate for the project you're currently working on. GodotEnv can infer the correct version for your project from files in your directory tree. To do so, run the godot install or godot use commands without a version argument:

bash
# installs version inferred from project files
godotenv godot install

# uses version inferred from project files
godotenv godot use

GodotEnv will walk up the directory tree and use the following files, in order of precedence:

  • global.json specifying a Godot.NET.Sdk value in msbuild-sdks.
  • *.csproj specifying a versioned Godot.NET.Sdk as its Project SDK.
  • .godotrc with a Godot version string as its first line.

A global.json file at any directory level above the working directory will take precedence over all csproj files, even those closer to the working directory; likewise, any csproj file in the tree will take precedence over all .godotrc files. Files of the same type that are fewer steps up the directory tree will take precedence over ones that are further up the tree.

Versions from global.json or a csproj file are assumed to be .NET-enabled. A .godotrc file may specify a non-.NET Godot by appending a space and the string no-dotnet to the version string. For instance, a .godotrc file containing the value 4.0.1 no-dotnet indicates the non-.NET version of Godot 4.0.1.

[!IMPORTANT] Remember to run godotenv godot install and godotenv godot use as necessary after setting up or modifying a version file, and whenever returning to your project from some other project that may have used a different Godot version.

✍️ Pinning the Current Godot Version for a Project

To enable the version-free godotenv godot install and godotenv godot use commands without hand-authoring a version-specifying file for your project, you can use the godotenv godot pin command. This command will locate the top-level directory of your project and place a version-specifying file in it, indicating your active Godot version as the preferred version for the project.

  • To find the top-level directory of your project, the command walks up the directory tree from the working directory.
    • If your project contains any sln files, the command will use the topmost directory containing a sln file.
    • If your project does not contain any sln files, the command will use the topmost directory containing a project.godot file.
  • If your active Godot version is .NET-enabled, the command will add its version number as a Godot.NET.Sdk value in an existing global.json in the top-level project directory, or create a new global.json with the value if one does not exist.
  • If your active Godot version is not .NET-enabled, the command will place its version number in a .godotrc file in the top-level project directory, overwriting any existing .godotrc file in that location.

Once the version-specifying file is created or updated with the preferred Godot version, you can commit it to source control for use by others on your team.

Uninstalling a Godot Version

Uninstalling works the same way as installing and switching versions does.

bash
# uninstalls .NET version
godotenv godot uninstall 4.0.1

# uninstalls non-dotnet version
godotenv godot uninstall 4.0.1 --no-dotnet

Getting the Symlink Path

GodotEnv can provide the path to the symlink that always points to the active version of Godot.

bash
godotenv godot env path

Getting the Active Godot Version Path

GodotEnv will provide you with the path to the active version of Godot that the symlink it uses is currently pointing to.

bash
godotenv godot env target

️ Getting and Setting the GODOT Environment Variable

You can use GodotEnv to set the GODOT user environment variable to the symlink that always points to the active version of Godot.

bash
# Set the GODOT environment variable to the symlink that GodotEnv maintains.
godotenv godot env setup

# Print the value of the GODOT environment variable.
godotenv godot env get

On Windows, this adds the GODOT environment variable to the current user's environment variable config.

On macOS, this adds the GODOT environment variable to the current user's default shell configuration file. In case the user's shell isn't compatible, defaults to zsh.

On Linux, this adds the GODOT environment variable to the current user's default shell configuration file. In case the user's shell isn't compatible, defaults to bash.

After making changes to environment variables on any system, be sure to close any open terminals and open a new one to ensure the changes are picked up. If changes are not picked up across other applications, you may have to log out and log back in. Fortunately, since the environment variable points to a symlink which points to the active Godot version, you only have to do this once! Afterwards, you are free to switch Godot versions without any further headache as often as you like.

Clearing the Godot Installers Download Cache

GodotEnv caches the Godot installation zip archives it downloads in a cache folder. You can ask GodotEnv to clear the cache folder for you.

bash
godotenv godot cache clear

Addon Management

GodotEnv allows you to install [Godot addons][asset-library]. A Godot addon is a collection of Godot assets and/or scripts that can be copied into a project. [By convention][godot-addons-structure], these are stored in a folder named addons relative to your Godot project. Check out the [Dialogue Manager][godot-dialogue-manager] addon to see how a Godot addon itself is structured.

Besides copying addons from remote git repositories or zip files, GodotEnv allows you to install addons from a local git repository or symlink to local directories on your machine so that you can use an addon across multiple Godot projects while it is still in development.

Using GodotEnv to manage addons can prevent some of the headaches that occur when using git submodules or manually managing symlinks.

Additionally, GodotEnv will check for accidental modifications made to addo

Issues· 0 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

C#addonaddonsgamedevgodot

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言