Create global or localized wind forces with PhysX

You can create global wind forces or wind forces contained within a collider volume with the PhysX Force Region component. Wind forces act on entities with components that can be affected by wind. The following components can be affected by wind:

Note that the PhysX Rigid Body component is not affected by wind, but is affected by forces from a PhysX Force Region component.

Example wind provider setup

  1. Create an entity for the wind provider.

  2. Add a Tag component to the entity. The Tag component will specify whether the wind force is global or localized to a collider volume.

  3. Specify whether the wind provider will be global or localized. To determine what value to use for the tag component, from the File menu, choose PhysX Configuration. At the bottom of the Global Configuration tab there is a section labeled Wind Configuration.

    PhysX Wind Configuration

    Wind Configuration has properties for a Global wind tag and a Local wind tag. You may use the default values or set them as desired. These tags are used by the PhysX wind system to detect entities that provide wind data.

    For this example use the Global wind tag property value. In the Tag component of the entity, add a tag element and give it the value global_wind.

    If you choose to use the Local wind tag, the wind will only affect entities that are inside the volume of the PhysX Collider you create in the next step.

  4. Add a PhysX Collider component. If you are using the Local wind tag, this collider will define the volume of the wind force. With the Global wind tag, the size and position of this collider does not matter because the wind will be global, however, the collider will provide a useful visualization for the global wind force.

  5. Set the PhysX Collider component’s Shape property to Box.

  6. Scale and position the PhysX Collider component. Use the move tool to place the entity in the level, and set the Box Dimensions property in the PhysX Collider component as desired.

  7. Add a PhysX Force Region component to the entity. The PhysX Force Region component creates the wind force.

  8. In the PhysX Force Region component, specify 10.0 in the Direction property’s Y component to set a direction for the wind force.

  9. In the PhysX Force Region component, specify 50.0 in the Magnitude property to create magnitude for the wind force.

    The PhysX collider box in Perspective displays cones and vectors representative of the wind force direction.

    PhysX Wind entity setup

  10. To test the wind provider, add an entity with a Cloth mesh. There is an example slice asset you can drag into Perspective from Asset Browser. Navigate to Gems\NvCloth\Assets\slices in Asset Browser. Locate the cloth_locked_corners_two.slice and drag and drop the slice into Perspective.

  11. Use the Move tool to place the cloth entity. If you are using the Local wind tag, you must place the cloth asset inside the PhysX Collider volume.

    PhysX Wind entity setup

  12. Press Control + G to test the wind simulation.

    PhysX Wind entity test

Copyright © 2022 Open 3D Engine Contributors

Documentation Distributed under CC BY 4.0.
For our trademark, privacy and antitrust policies, code of conduct, and terms of use, please click the applicable link below or see

The Linux Foundation has registered trademarks and uses trademarks. For a list of trademarks of The Linux Foundation, please see our Trademark Policy page.