Improved support for controller / gamepad

[fritzw]

The current gamepad user experience is somewhat suboptimal, at least for players who played any recent platformer with a gamepad.

• Split menu controls "Confirm/Cancel" from Clonk controls "Throw/Dig". If not configured, the old defaults should be used.
  • Alternative: Make "Jump" the same as "Menu Confirm" for gamepad controls, if the above is too complicated.
• Make "Up" and "Jump" separate configurable inputs, which are mapped to the same keyboard key by default: "Up" should to things like enter buildings, climb up, swim up, move up in menu. "Jump" should only make Clonks jump and no other actions (unless other actions are mapped to the same button, like "Menu Confirm").
• Nice to have: Show controller button icons instead of controller button numbers in the UI action buttons at the bottom of the screen.
• Nice to have: Implement XInput support instead of (or in addition to) the legacy WINMM Joystick API (joyGetPosEx). I'm not sure how many gamepads that support this API are even still in existence today.
• Nice to have: Disallow "classic controls" and only use "Jump and Run" controls when using gamepad, or display a warning that "classic" is not suitable for gamepads. On keyboard, you have 3 fingers to control Left/Right/Stop, but on a gamepad you control all 3 only with the thumb, making it very clumsy.
• Implement better directional control for controller analog sticks
  • Add analog stick hysteresis if it feels better
• Maybe improve swimming directional control with analog stick, even if quantized to 8 directions.

Firstly, Clonk does not support XInput, so no support for "modern" controllers like the various XBox types. This can be fixed using Xidi. This works, but you see no actual button names in the UI, only button numbers (e.g. on the action indicators at the bottom right of the screen). Actual XInput support would be nice, and it "should not be that hard" (haha). Just call XInputGetState instead of joyGetPosEx (but of course the devil is in the details).

But second, and more importantly: Nearly all modern games follow the same conventions for gamepad control for good reasons:

1. The A button on an XBox style controller is used for 2 actions: Confirm (in menus) and Jump (in game).
2. The Up direction of the analog stick and on the D-pad are never used to jump, because this causes undesired jumps in hectic situations, but it is used for things like climbing or swimming upwards.
3. The B button is used for: Cancel or Back (in menus) and some (maybe configurable) action in game.

But in Clonk, this setup is currently not possible.
You could configure the A button as the "Up" key in Clonk, allowing you to jump with A. But "Confirm" in menus is always the same as "Throw", so you can't have "Confirm" and "Jump" both on A. Also, you would have to press A to climb up or navigate upwards in menus. You can use Xidi to map both A and Up to the clonk "Up" key to fix that issue and still have Jump on A, but then you still have the problem that you can get accidental jumps when you walk around, by pressing the analog stick slightly in the wrong direction.

The 3rd point is not so much of a problem, because the "Cancel" button in menus is the same as "Dig". Mapping that to the B button works fine, although it would still be nice to have the option to configure "Dig" independently of "Cancel".

The ideal solution in my opinion would be to have "Up" and "Jump" (and possibly even "Menu Cancel") as separately configurable inputs (which could be configured to the same input of course). A quick look at the code tells me that this is probably not so easy, because some code depends on the notion that "Up" is the same as "Jump", for example ObjectComUp directly calls PlayerObjectCommand(cObj->Owner, C4CMD_Jump). I expect there to be more such places, but I didn't look further than that, so I might be mistaken. Some problematic cases might even be in some c4script code somewhere...

If someone changed the code anyways, it might also be desirable to configure "Menu Cancel" and "Dig" as separate keys.

[maxmitti]

Last time I checked, XInput actually worked, when I pressed some button on the gamepad before starting Clonk (or restarting it afterwards), or something similar. The same was also true for other old games like Need for Speed Underground 2.

It might still have been in Windows 7, but I would hope that Microsoft didn’t drop that compatibility in newer versions.

All the button and axis names are definitely not helpful at all.
I wonder how much better it would be when using SDLs Gamepad support.

Splitting menu actions from the normal controls is an interesting idea.
There is already some special handling for the mouse, which could be helpful.
Fortunately, in this case, the menu handling functionality for scripts is quite limited. So there should not be scripting issues, I think.

[fritzw]

Well, at first I also thought that it kinda works, because I could control the menu in Clonk with my XBox 360 controller, even without Xidi. But it turned out that it was only because Steam was running in the background and was translating controller inputs to keyboard inputs like the arrow keys. It's called "Desktop Layout" in the Steam controller settings, and after I set that to the "Disabled" layout, the controller did nothing in Clonk without Xidi. Even playing was possible (to a degree) when selecting the "Keyboard 4" controls for my player, but more customizations would be necessary in Steam to make it work really.

Oh, in case anyone is interested, here's my current Xidi.ini which maps the A button to "Up" on the left stick:

[Mapper]
Type                                = JumpOnA

[CustomMapper:JumpOnA]
Template            = DigitalGamepad
ButtonA             = Axis(Y, -)

[maxmitti]

No, it was definitely not Steam, and I was using the Gamepad 1 option in Clonk.

[maxmitti]

Which Windows version are you using?

[fritzw]

This is on Windows 11.

[fritzw]

I've added a checklist to the first comment, with a few more details what an implementer would have to look out for. Will extend with more details if necessary.

[maxmitti]

I just tried on Windows 10 and it works.

[fritzw]

I don't have a Windows 10 PC ready to cross-check, but I guess they changed something in Windows 11 then. When I disable Xidi and close Steam, my controller does not interact with Clonk at all, neither in the main menu, nor in the controller configuration menu, nor in-game.

Still, the other more important points remain.

[maxmitti]

I just fully realized that you want to split Jump from Up for Clonk controls.
That seems indeed very difficult, also due to scripts.

[fritzw]

Oh, it's still there in Windows 11, but was not active by default for me. In the legacy control panel, there is an entry called "Set up USB game controllers", where you can "Select the device you want to use with older programs" after clicking "Advanced":

[fritzw]

I just fully realized that you want to split Jump from Up for Clonk controls.
That seems indeed very difficult, also due to scripts.

Ah. Well, yes that's what I feared.

[fritzw]

I guess that separating the menu controls from the Clonk controls is the more important part from a usability standpoint, though. Having "Jump" and "Up" on the same key is occasionally annoying, but not being able to "Confirm" menu entries using "A" is a major problem in my opinion. That works against years of trained muscle memory.

[maxmitti]

I just fully realized that you want to split Jump from Up for Clonk controls. That seems indeed very difficult, also due to scripts.

Although, I thought about it more and it could actually work out decently for most packs.
Jump is only the default action for Up.
So it should be easily possible to inhibit that or trigger it separately.

[maxmitti]

I guess that separating the menu controls from the Clonk controls is the more important part from a usability standpoint, though. Having "Jump" and "Up" on the same key is occasionally annoying, but not being able to "Confirm" menu entries using "A" is a major problem in my opinion. That works against years of trained muscle memory.

Would it help to map Throw to two buttons? The one you use for controlling the clonk and also “A”.
This is already possible with Extra.c4g/KeyConfig.txt:

[Keys]
Joy1Btn4=button1,button2

1 is for Gamepad 1 and 4 should be Throw (these + 1).
button1 and button2 are parsed like this, which should be the same as displayed in the gamepad options.

You can also map to all the other controls found here.

[fritzw]

Would it help to map Throw to two buttons? The one you use for controlling the clonk and also “A”.

Not really, because the conventional mapping for button A in most games is "Jump". If I understand you correctly, this would not be possible with this suggestion, right? The minimal solution to my "problem" would be to map A to Thrown only while controlling a menu, and not a Clonk or other object.