https://github.com/jonas-hack/unity-thrustmaster-t16km-hosas-inputsystem

Automatically Differentiate Between Left- & Right Stick Inputs for HOSAS Use
https://github.com/jonas-hack/unity-thrustmaster-t16km-hosas-inputsystem

flight-simulator hosas input-system joystick-control t16000m thrustmaster unity unity3d

Last synced: about 1 month ago
JSON representation

Automatically Differentiate Between Left- & Right Stick Inputs for HOSAS Use

• Host: GitHub
• URL: https://github.com/jonas-hack/unity-thrustmaster-t16km-hosas-inputsystem
• Owner: Jonas-Hack
• Created: 2023-08-21T14:12:14.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2023-11-10T13:46:39.000Z (about 1 year ago)
• Last Synced: 2023-11-10T15:09:13.841Z (about 1 year ago)
• Topics: flight-simulator, hosas, input-system, joystick-control, t16000m, thrustmaster, unity, unity3d
• Language: C#
• Homepage:
• Size: 7.81 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Unity-Thrustmaster-T16KM-HOSAS-InputSystem

 Automatically Differentiate Between Left- & Right Stick Inputs for HOSAS Use

## Purpose

By default Unity does not recognize the difference between left- and right handed fight sticks.

There is however a suitable system for *XR-Controllers* in the form of `Configuration Usage Tags`.

These scripts automatically assign a side to *Thrustmaster T16000M* sticks by reading the value of the little switch on the bottom.

Additionally the sides get updated automatically at runtime, should the switch be flipped again - or another device be plugged in.

# Usage

Just place the scripts somewhere in your project.

## Usage in Input Action UI

In the *Input Actions* Window, for each binding - the side can be chosen:

```{leftHand}/stick```

```{rightHand}/hat```

## Usage in Code

Additionally the value of ```leftRightSwitch```can be read directly:

````

        // https://docs.unity3d.com/Packages/[email protected]/api/UnityEngine.InputSystem.InputAction.html

        InputAction changeHandAction = new InputAction(binding: "/leftRightSwitch");

        changeHandAction.performed += (_ => foo()); // Right Side

        changeHandAction.canceled += (_ => bar());  // Left Side

        changeHandAction.Enable();

````

Though I see no reason to do so.

**NOTE:** To get notified of *ANY* change in stick side, use `InputActionType.PassThrough`.

## Support for other Joysticks

For now this *ONLY* works for *Thrustmaster T16000M* joysticks. However, support for other sticks can be added:

Analogous to ``SidedTM16KM.cs``:  

1. Create an Input **Layout Override**

2. Add a **binding** using the `SidedStickInitialize` Attribute

3. Create a **registerStick** method

4. Add the method using the `SidedStickRegistrate` Attribute

If you do so, please create a pull request, so we can all benefit.

## Acknowledgements

This was originally based on two Unity Forum posts: [1](https://forum.unity.com/threads/two-identical-joysticks.639691/), [2](https://forum.unity.com/threads/t-16000m-read-left-hand-right-hand-switch.873124/), though some quality of life features, as well as some bug-fixes, are entirely my own.