This documentation is for a prerelease version of O3DE. Click here to switch to the latest release, or select a version from the dropdown.

Version:

Icon of a magnifying glass.
  Edit on GitHub

IN THIS ARTICLE

Debugger Configuration

In PhysX Configuration, you can specify how to interact with PhysX Visual Debugger (PVD). PhysX Visual Debugger is a third-party application that records your PhysX data from O3DE Editor. You can then review this data to see how your physics effects appear.

For more information, see NVIDIA PhysX Visual Debugger documentation.

Install PhysX Visual Debugger

  1. To get started, download PhysX Visual Debugger.

    Note:
    You must have a NVIDIA account to download PhysX Visual Debugger. If you don’t already have an account, create and sign in to your account.

  2. Follow the installation steps.

  3. After you install the application, open PhysX Visual Debugger. This application must be running if you want to record data from O3DE Editor.

  4. In O3DE Editor, open a level or create one that has entities with PhysX components. For example, you can create a simple dynamic entity that responds to gravity.

Configure PhysX Debugger in O3DE

  1. In O3DE Editor, choose Tools, PhysX Configuration.

  2. Click the Debugger tab.

  3. You can specify the following settings.

    PhysX Visual Debugger settings.

  4. To verify that PhysX Visual Debugger is connected to O3DE, for PVD Auto Connect, choose Game or Editor and then enter game or editor mode. Depending on what you choose, the following message appears in the Editor Console.

    (PhysX) - Successfully connected to PhysX Visual Debugger.

  5. Open PhysX Visual Debugger to view the recorded information.

    Example:

    Review the recorded data from O3DE Editor in PhysX Visual Debugger.

  6. You can also manually connect or disconnect from PhysX Visual Debugger using the following console variable commands.

    physx_PvdConnect

    physx_PvdDisconnect

    For more information, see Debugging PhysX.