Struct leafwing_input_manager::plugin::InputManagerPlugin

pub struct InputManagerPlugin<A: Actionlike> { /* private fields */ }

A [Plugin] that collects Input from disparate sources, producing an ActionState that can be conveniently checked

This plugin needs to be passed in an Actionlike enum type that you’ve created for your game. Each variant represents a “virtual button” whose state is stored in an ActionState struct.

Each InputManagerBundle contains:

• an InputMap component, which stores an entity-specific mapping between the assorted input streams and an internal repesentation of “actions”
• an ActionState component, which stores the current input state for that entity in an source-agnostic fashion

If you have more than one distinct type of action (e.g. menu actions, camera actions and player actions), consider creating multiple Actionlike enums and adding a copy of this plugin for each Actionlike type.

Systems

All systems added by this plugin can be dynamically enabled and disabled by setting the value of the ToggleActions<A> resource is set. This can be useful when working with states to pause the game, navigate menus or so on.

WARNING: Theses systems run during [CoreStage::PreUpdate]. If you have systems that care about inputs and actions that also run during this stage, you must define an ordering between your systems or behavior will be very erratic. The stable labels for these systems are available under InputManagerSystem enum.

Complete list:

• tick_action_state, which resets the pressed and just_pressed fields of the ActionState each frame
  • labeled [InputManagerSystem::Reset]
• update_action_state, which collects Input resources to update the ActionState
  • labeled InputManagerSystem::Update
• update_action_state_from_interaction, for triggering actions from buttons
  • powers the ActionStateDriver component baseod on an Interaction component
  • labeled InputManagerSystem::Update
• release_on_disable, which resets action states when ToggleActions is flipped, to avoid persistent presses.

Implementations

impl<A: Actionlike> InputManagerPlugin<A>

pub fn server() -> Self

Creates a version of the plugin intended to run on the server

Inputs will not be processed; instead, ActionState should be copied directly from the state provided by the client, or constructed from ActionDiff event streams.

Trait Implementations

impl<A: Actionlike> Default for InputManagerPlugin<A>

fn default() -> Self

Returns the “default value” for a type.

impl<A: Actionlike> Plugin for InputManagerPlugin<A>

fn build(&self, app: &mut App)

Configures the [App] to which this plugin is added.

fn name(&self) -> &str

Configures a name for the [Plugin] which is primarily used for debugging.