Skip to content

Repository files navigation

UEVR Plugin mapping [A/B]ButtonTouch[Left/Right] and optionally ThumbrestTouch[Left/Right] OpenXR inputs to keyboard outputs

In UEVR the OpenXR Inputs AButtonTouchLeft, BButtonTouchLeft, AButtonTouchRight and BButtonTouchRight are normally unused. This plugin maps these inputs to keyboard-outputs (1, 2, 3 and 4), providing 4 more additional mappings.

Two additional variants are available for situations, where also the ThumbRestTouch inputs are not used (e.g. for DPad-shifting):

  1. Adding an additional mapping of ThumbrestTouchLeft to 5.
  2. Adding mappings for both ThumbrestTouchLeft and ThumbrestTouchRight to 5 and 6.

This plugin can be used with VR controllers, that:

  1. have additional possible inputs available (like e.g. the Trackpads of Index Controllers)
  2. have the ability to rebind mappings (like controllers using SteamVR)

The downside of the keyboard mapping is, that the game switches from gamepad to keyboard input and back. It is possible, that games do not allow this or have problems with it. But mainly the only side effect should be a quick switch of on-screen input-hints.

An additional feature of this plugin is, that a short haptic feedback is produced on every input.

Download

You can download the latest version from the release page.

The downloaded zip-file contains 3 DLLs:

  • uevr-touch-buttons-mapping-plugin.dll: Plugin without Thumbrest-mappings
  • uevr-touch-buttons-mapping-plugin-thumbrest-left.dll: Plugin with additional left Thumbrest-mapping.
  • uevr-touch-buttons-mapping-plugin-thumbrest-both.dll: Plugin with additional left and right Thumbrest-mappings.

Installation

You can install the plugin either globally to be active for all UEVR games, or only for a single games.

Global installation

  1. Go to UEVR's global directory by either clicking the Open Global Dir button in UEVR or by navigating to %appdata%\UnrealVRMod.
  2. Create a folder named UEVR and inside that a subfolder called plugins.
  3. Extract the DLL file of the preferred variant from the downloaded zip file into the plugins folder, so that the dll file resides in e.g. %appdata%\UnrealVRMod\UEVR\plugins\uevr-touch-buttons-mapping-plugin.dll

Per-game installation

  1. Go to UEVR's global directory by either clicking the Open Global Dir button in UEVR or by navigating to %appdata%\UnrealVRMod.
  2. Open the subfolder containing the profile for your game (e.g. Borderlands3).
  3. If it does not yet exist, create a subfolder called plugins.
  4. Extract the DLL file of the preferred variant from the downloaded zip file into the plugins folder, so that the dll file resides in e.g. %appdata%\UnrealVRMod\Borderlands3\plugins\uevr-touch-buttons-mapping-plugin.dll

Setup Example (SteamVR - Index Controllers)

Setup varies between controllers and software. This guide is to setup inputs for Index Controllers using SteamVR's controller bindings functionality:

  1. After launching the game, open SteamVR's settings, enter the Controller section, click Manage Controller Bindings, select the UEVR_... game to manage bindings for, switch to Custom binding and click Edit this binding.
  2. Delete all mappings for left Trackpad.
  3. Add a new DPAD mapping for the left Trackpad.
  4. Set North to bbuttontouchleft.
  5. Set South to abuttontouchleft.
  6. Click the checkbox to save the Trackpad mapping.
  7. Repeat steps 2-6 for the right trackpad (you may have to turn off Mirror Mode).

This would add the following mappings:

  • Bottom Left Trackpad is mapped to key 1.
  • Top Left Trackpad is mapped to key 2.
  • Bottom Right Trackpad is mapped to key 3.
  • Top Right Trackpad is mapped to key 4.

NOTE: Index (and probably other SteamVR) Controllers have the problem, that the default systembutton mapping does not work, since the controllers actual System Button brings up the SteamVR dashboard instead. Therefore it's best to map left Trackpad North to systembutton instead.

Compatibility

Please note that game profiles may already contain input-altering plugins. So there might be incompatibilities with various game profiles.

Thanks

Many thanks to Markmon, who's great Index Controls Plugin served as a boilerplate for this plugin.

And of course also many thanks to Praydog for creating UEVR and all others contributing to the ecosystem. It cannot be overstated how much ever evolving value UEVR adds to the world of PCVR!

About

UEVR Plugin mapping `[A/B]ButtonTouch[Left/Right]` and optionally `ThumbrestTouch[Left/Right]` OpenXR inputs to keyboard outputs

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages