Version:

控制台变量 (CVARs)

控制台变量(CVAR)可用于设置 O3DE 中的各种编辑器和运行时选项。O3DE 随附了许多内置的 CVAR,但也支持配置和分组您自己的 CVAR 的选项。

使用CVAR

你可以在代码中使用 CVAR 宏函数定义自己的 CVAR。您还可以在 控制台变量组中将 CVAR 组合在一起,这样就可以一次性更改多个 CVAR。

通过 console在编辑器中调用CVAR。

在启动 O3DE 二进制文件时,通过--{cvar name} {value}--{cvar name}={value},您也可以在命令行中传递 CVAR。例如,ServerLauncher.exe --sv_somebool=true

此外,您还可以在 配置文件 中添加 CVAR。

发现 CVAR

查找当前项目中所有可设置 CVAR 的最快方法是通过 控制台变量窗口。调出控制台窗口将列出当前项目中的所有 CVAR,并允许你设置它们的值。

您也可以开始在控制台中键入 CVAR 名称的开头,然后使用 Tab 键显示自动完成并查看所有潜在匹配。例如,键入 ed_ 后,您可以使用 Tab 键循环查看所有影响编辑器的 CVAR。

Automatic CVAR expansion in the console

CVAR 控制台函数

有了内置的控制台命令,使用 CVAR 就更容易了:

名称说明
DumpCommandsVars(遗留)将把所有 CVAR 及其值转储到名为 consolecommandsandvars.txt 的文件中。
更喜欢使用控制台窗口查看 CVAR 及其值。
resetcvars将所有 CVAR 重置为初始值。

常见的CVAR前缀

O3DE 使用以下前缀,以方便查找 CVAR:

前缀用法
bg_Both Games, 适用于可在客户端和服务器上使用的通用 CVAR。
cl_仅适用于客户端的 CVAR。
ed_仅适用于编辑器的 CVAR。
net_仅适用于底层网络的 CVAR。
physx_仅适用于关于NVIDIA PhysX的 CVAR。
r_仅适用于关于渲染的 CVAR。
s_仅适用于关于音效的 CVAR。
sv_仅适用于服务器的 CVAR。
sys_仅适用于底层核心系统的 CVAR。

O3DE中的CVAR的示例

许多 O3DE 功能都暴露了 CVAR,以帮助调试、故障排除和额外的可视化。这些功能包括