Skip to content

FAQ

Which engine versions are supported?

The guides use Unreal Engine 5.8. See Compatibility for the guide and demo environments and where to check the Fab package for your engine.

Where do I get UnrealPy?

UnrealPy is a paid plugin distributed through Fab. Once you have it in your Fab Library, follow the installation guide.

Which Python version?

Always the engine's (3.11 on UE 5.8). UnrealPy refuses to load a virtual environment made for another version.

Can I use pip packages?

Yes. Close Unreal Editor, add the packages your game uses to [project].dependencies in pyproject.toml, then reopen the project so UnrealPy can sync the environment. Keep NumPy within >=2.0.0,<3. See Packaging for shipping dependencies.

Can I use it with existing Blueprints and C++?

Yes. Python can call reflected Blueprint and C++ functions and use exposed properties. Use ue.uproperty and @ue.ufunction to expose members of Python classes to Unreal. See Blueprints.

Why are Python-only fields not visible in the editor?

Only ue.uproperty(...) fields are Unreal properties. A plain annotation stays Python-only on purpose.

Does it work in packaged games?

Yes. Packaged games run UnrealPy's own interpreter with a staged runtime environment. See Packaging.

Does hot reload keep my state?

Python state and Unreal properties of live instances are kept in the editor. See Hot reload.

Why does the editor start slowly after I edit a class?

UnrealPy may need to rebuild the class cache so saved levels and Blueprints can find their Python classes when the editor opens. If it rebuilds on every launch, check the troubleshooting steps.

Can I derive a script class from a Blueprint?

No. A @ue.uclass cannot derive from a Blueprint class. Bind a @ue.script to the Blueprint instead.

How do I debug Python?

UnrealPy's documented editor workflow uses Python tracebacks in the Output Log. The plugin does not include a dedicated IDE debugger integration. See Debugging for logging and common editor problems.

Where do I report a bug?

See Support.