实时查看器
实时查看器(Live Viewer)可以搜索、查看、编辑和监视每个对象的属性,非常适合调试 Mod,或了解数值在运行时如何发生变化。但它无法显示未通过反射公开的数据。
要显示该工具,必须确保以下配置项均设为 1:
GuiConsoleEnabledGuiConsoleVisible
如果窗口显示异常,例如打开后空白或全白,可以修改 GraphicsAPI 设置,例如设为 dx11。
有时字体太小而难以看清(尤其是在高分辨率下),可以修改 GuiConsoleFontScaling 设置来调整。
右键点击搜索栏可显示选项。
| 设置 | 说明 |
|---|---|
| Refresh search(刷新搜索) | 刷新搜索结果。 |
| Save filters(保存筛选器) | 将当前搜索筛选条件保存到 working directory/liveview/filters.meta.json。下次启动游戏时会加载已保存的筛选器。 |
| Apply when not searching(未搜索时应用) | 未按名称搜索对象时也应用筛选器。 |
| Include inheritance(包含继承对象) | 包含搜索结果中任意对象的子对象。 |
| Instances only(仅实例) | 仅包含对象实例。这些对象作为 Actor 的一部分存在于关卡中(包括 Actor 本身、控件、组件等),其属性反映实时值。例如 <package name>_C 或 <package name>_C_<some instance id>。 |
| Non-instances only(仅非实例) | 仅包含对象包的默认状态:它们已加载到内存,但并不存在于关卡中。无法修改这些属性的值。 |
| CDOs only(仅类默认对象) | 仅包含类默认对象(CDO),即非实例从 UClass 对象继承的反射属性。例如 <full path>_GEN_VARIABLE 或 <package path>.Default__<package name>。 |
| Include CDOs(包含 CDO) | 在任意搜索条件中包含 CDO。 |
| Use Regex for search(使用正则表达式搜索) | 使用正则表达式进行更精确的搜索。 |
| Match Memory Address(匹配内存地址) | 如果搜索内容是有效的十六进制内存地址,则把位于该地址的对象,或某个属性位于该地址的对象包含在结果中。 |
| Exclude class names(排除类名) | 排除指定类名,例如 CanvasPanelSlot 或 StaticMeshComponent。使用逗号分隔列表,例如 CanvasPanelSlot, StaticMeshComponent,Package , Function。 |
| Include class names(包含类名) | 通过排除类名的下拉菜单访问。仅包含指定类名,例如 CanvasPanelSlot 或 StaticMeshComponent。使用逗号分隔列表,例如 CanvasPanelSlot, StaticMeshComponent,Package , Function。 |
| Has property(具有属性) | 仅查找具有指定名称属性的对象,例如 Player Name。只有在搜索栏中输入内容时,此设置才生效。 |
| Has property type(具有属性类型) | 仅查找具有指定类型属性的对象,例如 BoolProperty 或 MulticastInlineDelegateProperty。 |
| Function parameter flags(函数参数标志) | 点击此复选框打开弹窗。可以选择任意数量的标志来筛选函数,并决定是否用选定的标志检查返回值标志。 |
底部属性查看面板有三个控件:
<<:在历史记录中后退。>>:在历史记录中前进。Find functions:打开一个窗口,搜索并调用此对象及其任何子对象相关的函数。无需编写代码,即可在游戏中测试函数调用。
监视
右键点击大多数属性类型或函数,即可添加监视(watch)。
进入 watches 页签即可查看监视项。
点击每个监视项左侧的加号按钮,可展开数值框。
每个监视项左侧有两个复选框:
- 启用/禁用监视。
- 将监视写入文件。启用后,关闭游戏时,监视值会保存为文本文件,存放在
working directory/watches/中。
监视项右侧提供保存监视的选项。保存后,重新启动游戏时会自动重新添加该监视项。此数据存储在 working directory/watches/watches.meta.json 中。
原文:docs/feature-overview/live-view.md · 固定提交 560411f18512 · 来源与 MIT 许可