键位映射看似简单，但实际操作中有几个关键前提必须满足：启用编辑模式、获取系统权限以及确保软件版本达标。具体来说，Bubbly需为v2.8.0及以上版本，Windows下必须以管理员身份运行，macOS则需在「系统设置→隐私与安全性→辅助功能」中授权Bubbly进程。进入「设置→控制方案→新建自定义方案」，启动目标游戏后即可绑定动作，支持敲击或拖拽两种方式，最后导出配置、设为默认并重启生效。

许多玩家希望将键盘按键映射为游戏内操作（例如用空格跳跃、用R释放技能），但打开Bubbly后却找不到映射入口，或点击保存按钮无反应。这通常是因为编辑模式未开启，或者配置文件被系统权限锁定造成的。

确认Bubbly版本与运行环境

首先，打开Bubbly主界面右下角的「关于」选项，查看当前版本号。必须为v2.8.0及以上（2025年12月后发布），旧版本根本不支持实时键位重映射。如果版本过低，请从官网 bubbly.dev/download 卸载旧版后下载最新安装包——【切忌从第三方应用市场安装，签名冲突会导致映射开关直接灰显，所有尝试均会白费】。

Windows用户务必右键选择“以管理员身份运行”Bubbly；macOS用户则需前往「系统设置→隐私与安全性→辅助功能」中勾选Bubbly进程。

进入映射编辑界面

点击顶部菜单栏的「设置」→「控制方案」→「新建自定义方案」。

此时右侧会显示一张空白键位图，左侧列出当前游戏识别到的可绑定动作（例如“移动”“技能1”“交互”）。如果左侧列表为空，请先启动目标游戏并进入主场景，Bubbly会自动抓取UI控件坐标——不用着急，让游戏运行起来即可。

点击任意动作条目（如“跳跃”），光标会自动跳转到右侧键盘图上对应的区域——至此便可开始按键绑定。

绑定物理按键到游戏动作

方法一：直接敲击键盘
聚焦在“跳跃”动作后，直接按下你想要的键（例如空格键），Bubbly会立即显示「空格 → 跳跃」绑定成功的提示。

方法二：拖拽式绑定
按住左侧动作名称（如“技能3”）不放，拖入右侧键盘图中任意键帽区域（建议拖到F12位置），松开鼠标即完成绑定。这种方式适合将多个动作集中映射到功能键区，避免与系统快捷键产生冲突。

【特别提醒：Ctrl/Cmd键绝对不能单独绑定，它只应作为组合键前缀使用；一旦误绑，后续所有组合键都将失效，后果严重】

保存并启用配置

第一步：点击右上角「导出配置」，保存为.bbl文件（建议文件名带上游戏名称，如“原神_手柄适配.bbl”，便于日后查找）。

第二步：返回「控制方案」列表，找到刚创建的方案，点击右侧「设为默认」按钮。

第三步：关闭Bubbly窗口，重新启动软件，进入游戏进行验证。此时按下绑定键，屏幕左上角会弹出半透明操作提示（例如「跳跃✔」），若无提示则表示未生效——请返回检查前面步骤。