：3步跑通的零代码手柄控制映射神器)
Universal Control Remapper (UCR)：3步跑通的零代码手柄控制映射神器
【免费下载链接】UCRUniversal Control Remapper [ALPHA]项目地址: https://gitcode.com/gh_mirrors/ucr/UCR
Universal Control Remapper，简称 UCR，是一款零代码的控制映射工具。如果你不想写一行脚本，只想改手柄映射，它正好为你而来。它跑在 AutoHotkey（AHK，Windows 热键脚本引擎）之上，但你全程不用碰代码。
🎯 它凭什么？——核心能力速览
场景：给老游戏输出“Xbox 风”手柄信号输入读取与输出生成，都由 IOClass 系统负责。它是一套可插拔的输入输出抽象，每种控制器类型就是一个 IOClass，你在菜单里勾选即可。 你得到什么：
| 输入 | 输出 | 典型用途 |
|---|---|---|
| 手柄按键 / 摇杆 | 键盘、鼠标 | 老 PC 游戏 |
| 非 Xbox 手柄 | vJoy 虚拟手柄（虚拟手柄驱动） | 只认 Xbox 的游戏 |
| 鼠标移动 | 手柄轴 | FPS 瞄准 |
场景：同一手柄、多套按键配置文件（Profile）可以组成树状结构，子配置可继承父配置里的插件。 你得到什么：
- 配置工具箱里新建、重命名、一键复制
- 子配置继承父配置映射，不用重复配
- 命令行可按名字精确切换配置
场景：单个插件搞不定的映射插件是最小映射单元，每个插件是一个小部件，可以串联。 你得到什么：
- 21 个内置插件，覆盖按键、轴、鼠标场景
- 输入 → 变换 → 输出，自由串联
- 参数一键保存，重启后自动记住
从零到跑通：你的第一条控制映射三步路径
拿到：一个能跑的 UCR
- 克隆仓库：
git clone https://gitcode.com/gh_mirrors/ucr/UCR- 双击 UCR.exe 启动
预期看到：主窗口打开，配置树里有一个默认配置。 ⚠️ 源码方式运行要先装好 AutoHotkey；发布包的编译版解压即用。
配好：第一个按键映射
- 新建配置并命名
- 添加 ButtonToButton 插件
- 输入绑到摇杆 A 键
- 输出绑到键盘空格
- 点“Save Settings”
预期看到：按手柄 A 键，游戏收到空格。 ⚠️ 最易踩的坑：忘记保存。UCR 不自动保存，不保存就退出等于白配。
验证：虚拟 Xbox 输出
- 菜单里看 vJoy 日志
- 失败就装 SCPVBus 驱动
- 设备管理器里核对设备
预期看到：设备管理器出现 vJoy 设备。 ⚠️ Xbox 手柄只能用 XInput 模式读取。XInput 是 Xbox 标准输入协议，Bind Mode（热键捕获模式）对它无效。
🛠️ 踩坑实录：控制映射 3 个高频问题及修复
我帮你踩过了，直接给路径。
问题一：Xbox 手柄映射不生效症状：UCR 开着映射正常，关掉 UCR 手柄就恢复正常。 根因：用了 Bind Mode 读取 Xbox 手柄。 修复：主菜单启用 XInput，重启 UCR，重连手柄。
问题二：vXBox 输出没反应症状：输出选了 vXBox，游戏里看不到手柄。 根因：vJoy 加载了，但虚拟 Xbox 依赖的 SCPVBus 驱动没装。 修复：IOClasses 菜单打开 vJoy 日志；异常就到 Resources/ScpVBus/ 里用管理员身份跑 install.bat。
问题三：拔下手柄 CPU 飙升症状：拔掉手柄后，UCR 的 CPU 占用明显上升。 根因：已断开手柄的绑定仍在被轮询。 修复：切到全局配置再切回来，触发一次配置重载。
⚡ 进阶：3 个可复现的控制映射高级玩法
玩法一：Shift 状态（同一手柄两层按键）基础映射放父配置，特殊功能放子配置，勾选“继承父配置”；按键进入子配置，松开即返回。
父配置（基础映射） └─ 子配置（Shift 功能） 按住 LB 进入，松开返回适合谁：想给同一手柄做“双层按键”的人。
玩法二：一个轴，两种用途用 AxisSplitter 把一个摇杆轴拆成两路输出：一路轴同时驱动两个 Xbox 扳机，或一半送鼠标、一半送虚拟手柄。
适合谁：飞行、赛车模拟玩家。
玩法三：命令行精确切配置把启动命令做成快捷方式： UCR.exe CLI.ahk "MAME" "megaman" 父配置按名字匹配；找不到同名子配置时，父配置兜底。
适合谁：游戏多、想一键进特定配置的人。
生态与贡献入口：怎么给 UCR 加一个插件
- 内置插件示例：Plugins/Core/
- 插件基类：Classes/Plugin.ahk
- GUI 控件库：Classes/GuiControls/
- 设计文档：Docs/UCR.mdj
最小插件：
class MyPlugin extends _UCR.Classes.Plugin { Type := "我的插件" Description := "一句话描述" }继承基类，每个实例自动拥有独立界面。
去克隆仓库，建出你的第一条控制映射配置，把操控权拿回自己手里。
提示：本 AHK 版本正在逐步退役，新功能建议关注项目的新 C# 版本。
【免费下载链接】UCRUniversal Control Remapper [ALPHA]项目地址: https://gitcode.com/gh_mirrors/ucr/UCR
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
