Python Automation in Unreal Engine: A Starter Guide to Editor Workflows

What will you learn in this guide?

You’ll learn how to enable Python in Unreal Editor, run a simple script, and choose the automation method that best suits your needs. Epic Games’ documentation marks Python support as experimental and recommends caution, especially when shipping products. The use cases covered here are therefore focused on production and content-management tasks inside the editor, not gameplay code that runs while a game is playing.

Python can serve as a shared scripting language for production pipelines that connect different 3D applications. In Unreal Editor, it can also be used to automate asset-management workflows, handle time-consuming tasks such as generating LODs for Static Meshes, place level content procedurally, and create editor-specific interfaces. These are use cases listed in the documentation; they don’t mean a ready-made automation solution is available for every project.

Requirements and project setup

Python features are provided through the Python Editor Script Plugin in Unreal Editor. The plugin must be enabled for each project; enabling it in one project does not automatically enable it in others. Epic Games also recommends enabling the Editor Scripting Utilities plugin, which provides simplified APIs for common editor tasks.

The editor uses the bundled Python 3.11.8 that comes with the plugin. So you don’t need to install Python separately just to run scripts in Unreal Editor. If you want to embed a different Python version, you’ll need to set the UE_PYTHON_DIR environment variable on your operating system and rebuild Unreal Engine from source; this isn’t a required step to get started.

Step by step: Enable Python and run your first script

1. Open the Unreal project you want to use. From the main menu, go to Edit > Plugins.

2. Find the Scripting section in the Plugins window and enable Python Editor Script Plugin. Following Epic Games’ recommendation, you can also enable Editor Scripting Utilities.

3. Restart Unreal Editor. Enabling the plugin alone isn’t enough; you need to restart before running scripts.

4. For your first test, open the Output Log panel and switch the console input to Python mode. You can also open the console with the backtick () key. Python lines entered in this mode run immediately; use **Shift + Enter** for multiple lines. print` output is also displayed in the Output Log panel.

5. To run a script from a file, use File > Execute Python Script in the main menu and select the script on your computer. You can rerun previously executed files from the Recent Python scripts list. The list reads the script’s current contents from the file.

You can also run a Python line or file using the py command while the console is in its normal command mode. The file example from the documentation is:

py "C:\MyScripts\my_script.py"

Replace the path in this example with the location of the script you want to run. If the script expects additional command-line arguments, you can provide them after the file name.

Automating repetitive tasks

There are two main ways to run a script every time a project opens. In the project-specific Project Settings, you can add scripts under Plugins > Python in the Startup scripts setting. Unreal Editor runs these scripts after the default startup level has fully loaded. Restart the editor after making changes; the scripts will run the next time you open the project.

Another option is to place a file named init_unreal.py in the Content/Python folder of a project or plugin. If the editor finds a script with this name in one of the configured paths, it runs it automatically. Epic Games describes this approach for situations where people working with the same content need to run shared startup code every time the editor launches.

The command line offers options for repeatable operations or running without opening the interface. The full editor method loads the project and default startup level before running the script; according to the documentation, both relevant plugins must be enabled in the project for this method. The commandlet method can run headlessly and is faster. However, it doesn’t load levels automatically, so you’ll need to handle loading separately if the script requires level content. With either command-line approach, Unreal Editor closes after the script runs.

Teams using Blueprints can also use Python execution nodes, but these nodes are only available in editor-specific classes such as Editor Utility Widget and Editor Utility Blueprint. The documentation recommends the Execute Python Script node for calling Python from a Blueprint. Its inputs can be read before the script runs, and its outputs can be set after execution. You can check the success status through the Return Value output; error details appear in the Output Log. This node executes Python lines, not a file.

Common issues and limitations

The most important distinction is between editor automation and runtime. The Python environment is available in Unreal Editor, but not in Play In Editor (PIE), Standalone Game, or packaged executables. Python should therefore not be treated as a gameplay scripting language.

Another common issue is enabling the plugin in a different project. Each project requires its own activation and a restart. It’s also easy to assume that scripts run with commandlets will load levels automatically, which can lead to errors. If a script fails in a Blueprint node, check the Output Log for the error message.

Next steps: Architecture and visualization workflows

For architecture, interior design, and archviz teams, Python has the potential to reduce repetitive content-management tasks in Unreal Editor and connect production workflows that involve different 3D applications. For example, automating a team’s asset-management steps or level-content placement aligns with the use cases described in the documentation. This doesn’t guarantee a specific BIM import or compatibility with a particular application; the integration needs to be designed around the project’s content.

Start with a small task that you can validate inside the editor, and try the script from the console or through Execute Python Script. Then, if you repeat the process often, move on to startup scripts or command-line execution. Include the warning that Python support is experimental, the project-specific plugin requirement, and its unavailability at runtime in your production plan. The Unreal Python 5.8 API documentation is a reference for exploring available API sections and types.

Sources and license

This guide is adapted into Turkish from Epic Games’ Scripting the Unreal Editor using Python guide and the Unreal Python 5.8 API Documentation page. Both sources are official Epic Games documentation.