feat: add configurable trigger button via sButton INI setting

[codepuncher]

Summary

Adds a configurable sButton INI option so users can choose which gamepad button triggers the hold-to-open-map behaviour. Requested by Nuascura on NexusMods.

Changes

• QuickMap.ini — new sButton=Start setting with inline documentation
• src/Plugin.cpp — ReadButton() function parses the INI value to a BSWin32GamepadDevice::Key code; warns and falls back to Start on unknown values
• src/InputHandler.h/cpp — buttonKeyCode/buttonName private members replace the hardcoded kStart; ProcessStartButton → ProcessButton; UpdateShortPressUserEvent → UpdateShortPressBinding
• README.md / docs/nexus-page.md — sButton documented in the Configuration section

Supported values

Start, Back (case-insensitive)

Both buttons safely preserve the short press (Journal Menu and Quick Inventory respectively).

Testing

• Tested in-game with sButton=Start (default) and sButton=Back
• Short press and long hold both work correctly for both buttons

[Copilot]

Pull request overview

Adds an INI-configurable gamepad trigger button (sButton) for QuickMap’s hold-to-open-map behavior, replacing the previously hardcoded Start-button trigger and updating docs/config templates accordingly.

Changes:

• Added sButton parsing in src/Plugin.cpp and plumbed the chosen key/name into the input handler.
• Refactored InputHandler to use a configurable buttonKeyCode/buttonName and renamed related methods.
• Documented sButton in QuickMap.ini, README.md, and docs/nexus-page.md.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
src/Plugin.cpp	Adds ReadButton() and wires configured button into InputHandler; updates short-press binding refresh calls.
src/InputHandler.h	Introduces configurable default button constant and new SetButton; renames APIs around “Start”.
src/InputHandler.cpp	Implements SetButton, switches logic to use configured key code/name, and updates logging.
README.md	Documents the new sButton option in the configuration snippet.
QuickMap.ini	Adds the new sButton setting with inline documentation.
docs/nexus-page.md	Documents sButton in the Nexus page configuration section and updates compatibility wording.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated 2 comments.

[Copilot]

Pull request overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated 1 comment.

[Copilot]

Pull request overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated 1 comment.

[Copilot]

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 1 comment.

[Copilot]

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 2 comments.

Comments suppressed due to low confidence (1)

docs/nexus-page.md:30

• Same as above: this overview line implies short press behavior is preserved for any configured button, but the plugin consumes short presses for non-Start/Back buttons. Consider adding a brief note (e.g., “Start/Back only”) or referencing the warning in the Configuration section.

Hold a configurable gamepad button (default: [b]Start[/b]) for a configurable duration to open the [b]world map[/b] directly. A short press opens whatever menu the button is bound to in your controls.

[Copilot]

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 1 comment.

Comments suppressed due to low confidence (1)

README.md:7

• The README still says "Inspired by ... hold-Start-to-open-map" even though the trigger button is now configurable (Start/Back). Update this line to avoid implying Start is required.

Hold a configurable gamepad button (**Start** or **Back**, default: **Start**) for a configurable duration to open the **world map**. A short press opens the button's normal menu.

> **Gamepad only.** Default behaviour is fully preserved.

Inspired by Red Dead Redemption 2's hold-Start-to-open-map mechanic.