控制台变量编辑器

介绍如何使用控制台变量编辑器可以查看并修改项目中使用的所有控制台变量,以及如何将控制台变量设置保存为预设,并在不同项目间共享。

Choose your operating system:

Windows

macOS

Linux

控制台变量编辑器(Console Variables Editor) 面板显示项目中的所有控制台变量,同时也可以查看和修改这些变量。你可以创建预设来将同样的控制台变量应用到其他项目。控制台变量编辑器也可以使用多用户会话来跨越多台电脑操作变量。

控制台变量编辑器用户界面

控制台变量编辑器插件带有蓝图API用于访问并操作控制台变量编辑器创建的控制台变量预设。更多信息请参阅蓝图API参考

要使用控制台变量编辑器,需要在你的项目中启用 控制台变量编辑器(Console Variables Editor) 。 如何在项目中启用插件,参阅使用插件

控制台变量编辑器插件

在主菜单中,选择 窗口(Window) > 控制台变量(Console Variables) 来打开控制台变量编辑器。你可以将打开的窗口贴靠在虚幻引擎任何地方。

从主菜单打开控制台变量编辑器

控制台变量列表

该列表显示所有正在使用的控制台变量和已经执行过的指令。当你第一次打开控制台变量编辑器的时候,列表中将会加载一个不包括任何变量的空白预设。如果插件设置中 向当前预设添加所有更改过的控制台变量(Add All Changed Console Variables to Current Preset) 被选为 是(True),该列表里也会显示一些在项目设置中添加的变量。

要向列表中添加控制台变量和指令,点击 (+)添加控制台变量(Add Console Variable) ,然后在输入框中搜索指令或者变量。在你输入文本的时候,输入框下方会自动建议匹配的控制台变量名称,但是诸如‘stat unit'之类的控制台指令不会在建议中出现。

如果你输入的控制台变量是有效的,它将会出现在列表中。如果你连同有效的值一同输入控制台变量或指令,该指令会直接用这个值开始运行,而控制台变量会带着新赋予的值出现在列表中。

点击添加控制台变量按钮并输入控制台指令"stat unit"

当你向列表中添加一个变量,当前值便会保存为 预设值(Preset Value) 。每一个变量都可以重置为它的初始值,或者通过取消选择它所在行的复选框临时撤回更改。

选择和取消选择行来展示数值如何变化

要移除一个控制台变量,将光标移至其所在行的右侧并点击 移除(Remove)。将变量从列表中移除后,其数值会被重置到插件加载时的数值。

光标移至所在行时,移除按钮就会出现

将光标移至控制台变量,可以看到相关具体描述和数值含义的提示文本。

在编辑器中将光标移至控制台变量的名称就会显示提示文本

控制台变量列表的每一行都包含一组如下排列的表格。你可以通过点击对应的标题按照 序号(Sort Order Number)控制台变量名称(Console Variable Name)源(Source) 对变量重新排序。

Column

Description

序号(Sort Order Number)

控制台变量在列表中的排序。你可以通过拖拽不同行来改变它们的排序。

如果你通过另一列来排序,你可以点击设置序号(Set Sort Order)来使列表中的排序相匹配。更多信息请参阅显示选项

复选框(Checkbox)

取消勾选复选框可以让你临时取消对这一行控制台变量的修改。取消选择后,变量会被重置到插件启动加载时的数值。

当你重新勾选这一行时,变量的数值又会回到取消勾选前的最后数值。没有勾选时对该行变量做出的修改在勾选后并不会体现出来。

当前只有控制台变量可以勾选和取消勾选。

控制台变量名称(Console Variable Name)

显示控制台变量的名称。将光标移至名称,若该控制台变量有提示文本,文本便会出现。

数值(Value)

与变量或者指令类型相匹配的可编辑的区域。

更改数值区时,控制台指令或者对变量的更改会直接执行。如果多用户启用,其他用户的设备上也会体现出这些变动。

将光标移至数值上时会显示以下数值:

  • 自定义值(Custom Value)

  • 预设值(Preset Value)

  • 初始值(Startup Value)

如果当前数值与预设值不同,数值控件旁会出现重置数值的选项。点击 重置(Reset) ,变量便会重置到预设值。

源(Source)

描述该变量最近一次是如何被定义的。如果最后一次修改时使用的是控制台变量编辑器,这一列就会显示控制台(Console)。

显示选项

点击 显示选项(Show Options) 来自定义列表中显示哪些行。每个选项的详情如下表。

显示选项下拉菜单

选项

描述

Show

显示构造函数(Show Constructor)

启用后,在一个引擎类启动并设定了控制台变量的情况下,显示由默认构造函数所设置的控制台变量。

显示可扩展性(Show Scalability)

启用后,显示由可扩展性选项设定的控制台变量。

