16 releases (7 breaking)
0.8.1 | Jul 5, 2024 |
---|---|
0.7.2 | Jun 10, 2024 |
0.4.0 | Mar 11, 2024 |
#899 in Game dev
154 downloads per month
40KB
429 lines
Bevy RTS Camera
Summary
Bevy RTS Camera provides an RTS-style camera for Bevy Engine, to get your game up and running quickly. Designed for simple use cases, and does not try to cover advanced requirements.
Features:
- Pan, zoom, and rotation
- Automatically follows whatever you mark as 'ground'
- Smoothed movement
- Customisable controls and other settings
- Comes with optional controller, or you can control it yourself
Default Controller
A default controller is included with these default controls:
- Arrow Keys: pan
- Mouse Wheel: zoom
- Middle Mouse: rotate
You can also 'edge pan' by moving the mouse to the edge of the screen.
Quick Start
Add the plugin:
.add_plugins(RtsCameraPlugin)
Add RtsCamera
to a camera:
commands.spawn((
Camera3dBundle::default(),
RtsCamera::default(),
RtsCameraControls::default(), // Optional
));
Add Ground
to your ground/terrain entities:
commands.spawn((
PbrBundle {
mesh: meshes.add(Plane3d::default().mesh().size(80.0, 80.0)),
..default()
},
Ground,
));
This will set up a camera at world origin with good defaults based on a roughly realistic scale (where an average human is 1.75 units tall).
Check out the advanced example to see the possible configuration options.
Version Compatibility
bevy | bevy_rts_camera |
---|---|
0.13 | 0.1-0.7 |
License
All code in this repository is dual-licensed under either:
- MIT License (LICENSE-MIT or http://opensource.org/licenses/MIT)
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
at your option. This means you can select the license you prefer! This dual-licensing approach is the de-facto standard in the Rust ecosystem and there are very good reasons to include both.
Dependencies
~35–72MB
~1.5M SLoC