Controller Support

common/include/common/config/AlpineCoreConfig.h

@@ -12,6 +12,7 @@ class AlpineCoreConfig
 public:
     // Configurable fields
     bool vsync = false;
+    bool gamepad_rawinput_enabled = false;
 
     std::vector<std::string> orphaned_lines;
     bool load(const std::string& filename = "alpine_system.ini");

common/src/config/AlpineCoreConfig.cpp

@@ -39,6 +39,11 @@ bool AlpineCoreConfig::load(const std::string& filename)
         processed.insert("VerticalSync");
     }
 
+    if (settings.count("GamepadRawInput")) {
+        gamepad_rawinput_enabled = string_to_bool(settings["GamepadRawInput"]);
+        processed.insert("GamepadRawInput");
+    }
+
     for (const auto& [key, value] : settings) {
         if (!processed.contains(key) && key.rfind("AFCC", 0) == std::string::npos) {
             orphaned_lines.push_back(key + "=" + value);
@@ -85,6 +90,7 @@ void AlpineCoreConfig::save(const std::string& filename) const
 
     file << "\n[Configuration]\n";
     file << "VerticalSync=" << bool_to_string(vsync) << "\n";
+    file << "GamepadRawInput=" << bool_to_string(gamepad_rawinput_enabled) << "\n";
 
     file.close();
     xlog::info("Saved Alpine core config to {}", filename);

docs/CHANGELOG.md

@@ -28,6 +28,25 @@ Version 1.3.0 (Bakeapple): Not yet released
   - `Corona` for configuring custom glare effects in levels
   - `Note` for leaving important information in levels (editor only)
 
+[@AL2009man](https://github.com/AL2009man) & [@nickalreadyinuse](https://github.com/nickalreadyinuse)
+- Controller Support
+> [!WARNING]
+> When using Steam Input or Steam Hardware Inputs (Steam Deck, Steam Controller 2026, Steam Controller 2025): change the controller configuration to one of the many `Gamepad` templates to enable controller support.
+  - Full controller support via SDL3 Gamepad API
+  - Glyph support for Xbox, PlayStation, Nintendo, and Steam Hardware (Steam Controller 2015, Steam Deck, and Steam Controller 2026)
+  - Dual-Analog support for movement and camera controls
+  - Initial Rumble support
+    - Trigger Rumble/Impulse Triggers are also supported (requires enabling `GamepadRawInput` in `alpine_settings.ini`)
+  - Gyro Aiming support
+    - Natural Sensitivity Scale / Real World Sensitivity support 
+    - Gyro Space orientation support for Yaw, Roll, Local Space, Player Space and World Space
+    - Gyro Autocalibration system 
+    - Gyro Modifier / Gyro Ratcheting support (via Game Action remapping)
+  - Simultaneous Contoller+Keyboard/Mouse / Mixed Input support
+    - if using SteamInput's supported Input Camera styles: We recommend selecting `ms_scale`'s Modern (`2`) and change the mouse sensitivity to `2.5000`. If it's set to ``6545px`` (default slider on SteamInput): this will skip "[Input] Angles/Degrees to Mouse Pixels" slider.
+  - Partial controller menu navigation support (Mouse controls are handled via Right Stick Input)
+  - Additional Controller settings are available in `alpine_settings.ini`and/or console commands, this includes experimental Flick Stick support, resetting gyro autocalibration systems and Gyro Vehicle Camera.
+
 ### Minor features, changes, and enhancements
 [@GooberRF](https://github.com/GooberRF)
 - Standardize user agent string format across all use cases
@@ -123,6 +142,7 @@ Version 1.3.0 (Bakeapple): Not yet released
 
 [@AL2009man](https://github.com/AL2009man)
 - Add `ms_scale` toggle to use various mouse sensitivity scaling options between Classic (original scaling), Raw and Modern (id Tech/Source).
+- Add `GamepadRawInput` option (via `alpine_settings.ini`) to enable RawInput driver for better handling of XInput controllers, while allowing Trigger Rumble/Impulse Trigger support.
 
 [@natarii](https://github.com/natarii)
 - Implement FFLink client functionality in launcher

game_patch/CMakeLists.txt

@@ -98,10 +98,19 @@ set(SRCS
     graphics/d3d11/gr_d3d11_hooks.h
     graphics/d3d11/gr_d3d11_outline.h
     graphics/d3d11/gr_d3d11_outline.cpp
+    input/input.cpp
     input/input.h
     input/mouse.h
     input/mouse.cpp
     input/key.cpp
+    input/gamepad.cpp
+    input/gamepad.h
+    input/rumble.cpp
+    input/rumble.h
+    input/glyph.cpp
+    input/glyph.h
+    input/gyro.cpp
+    input/gyro.h
     hud/hud_colors.cpp
     hud/hud_scale.cpp
     hud/hud_personas.cpp
@@ -299,6 +308,7 @@ target_include_directories(AlpineFaction PRIVATE
     ${CMAKE_SOURCE_DIR}/vendor/dds
     ${CMAKE_SOURCE_DIR}/vendor/toml++
     ${CMAKE_SOURCE_DIR}/vendor/nlohmann
+    ${CMAKE_SOURCE_DIR}/vendor/gamepadmotionhelpers
 )
 
 if(NOT MSVC)
@@ -332,4 +342,14 @@ target_link_libraries(AlpineFaction
     freetype
     stb_vorbis
     stb_image
+    SDL3::SDL3
+    GamepadMotionHelpers
 )
+
+if(WIN32)
+    target_link_libraries(AlpineFaction
+        setupapi
+        imm32
+        cfgmgr32
+    )
+endif()