Skip to content

mattdeform/unreal_pycharm_debug

Repository files navigation

CI pytest linting: pylint Code style: black Checked with mypy


Unreal

Python Unreal

Unreal PyCharm Debug

An Unreal Engine plugin for connecting to a PyCharm debugger.

View Demo · Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Roadmap
  4. Contributing
  5. Contact
  6. Acknowledgments

About The Project

This is NOT an official JetBrains or Epic Games plugin.

Unreal

(back to top)

Getting Started

Prerequisites

(back to top)

Installation

  1. Select the Unreal Engine version required from the Releases page (installation instructions included on release page).
  2. Enable the Plugin in the Unreal "Plugin Settings" menu, and restart the editor.
    • Unreal
  3. In the level editor you should have a new menu named "PyCharm".
    • Unreal

(back to top)

Usage

  1. You can configure port number and debug egg file location (comes with PyCharm installation) by clicking on the PyCharm -> Configure menu.
    • Unreal
  2. Select desired port number, and click "Find installed" to find the systems installed PyCharm. Alternatively you can manually enter a path to a desired pydevd-pycharm.egg file.
    • Unreal
  3. In PyCharm, create a new Python Debug Server named Unreal, with the port number set in the previous step.
    • Unreal
  4. In PyCharm click the Unreal debug icon.
    • Unreal
  5. From the level editor click PyCharm -> Connect. This will freeze your Unreal session until the next step (or timeout)
    • Unreal
  6. Switch back over to PyCharm and click "Resume Program" or press F9
    • Unreal

PyCharm is now connected to Unreal, you can set break points in your code and interactively debug your Python tools, enjoy!

Note: Sometimes debug sessions can hang or become unstable. If this happens you can simply click the "Disconnect" button in Unreal and then start from step 4 again.

(back to top)

Roadmap

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

If you have a suggestion that would make this better, please open an issue from the request a feature or report a bug pages.

Development and contribution guidelines can be found on the CONTRIBUTING.md page

Contact

Please reach out via the request a feature or report a bug pages.

(back to top)

Acknowledgments

(back to top)