godot
Run the Godot game engine
TLDR
Run a project if the current directory contains a project.godot file, otherwise open the project manager
Edit a project (the current directory must contain a project.godot file)
Open the project manager even if the current directory contains a project.godot file
Export a project for release using a given export preset (the preset must be defined in the project)
Execute a standalone GDScript file (the script must inherit from SceneTree or MainLoop)
SYNOPSIS
godot [options] [project_path]
PARAMETERS
--editor
Open the Godot editor GUI.
--path
Specifies the path to the project to open.
--scene
Runs a specific scene within the project.
--quiet
Run Godot in quiet mode, suppressing output.
--verbose
Run Godot in verbose mode.
--version
Displays the Godot engine version.
--export
Exports the project using the specified export preset.
--build-solutions
Regenerates the C# solution file for the project.
--print-help
Prints a complete listing of the available options.
DESCRIPTION
The `godot` command typically refers to the Godot Engine executable, used for creating and managing game development projects. It's the primary way to open the Godot editor, run game projects, and perform various build tasks. The command doesn't have a traditional 'man page' like many standard Linux utilities, as it's a software application rather than a core OS tool. Usage involves specifying command-line arguments to control editor behavior, project execution, and export processes. The specific options available depend on the Godot Engine version. Key tasks include opening projects for editing, running specific scenes, and exporting games for various platforms. Godot relies on project files (.godot) and scene files (.tscn, .escn) within a directory structure.
CAVEATS
The availability and behavior of these options might differ based on the specific version of the Godot Engine you're using. Consult the Godot documentation for the most accurate information.
PROJECT STRUCTURE
Godot projects consist of a project file (`project.godot`) and a directory containing scenes, scripts, assets, and other resources. The command usually needs to be executed within or pointed to the root of the project directory.
GDSCRIPT
GDScript is Godot's custom scripting language, similar to Python, and is the primary way to add game logic. Executing code involves either running scenes in the editor or exporting a project for deployment.
HISTORY
Godot Engine was initially developed by Juan Linietsky and Ariel Manzur. It gained popularity as a free and open-source game engine, known for its flexible scene-based design and GDScript language. The command-line interface evolved with the engine, providing greater control over project management and build processes. The `godot` command's usage is tied directly to the engine's development cycle.