UE5【插件】一键重命名蓝图变量、事件、函数、宏等(实现批量翻译)
Blueprint Operations - Batch Export & Rename
v2025.10.31
作者:chh(本博主,哈哈哈~)
一个强大的文本转换实用程序,提供批量重命名功能以实现批量翻译。支持批量重命名蓝图资产,包括变量、事件、函数、宏、图表、类别、描述、注释、局部变量和文件资产!
文章目录
- 一、插件介绍
- 二、基本使用教程
- 三、高级使用教程
- 四、注意事项
- 五、更新和维护
一、插件介绍
一个强大的文本转换工具,提供批量重命名,从而实现批量翻译,可以批量重命名蓝图中的变量、局部变量、事件、函数、宏、图表、类别、描述、注释等属性,还可以批量重命名文件资产。
插件已上架Fab商城:https://fab.com/s/e00b08e195b2

视频插件使用教程:
bilibili 哔哩哔哩 视频链接
二、基本使用教程
右键单击任意文件并选择 脚本化资产行为,然后你可以看到这个脚本的功能。

你可以在 引擎 → Plugins → BlueprintOperations内容 看到脚本的内容。
脚本默认有 “NamingAssistant” 蓝图的中英文数据。通过选择 “BlueprintNamingAssistant” 并点击 “One Click Apply Blueprint Element Conversion”,“NamingAssistant” 蓝图的元素将被转换为中文。打开 “NamingAssistant” 蓝图,你会看到蓝图所有的变量、局部变量、事件、函数、宏、图表、类别、描述、注释等全部被转换成中文。

编译并保存,回到内容浏览器查看 脚本化资产行为,可以看到脚本的功能名称被转换成中文。
其原理则是利用脚本本身的功能,将脚本自身的做为例子进行批量重命名。

数据转换是可逆的,只要数据表中的数据仍然保留着,就可以点击 “一键恢复蓝图元素转换”,将其恢复到之前的状态。
数据存储在数据表格中。您可以右键单击数据表,将其导出为 CSV 文件进行备份。

三、高级使用教程
你可以选择多个蓝图,右键点击它们,然后选择 “一键导出选择的蓝图元素” ,这种方法效率更高。另外,选中 “Export CSV File” 选项,将 CSV 文件交给 AI 翻译器或使用翻译软件进行批量翻译。

之后将 CSV 文件导入到数据表中,就可以使用脚本执行数据转换。

使用脚本导出数据将覆盖表中的数据,所以建议备份重要的 CSV 文件。
你可以设置自己喜欢的分隔符和全局关键字设置为忽略导出。

批量修改所选的蓝图的所有注释框颜色、字体大小、气泡显示等等。

至于文件重命名,可以在一开始或者最后才操作,因为蓝图元素是根据路径获取蓝图,文件重命名之后路径名全都改变了,会导致加载不到蓝图。这里的文件类型没有设限,所有文件类型都可以重命名。

四、注意事项
导出的 CSV 默认为Windows风格的换行符(CRLF,即\r\n),经过中文转换测试,CSV 文件导入到数据表格前,你要确保 CSV 文件编码为 UTF-8(无BOM),换行符为Windows风格(CRLF),否则数据转换时识别不了换行符,文本过长从而导致UE编辑器崩溃。
若用 WPS 编辑,请另存为UTF-8编码,因为这样不会出现中文乱码,但是其导出编码为UTF-8 with BOM,换行符为 LF,所以还需要用专业文本编辑器(如VS Code)打开 CSV 文件,查看右下角的编码和换行符标识,将编码更改为为UTF-8,换行符更改为CRLF,保存之后再导入到数据表格。
核心是确保两个关键点:
- 编码为 UTF-8(无BOM);
- 换行符为 Windows风格(CRLF),与UE5导出时的格式一致。
五、更新和维护
- v2025.10.31
- 支持批量重命名文件。
- 支持对蓝图变量、变量类别以及变量描述进行批量重命名。
- 支持对蓝图中的局部变量、局部变量类别以及局部变量描述进行批量重命名。
- 支持对蓝图自定义事件和图表进行批量重命名。
- 支持对蓝图函数、函数类别以及函数描述进行批量重命名。
- 支持对蓝图宏、宏类别以及宏描述进行批量重命名操作。
- 支持对蓝图注释文本、注释字体大小、注释框颜色等进行批量修改。
- 提供了 61 个 C++ 构建蓝图函数。
