https://github.com/totalkrill/bevy_mod_lookat
microplugin for bevy that syncs the rotation of entites towards a selected target
https://github.com/totalkrill/bevy_mod_lookat
Last synced: 10 months ago
JSON representation
microplugin for bevy that syncs the rotation of entites towards a selected target
- Host: GitHub
- URL: https://github.com/totalkrill/bevy_mod_lookat
- Owner: TotalKrill
- License: mit
- Created: 2024-08-08T13:37:11.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-11-30T12:19:45.000Z (over 1 year ago)
- Last Synced: 2025-03-21T01:51:00.078Z (over 1 year ago)
- Language: Rust
- Size: 3.87 MB
- Stars: 7
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# bevy_mod_lookat
[](https://crates.io/crates/bevy_mod_lookat)
[](https://docs.rs/bevy_mod_lookat)
[](https://opensource.org/licenses/MIT)
e
A Bevy Plugin and library to help with rotating an entity towards a target even through hierarchies
## Features
- Updates an entities rotation in the world towards another entity or target
| Bevy version | Crate version |
| ------------ | ------------- |
| 0.16 | 0.3-0.4 |
| 0.15 | 0.2 |
| 0.14 | 0.1 |
## Example
``` rust
//! A simple 3D scene with light shining over a cube sitting on a plane.
use bevy::{color::palettes::css::*, prelude::*, render::primitives::Aabb};
use bevy_mod_lookat::*;
fn main() {
App::new()
.add_plugins(DefaultPlugins)
.add_plugins(RotateTowardsPlugin::default())
.add_systems(Startup, setup)
.add_systems(Update, (mover, rotate).chain())
.add_systems(
PostUpdate,
(draw_axes, draw_forward).after(TransformSystem::TransformPropagate),
)
.run();
}
#[derive(Component)]
struct Move;
#[derive(Component)]
struct Rotate;
#[derive(Component)]
struct ShowAxes;
#[derive(Component)]
struct ShowForward;
fn draw_axes(mut gizmos: Gizmos, query: Query<(&GlobalTransform, &Aabb), With>) {
for (&transform, &aabb) in &query {
let t = transform.compute_transform();
let length = aabb.half_extents.length();
gizmos.axes(t, length);
}
}
fn draw_forward(mut gizmos: Gizmos, query: Query<&GlobalTransform, With>) {
for &transform in &query {
let t = transform.compute_transform();
gizmos.line(
t.translation,
t.translation + t.forward() * 6.0,
Color::BLACK,
);
}
}
fn rotate(mut query: Query<&mut Transform, With>, time: Res
let target_id = commands
.spawn((
Mesh3d(meshes.add(Cuboid::new(0.05, 0.05, 0.05))),
MeshMaterial3d(materials.add(Color::from(CRIMSON))),
Transform::from_xyz(1.0, 0.5, 1.0),
Move,
Rotate,
ShowAxes,
))
.id();
// cube
commands
.spawn((
Mesh3d(meshes.add(Cuboid::new(1.0, 1.0, 1.0))),
MeshMaterial3d(materials.add(Color::srgb_u8(124, 144, 255))),
Transform::from_xyz(3.5, 0.5, 0.0),
ShowAxes,
))
.with_children(|commands| {
commands
.spawn((
Mesh3d(meshes.add(Cuboid::new(0.5, 0.5, 0.5))),
MeshMaterial3d(materials.add(Color::srgb_u8(124, 100, 255))),
Transform::from_xyz(0.0, 0.5, 0.0),
Rotate,
ShowAxes,
))
.with_children(|parent| {
parent.spawn((
Mesh3d(meshes.add(Cuboid::new(0.3, 0.1, 2.0))),
MeshMaterial3d(materials.add(Color::from(GREEN))),
Transform::from_xyz(0.0, 0.7, 0.0),
RotateTo {
entity: target_id,
// this choses what the flat side should be in relation towards
updir: UpDirection::Parent,
},
ShowForward,
));
});
});
// light
commands.spawn((
PointLight {
shadows_enabled: true,
..default()
},
Transform::from_xyz(4.0, 8.0, 4.0),
));
// camera
commands.spawn((
Camera3d::default(),
Transform::from_xyz(-2.5, 4.5, 9.0).looking_at(Vec3::ZERO, Vec3::Y),
));
}
#[cfg(test)]
mod tests {
use super::*;
use test::bench::Bencher;
#[bench]
fn bench(b: &mut Bencher) {
let mut app = App::new();
app.add_plugins(MinimalPlugins);
let mut commands = app.world_mut().commands();
// circular base
commands.spawn(SpatialBundle {
transform: Transform::from_rotation(Quat::from_rotation_x(
-std::f32::consts::FRAC_PI_2,
)),
..default()
});
for i in 0..100 {
let target_id = commands
.spawn((
SpatialBundle {
transform: Transform::from_xyz(i as f32 * 1.0, 0.5, 1.0),
..default()
},
Move,
Rotate,
))
.id();
// cube
commands
.spawn((SpatialBundle {
transform: Transform::from_xyz(3.5, 0.5, i as f32 * 1.0),
..default()
},))
.with_children(|commands| {
commands
.spawn((
Rotate,
SpatialBundle {
transform: Transform::from_xyz(0.0, i as f32 * 0.5, 0.0),
..default()
},
))
.with_children(|parent| {
parent.spawn((
SpatialBundle {
transform: Transform::from_xyz(0.0, i as f32 * 0.7, 0.0),
..default()
},
RotateTo {
entity: target_id,
// this choses what the flat side should be in relation towards
updir: UpDirection::Parent,
},
ShowForward,
));
});
});
}
app.add_plugins(RotateTowardsPlugin)
.add_systems(Update, (mover, rotate));
// move past the Startup state
for i in 0..20 {
app.update();
}
b.iter(|| {
app.update();
});
}
}
```