显示游戏设置(Show Game Setting)

启用后,显示由‘UGameUserSettings(config=GameUserSettings)'设定的控制台变量。

显示项目设置(Show Project Setting)

启用后,显示由项目设置所设定的控制台变量。

显示系统设置文件(Show System Settings ini)

启用后,显示由系统ini设置文件设定的控制台变量。

显示设备配置(Show Device Profile)

启用后,显示由设备配置文件设定的控制台变量。

显示游戏覆盖(Show Game Override)

启用后,显示由游戏中覆盖设定的控制台变量,比如一个需要特定数值才能正确运行的平台。

显示控制台变量设置文件(Show Console Variables ini)

启用后,显示由‘Engine/Config/ConsoleVariables.ini'设置文件中启动部分设定的控制台变量。

显示指令行(Show Command line)

启用后,显示由命令行参数设定的控制台变量。

显示代码(Show Code)

启用后,显示由构造函数以外的源代码设定的控制台变量,通常来自一个插件。

显示控制台(Show Console)

启用后,显示由你使用蓝图、CMD输入、控制台变量编辑器所设定的控制台变量。

只显示修改(Show Only Modified)

启用后,显示当前与预设值不同的控制台变量。

Sort

设定排序(Set Sort Order)

选用后,当前列表的控制台变量排序会被保存。

Options

追踪所有变量修改(Track All Variable Changes)

该选项与插件设置中的添加所有修改过的控制台变量至当前预设(Add All Changed Console Variables to Current Preset)相同。

搜索

搜索分为预设搜索和全局搜索。你输入的任何文本都会变成搜索关键字。‘|' 符号可以将关键字用OR分割,空格将关键字用AND合并。

举个例子,输入"lumen|screen percentage",便会匹配"lumen"或者"screen percentage"关键字。搜索结果会包括含有"lumen"的结果,也会包括同时含有"screen"和"percentage"的结果。

预设搜索

搜索时会默认进行预设搜索。预设中 名称(Name)源(Source) 或者提示文本不匹配搜索关键字的控制台变量都不会被显示。

预设搜索示例

全局搜索

输入搜索文本后点击 搜索全部(Search All) 便会启用全局搜索。虚幻引擎中所有 名称(Name) 匹配搜索关键字的控制台变量都会出现在搜索结果中。输入的搜索关键字会出现在搜索框下方。所有匹配的变量都会以行的形式罗列出来,并且可以像在预设中一样进行操作。

全局搜索示例

点击搜索关键字可以切换是否匹配这个关键字。

在全局搜索中切换是否匹配一个关键字

右键 或者 **Ctrl+左键**点击可以移除单个的搜索关键字。

在全局搜索中移除关键字

点击 移除(Remove) 会移除全部搜索关键字并返回至预设搜索。

移除按钮移除全部搜索关键字并返回至预设搜索

将光标移至控制台变量所在行并点击 添加CVAR(Add CVAR),将会将搜索结果中的变量添加至你的预设。如果你启用了追踪所有变量修改(Track All Variable Changes),在这里修改的变量也会自动添加到当前的预设中。

将控制台变量添加至预设

预设

预设(Presets) 面板用于保存和加载预设。加载预设时,当前列表中的所有变量都会被清空,但是数值不受影响。新加载进来的变量会保持它们在预设中的数值,除非其所在行的复选框被取消勾选。

预设面板

多用户

如果你的项目中启用了多用户插件,控制台变量编辑器中会显示多用户选项。你可以将变量修改和指令调用传递至组里的其他用户。

点击多用户控制(Multi-User Controls),多用户相关的设置会出现在控制台变量编辑器下方。在这里可以对组里的每一个用户选择是否进行控制台变量同步。

显示多用户选项

插件设置

插件设置位于 项目设置(Project Settings)> 插件(Plugins) 。其下的 控制台变量编辑器(Console Variables Editor) 选项可以用于自定义编辑器的运作和显示。下表描述所有插件设置。

控制台变量编辑器插件设置

设置

描述

未勾选行显示类型(Unchecked Row Display Type)

判定未勾选行的数值如何显示。未勾选行有以下几种显示方式:

  • 显示当前值(Show Current Value)

  • 显示上一个输入值(Show Last Entered Value)

向当前预设添加所有更改过的控制台变量(Add All Changed Console Variables to Current Preset)

启用后,在编辑器之外修改过的控制台变量也会被添加到列表中。该方式只适用于控制台变量,编辑器以外输入的控制台指令不会被添加到列表中。

更改过的控制台变量略过清单(Changed Console Variable Skip List)

向当前预设添加所有更改过的控制台变量(Add All Changed Console Variables to Current Preset)选项启用时,该清单里的控制台变量不受这个选项影响。如果在编辑器以外被修改,它们不会像正常变量一样被添加到编辑器的列表里。