🎮 Uni-Mapper: Universal Controller Mapper 🎮

A powerful and highly customizable tool designed to map any generic controller's inputs to keyboard and mouse actions, giving you the power to play almost any PC game with your favorite gamepad.

---

📜 Table of Contents

• ✨ Features at a Glance
• ⚙️ Installation
  • Prerequisites
  • Cloning the Repository
  • Running the Setup Script
• 🚀 How to Use Uni-Mapper
  • Running the Application
  • Understanding the Interface
• 🧠 Core Concepts: Profiles vs. Presets
  • 👤 What are Profiles?
  • 📚 What are Presets?
• 🌟 Advanced Features
  • 🚶‍♂️🚗✈️ Multi-Mode Controls
  • ⌨️ Setting Up Mode-Switching Hotkeys
  • ➕ Multi-Key Actions
  • 🎯 Mode-Specific Sensitivity
  • 🛠️ Creating Your Own Presets
• 🆘 Troubleshooting

---

✨ Features at a Glance

✅ Full Controller Mapping: Map every button, stick direction, and D-pad input to any keyboard key or mouse action.
✅ Multi-Mode System: Instantly switch between On Foot, Ground Vehicle, and Flight mappings.
✅ Profiles & Presets: Save personal configs and use ready-made game templates.
✅ Adjustable Sensitivity & Deadzones: Fine-tune controls per mode.
✅ Advanced Actions: Map a single button to multiple key presses.
✅ Real-time Visualization: Diagnose inputs and deadzones.
✅ Run as Administrator: Built-in elevation support.

---

⚙️ Installation

Prerequisites

• Python 3.x installed (check Add Python to PATH during install).

Cloning the Repository

• Install GitHub Desktop.
• Clone the repo with the repository URL.

Running the Setup Script

• Navigate to the cloned folder.
• Run PreSetup.bat to auto-install required libraries (pygame, pynput).

---

🚀 How to Use Uni-Mapper

Running the Application

• Run UM_GUI.bat and you’re done.
• If inputs don’t register in-game, restart with Run as Administrator (link inside Uni-Mapper).

Understanding the Interface

• Mappings & Profiles: Configure buttons, manage profiles & presets.
• Settings: Global & mode-specific sensitivity, inversion, deadzones.
• Visualization: Real-time controller diagnostics.
• Status: Device info & log.

---

🧠 Core Concepts: Profiles vs. Presets

👤 What are Profiles?

• Your full custom setup (mappings, sensitivities, hotkeys).
• Saved per-game, persistent between sessions.

📚 What are Presets?

• Pre-made, read-only templates for specific games.
• Loaded, then customized & saved as your own profile.

---

🌟 Advanced Features

🚶‍♂️🚗✈️ Multi-Mode Controls

• Separate tabs for On Foot, Ground Vehicle, and Flight.

⌨️ Setting Up Mode-Switching Hotkeys

• Assign hotkeys or controller buttons for switching modes.

➕ Multi-Key Actions

• Map a single input to multiple key presses (e.g., ctrl,c).

🎯 Mode-Specific Sensitivity

• Independent sensitivity, acceleration, and inversion per mode.

🛠️ Creating Your Own Presets

• Save your profile → copy .json → move to presets/ → rename/edit.

---

🆘 Troubleshooting

• Controller Not Detected: Check connection, restart app.
• Inputs Not Working In-Game: Run Uni-Mapper as Administrator.
• Stick Drift: Adjust deadzones in Settings.