实时查看器

实时查看器

实时查看器(Live Viewer)可以搜索、查看、编辑和监视每个对象的属性,非常适合调试 Mod,或了解数值在运行时如何发生变化。但它无法显示未通过反射公开的数据。

要显示该工具,必须确保以下配置项均设为 1:

  • GuiConsoleEnabled
  • GuiConsoleVisible

如果窗口显示异常,例如打开后空白或全白,可以修改 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 许可