PyCharm与Unreal Engine集成进行开发

以下是将PyCharm与Unreal Engine集成的详细方案，结合开发流程和实战案例，帮助您高效完成Python脚本开发与调试：

一、环境配置与工具链搭建

1. 基础环境准备

• Unreal Engine版本：推荐使用UE5.1及以上（Python API更完善）
• Python解释器：
  • 路径：{UE_Install_Path}/Engine/Binaries/ThirdParty/Python/Win64/Python.exe
  • 版本：UE5默认使用Python 3.9（需与PyCharm解释器版本一致）
• PyCharm配置：

  # 项目结构示例
  ProjectRoot/
  ├── PythonScripts/         # 存放Python脚本
  ├── Plugins/
  │   └── UnrealEnginePython # UnrealEnginePython插件目录
  └── .env                   # 环境变量配置
  

2. 插件安装与启用

• UnrealEnginePython插件：
  1. 克隆仓库：git clone https://github.com/20tab/UnrealEnginePython.git
  2. 移动到项目目录：{ProjectRoot}/Plugins/UnrealEnginePython
  3. 启用插件：在UE编辑器中进入Edit > Plugins > Scripting，勾选UnrealEnginePython
• Python Editor Script插件：
  1. 在UE编辑器中启用Python Editor Script Plugin
  2. 生成API文件：Generate Python API（路径：{ProjectRoot}/Intermediate/Python）

3. PyCharm配置

1. 解释器设置：
   • 选择UE内置Python：File > Settings > Project > Python Interpreter
   • 添加搜索路径：

     # 右键项目根目录 > Mark Directory as > Sources Root
     {
            
            ProjectRoot}/PythonScripts
     {
            
            UE_Install_Path}/Engine/Plugins/Marketplace/UnrealEnginePython/Content/Scripts
     

2. 虚拟环境：

   # 创建虚拟环境（推荐使用conda）
   conda create -n ue_python python=3.9
   conda activate ue_python
   

3. 安装依赖：

   pip install pydevd pyyaml unreal-engine
   

二、核心功能开发与调试

1. 脚本开发流程

# PythonScripts/LevelGenerator.py
import unreal

def generate_level():
    # 创建地形
    terrain = unreal.TerrainSubsystem.get_terrain_subsystem().create_terrain("MyTerrain")
    terrain.set_landscape_size(1024