/bevy_mod_raycast

Unofficial plugin for raycasting in Bevy

Primary LanguageRustMIT LicenseMIT

Ray Casting for Bevy

CI crates.io docs.rs Bevy tracking

A Bevy plugin for 3D ray casting against meshes. Used to build bevy_mod_picking. Contributions welcome!

ezgif-2-69b8dc941be6

Uses

This plugin makes it simple to create ray casting sources, such as a transform (first person, third person shooter), or screenspace coordinates (mouse picking). Rays are shot from these sources every frame using a bevy system, and the intersections are stored in the ray casting source's component.

  • Only meshes that you mark with a component will be checked for intersections.
  • You can define which ray casting source(s) should interact with which mesh(es) by marking grouped sources and targets with the same type.
  • This plugin also provides some functionality to compute the intersection of rays with primitive shapes.
  • Rudimentary acceleration is provided with opt-in bounding spheres.

Bevy Version Support

I intend to track the main branch of Bevy. PRs supporting this are welcome!

bevy bevy_mod_raycst
0.5 0.2
0.4 0.1

Examples

Mouse picking using a ray cast built using screen space coordinates:

cargo run --example mouse_picking

Ray casting from a camera using ray casts from the camera entity's GlobalTransform:

cargo run --example minimal

Optimization Mouse picking over many meshes using bounding volumes:

cargo run --example bounding_volume

Optimization Mouse picking over complicated mesh using simplified mesh:

cargo run --example simplified_mesh