Skip to content

Basic first-person fly camera for the Bevy game engine

License

Notifications You must be signed in to change notification settings

toolness/bevy_flycam

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

bevy_flycam

Crates.io Crates.io docs.rs

A basic first-person fly camera for Bevy 0.10

Controls

  • WASD to move horizontally
  • SPACE to ascend
  • LSHIFT to descend
  • ESC to grab/release cursor.

Comparison

There are a few notable differences from bevy_fly_camera...

  • No linear interpolation
  • Cursor grabbing
  • Shorter code
  • Single-line setup
  • A tiny bit faster?

Usage

  1. Add to Cargo.toml or copy lib.rs to your own file

    [dependencies]
    bevy = "0.10"
    bevy_flycam = "*"

    or

    [dependencies]
    bevy = "0.10"
    bevy_flycam = { git = "https://github.com/sburris0/bevy_flycam" }
  2. Include the prelude:

    use bevy_flycam::prelude::*;

    This will spawn a camera for you. Use NoCameraPlayerPlugin if you do not want this and make sure to use .insert(FlyCam) on your own camera or else this plugin won't know what to move.

  3. Add the PlayerPlugin:

    #[bevy_main]
    fn main() {
        App::new()
            .add_plugins(DefaultPlugins)
            .add_plugin(PlayerPlugin)
            .run();
    }

Alternatively you can see the example basic.rs or scroll.rs located in the examples folder. You can run the example by cloning this repository and run the command: cargo run --release --example basic

Customization

To modify player movement speed or mouse sensitivity add it as a resource.
Same thing goes for the keybindings used for moving the camera.

#[bevy_main]
fn main() {
    App::new()
        .add_plugins(DefaultPlugins)
        .add_plugin(PlayerPlugin)
        .insert_resource(MovementSettings {
            sensitivity: 0.00015, // default: 0.00012
            speed: 12.0, // default: 12.0
        })
        .insert_resource(KeyBindings {
            move_ascend: KeyCode::E,
            move_descend: KeyCode::Q,
            ..Default::default()
        })
        .run();
}

Support

Bevy tracking

bevy_flycam's crate version follows bevy's minor version as shown:

bevy bevy_flycam
0.10.1 0.10.1

Contributing

PRs are very welcome.

About

Basic first-person fly camera for the Bevy game engine

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Rust 100.0%