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.
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
Beacon 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.