← 返回主页

Controller-Mapper

一个功能强大的Xbox手柄按键映射工具,支持将手柄按键映射为鼠标点击或键盘按键。

1.0
版本
Python
开发语言
Tkinter
GUI框架

主要功能

  • 🎮 Xbox手柄支持: 完美支持Xbox有线/无线手柄
  • 🖱️ 鼠标映射: 将手柄按键映射为鼠标左键/右键点击
  • ⌨️ 键盘映射: 将手柄按键映射为任意键盘按键
  • 🎯 坐标映射: 支持鼠标点击指定屏幕坐标
  • 🔄 实时检测: 实时显示手柄连接状态和按键状态
  • 💾 配置保存: 自动保存映射配置,下次启动自动加载

技术栈

Python Tkinter Pygame PyAutoGUI PyInstaller

系统要求

  • Windows 7/8/10/11
  • Python 3.7+ (源码运行)
  • Xbox手柄 (有线或无线)

项目介绍

支持的按键

  • 方向键: 上、下、左、右
  • 功能键: A、B、X、Y
  • 肩键: LB、RB
  • 扳机键: LT、RT
  • 摇杆键: LS、RS
  • 系统键: Back、Start

快速开始

方式一:直接运行EXE文件

  1. 下载最新版本的 手柄映射器.exe
  2. 连接Xbox手柄到电脑
  3. 双击运行程序
  4. 等待手柄连接状态显示为"已连接"
  5. 开始配置按键映射

方式二:源码运行

  1. 克隆或下载本项目
  2. 安装依赖包:
    pip install -r requirements.txt
  3. 运行主程序:
    python controller_mapper.py

使用说明

1. 连接手柄

  • 确保Xbox手柄已正确连接到电脑
  • 程序启动后会自动检测手柄
  • 状态栏显示"手柄状态:已连接"表示连接成功

2. 配置按键映射

  • 点击任意按键对应的"设置"按钮
  • 选择映射类型:
    • 鼠标左键: 映射为鼠标左键点击
    • 鼠标右键: 映射为鼠标右键点击
    • 键盘按键: 映射为指定的键盘按键
    • 鼠标坐标: 映射为点击指定屏幕坐标
    • 无动作: 禁用该按键