# Ray Casting for Bevy
[](https://github.com/aevyrie/bevy_mod_raycast/actions?query=workflow%3A%22CI%22+branch%3Amaster)
[](https://crates.io/crates/bevy_mod_raycast)
[](https://docs.rs/bevy_mod_raycast)
[](https://github.com/bevyengine/bevy/blob/main/docs/plugins_guidelines.md#main-branch-tracking)
A [Bevy](https://github.com/bevyengine/bevy) plugin for 3D ray casting against meshes. Used to build [`bevy_mod_picking`](https://github.com/aevyrie/bevy_mod_picking). Contributions welcome!
## 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.
- Acceleration is provided using Bevy's AABBs and visibility culling.
## Bevy Version Support
I intend to track the `main` branch of Bevy. PRs supporting this are welcome!
|0.6|0.3|
|0.5|0.2|
|0.4|0.1|
## Examples
Mouse picking using a ray cast built using screen space coordinates:
```shell
cargo run --example mouse_picking
```
Ray casting from a camera using ray casts from the camera entity's GlobalTransform:
```shell
cargo run --example minimal
```
*Optimization* Mouse picking over many meshes using AABBs:
```shell
cargo run --example bounding_volume
```
*Optimization* Mouse picking over complicated mesh using simplified mesh for the raycasting:
```shell
cargo run --example simplified_mesh
```