MCKeyBinder 按键同步器 v1.0.0

MCKeyBinder 按键同步器 v1.0.0

把一套按键设置一键同步到所有整合包，不用往整合包里装任何 Mod。

换整合包最烦的就是重新绑一遍疾跑、潜行、背包、小地图……这个工具直接改各整合包的
options.txt，把主配置里的按键写过去。绑定名相同就等于功能相同，所以同一个 Mod
出现在不同整合包里也能精确对上，不需要 Mod 参与。

下载

文件	说明
MCKeyBinder-1.0.0-win64.zip	解压后双击里面的 MCKeyBinder.exe。启动快，推荐
MCKeyBinder.exe	单文件版，就一个 exe。启动时会自解压，慢一两秒

不用装 Python，也不用装任何 Mod。 两种都是绿色版：第一次运行会在 exe 旁边建一个
data/ 放主配置、备份和缓存。想搬到别的电脑，把整个文件夹（或那个 exe）拷走即可；
删掉 data/ 等于恢复出厂设置。

没签名的 exe 第一次运行可能被 SmartScreen 拦一下（「更多信息 → 仍要运行」）。

这一版有什么

同步

• 自动扫描 PCL2 / HMCL / 官方启动器的整合包实例，自动识别每个实例的 MC 版本和加载器。
• 三种同步范围：整体「一键同步」、只同步按键、只同步「其他设置」。
• 跨 Mod 同功能映射：主配置里 Xaero 小地图的「打开世界地图」，能连 JourneyMap 的对应按键一起改。
• 同步前自动备份，随时还原；optionsof.txt（OptiFine）和 Mod 自己的配置文件也能扫能同步。
• 手动改动保护：同步过一次之后就有了基线。你要是后来在某个整合包里故意把某个键解绑，
  下次同步会保留你的改动而不是绑回去。勾掉选项或点「重置同步基线」可以强制对齐。

界面

• MC 风格的键位图：整副键盘 + 鼠标 + 滚轮布局，空闲 / 已绑定 / 与主配置不同 / 冲突分色，
  按 Mod、归属、状态、关键词过滤，点一个键就能看它被哪些功能占了、就地改键或解绑。
• 「按键对比」表逐条列出每个实例的差异，可以单独勾选某几个键同步。
• 「其他设置」页列的是视野、界面尺寸、最大帧率、鼠标灵敏度、屏幕扭曲效果这类 options.txt
  设置，中文名取自当前 MC 版本的原版语言文件；推荐项默认勾上。
• 窗口大小、分栏位置、标签页、日志展开状态都会记住。

安全

• 整份重写目标文件时只保留该实例本来就认识的绑定名，绝不整文件替换。
• 写入是原子的：临时文件 + os.replace，中途出错不会留下半个文件。
• 每次写入前自动备份，连「恢复」这个动作本身也会先备份一次。

从源码跑

只需 Python 3.9+，零第三方依赖：

git clone https://github.com/Lkig/MCKeyBinder.git
cd MCKeyBinder
python main.py

自己打包 exe：

python -m venv .venv
.venv\Scripts\python -m pip install -r requirements-build.txt
.venv\Scripts\python tools\build_exe.py

许可

MIT License。