Skip to content

Tonetfal/CommonUIInputExtension

Repository files navigation

Common UI Input Extensions

This plugin exposes some common UI input related functions to blueprints allowing to easily bind either common UI input actions or Enhanced Input Input Actions to common user widgets.

Installation

Clone the repository in your project's Plugin directory.

Usage

If you want to bind and manage your UI inputs using common UI efficiently, you can do the following:

Docs/cuiiext_commonuiexample.png

Enhanced Input counterpart:

Docs/cuiiext_enhancedinputexample.png

If you want to have the original input action event, you need to mark it as not generic.

Generic actions will fire only one delegate at a time, whereas non-generic actions fire any amount of IA events you have active and reachable.

Docs/cuiiext_generic_actions_01.png


Docs/cuiiext_generic_actions_02.png


Docs/cuiiext_generic_actions_03.png

Generic notes

  • To allow common UI action router to work, set GameViewportClientClass to CommonGameViewportClient.
  • When using non-persistant input actions, ensure that there is a parent activatable widget relatively to the input binding target at any level. Also ensure that the widget is active; if it isn't the inputs are ignored by it.
  • Don't forget to unregister bindings when the widget is not used anymore; this is specifically important to persistent inputs.

Notes for Enhanced Input version

  • Common UI and Enhanced Input documentation
  • Make sure to bind IMC containing your input actions to get them firing. You can either do it manually or through common activatable widget's details panel; ensure that you have enhanced input support enabled to see the property.
  • Don't specify same IMC for both UI and game as the activatable widget will unregister it once deactivated.

About

Expose some common UI input related functions to blueprints

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published