Better Genshin Impact 自定义键位设置技术解析

背景介绍

Better Genshin Impact 是一款针对原神游戏的增强工具，其中一项重要功能是自动拾取物品。然而，原神游戏本身支持自定义键位设置，这导致工具内置的固定按键映射可能无法适配所有玩家的个性化设置。

技术实现原理

原神键位配置存储机制

原神将玩家的键位设置存储在Windows注册表中，具体路径为：

HKEY_CURRENT_USER\Software\miHoYo\原神\GENERAL_DATA_h2389025596

这个注册表项包含一个JSON格式的值，其中_overrideControllerMapValueList键存储了自定义键位配置。如果玩家使用默认键位，则该键为空；否则，它是一个包含键位映射信息的数组。

键位配置数据结构

键位配置采用XML格式存储，主要结构如下：

<ActionElementMap>
    <actionCategoryId>0</actionCategoryId>
    <actionId>17</actionId>
    <elementType>1</elementType>
    <elementIdentifierId>6</elementIdentifierId>
    <axisRange>0</axisRange>
    <invert>false</invert>
    <axisContribution>0</axisContribution>
    <keyboardKeyCode>102</keyboardKeyCode>
    <modifierKey1>0</modifierKey1>
    <modifierKey2>0</modifierKey2>
    <modifierKey3>0</modifierKey3>
    <enabled>true</enabled>
</ActionElementMap>

关键字段说明：

• actionId: 表示游戏内动作类型（如17代表元素战技）
• keyboardKeyCode: 对应的键盘按键代码
• elementIdentifierId: 按键标识ID

实现方案

Better Genshin Impact 通过以下方式实现了自定义键位支持：

1. 读取注册表配置：从Windows注册表中获取原神的键位设置
2. 解析XML数据：提取玩家自定义的按键映射关系
3. 动态按键映射：根据解析结果动态调整工具内部的按键检测逻辑

技术挑战与解决方案

挑战1：键位代码转换

原神使用自定义的键位代码系统，需要将其转换为标准的Windows虚拟键码(VK)。例如：

• 102对应F键
• 107对应K键

解决方案是建立一个映射表，将游戏内的键位代码转换为标准的VK代码。

挑战2：多按键组合

原神支持按键组合（如Ctrl+Shift+F），这增加了实现的复杂性。通过解析modifierKey1/2/3字段可以识别修饰键的组合情况。

挑战3：默认配置处理

当玩家使用默认键位时，_overrideControllerMapValueList为空，需要有一套默认的键位映射作为后备方案。

实际应用

在Better Genshin Impact中，自定义键位功能主要用于：

1. 自动拾取物品的按键检测
2. 元素战技/爆发的按键识别
3. 其他需要模拟玩家按键操作的功能

开发者已经实现了键位配置的读取和解析功能，用户可以通过修改配置文件来适配自己的键位设置，同时需要将对应按键的图像放入指定文件夹以支持图像识别功能。

未来优化方向

1. 图形化配置界面：提供可视化的键位设置界面，避免手动修改配置文件
2. 自动图像适配：根据键位设置自动生成或调整识别模板
3. 多设备支持：扩展对手柄等外设的自定义键位支持

通过这套自定义键位系统，Better Genshin Impact能够更好地适配不同玩家的操作习惯，提升工具的兼容性和用户体验。