命令行教程¶

一些开发人员喜欢广泛使用命令行。Godot被设计为对他们友好，所以这里是完全从命令行工作的步骤。由于该引擎几乎不依赖外部库，所以初始化时间非常快，因此适合于此工作流。

路径¶

建议将godot二进制文件放在path环境变量中，这样就可以在任何地方通过键入 godot . 在Linux上，您可以通过将godot二进制文件放入 /usr/local/bin 确保它被称为 godot .

根据godot二进制文件的位置和当前工作目录，您可能需要设置项目的路径，以使以下任何命令正常工作。

这可以通过给 project.godot 作为第一个参数的项目文件，如下所示：

user@host:~$ godot path_to_your_project/project.godot [other] [commands] [and] [args]

或者使用 --path 论点：

user@host:~$ godot --path path_to_your_project [other] [commands] [and] [args]

例如，导出游戏的完整命令（如下所述）可能如下所示：

user@host:~$ godot --path path_to_your_project --export my_export_preset_name game.exe

从命令行创建项目可以通过将shell导航到所需位置并生成project.godot文件来完成。

user@host:~$ mkdir newgame
user@host:~$ cd newgame
user@host:~/newgame$ touch project.godot

这个项目现在可以用Godot打开了。

运行编辑器是通过使用 -e 旗帜。必须从项目目录或子目录中执行此操作，否则将忽略该命令并显示项目管理器。

user@host:~/newgame$ godot -e

如果已经创建并保存了一个场景，以后可以通过使用该场景作为参数运行相同的代码对其进行编辑。

user@host:~/newgame$ godot -e scene.tscn

Godot是您的文件系统的朋友，不会创建额外的元数据文件。使用 rm 删除场景文件。确保没有任何内容引用该场景，否则在打开时将引发错误。

user@host:~/newgame$ rm scene.tscn

要运行游戏，只需在项目目录或子目录中执行godot。

user@host:~/newgame$ godot

当需要测试特定场景时，将该场景传递到命令行。

user@host:~/newgame$ godot scene.tscn

在命令行中捕获错误可能是一项困难的任务，因为它们只是飞驰而过。为此，通过添加 -d . 它适用于运行游戏或简单场景。

user@host:~/newgame$ godot -d

user@host:~/newgame$ godot -d scene.tscn

还支持从命令行导出项目。这对于持续集成设置特别有用。Godot的无头版本（服务器构建，无视频）非常适合这样做。

user@host:~/newgame$ godot --export "Linux/X11" /var/builds/project
user@host:~/newgame$ godot --export Android /var/builds/project.apk

平台名称由 --export 开关与编辑器的导出向导中显示的相同。要从命令行获取受支持平台的列表，请尝试导出到未识别的平台，然后将显示配置支持的平台的完整列表。

要导出游戏的调试版本，请使用 --export-debug 切换而不是 --export . 它们的参数和用法相同。

可以从命令行运行简单的.gd脚本。此功能在大型项目中特别有用，用于资产的批量转换或自定义导入/导出。

脚本必须从scenetree或mainloop继承。

下面是一个简单的例子，说明它是如何工作的：

#sayhello.gd
extends SceneTree

func _init():
    print("Hello!")
    quit()

以及如何运行它：

user@host:~/newgame$ godot -s sayhello.gd
Hello!

如果路径中不存在project.godot，则假定当前路径为当前工作目录（除非 -path 指定）。