Home

📚 Gamepad-Core Wiki

Complete Technical Documentation & Developer Resources

Modern, policy-based C++ library for advanced gamepad features (DualSense/DS4).
Engine-agnostic architecture designed for Unreal, Unity, Godot, and O3DE.

---


---

🎯 What is Gamepad-Core?

GamepadCore is a high-performance, platform-agnostic C++ library designed to handle raw HID communication with game controllers. It bypasses generic abstraction layers (like XInput or SDL) to unlock hardware-specific features often inaccessible in standard APIs.

This wiki provides in-depth technical documentation for developers integrating Gamepad-Core into their projects.

---

📖 Documentation Index

🏗️ Architecture & Design

🏛️	Architecture Overview Understanding the policy-based design, layer separation, and extension points Core abstractions (GCore, GImplementations) Platform policies and hardware abstraction How to extend for new platforms or engines Thread safety and performance considerations

---

🎮 DualSense Advanced Features

📄

Technical Documentation: Trigger Effect Mapping Complete reference for DualSense adaptive trigger effects and their data structures Official Sony trigger modes (Feedback, Weapon, Vibration, etc.) Unofficial/community-discovered effects Vestigial modes and experimental features C++ struct definitions and parameter ranges

🎮	HEX Mapping Reference: DualSense Triggers Raw HEX command reference for low-level trigger programming Byte-level HID report structure HEX values for each trigger effect type Parameter encoding and bit fields Examples and usage patterns

---

🚀 Quick Navigation

For Developers

• New to Gamepad-Core?
  Start with the Architecture Overview to understand the library's design philosophy.

• Integrating into a game engine?
  Check the Architecture Overview for policy implementation examples.

• Need trigger effect references?
  See Trigger Effect Mapping for high-level API docs, or HEX Mapping Reference for raw HID commands.

For Researchers

• Reverse engineering DualSense protocol?
  The HEX Mapping Reference documents all discovered HID report structures.

• Contributing new findings?
  Update the Technical Documentation with your discoveries!

---

🛠️ Additional Resources

Live Projects Powered by Gamepad-Core

• Unreal-Dualsense (v2.0. 0-pre-release)
  Production-ready Unreal Engine plugin with full DualSense integration

• Godot-Dualsense
  GDExtension prototype for Godot 4.x

External References

• DualSense on Windows (Ohjurot) — Original research on Windows HID
• pydualsense (flok) — Python implementation
• DualSense API (BadMagic100) — C# wrapper

---

🤝 Contributing to the Wiki

Found an error? Discovered a new trigger effect? Want to add examples?

How to contribute:

1. Click "Edit" on any wiki page (requires GitHub account)
2. Make your changes using Markdown
3. Submit with a descriptive commit message
4. Changes are reviewed by maintainers

Contribution guidelines:

• Keep technical accuracy high
• Provide code examples where relevant
• Link to related wiki pages for context
• Use clear, concise language

---

📄 License & Legal

This documentation is part of the Gamepad-Core project, licensed under the MIT License.

Trademarks: PlayStation, DualSense, and DualShock are trademarks of Sony Interactive Entertainment Inc.
This project is not affiliated with Sony.

---

Questions? Open an Issue or Discussion

⬆ Back to Top