在虚幻引擎(Unreal Editor,简称UE编辑器)中运行命令是开发者调试、配置项目或快速执行操作的核心技能,掌握此能力可大幅提升工作效率,下面详细介绍几种主要方法:
通过控制台命令(最常用)
- 打开控制台:
- 在编辑器或游戏运行窗口(PIE或独立运行)中,按波浪键 `~(通常位于键盘左上角)
- 注意:打包后项目的控制台默认由项目设置决定是否启用。
- 输入命令:
- 控制台打开后,直接输入命令文本(如 `stat fps` 显示帧率)。
- 按 Enter 执行。
- 常用控制台命令示例:
stat unit // 显示性能数据(帧时间、线程负载) t.maxfps 60 // 限制帧率为60 r.ScreenPercentage 70 // 设置渲染分辨率为屏幕的70% Open [地图名称] // 加载指定地图(如 Open /Game/Maps/MyLevel)
在蓝图或C++中执行
可通过编程动态调用命令:
- 蓝图:
- 使用
Execute Console Command
节点。 - 连接对象引用(如PlayerController)和命令字符串(如”show collision”)。
- 使用
- C++:
// 在玩家控制器中执行 APlayerController* PC = GetWorld()->GetFirstPlayerController(); if (PC) { PC->ConsoleCommand(TEXT("stat unit")); }
编辑器菜单与工具栏
- 工具栏按钮:
- 点击顶部工具栏的 运行按钮(▶️) 启动PIE(Play In Editor)。
- 使用 模拟按钮(️) 运行模拟模式。
- 菜单命令:
文件(File) > 打包项目(Package Project)
:执行项目打包。构建(Build) > 编译(Compile)
:编译蓝图/C++代码。
Python脚本(高级)
在UE编辑器内置的Python环境中:
- 打开
Output Log
窗口(Window > Developer Tools > Output Log)。 - 输入Python命令:
unreal.log("执行命令示例") unreal.EditorLevelLibrary.save_all_dirty_levels() # 保存所有未保存关卡
- 通过
unreal.SystemLibrary.execute_console_command()
调用控制台命令。
重要注意事项
- 命令上下文:部分命令仅在PIE模式/打包后生效(如游戏性指令)。
- 安全性:谨慎执行未知命令,避免项目损坏(尤其涉及文件删除或系统调用)。
- 命令帮助:输入
help
或DumpConsoleCommands
可查看可用命令列表。 - 项目设置:路径类命令需使用虚幻的虚拟路径(如
/Game/Textures/MyTexture
)。
高级技巧
- 自定义命令别名:在
DefaultInput.ini
中添加ConsoleCommands
节创建快捷指令。 - 快捷键绑定:在编辑器偏好设置中将常用命令绑定至组合键。
- 启动参数:通过命令行启动编辑器时传递命令(如
UE4Editor.exe -ExecCmds="stat fps; quit"
)。
熟练掌握这些方法,您将能高效利用命令流优化开发流程,建议结合官方文档实践验证命令效果。