《使用 UnrealEnginPython 插件进行UE4中的Python开发》学习笔记6

本文为B站系列教学视频《使用 UnrealEnginPython 插件进行UE4中的Python开发》——《Day 06 使用编译版插件在游戏打包后对内容进行修改》的学习笔记，UP主为腾讯游戏策划、虚幻社区贡献者 世欺子。

---

---

本节课将对在虚幻引擎中如何在 Windows（64位）上打包运行使用了

UnrealEnginPython

编译版的工程项目进行讲解，然后在实 *** 中尝试打包一个使用

UnrealEnginePython

编译版并且在游戏运行时（Runtime）调用了

Python

脚本的工程项目。

---

6.1 注意事项

在Windows（64位）上打包运行

UnrealEnginPython

编译版编写的项目需要注意以下几点：

1. 为工程项目配置好

   UnrealEnginePython

   编译版插件（参见《使用 UnrealEnginPython 插件进行UE4中的Python开发》学习笔记5 )。
2. 确保

   Content/Scripts/ue_site.py

   文件位于工程项目中（可以是空文件)。
3. 确保

   Scripts

   文件夹在 要复制的额外非自产目录（

   UE4

   是

   Additional Non-Asset Directories to Copy

   ）索引数组中，可以在 项目设置 的 打包（

   Packaging

   ） 选项卡中进行设置
4. 确保在项目打包完成后，将对应发行版

   Python

   拷贝至打包后的项目目录

   Binaries\Win64

   下。

---

6.2 尝试打包一个项目

笔者以《使用 UnrealEnginPython 插件进行UE4中的Python开发》学习笔记4 中的项目为例，在Windows（64位）上打包该项目。

1. 打开

   Python Editor

   ，新建空白脚本

   ue_site

   。
   

2. 在编辑主界面窗口上选择“编辑”，点击 项目设置 ，在 打包（

   Packaging

   ） 选项卡下取消 “使用pak文件” 选项勾选，这样我们打包的项目就不会生成压缩文件，以便于后续验证项目打包完成之后依然可以修改。
   

3. 展开 要复制的额外非自产目录选项（

   UE4

   中是

   Additional Non-Asset Directories To Package

   选项），然后在 “0组元素” 右边点击 “＋” 号添加元素，可以看到出现一个新选项 “索引0”，点击 “ ⋯ \cdots ⋯”选择目录，选择工程目录 “

   UEPython_Tutorial\Content

   ” 下的

   Scripts

   文件夹。

   要复制的额外非自产目录（Directories to Always Staqe as Non UFS）：其中包含打包项目时应固定被复制、但不作为.pak文件一部分的文件。这用于传输手动加载的额外文件，而不使用UFS（虚幻文件系统文件）IP API（如执行其自身内部文件的第三方库），注意这些路径相对于用户的项目内容目录。

   

4. 在 “地图和模式” 中将 “编辑器开始地图”（Editor Startup Map）和 “游戏默认地图”（Game Default Map）都更改为 NewMap。“编辑器开始地图”（Editor Startup Map）表示当编辑器启动时打开的地图，“游戏默认地图”（Game Default Map）表示项目打包后游戏默认加载的地图。
   

5. 在工具栏中选择 “平台”，接着选择 “Windows”，点击 “打包项目”，出现 “SDK未设置” 错误提示 “Windows的SDK未正常安装，而其是生成数据的必需项。请检查主工具栏中“启动”菜单的SDK部分来更新SDK”，解决办法参见《UE5打包SDK未正确安装的问题》。
   
   

6. 问题解决后，重新尝试打包项目，可以看到 “

   Windows

   ” 选项前的图标发生了变化，并且可以看到 “

   SDK管理

   ” 中显示了安装好的

   SDK

   版本信息至工程目录。点击“打包项目”，选择目录为工程目录 “

   UEPython_Tutorial

   ”。
   
   
   
   如果打包失败，出现错误提示 “

   ERROR: No target name was specified on the command-line.

   ”，原因可能是因为

   C++

   项目名称不合法，比如项目名称为

   Test

   ，或者出现了 “

   %-！

   ” 等特殊字符以及中文。

7. 打包完成后，可以看到在项目 “

   UEPython_Tutorial

   ” 目录下生成了一个

   Windows

   文件夹，该文件夹中包含

   UEPython_Tutorial.exe

   程序，点击执行，可以看到游戏成功运行且 “兔子梯”（

   10

   层）成功出现。
   
   
   

8. 尝试修改

   UEPython_Tutorial\Windows\UEPython_Tutorial\Content\Scripts

   的

   Python

   脚本

   tutorial_using_bp_custom_functions.py

   ，将 “兔子梯” 的层数由 10 层 改为 5 层，验证项目打包后还能否对项目进行修改。
   

9. 重新执行

   UEPython_Tutorial.exe

   程序， “兔子梯” 的层数成功变成了 5 层，这说明使用了

   UnrealEnginePython

   插件的项目打包后还可以直接通过修改

   Python

   脚本从而实现对项目的修改。
   

---

完结，★,°:.☆(￣▽￣)/$:.°★ ，撒花。