Bevy Input Map

Decouples gameplay code from device specific input api. Converts user inputs from different input hardware into game specific actions, eg. keyboard "Space" or joystick "A" can be mapped to "Jump" Action.

Usage

Add to Cargo.toml dependencies [dependencies] bevy_prototype_input_map = "0.1"

In code ```rust fn main() { App::build() .addplugin(InputMapPlugin::default()) .addstartupsystem(setup.system()) .addsystem(system.system()) .run(); }

fn setup( mut inputmap: ResMut, ) { inputmap .bindkeyboardpressed(KeyCode::Return, "SHOOT") .bindmousemotion(Axis::YNegative, "AIMUP") .setdeadzone("AIMUP", 0.1) }

// system fn system(inputmap: Res) { if inputmap.isactionactive("SHOOT") { println!("Bang..."); } ```

*Check out examples

Example

Use commands

Via Code

cargo run --example keyboardmousewith_code

cargo run --example gamepadwithcode

Via JSON/RON

cargo run --example keyboardmousewith_json

cargo run --example gamepadwithron

For Action Events Usage

cargo run --example withactionevents

Features

• new* Joystick Support: Button & Analog Input
• Event Phase: Ability to set at which event phase an action is active
• Action Events: OnActionBegin, OnActionProgress, OnActionEnd
• Binding Stack: Ability to Push, Additive Push and Pop bindings
• JSON/RON Support: Ability to use serialised string to setup bindings
• Support to set custom strength curve function
• Keyboard Key Mapping
• Mouse Button Mapping
• Mouse Move Mapping
• Action Strength
• Action Deadzone

Repo

https://github.com/PradeepKumarRajamanickam/bevyinputmap/

Note* Latest commit on master branch might be unstable. Use the release tags if you are looking for stable commits or grab crate from crate.io

Bug Report

https://github.com/PradeepKumarRajamanickam/bevyinputmap/issues

Release Notes

v0.1.5 (18 Nov, 2020)

• Joystick Support
• Improved Documentations

v0.1.4 (03 Oct, 2020)

• Event Phase
• Action Events

v0.1.3 (18 Sept, 2020)

• Binding Stack
• JSON & RON Support

v0.1.2 (14 Sept, 2020)

• New API
• Ability to set custom strength curve

v0.1.1 (7 Sept, 2020)

• minor* Readme changes
  • Had to bump the version to publish some readme changes

v0.1.0 (7 Sept, 2020)

• Keyboard Key Mapping
  • Key press can now be binded to action
• Mouse Button Mapping
  • Mouse button press can now be binded to action
• Mouse Move Mapping
  • Mouse move event can now be mapped to action
• Action Strength
  • Can now query strength of an action.
  • It will be in range of 0.0 - 1.0
  • Useful for analog inputs like joystick
• Action Deadzone
  • For analog inputs sometimes it is meaningful to have a min threshold to avoid small input noise and to reduce sensitivity

Author

Pradeep Kumar Rajamanickam

Acknowledgments

Inspired by - Godot Input Mapper [https://godotengine.org/article/handling-axis-godot] - Unreal Action/Axis Mapping [https://docs.unrealengine.com/en-US/Gameplay/Input/index.html]