An easy plug-n-play multifunctional camera that allows for easy setup of a camera for a scene.
Add a few lines of code to your existing project allows you to test a wide variety of cameras by attaching it to your player entity or the default spaceship entity.
Inspired and extended on bevy_flycam, this plugin is fairly simple but should be a neat help for developers looking for a camera implementation without going the hassle of reinventing the wheel.
Before I start using a plugin, I all ways like to run the examples prior to setting it up for my own project. Just to see if the plugin satisfy my needs. If you're like me then this is for you.
cd bevy_config_cam)cargo run --release --example simple)Adding this plugin to your project is very simple, it only requires you to write 2 lines of code.
Add the correct version to your Cargo.toml, you can find the version you looking for under the support section. The thing you should be adding should look like this (only add the line marked by # <--):
```toml
[dependencies]
bevy = { version = "0.5"}
bevyconfigcam = { version = "0.1.1"} # <-- ```
rust
fn main() {
App::build()
.insert_resource(Msaa { samples: 4 })
.add_plugins(DefaultPlugins)
.add_plugin(ConfigCam) // <--
// ...
// Your other plugins and game code here
// ...
.run();
}
Now, there is a reason for the name bevy_config_cam. It is most likely that you want something more than just the default behavior. You might want to toggle between 2 types of cameras or allow the user to change the fov using a slider. Currently I haven't gotten far with creating a user-friendly api you can access but is something I will look into. For now you can insert two recourses to override the default behavior of the plugin, as seen in the example:
rust
.insert_resource(MovementSettings {
sensitivity: 0.00015, // default: 0.00012
speed: 15.0, // default: 12.0
dist: 5.0, // Camera distance from the player in topdown view
..Default::default()
})
.insert_resource(PlayerSettings {
pos: Vec3::new(2., 0., 0.),//Initial position of the player
player_asset: "models/craft_speederA.glb#Scene0", //Model of the player, default is a red cube
..Default::default()
})
Note: That some of them are overwritten by accessing the settings or the changing the camera type. Feedback on this is high appreciated, just create a new issue and I'll look into it when I have the time.
|bevy|bevy_multicam| |---|---| |0.5|0.1.X|
The project is under dual license MIT and ISC (functionally equivalent, though ISC removing some language that is no longer necessary), so joink to your hearts content, just remember the license agreements.
Yes this project is still very much WIP, so PRs are very welcome
