Known issues and limitations
Editor-only feature not for runtime builds
The Python Scripting package is a feature designed to work only in the Unity Editor. It isn't available in runtime builds.
Script editor window output limitation
The Python Script Editor output section (top section) has a limit of 10,000 characters.
Python for .NET with Unity limitations
When you access the Unity API in Python it is not actual bindings of our C# API. This is possible thanks to Python for .NET that allows you to call the functionnalities of any loaded C# assemblies in Python dirrectly. This can sometimes cause unexpected issues due to Python for .NET limitations regarding Unity's usage of C#.
For example it is currently recommended to use list comprehension to convert Unity C# list-type data structure to python list instead of a simple cast:
myPythonList = list(Selection.activeGameObjects): this can cause Unity to close unexpectedlymyPythonList = [gameObject for gameObject in Selection.activeGameObjects]: this is OK
Project settings limitations
- You cannot change the internal Python version
- You cannot use a virtual environment manager like
venvorconda. - Paths are treated as verbatim strings. You need to expand environment variables or use the
~(on macOS and linux) denoting the home directory.
PySide and Apple Silicon
PySide2 Python package is not compatible with Apple Silicon. This affects the sample "PySide Camera Selector" that is currently not usable on any Apple computer with an Apple Silicon processor.
Workaround: You can use PySide6, PyQt5, or PyQt6 Python package instead of PySide2. However, this might require small changes in the sample to make it work.