Skip to content

Unreal Engine 5.8 · Python 3.11

Write Unreal gameplay in Python.

Build gameplay systems in Python with Unreal’s reflected API. See changes on save, give designers controls in the editor, and ship the same scripts in your game.

UnrealPy is a paid plugin distributed through Fab.

Python/scripts/beacon.py Python
import ue


@ue.uclass
class Beacon(ue.Actor):
    message: str = ue.uproperty(
        "Beacon is online",
        category="Beacon",
    )

    def begin_play(self) -> None:
        ue.log(self.message)

    @ue.ufunction(pure=True, category="Beacon")
    def get_message(self) -> str:
        return self.message
Unreal Output LogBeacon is online

A placeable actor with an editable property and a Blueprint callable function. Create an actor in the editor →

Why UnrealPy?

Iterate on save

Edit a gameplay script and try the change in Unreal Editor. Hot reload updates live instances and preserves their property values.

Build together in Unreal

Programmers can write reusable actors and components. Designers can place them, tune values in Details, and call their functions from Blueprint graphs.

Use the Python ecosystem

Bring Python packages into gameplay and editor tools, from NumPy for math and data processing to compatible libraries for machine learning and AI.

Work with coding agents

Give an agent the Python module, generated Unreal type hints, and tests for the feature it needs to change. That can keep prompts smaller and shorten the edit-and-test loop.

From first script to packaged game

Follow a guide or jump to the part of UnrealPy you need.

Doom on UnrealPy

Explore a full example project with Python gameplay, procedural levels, and multiplayer over Unreal networking. Run it with the free Freedoom data set.

Explore the demo project

Keep the reference close