1 unstable release

0.20.0 Jul 9, 2024

#2290 in Game dev

Download history 143/week @ 2024-07-08 18/week @ 2024-07-15 36/week @ 2024-07-22 4/week @ 2024-07-29 32/week @ 2024-08-05 14/week @ 2024-08-12 14/week @ 2024-08-26

61 downloads per month
Used in bevy_mod_picking

MIT/Apache

75KB
1.5K SLoC

A raycasting backend for bevy_mod_picking that uses Avian for raycasting.

Usage

Pointers will automatically shoot rays into the Avian scene and pick entities.

To ignore an entity, you can add Pickable::IGNORE to it, and it will be ignored during raycasting.

For fine-grained control, see the AvianBackendSettings::require_markers setting.

Limitations

Because raycasting is expensive, only the closest intersection will be reported. This means that unlike some UI, you cannot hover multiple Avian objects with a single pointer by configuring the Pickable component to not block lower elements but still emit events. As mentioned above, all that is supported is completely ignoring an entity with Pickable::IGNORE.

This is probably not a meaningful limitation, as the feature is usually only used in UI where you might want a pointer to be able to pick multiple elements that are on top of each other. If are trying to build a UI out of Avian entities, beware, I suppose.

Dependencies

~36–73MB
~1.5M SLoC