# ETS2-KeyBinder

**Repository Path**: chenjjian/ETS2-KeyBinder

## Basic Information

- **Project Name**: ETS2-KeyBinder
- **Description**: 欧卡2/美卡 转向灯拨杆/雨刮/档位开关 原生按键绑定工具 (ETS2/ATS Key Binder)
- **Primary Language**: C++
- **License**: MIT
- **Default Branch**: Refactor_Qt6
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-05
- **Last Updated**: 2025-06-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 欧卡2/美卡原生按键 图形化界面绑定工具

游戏原生支持特殊按键的绑定，但在游戏界面中无法直接修改。

该工具用于将欧卡2/美卡中的转向灯拨杆、雨刮、档位开关等原生按键绑定到游戏控制器上，支持按下与松开的复杂组合键绑定，可点击视频观看绑定效果与教程 [《绑定效果与教程》](https://www.bilibili.com/video/BV1cEGrzvEtb)

# 使用方法

1. 禁用Steam输入，连接好自己的游戏控制器

![image](https://github.com/user-attachments/assets/d3009fd0-ac97-4435-a222-bbf65989ab18)

2. 打开游戏，进入设置界面，确保自己的游戏控制器有在“输入类型”选中
3. 关闭游戏
4. 打开绑定工具，选择对应游戏

![image](https://github.com/user-attachments/assets/a97671fc-94a5-4d43-a264-107f128fe997)

5. 选择对应的硬件设备
6. 选择游戏配置文件
  
![image](https://github.com/user-attachments/assets/82c7569f-4f1b-4ac2-bb6e-fde884dd2f0f)

7. 参考显示的按键状态，自行选择自动绑定（组合键/单按键）或手动绑定

![image](https://github.com/user-attachments/assets/752d5852-74b4-4902-9a9d-254f97f1f463)


# 绑定功能

## 自动绑定（组合键）
目前验证过自动绑定的设备有：
- 五菱宏光原车配件拨杆
- 其他待验证，有问题请反馈

![image](https://github.com/user-attachments/assets/e2276358-e34e-4869-b356-1cb84daaf61b)


## 自动绑定（单按键）
这种方式适合自己DIY的游戏控制器，预先处理过组合信号为1个信号

![image](https://github.com/user-attachments/assets/64cef967-7ea9-47a8-adf9-c9f081efe312)

## 手动绑定
这种方式适合所有的设备，手动输入按键索引进行绑定，支持按下与松开的复杂组合键绑定

![image](https://github.com/user-attachments/assets/f3b84830-4e56-48a4-8846-c8eb381c5e8e)

# 说明
Qt6：用Qt6 C++ 重新编写的按键绑定工具，有图形化界面，支持欧卡2、美卡的复杂组合键绑定。

PythonCommandLine(Old)：旧工程，原作者用Python的编写的命令行绑定工具，只支持欧卡2单按键绑定。